问为什么在使用docfx.json中指定的自定义模板构建时，docfx不应用我的自定义模板文件？
EN

Stack Overflow用户

提问于 2018-11-15 18:33:37

回答 1查看 457关注 0票数 1

docfx文档站点展示了如何自定义默认模板中使用的各种.partial文件(参见walkthrough.html)。

我遵循了这些说明，创建了一个新的模板文件夹，并在其中放置了一个修改过的styles\main.css文件，并在下执行了步骤--应用模板部分，其中除了默认值之外还指定了自定义模板名：

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

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

发布于 2018-11-15 18:37:42

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

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

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

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

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

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

票数 0

页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持

原文链接：

https://stackoverflow.com/questions/53325868

复制

相似问题

问为什么在使用docfx.json中指定的自定义模板构建时，docfx不应用我的自定义模板文件？EN