Release v0.1.7 · fengyangsi/fy-docs

English

vendor Subcommand: cargo fy-docs vendor (re)writes the embedded fy-spec template into docs/fy-spec/lib.typ; vendor --check verifies without writing and exits non-zero on drift, so CI can pin the template version. Requires no typst binary.
SSE Live Reload: the dev server pushes build ids over a /events Server-Sent-Events stream, replacing the 1.5-second polling loop. The single live.js client ships with static builds too and stays silent when no server answers.
Typst Precheck: every compiling command verifies up front that typst exists and is at least 0.14, failing with an actionable message instead of a raw flag error.
Windows CI Job and a typst pinned to 0.15.1 in CI, so "tested against Typst 0.15" is enforced rather than implied.
Real-Binary Integration Tests: fresh build, broken-source exit code, and vendor drift checks run against the actual executable, skipping gracefully where typst is absent.
fy-spec Single Source of Truth: the template's typst.toml and examples/basic.typ moved into this repository's docs/fy-spec/; the HTML class contract between lib.typ and base.css is documented as a dogfood spec chapter.

Exit Codes: build and html now exit non-zero when compilation fails (previously exit 0 after writing an error page), so CI pipelines catch broken documents. The dev server still survives failures and renders error pages.
Dev-mode rebuilds inherit the startup --lang / --with-pdf options instead of silently rebuilding every language after the first save.
Compile failures write error pages per language (index_<lang>.html); successfully built targets keep their fresh pages and the multi-language landing page is never overwritten by error output.
Output files are written atomically (sibling temp file + rename), so a dev-server reload can never serve a half-written page.
The watcher excludes docs/target/ and docs/release/ by path, not only by file extension.
UI language derives from the document's language target instead of scanning for CJK characters (Japanese documents no longer get Chinese controls).
Minimum Typst raised from 0.13 to 0.14: the --pdf-standard 2.0 flag fy-docs passes first shipped there.
README corrected: PDF filenames include the language suffix, the options table lists --with-pdf/--no-open, and the version floor is stated accurately.

Redirect landing page values are escaped for JavaScript string contexts (backslash, control characters) and the default target is escaped in both its script and <noscript> forms; an unusual language directory can no longer produce invalid JavaScript.
Compile-thread panics degrade to per-language error pages with a log line instead of aborting the whole process.
_temp_*.html intermediates are removed on every path, including extraction failures.
<body> extraction tolerates attributes on the opening tag, so a typst export format drift cannot break page assembly.
Cargo.toml parsing is unified: init now resolves workspace = true inherited versions like build does, and the two duplicate .gitignore helpers collapsed into one.

Retired the standalone fy-spec repository; every project vendors its template copy via cargo fy-docs vendor, and this repository is the template's only home.

vendor 子命令：cargo fy-docs vendor 将内嵌的 fy-spec 模板（重）写入 docs/fy-spec/lib.typ；vendor --check 只读校验、漂移即非零退出，供 CI 锁定模板版本。该命令无需 typst。
SSE 热重载：dev 服务器通过 /events（Server-Sent Events）流推送构建编号，取代 1.5 秒轮询；单轨 live.js 客户端随静态构建一同分发，无服务器应答时静默关闭。
typst 预检：所有编译类命令启动即校验 typst 存在且不低于 0.14，以可操作的信息报错，而非裸露的参数错误。
Windows CI 测试任务，并在 CI 中将 typst 锁定到 0.15.1，让「基于 Typst 0.15 测试」成为强制事实而非口头声明。
真实二进制集成测试：全新构建、损坏源码退出码、vendor 漂移校验均对真实可执行文件运行；无 typst 环境自动跳过。
fy-spec 唯一真身：模板的 typst.toml 与 examples/basic.typ 迁入本仓库 docs/fy-spec/；lib.typ 与 base.css 之间的 HTML 类名契约以自食文档章节固化。

退出码：build 与 html 在编译失败时以非零退出码结束（此前写完错误页后仍退出 0），CI 流水线得以拦截损坏文档；dev 服务器依旧存活并将失败渲染为错误页。
dev 模式重建继承启动时的 --lang / --with-pdf 选项，不再在首次保存后悄悄全量重建。
编译失败按语言写入错误页（index_<lang>.html）；成功的语言保留最新产物，多语言分流页绝不被错误输出覆盖。
产物原子写入（同目录临时文件 + rename），dev 服务器重载期间不可能读到半截页面。
watcher 按路径排除 docs/target/ 与 docs/release/，不再仅依赖扩展名过滤。
UI 语言改由文档语言目标推导，弃用 CJK 字符嗅探（日文文档不再误判为中文）。
最低 Typst 版本由 0.13 提升至 0.14：fy-docs 传入的 --pdf-standard 2.0 自该版本起才受支持。
修正 README：PDF 文件名补语言后缀、参数表补全 --with-pdf/--no-open、版本下限如实标注。

重定向分流页的取值按 JavaScript 字符串上下文转义（反斜杠、控制字符），默认跳转目标在脚本与 <noscript> 两处均过转义；异常语言目录不再可能产出非法 JS。
编译线程 panic 降级为该语言的错误页与一行日志，不再中止整个进程。
_temp_*.html 中间文件在所有路径（含提取失败）下均被删除。
<body> 提取容忍开始标签带属性，typst 导出格式演进不再破坏页面拼装。
Cargo.toml 解析统一：init 现与 build 一样解析 workspace = true 继承版本；两处重复的 .gitignore helper 合一。