求助:GitHub Pages部署Quarto书籍遇404,如何配置多站点?
解决方案
核心问题说明
免费GitHub账户支持同时运行1个用户站点和多个项目站点,你的问题出在项目站点的访问路径配置错误,以及Quarto的base-url未正确设置。
步骤1:修正书籍仓库的GitHub Pages配置
- 打开
industrial-stats仓库的设置页面,找到「GitHub Pages」板块。 - 确认部署源选择的是
master分支的/docs文件夹(和你博客的配置一致),保存设置。 - 项目站点的正确访问路径是:
https://juanriera.github.io/industrial-stats/—— 必须带上仓库名,这是GitHub项目站点的规则,你之前可能直接尝试访问根路径导致404。
步骤2:配置Quarto的base-url避免资源路径错误
在书籍仓库的_quarto.yml文件中添加以下配置:
website: base-url: /industrial-stats/
这个配置会让Quarto生成的所有静态资源链接都带上/industrial-stats/前缀,确保页面加载时能正确找到CSS、JS等文件,避免404。
步骤3:更新博客导航栏链接
在博客仓库的_quarto.yml的导航配置中,添加「Libro」菜单:
website: navbar: left: - text: "Libro" href: "https://juanriera.github.io/industrial-stats/"
根据你现有导航结构调整位置,确保链接指向正确的项目站点地址。
步骤4:重新部署验证
- 重新渲染书籍项目,将生成的文件推送到
industrial-stats仓库的master分支。 - 等待GitHub Pages完成部署(通常需要1-5分钟),访问
https://juanriera.github.io/industrial-stats/确认页面正常加载。 - 打开博客站点,测试导航栏的「Libro」链接是否能正确跳转。
补充说明
你关闭博客站点后书籍能正常运行,是因为此时没有用户站点占据根域名,GitHub会临时将书籍的项目站点解析到根路径,但这不是正确的长期方案。按照上述步骤配置后,两个站点可以同时正常运行。
内容的提问来源于stack exchange,提问作者Juan Riera
相关产品推荐
相关产品推荐

