.zest.fsx 模板语言

.zest.fsx 是 Zest 的原生模板格式——F# 脚本 + Markdown + HTML DSL 三合一。

元数据（Frontmatter）

注释风格（推荐）

YAML 风格

title: 关于我们
layout: default

内容编写

内容部分使用标准 Markdown：

# 一级标题

**粗体** *斜体* ~~删除线~~ `行内代码`

- 无序列表
- 另一项

1. 有序列表
2. 第二项

[链接文字](/url/)
![图片说明](/image.png)

> 引用文本

| 表头 | 表头 |
|------|------|
| 单元格 | 单元格 |

HTML DSL（计算表达式）

高级页面使用 F# 计算表达式：

page {
  title "关于 Zest"
  layout "default"
  tags ["fsharp"; "dsl"]
  content [
    h1 [ text "关于 Zest" ]
    p  [ text "Zest 是静态站点生成器。" ]
    ul [
      li [ aHref "/guide/" "指南" ]
      li [ aHref "/zss/"   "ZSS" ]
    ]
  ]
}

可用 HTML 元素

函数	标签	函数	标签
`div[...]`	`<div>`	`p[...]`	`<p>`
`h1`..`h6`	标题	`span[...]`	`<span>`
`ul/ol[...]`	列表	`li[...]`	`<li>`
`a href ch`	链接	`aHref url text`	链接快捷
`img src alt`	图片	`codeBlock lang code`	代码块
`section[...]`	`<section>`	`article[...]`	`<article>`
`nav[...]`	`<nav>`	`header/footer`	页眉/页脚
`table/tr/td`	表格	`form[...]`	`<form>`

元素修饰器

p [text "你好"] |> withClass "greeting"
div [] |> withId "main" |> withStyle "color:red"

CSS 类快捷

divC    "card"  [...]     // <div class="card">
spanC   "badge" [...]     // <span class="badge">
pC      "lead"  [...]     // <p class="lead">
sectionC "hero" [...]     // <section class="hero">

条件与列表

showIf (user.IsLoggedIn) (p [text "欢迎！"])
hideIf (page.Tags.IsEmpty) (div [text "无标签"])
each items (fun item -> li [text item])

11ty 风格短代码

Collections API

脚本中可直接调用（无需额外 open）：

let all   = site_pages ()          // 全部页面
let posts = pages_by_dir "posts"   // 按目录过滤
let tagged = pages_by_tag "fsharp" // 按标签过滤
let recent = recent_pages 5        // 最新 N 篇（按 date 降序）

let author = site_data "site.author"

let nav = include_partial "nav.html"

列表页示例

render [
    h1 [Text "所有文章"]
    divC "post-grid" [
        for p in pages_by_dir "posts" |> List.sortByDescending (fun p -> p.Date) ->
            divC "card" [
                h2 [a p.Url [Text p.Title]]
                pC "date" [Text (p.Date |> Option.map string |> Option.defaultValue "")]
            ]
    ]
]

集合

按标签或 URL 分组页面：

let posts = Collections.groupByTags allPages      // 按标签
let byDir = Collections.groupByCollection allPages // 按目录
Collections.renderPageList posts                   // 渲染 <ul>

TOML 数据

_data/*.toml 中的全局数据通过以下方式访问：

site_data "site.author"       // 脚本内直接用
TemplateData.siteSection globalData "site.social"  // 底层 API

分页

let pages = Pagination.paginate items 10 (fun n -> sprintf "/page/%d/" n)
for p in pages do
  Pagination.renderPagination p

ZSS 集成

模板中直接使用 ZSS：

styleBlock "$primary: #333; body { c: $primary; }"  // 内联 <style>
stylesheet "/assets/css/style.zss"                    // 外部 .zss