卡
目錄
可以使用 `card` 短程式碼將卡片新增到頁面。此短程式碼的引數為
引數 | 描述 |
---|---|
title | 卡片標題 |
圖示 | 卡片的圖示 slug |
image | 使用自定義影像而不是圖示(與圖示互斥) |
連結 | (可選)卡片被點選時的連結目標 |
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/"