卡片

可以使用 card 短程式碼將卡片新增到頁面。此短程式碼的參數為

參數說明
title卡片的標題
icon卡片的圖示代碼
image使用自訂圖片代替圖示(與圖示互斥)
link(選用)點擊卡片時的連結目標
descriptionMarkdown 格式的說明文字

注意事項

卡片的 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/"