卡片

卡片可以使用 card shortcode 新增到頁面中。此 shortcode 的引數如下:

引數描述
title卡片的標題
icon卡片的圖示 slug
image使用自定義影像代替圖示(與 icon 引數互斥)
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 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/"
頁面選項