无需Web服务器,本地加载docfx build输出站点的可行方案
解决docfx build输出本地打开的导航与图片路径问题
可以将docfx build的输出文件放在本地文件夹直接打开使用,你遇到的导航消失、图片路径异常问题,确实是因为基准URL配置不当导致的,按以下步骤修复:
- 编辑项目根目录的
docfx.json文件,找到build节点,添加"baseUrl": "./"配置,让所有资源引用使用相对路径:"build": { "baseUrl": "./", // 保留原有其他配置项 } - 执行
docfx build重新生成输出文件,此时导航脚本、图片等资源的引用路径都会改为相对路径,不再出现c:///这类绝对本地路径 - 打开输出文件夹中的
index.html,导航功能会恢复正常,图片也能正确加载
注意:如果项目中使用了自定义模板或手动添加的静态资源,要确保这些资源的引用路径也是相对路径,避免硬编码绝对路径导致加载异常。
内容的提问来源于stack exchange,提问作者user1048175
相关产品推荐
相关产品推荐

