快速指南 — Zest SSG

my-site/
  _config.toml         # 站点配置
  _init.zest.fsx        # 初始化脚本（可选）
  _data/                # 全局数据
  _layouts/             # HTML 布局
  _includes/            # 可复用片段
  content/              # 页面内容
  assets/               # 资源文件
  _site/                # 构建输出（自动）

函数	说明
`h1, h2, h3, h4, h5, h6`	标题元素
`p, a, span, div`	文本元素
`divC, pC, spanC, aC, sectionC`	带类名快捷构造
`ul, ol, li`	列表
`img`	图片
`table, thead, tbody, tr, th, td`	表格
`text, html, raw`	文本/HTML/原始输出
`render`	将 HTML 片段列表输出到页面
`codeBlock`	代码块
`include_partial`	引入局部模板

元数据	说明
`@title`	页面标题
`@layout`	使用的布局
`@permalink`	URL 路径（默认 /:slug/）
`@tags`	标签
`@date`	发布日期
`@description`	描述

site_pages() — 所有页面
recent_pages(n) — 最新 N 篇
pages_by_tag(tag) — 按标签过滤
pages_by_dir(dir) — 按目录过滤
pages_by_collection(col) — 按集合过滤
all_tags() — 所有标签
tag_cloud(min) — 标签云
all_collections() — 所有集合
search_pages(q) — 按标题搜索
sort_pages_by(key, order) — 排序
group_pages_by_year() — 按年分组
site_data(key) — 读取全局数据（_data/ 或 _config.toml）

过滤器	用法	说明
pages_by_tag	`pages \| pages_by_tag("tag")`	按标签筛选
recent	`pages \| recent(5)`	最近 N 篇
by_collection	`pages \| by_collection("col")`	按集合筛选
search	`pages \| search("query")`	搜索
where	`pages \| where("key", "val")`	属性筛选

变量绑定：let primary = #6c63ff
管道运算符：color = base |> lighten(20%)
颜色函数：lighten、darken、alpha、mix、complement
混入：@mixin / @include
响应式简写：@sm、@md、@lg、@xl
@apply：复用工具类
三种语法：SCSS 风格 / 缩进风格 / F# 风格 — 可混用

注意：@use 仅支持内置模块（zest:reset、zest:utilities 等）和本地文件路径，不支持 CDN 外部链接。如需引用外部样式，请在 HTML 布局中使用 <link> 标签，或在 ZCSS 中使用原生 CSS @import url(...)。