卡片
目錄
卡片可以使用 card
shortcode 新增到頁面中。此 shortcode 的引數如下:
引數 | 描述 |
---|---|
title | 卡片的標題 |
icon | 卡片的圖示 slug |
image | 使用自定義影像代替圖示(與 icon 引數互斥) |
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
shortcode,它可以生成… 嗯,一個網格… 的卡片。網格在大螢幕上是 3x3 大小,在中等螢幕上是 2x2,在小螢幕上是單列。
Grid 是一個與 card
獨立的 shortcode,但它在底層實現了相同的元件。用於插入網格的標記稍微有些非傳統。grid shortcode 不接受任何引數。它只允許您指定網格在頁面上出現的位置。
{{< 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/"