如何在DocFX中更改页脚？

Question

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

​

​

以下是我所做的：

1. 出口模板：

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

1. 更改页脚部分：

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

1. 使用更新的模板：

运行docfx -t _exported_templates\default。

1. 再次送达网站

运行docfx docfx.json --serve。

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

Answer 1

尝试将步骤3、4合并为：docfx -t _exported_templates\default --serve。

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

另一个快速解决方案是将_appFooter添加到docfx.json中的全局元数据，如下所示：

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

可以在这里找到完整的保留元数据列表：manual.html#322-reserved-metadata

Answer 2

最简单的方法是直接改变模型。在模板中，创建一个名为conceptual.extension.js的文件，并使用以下代码：

exports.postTransform = function (model) {
    model._appFooter = "<span>Copyright © 2015-2017 MY COPYRIGHT<br>Generated by <strong>DocFX</strong></span>";
    return model;
}