Почему DocFX обслуживает контент через внутренний сервер?

Question

Я только начал изучать DocFX. Согласно его официальному руководству, мы создаем контент с помощью команды, аналогичной docfx docfx.json --serve, а затем просматриваем созданный сайт из http://localhost:8080. Мой вопрос: если DocFX является генератором сайта stati c, почему он обслуживает контент через веб-сервер? Почему он не просто говорит клик по индексу. html для просмотра сгенерированного сайта ? Есть ли разница?

Answer 1

DocFX действительно генерирует содержимое c, однако основной индекс. Страница html попытается загрузить некоторые ресурсы, такие как оглавление (в c. html), используя XMLHttpRequest из браузера. Такие запросы будут заблокированы браузером, если вы загрузили сайт, открыв страницу индекса. html с диска.

Если вы попытаетесь, запустите инструменты разработчика F12 в Chrome (или браузере вашего выбор), и вы увидите предупреждения, такие как:

Доступ к XMLHttpRequest в 'file: ///your-path/_site/toc.html' из источника 'null' имеет был заблокирован политикой CORS: запросы на разные источники поддерживаются только для схем протоколов: http, data, chrome -extension, edge, https.

В результате сайт действительно должен быть загружен с веб-сервера по HTTP, чтобы получить лучший результат