You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

求助:GitHub Pages部署Quarto书籍遇404,如何配置多站点?

解决方案

核心问题说明

免费GitHub账户支持同时运行1个用户站点和多个项目站点,你的问题出在项目站点的访问路径配置错误,以及Quarto的base-url未正确设置。

步骤1:修正书籍仓库的GitHub Pages配置

  1. 打开industrial-stats仓库的设置页面,找到「GitHub Pages」板块。
  2. 确认部署源选择的是master分支的/docs文件夹(和你博客的配置一致),保存设置。
  3. 项目站点的正确访问路径是: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:重新部署验证

  1. 重新渲染书籍项目,将生成的文件推送到industrial-stats仓库的master分支。
  2. 等待GitHub Pages完成部署(通常需要1-5分钟),访问https://juanriera.github.io/industrial-stats/确认页面正常加载。
  3. 打开博客站点,测试导航栏的「Libro」链接是否能正确跳转。

补充说明

你关闭博客站点后书籍能正常运行,是因为此时没有用户站点占据根域名,GitHub会临时将书籍的项目站点解析到根路径,但这不是正确的长期方案。按照上述步骤配置后,两个站点可以同时正常运行。

内容的提问来源于stack exchange,提问作者Juan Riera

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.30 18:24:27