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

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

0 голосов
/ 15 ноября 2018

На сайте документации docfx показано, как настроить различные .partial файлы, используемые в шаблоне по умолчанию (см. https://dotnet.github.io/docfx/tutorial/walkthrough/advanced_walkthrough.html).

. Я следовал этим инструкциям, создавая новую папку шаблонов и добавляя измененные стили \Файл main.css, а также предпринял шаги в разделе Применить шаблон , где указывается пользовательское имя шаблона в дополнение к значению по умолчанию: 

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

Однако, когда япостройте сайт, файл _site / styles / main.css не содержит моих изменений.

1 Ответ

0 голосов
/ 15 ноября 2018

Я использую 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"
],
...