如何在pyproject.toml中配置Devpi指定Sphinx的source_dir路径？

你可以直接在pyproject.toml中通过tool.devpi配置段传递Sphinx构建参数，指定source目录路径，无需修改sys.path。具体配置如下：

[tool.devpi]
sphinx_opts = "-s docs/source"

如果需要同时指定文档输出目录（比如默认的docs/build），可以扩展参数：

[tool.devpi]
sphinx_opts = "-s docs/source -b html docs/build"

原理说明 #

devpi在构建包文档时会调用sphinx-build命令，sphinx_opts配置项允许直接传递命令行参数给sphinx-build。其中-s参数正是Sphinx用来指定源文件目录的选项，这样就能让Sphinx直接定位到docs/source下的conf.py和RST文件。这种配置方式是devpi官方支持的标准用法。

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