当我运行docfx docfx.json --serve
并转到 时localhost:8080
,我在顶部菜单上看到两个项目:“文章”和“Api 文档”。当我在文件系统中导航到_site\
并单击index.html
以在 Chrome 中打开它时,这些菜单项丢失了。当我将其作为静态站点运行时,如何确保正确设置菜单?
我需要能够打包 html 文件并将它们发送给人们以便他们在本地查看,而无需他们下载 repo 并安装 docFX。
当我运行docfx docfx.json --serve
并转到 时localhost:8080
,我在顶部菜单上看到两个项目:“文章”和“Api 文档”。当我在文件系统中导航到_site\
并单击index.html
以在 Chrome 中打开它时,这些菜单项丢失了。当我将其作为静态站点运行时,如何确保正确设置菜单?
我需要能够打包 html 文件并将它们发送给人们以便他们在本地查看,而无需他们下载 repo 并安装 docFX。
原因:页面需要额外的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