docfx - 为什么在使用docfx.json 中指定的自定义模板进行构建时，docfx 没有应用我的自定义模板文件？

Question

docfx 文档站点显示了如何自定义默认模板中使用的各种 .partial 文件（请参阅https://dotnet.github.io/docfx/tutorial/walkthrough/advanced_walkthrough.html）。

我已经按照这些说明创建了一个新的模板文件夹并将修改后的 styles\main.css 文件放入其中，并且还采取了应用模板部分下的步骤，其中除了默认值之外还指定了自定义模板名称：

"template": [
  "default",
  "templates/<name of your your HTML template folder>"
],

但是，当我构建站点时，_site/styles/main.css 文件没有我的更改。

score 0 · Accepted Answer

我在 Windows 10 上使用 docfx，docfx 位于 C:\docfx，我导出了默认模板并在同一目录中创建了我的自定义模板。

我正在构建的项目位于 C:\source...\documentation 的其他地方

在导航到 C:\source...\documentation 后，我正在运行 docfx 构建，我发现为了让我的自定义模板工作，我必须在 docfx.json 中包含模板文件夹的完整路径，如在

"template": [
  "C:/docfx/_exported_templates/default",
  "C:/docfx/templates/MyCustomTemplate"
],

更新： 正如@hcdocs 所指出的，如果将自定义“模板”文件夹移动到 C:\source...\documentation 而不是 C:\docfx，则无需使用完整路径。执行此操作后，此配置运行良好：

"template": [
  "default",
  "templates/MyCustomTemplate"
],

1 回答 1