Почему мои пользовательские файлы шаблонов не применяются docfx при сборке с пользовательским шаблоном, указанным в docfx.json?

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 не содержит моих изменений.

Answer 1

Я использую docfx в Windows 10 с docfx, расположенным в C:\docfx, и я экспортировал шаблон по умолчанию и создал свой собственный шаблон в том же каталоге.

Проект, который я создаю, находится в другом месте, в C:\source...\ Документация

Я запускаю сборку docfx после перехода к C:\source...\ Документация и обнаружил, что для того, чтобы мой настроенный шаблон работал, мне пришлось включить полный путь к папкам шаблонов в docfx.json, так как в

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

ОБНОВЛЕНИЕ: Как указывает @hcdocs, если папка пользовательских шаблонов перемещается в C:\source...\ документацию, а не в C:\docfx, нет необходимости использовать полные пути. Этот конфиг работал нормально после этого:

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