SingulinkFX — HTML 文档模板

SingulinkFX 是 Singulink 团队为自家 .NET 项目维护的 DocFX 模板，目标很明确：让生成的 API 文档看起来像微软官方 .NET 文档。它完全响应式，默认配色和排版都贴近 docs.microsoft.com 的风格，适合希望文档观感专业、统一的 .NET 库作者。

模板的核心能力围绕 DocFX 的 API 文档场景展开。它支持四级目录，配合 DocFX 的 separatePages 成员布局，可以把每个方法、属性拆成独立页面，便于链接和导航。表格会自动隐藏空列，避免未写注释的方法留下空白描述列。v3.1 起加入浅色/深色主题切换，颜色、侧栏宽度、字体大小都可在 CSS 变量中调整，也内置了 Bootstrap Icons。文章页面有独立的样式覆盖，用 article 类包裹即可获得更适合阅读的排版。

使用门槛取决于你对 DocFX 的熟悉程度。如果你已经在用 DocFX，这个模板接入成本很低：下载模板、复制到 templates 目录、在 docfx.json 里加上模板名即可。若从零开始，建议参考 Singulink.IO.FileSystem 仓库里的 Docs 目录结构。注意模板版本与 DocFX 版本有对应关系，3.x 需要 DocFX v2.75+，旧版 DocFX 需用 v1.1。上线前请确认你的 DocFX 版本匹配，并检查自定义配置项是否生效。