Jupyter-book页面在GitHub Pages无法正常加载,请求故障排查
排查Jupyter-book在GitHub Pages显示异常的步骤
检查资源引用路径
本地正常但线上显示异常,核心原因大概率是资源(CSS、JS、图片)的绝对路径不匹配GitHub Pages的子目录环境。Jupyter-book默认生成的资源路径是根目录(如/css/theme.css),但你的页面部署在/fourier_book/子目录下,导致浏览器无法找到这些依赖资源。
解决方式:在Jupyter-book的_config.yml配置文件中添加baseurl: "/fourier_book/",重新执行jupyter-book build .生成适配的静态文件,再将_build/html下的所有内容完整上传到仓库。确认部署文件完整性
检查仓库根目录下是否包含_static、css、js等所有_build/html内的子文件夹及文件,若遗漏依赖资源,页面必然显示错乱。查看GitHub Pages部署状态
进入仓库的Settings -> Pages页面,确认部署状态是否为"Success"。若存在部署错误,页面会给出具体提示(如文件权限、路径配置问题等)。用浏览器控制台定位具体问题
打开在线页面后按F12调出开发者工具,切换到Console标签,查看是否有404报错(找不到资源文件)。这类报错能直接指明哪类资源路径出了问题,方便针对性调整。
内容的提问来源于stack exchange,提问作者user308522
相关产品推荐
相关产品推荐

