卡片

卡片可以使用 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.cn/
  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/"
页面选项