如何让JupyterLab标签页正常加载Sphinx生成的HTML的CSS、JS及图片？

1. 改Sphinx配置用相对路径（最推荐） #

• 打开Sphinx项目里的conf.py，把html_baseurl设为空字符串，同时确认html_static_path指向正确的静态文件目录：

  html_baseurl = ''
  html_static_path = ['_static']  # 保持默认配置即可，确保静态文件在这个目录下
  

• 重新生成HTML：Linux/macOS执行make html，Windows执行.\make.bat html。这样生成的所有CSS、JS、图片引用都会用相对路径，JupyterLab打开时就能正确找到资源。

2. 用JupyterLab的正确预览方式 #

• 别直接在文本编辑器里打开HTML文件，右键点index.html，选**"Open in New Tab"**（新标签页打开），JupyterLab会通过内置文件服务加载，相对路径的资源就能正常渲染。

3. 调整JupyterLab文件服务设置 #

• 如果前面的方法没用，检查JupyterLab的启动配置：要是用root用户运行，加--allow-root参数；如果服务器有反向代理，确保静态资源的路径被正确转发，默认配置一般不用改，但可以排查下权限问题。

4. 把Sphinx文档打包成单HTML文件 #

• 用Sphinx的singlehtml格式生成文档，把所有资源内嵌到一个HTML文件里，彻底解决路径问题：

  make singlehtml
  

  生成的_build/singlehtml/index.html在JupyterLab里打开，所有CSS、JS、图片都能直接加载。

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