mdbook-spec

mdbook-spec 是一个 mdBook 预处理器，为参考手册添加了若干功能。它提供：

• 语法图的解析和生成。
  • 语法产生式自动链接。
  • 语法摘要附录的生成。
• 标准库自动链接。
• 规则名称的处理。
  • 名称验证。
  • 将规则名称转换为链接。
  • 规则链接自动引用。
  • 规则测试链接的生成。
  • 测试摘要的生成。
• 对提示块的支持。

环境变量

mdbook-spec 使用的一些环境变量在 构建参考手册 中有详细说明：

• SPEC_RELATIVE — 可以设置以将外部书籍链接到在线站点。
• SPEC_DENY_WARNINGS — 是否应将警告视为错误。
• SPEC_RUST_ROOT — rust-lang/rust GitHub 仓库检出的路径。用于测试链接。