Custom template not applied when specified in docfx.json

Custom template not applied when specified in docfx.json

Applying a custom template works when used a parameter from command line, but does not work when specified in docfx.json configuration file.

Functional impact

In automatic build have to specify command line parameters instead of using the configuration file

Minimal repro steps

See attached docfx project, we try to add the Application Insights JavaScript snipped to the head of the html.

DocFx.zip

OK

docfx -t default,templates\mytemplate

NOK

docfx docfx-custom-template.json

Expected result

The JavaScript snippet from templates\mytemplate\partials\head.tmpl.partial to be included in the html

Actual result

Custom template is not applied when setting the template in the docfx configuration file

Further technical details

the custom template is specified in the docfx-custom-template.json as follow, see attached docfx project:

  "build": {
  "template": [
        "default",
        "templates/mytemplate"
    ],
    "content": [
      {
        "files": [
          "api/**.yml",
          "api/index.md",
          "api-vb/**.yml"
        ]
      },
...

[txwizard]

One thing that the documentation doesn’t make clear is that the templates directory goes off the root of the project, rather than the DocFX application root directory.

[vicancy]

I noticed that in your docfx-custom-template.json it defined two template section, one as the first property for build section, one as the last property for build section. Remove one and have a retry.