sphinx icon indicating copy to clipboard operation
sphinx copied to clipboard

ENH: Make sourcedir and outputdir parameters in sphinx-build optional

Open timhoffm opened this issue 2 weeks ago • 0 comments

This allows to simply run sphinx-build in your doc directory, instead of having to type sphinx-build . _build.

The default output folder name "_build" is a bit opinionated, but it's what sphinx-quickstart uses. It creates that folder and adds it to exclude_patterns in conf.py already. I believe, we can therefore afford to go with this default. One may later add an output_dir config variable to conf.py and use that instead of a hard-coded default.

timhoffm avatar Jul 02 '24 14:07 timhoffm