docfx - 如何更改 DocFX 中的页脚？

Question

只希望更改DocFX生成的页脚版权信息。



这是我所做的:

导出模板:

运行 docfx template export default ，获取文件夹 _exported_templates\default

更改页 footer 分:

我改过的文件是 .\partials_footer.liquid 和 .\partials\footer.tmpl.partial

使用更新后的模板:

运行 docfx -t _exported_templates\default .

再次为网站服务

运行 docfx docfx.json --serve .

但是当我刷新文档页面时没有显示更新。还有什么我错过的吗？

Answer 1

尝试将步骤 3、4 合并到:docfx -t _exported_templates\default --serve .

说明:如果您在 _site 中打开构建输出在第 3 步之后，您应该会发现页脚实际上已更新。在第 4 步中，DocFX 在提供服务之前再次构建站点，因此最终您会找到原始页脚，因为此构建不使用您的自定义模板。

另一个快速解决方案是添加 _appFooter到 docfx.json 中的全局元数据喜欢:

"globalMetadata": {
  "_appFooter": "<span>Customized Footer</span>"
},

完整的保留元数据列表可以在这里找到: http://dotnet.github.io/docfx/tutorial/docfx.exe_user_manual.html#322-reserved-metadata