卡片

可以使用card 代码片段将卡片添加到页面。此代码片段的参数为:

参数描述
标题卡片的标题
图标卡片的图标标识
图片使用自定义图片代替图标(与图标互斥)
链接(可选) 点击卡片时的链接目标
描述描述文本,使用 Markdown

注意

卡片的 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 代码片段,它会生成……嗯,网格……卡片。网格大小在大型屏幕上为 3x3,在中等屏幕上为 2x2,在小型屏幕上为单列。

网格是与card 分开的代码片段,但它在后台实现了相同的组件。用于插入网格的标记略有不寻常。网格代码片段不接受任何参数。它只是让您指定页面上网格出现的位置。

{{< grid >}}

网格数据在页面的前置 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/"