如何修改配置调整GitHub Pages托管的Jupyter Book访问链接

你当前访问路径携带/_build/html前缀，本质是GitHub Pages的发布源目录层级不对，不需要修改Jupyter Book核心配置，按以下方式调整即可：

• 核心逻辑：GitHub Pages会把你指定的发布源（对应分支+指定文件夹）的根目录作为站点根目录，你现在的配置是把包含_build文件夹的项目上层目录设为了发布源，服务器自然会按照实际文件层级返回/_build/html/index.html路径的内容。
• 手动部署调整方式：本地执行jupyter book build .完成构建后，不要把整个项目仓库推送到Pages发布分支（通常是gh-pages分支，或main分支的docs目录），只需要进入本地生成的_build/html文件夹，把这个目录下的所有文件（包含index.html、静态资源文件夹、所有生成的页面文件）全部推送到发布源的根目录，确保index.html直接位于发布源的第一级目录下即可。
• 自动部署调整方式：如果使用GitHub Actions做自动部署，直接使用官方维护的Jupyter Book部署工作流配置，工作流默认会自动提取_build/html下的内容作为站点根目录发布，不会携带多余路径前缀。

注意：不建议通过修改Jupyter Book的输出目录配置把构建产物直接生成到项目根目录，会导致源文件和构建生成的静态文件混杂，大幅提升后续维护成本。

内容的提问来源于stack exchange，提问作者Phil