Source files for the Truphone Connect API reference documentation, hosted in this repository: https://truphone.github.io/connect-api-docs
Assuming you already have a functional python development environment:
pip install sphinx
pip install sphinx_rtd_theme
pip install recommonmark
pip install sphinx-markdown-tables
Sphinx is now ready to build the documentation
Documents are written in the standard markdown format, stored under the source/
directories and built using the Read The Docs template for the Sphinx python documentation generator.
make html
Generated documentation will be stored under build/docs/html/index.html
make github
Same as make html but also copies the files to the docs/
folder for github to serve them