说明目录
Garden 使用说明组件参考garden card

组件参考 · card

介绍一篇论文、一个项目或一组值得参考的公开工具。

← 组件参考 · 用法：知识卡片

1示例

代码

```garden card
title: SQLite WAL 写入模式
url: https://www.sqlite.org/wal.html
meta: 文档说明 · sqlite.org
description: 把修改先顺序追加到预写日志，读操作继续访问原数据库页，减少读写互斥等待。
points:
  - 写入只追加到 `-wal` 文件末尾，不需要在事务提交时原地覆盖数据页。
  - 读事务记录当前末尾偏移量即可看到一致快照，不会阻塞并发写入。
  - 后台 Checkpoint 按阈值将日志页分批写回主库文件。
```

效果

SQLite WAL 写入模式

文档说明 · sqlite.org

把修改先顺序追加到预写日志，读操作继续访问原数据库页，减少读写互斥等待。

  1. 写入只追加到 -wal 文件末尾，不需要在事务提交时原地覆盖数据页。

  2. 读事务记录当前末尾偏移量即可看到一致快照，不会阻塞并发写入。

  3. 后台 Checkpoint 按阈值将日志页分批写回主库文件。

代码

```garden card
cards:
  - url: https://openlibrary.org/
    title: Open Library：每本书一个页面
    description: Internet Archive 维护的开放图书目录，可以查版本、借阅电子书。
    image: /images/garden/ref-card-book.svg
    alt: 一本合上的书
    source:
      - https://openlibrary.org/
    takeaway: "**可借鉴：** 选书时直接贴书的页面链接，大家看到的是同一个版本。"
  - url: https://www.gutenberg.org/
    title: Project Gutenberg：公版电子书
    description: 收录已进入公有领域的电子书，可以免费下载。
    image: /images/garden/ref-card-lamp.svg
    alt: 一盏台灯
    source:
      - https://www.gutenberg.org/
      - https://en.wikipedia.org/wiki/Project_Gutenberg
    takeaway: "**可借鉴：** 偶尔选一本公版书，没买书的人也能马上加入。"
```

效果

2字段写法

```garden card
title:        # 建议填，标题
url:          # 可选，标题链接
meta:         # 可选，副标题
description:  # 摘要（或 text）
points:       # 要点列表（或 items）
image:        # 可选，缩略图
alt:          # 可选，替代文本
source:       # 可选，来源网址
site:         # 可选，站点名
takeaway:     # 可选，底部结论
cards:        # 多卡模式，每项同上
  - url:      # 卡片链接
```

3字段

围栏写 ```garden card（编辑器代码片段触发词 ;gcard）。单张卡片直接在顶层写字段，多张横向资源行卡用 cards 数组；YAML 语法错误或顶层含未知键名时整块报 garden-yaml 错误。

字段是否必填默认值取值与限制说明
title建议填写同 url字符串卡片标题；未填时回退显示 url
url可选""完整 https:// 或 http:// 网址标题跳转的外链；未填时标题渲染为纯文本
meta可选无字符串标题下方的副标题或来源说明
description与 points、cards 至少填一项""字符串（别名 text）摘要段落，支持行内加粗与代码
points与 description、cards 至少填一项[]字符串数组或 { title, text? }[]（别名 items；建议 2～4 条要点，不做校验）摘要下方的编号要点列表
image可选无图片路径或 Data URL卡片缩略图
alt可选同 title字符串缩略图替代文本
source可选无单个网址、{ url, site?, icon? } 或数组跟在 description 后的来源胶囊；多个来源自动折叠为首域名加 +N（如 gutenberg.org +1）。icon 默认优先使用构建期下载到的站点 Favicon，其次取可注册域名主体的首字母大写（如 en.wikipedia.org 取 W，bbc.co.uk 取 B）
site可选url 去掉 www. 后的域名字符串来源站点显示名称
takeaway可选无字符串卡片底部带顶部分隔线的启发或结论（如 "**可借鉴：** ……"）
cards多卡模式必填无对象数组多张横向资源行卡，每项支持 url、title、description（或 text）、image、alt、meta、source、takeaway

4限制与报错

  • 除通用的 garden-yaml 外，本组件没有专属报错代码；表里写「不做校验」的建议值不会报错。
目录