请合并参考项目中的 root/lib/site.typ root/lib/site.typ 。 inline-math inline-math 现在在上下文中求值，查询脚注标签并传给 SVG 渲染器，支持行内和块级公式回退：

#inline-math($a/b$)
#inline-math($sum_(i=1)^n i$, block: true)

#inline-math($a/b$)
#inline-math($sum_(i=1)^n i$, block: true)

已有调用不需要修改函数签名。Typsite 会自动向 Typst 传入 HTML 功能标志和 html-frames html-frames 输入参数。

Typsite 可执行程序的版本是 0.1.8，内置 Typst 包继续使用原来的标识：

#import "@local/typsite:0.1.0": *

#import "@local/typsite:0.1.0": *

不要把导入改为 @local/typsite:0.1.8 @local/typsite:0.1.8 。需要导出时，可执行程序会先安装随附的包。

初始化的演示站点包含本文、模板、字体和 SVG 示例，构建时不需要下载 preview 包。在参考项目目录中运行：

typsite compile
typsite compile --port 8080

typsite compile
typsite compile --port 8080

第二条命令启动预览，可访问 http://localhost:8080/ http://localhost:8080/ 或 /en/ /en/ 。内容示例中的外部音乐播放器和网页字体仍需要浏览器联网，但不是构建依赖。

typsite clean typsite clean 会在删除前检查两个目标目录、取得构建锁，并拒绝清理与源文件或配置重叠的路径。没有归属标记的非空旧目录，需要明确允许：

# 先检查这两个目录；clean 会清空它们的内容。
typsite clean --cache ./.cache --output ./publish --force

# 先检查这两个目录；clean 会清空它们的内容。
typsite clean --cache ./.cache --output ./publish --force

源文件或配置目录不是默认位置时，也要传入，以便保护这些目录：

typsite clean --input ./content --config ./config \
  --cache ./build-cache --output ./public --force

typsite clean --input ./content --config ./config \
  --cache ./build-cache --output ./public --force

--force --force 只允许清理没有标记的旧目录，不会绕过路径安全检查或正在使用的构建锁。清理后可能保留锁文件；构建或预览运行时，不要删除 .typsite.lock .typsite.lock 。

修改 .typsite/options.toml .typsite/options.toml 已有的 [site] [site] ，不要重复添加同名配置段。把示例地址换成站点部署后的公开地址：

[site]
base_url = "https://example.org"
title = "我的站点"
description = "笔记与文章"
rss_path = "/rss.xml"
rss_limit = 20
rss_content = "summary" # 可选 "summary" 或 "full"
sitemap_path = "/sitemap.xml"

[site]
base_url = "https://example.org"
title = "我的站点"
description = "笔记与文章"
rss_path = "/rss.xml"
rss_limit = 20
rss_content = "summary" # 可选 "summary" 或 "full"
sitemap_path = "/sitemap.xml"

保留 [default_metadata.options] [default_metadata.options] 下的 rss = false rss = false ，也可以省略。这是每篇文章的默认值，不是 [site] [site] 下的开关。请在具体集合页中显式开启，不要把所有文章的默认值都改为 true。

合并新版 root/lib/lib.typ root/lib/lib.typ 的 rss rss 导入，或像下面一样直接从内置包导入。例如创建 root/feed.typ root/feed.typ ，嵌入演示站点中已有的两篇文章：

#import "/lib/lib.typ": *
#import "@local/typsite:0.1.0": rss
#show: schema.with("page")
#title[订阅集合]
#rss(true)

= #embed("./typst.typ")
= #embed("./article.typ")

#import "/lib/lib.typ": *
#import "@local/typsite:0.1.0": rss
#show: schema.with("page")
#title[订阅集合]
#rss(true)

= #embed("./typst.typ")
= #embed("./article.typ")

这会选出 typst.typ typst.typ 和 article.typ article.typ ，不包含 feed.typ feed.typ 。自己的站点应替换为实际文章路径。只选择直接嵌入；嵌套嵌入、引用、父级关系和仅声明的 child 图关系不添加条目。多个集合的选择合并去重。标记页自身始终排除，即使被另一个集合嵌入也不例外；标记不会被子文章继承。 #rss(false) #rss(false) 只取消集合标记，不会排除被其他集合选中的文章。

typsite compile
typsite compile --port 8080

typsite compile
typsite compile --port 8080

第一条命令生成 publish/rss.xml publish/rss.xml ，使用自定义输出目录或路径时则写到相应位置。第二条命令可通过 http://localhost:8080/rss.xml http://localhost:8080/rss.xml 本地检查。读者应订阅部署后的公开地址，例如 https://example.org/rss.xml https://example.org/rss.xml ，而不是 localhost 预览地址。每个生成页面的 HTML head 中也会加入 RSS 自动发现链接。

演示站点的两个首页已有 #rss(true) #rss(true) 。填写 base_url base_url 后，它们直接嵌入的文章会组成四个条目：中英文文章指南和 Typst 简介。再加入上面的 feed.typ feed.typ 只会重复选中已有文章，不会生成重复条目。首页、迁移指南和内容示例不会自动进入 RSS；站点地图仍包含所有编译文章。

• rss_content = "summary" rss_content = "summary" 是默认模式：依次取非空的 description description 、 summary summary 、 abstract abstract 元数据。可在所选文章里写 #metacontent("summary")[简短介绍。] #metacontent("summary")[简短介绍。] ；缺少摘要不会排除文章。
• rss_content = "full" rss_content = "full" 还会输出组合后的文章 HTML，不含页面导航、侧边栏或引用与反向链接页脚。嵌入内容仍保留在所选文章内部。不同阅读器对 SVG、MathML 和站点专用 CSS 的支持不同。
• 没有生成 rss.xml rss.xml ：检查 base_url base_url 、 rss_path rss_path 是否非空，以及 rss_limit rss_limit 是否大于零。默认路径和上限仍是 /rss.xml /rss.xml 、20。非空但无效的站点 URL 会导致校验失败。
• 文件有了但没有条目：检查集合页是否写了 #rss(true) #rss(true) ，以及是否有实际的直接 #embed(...) #embed(...) 。只填写 [site].base_url [site].base_url 不够； rss = false rss = false 也不是条目排除开关。
• RSS 日期使用 RFC 2822，不使用 ISO 时间戳。纯日期和 YYYY-MM-DD HH:MM[:SS] YYYY-MM-DD HH:MM[:SS] 按 UTC 处理；RFC 3339/RFC 2822 的偏移会转换为 UTC。无效日期省略，标题和摘要提取为文本，不会直接显示 HTML 标签。

更多选项与文章元数据示例见 首页的 RSS 章节 。