卡片
目录
可以使用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/"