简体   繁体   中英

Configuring source dir for Sphinx documentation conf.py file

I got a package that i am about to upload to a local devpi server. I got some issues with the package not being able to find the conf.py file for Sphinx which makes sense as it looks at the (package_name)/docs folder instead of (package_name)/docs/source which i use and also has all the RST files in it. How do i in pyproject.toml configure Devpi to set sphinx source_dir to (package_name)/docs/source ?

It could surely be resolved in some way using sys.path.append() and then changing the path of the config but I do wonder about the configuration of this and if it is supported.

In devpi-client version 5.2.3 it should work.
Because the change: "Use sphinx-build command instead of setup.py build_sphinx when building documentation." in version 6.0.0 the upload routine doesn't "recognize" your local dir structure.
But I haven't find out yet how you can propagate arguments to the sphinx-build to specify the docs source dir.

The technical post webpages of this site follow the CC BY-SA 4.0 protocol. If you need to reprint, please indicate the site URL or the original address.Any question please contact:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM