run_sphinx

documenteer.sphinxrunner.run_sphinx(root_dir)

Run the Sphinx build process.

Parameters:
root_dir : str

Root directory of the Sphinx project and content source. This directory conatains both the root index.rst file and the conf.py configuration file.

Returns:
status : int

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

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.