Skip to content

v0.1.6

Choose a tag to compare

@github-actions github-actions released this 30 Aug 11:10
· 19 commits to main since this release
v0.1.6
0907d3b

English

Added

  • Multilingual (i18n) Support: Automatically detect single-language and multi-language specification folders (docs/<lang>/main.typ like docs/zh-CN/, docs/en/).
  • Interactive Language Switcher: Added top toolbar 🌐 Language Switcher dropdown with smooth in-page navigation between index_<lang>.html pages.
  • CLI Commands Reorganized:
    • cargo fy-docs (and cargo fy-docs build): Idempotent, non-blocking full build for HTML and PDF 2.0 (CI-safe).
    • cargo fy-docs html: Compile offline HTML documentation only.
    • cargo fy-docs dev: Interactive development server with live reload and browser auto-opening.
    • Added --lang <LANG> parameter to target specific language documentation.
  • Multilingual Dogfood Specifications: Full bilingual specification books (English and Simplified Chinese) with interactive architecture DAG diagrams (powered by Fletcher).
  • CI Chinese Fonts: Added Google Noto CJK fonts installation in GitHub Actions workflows to guarantee zero .notdef box artifacts on headless Linux runners.

Changed

  • Template Decoupling: Fully decoupled fy-spec template fonts with safe fallback across Linux, macOS, and Windows. Fonts can be overridden via fonts parameter.
  • Dynamic Cover Metadata: Generic title, lang, region defaults without hardcoded ecosystem assumptions; author, subtitle, and methodology render dynamically only when provided.

Removed

  • Removed redundant fy-docs/fy-spec root directory, embedding directly from docs/fy-spec/lib.typ.

简体中文

新增

  • 多语言(i18n)原生支持:自动探测单语言与多语言规格目录(docs/<lang>/main.typdocs/zh-CN/docs/en/ 等),分别生成 index_<lang>.html 与对应语言的规格书 PDF。
  • 顶栏交互式语言切换下拉框:在多语言文档顶栏右侧新增 🌐 语言切换下拉菜单,点击可在多语言页面间同级顺畅跳转;单语言项目自动隐藏。
  • CLI 命令体系正交重构
    • cargo fy-docs(及 cargo fy-docs build):安全全量构建(HTML + PDF 2.0),执行完毕后以退出码 0 退出,彻底消除 CI 挂起风险。
    • cargo fy-docs html:仅构建离线 HTML 网页包。
    • cargo fy-docs dev:交互开发工作台,启动本地 Web 服务,自动打开浏览器并监听源码热重载。
    • 新增 --lang <LANG> 参数以定向编译指定语言文档。
  • 双语 Dogfood 规格说明书:为 fy-docs 自身建立完整的中英双语规格说明书,并使用 Fletcher 绘制 5 大核心模块交互式架构 DAG 图(支持在网页端点击节点直接跳转)。
  • CI 中文字体保障:在 GitHub Actions 流水线中预装 Google Noto 思源中文字体包,彻底根除 Linux 无头 Runner 上编译中文 PDF 出现 .notdef 豆腐块方格的缺陷。

变更

  • 模板字体与语言解耦:彻底解耦 fy-spec 模板字体,内置覆盖 Linux、macOS 与 Windows 的全平台安全回退栈,并支持调用方通过 fonts 参数自由覆盖。
  • 封面元数据动态渲染:去除强加的生态私货与写死默认值;authorsubtitlemethodology 等字段仅在调用方显式传入时才动态渲染。

移除

  • 彻底移除根目录下冗余的 fy-docs/fy-spec 目录,统一直接从 docs/fy-spec/lib.typ 进行编译期内嵌。