run_sphinx

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

Run the Sphinx build process.

Parameters

root_dir

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

Number of cores to run the Sphinx build with (-j flag)

Returns

status

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.

Return type

int