卡片
目录
卡片可以使用 card
shortcode 添加到页面中。此 shortcode 的参数如下:
参数 | 描述 |
---|---|
title | 卡片的标题 |
icon | 卡片的图标 slug |
image | 使用自定义图像代替图标(与 icon 参数互斥) |
link | (可选)卡片被点击时的链接目标 |
description | 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
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/"