В меню docfx отсутствуют статьи, документация по API при размещении из файловой системы, но отображается на локальном хосте: 8080

Когда я запускаю docfx docfx.json --serve и перехожу к localhost:8080, я вижу два пункта в верхнем меню: «Статьи» и «Документация по API». Когда я перехожу в файловой системе к _site\ и нажимаю index.html, чтобы открыть его в Chrome, эти пункты меню отсутствуют. Как я могу убедиться, что меню настроено правильно, когда я запускаю его как статический сайт?

Мне нужно иметь возможность упаковывать html-файлы и отправлять их людям, чтобы они могли просматривать их локально, без необходимости загружать репо и устанавливать docFX.


asp.net-core docfx
person devlord    schedule 13.05.2019    source источник
comment
Помогает ли вам посмотреть _site\toc.html?   -  person hcdocs    schedule 14.05.2019
comment
Когда я это делаю, я вижу (неформатированный) ``` [Введите здесь для фильтрации] * Статьи * Документация по API ``` И на обеих этих страницах отсутствует какая-либо навигация.   -  person devlord    schedule 14.05.2019

Ответы (1)


arrow_upward
8
arrow_downward

Причина: странице нужны дополнительные JS-файлы для панели навигации, но они заблокированы Chrome. Вы можете увидеть эти ошибки в консоли Chrome (F12):

docfx.vendor.js:4 Access to XMLHttpRequest at 'file:///C:/git/docfx-seed/_site/toc.html' from origin 'null' has been blocked by CORS policy: Cross origin requests are only supported for protocol schemes: http, data, chrome, chrome-extension, https.
send @ docfx.vendor.js:4
docfx.vendor.js:4 Access to XMLHttpRequest at 'file:///C:/git/docfx-seed/_site/logo.svg' from origin 'null' has been blocked by CORS policy: Cross origin requests are only supported for protocol schemes: http, data, chrome, chrome-extension, https.

Решение. Используйте шаблон statictoc, в котором все необходимые части уже встроены в HTML-файл:

docfx docfx.json -t statictoc
person Yuby    schedule 14.05.2019
comment
Я уже начал думать, что DocFx не вариант... -t statictoc все сразу исправил. Благодарю вас! - person owns; 02.06.2020