run_sphinx

documenteer.sphinxrunner.run_sphinx(root_dir, job_count=1, warnings_as_errors=False)

Run the Sphinx build process.

Parameters

  • root_dir (Union[str, Path]) – Root directory of the Sphinx project and content source. This directory contains both the root index.rst file and the conf.py configuration file.

  • job_count (int, default: 1) – Number of cores to run the Sphinx build with (-j flag)

Returns

Sphinx status code. 0 is expected. Greater than 0 indicates an error.

Return type

status

Notes

This function implements similar internals to Sphinx’s own sphinx-build command. Most configurations are hard-coded to defaults appropriate for building stack documentation, but flexibility can be added later as needs are identified.

Parameters

warnings_as_errors (bool, default: False) –