可以使用短代码将卡片添加到页面card。该短代码的参数是:

范围描述
标题卡的标题
图标卡的图标 slug
图像使用自定义图像代替图标(与图标互斥)
关联(可选)点击时卡片的链接目标
描述描述文本,Markdown 格式

笔记

卡片的 Markdown 描述存在一个已知的限制,即它们不能包含指向其他 .md 文档的相对链接。此类链接将无法正确呈现。相反,请使用指向要链接到的页面的 URL 路径的绝对链接。

例如,不要链接到../install/linux.md,而是写: /engine/install/linux/

例子

标记

{{< card
  title="Get your Docker on"
  icon=favorite
  link=https://docs.docker.com/
  description="Build, share, and run your apps with Docker"
>}}

网格

还有一个内置的grid短代码,可以生成……嗯,网格……卡片。大屏幕上的网格尺寸为 3x3,中屏幕上的网格尺寸为 2x2,小屏幕上的网格尺寸为单列。

Grid 是一个独立的短代码card,但它在底层实现了相同的组件。用于插入网格的标记有点不传统。网格简码不带参数。它所做的只是让您指定希望网格出现在页面上的位置。

{{< grid >}}

网格的数据在页面的前面的键下定义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/"