卡片
目錄
可以使用 card
短程式碼將卡片新增到頁面。此短程式碼的參數為
參數 | 說明 |
---|---|
title | 卡片的標題 |
icon | 卡片的圖示代碼 |
image | 使用自訂圖片代替圖示(與圖示互斥) |
link | (選用)點擊卡片時的連結目標 |
description | Markdown 格式的說明文字 |
注意事項
卡片的 Markdown 說明存在一個已知的限制,即它們不能包含指向其他 .md 文件的相對連結。此類連結將無法正確呈現。請改用指向您要連結頁面 URL 路徑的絕對連結。
例如,不要連結到
../install/linux.md
,請改寫成:/engine/install/linux/
。
範例
標記
{{< card
title="Get your Docker on"
icon=favorite
link=https://docs.docker.net.tw/
description="Build, share, and run your apps with Docker"
>}}
網格
還有一個內建的 grid
短程式碼,可以產生...一個卡片網格。網格大小在大螢幕上為 3x3,在中等螢幕上為 2x2,在小螢幕上為單欄。
網格與 card
是不同的短程式碼,但它在底層實作相同的組件。用於插入網格的標記略有不尋常。網格短程式碼不接受任何參數。它所做的只是讓您指定網格在頁面上出現的位置。
{{< grid >}}
網格的資料定義在頁面的 front matter 中,位於 grid
鍵下,如下所示
# front matter section of a page
title: some page
grid:
- title: "Docker Engine"
description: Vrrrrooooommm
icon: "developer_board"
link: "/engine/"
- title: "Docker Build"
description: Clang bang
icon: "build"
link: "/build/"