Skip to content

Read The Docs

Read the docs is the best free and open source solution to host documentation. It autoupdates when you push git changes.

Get Started

 1. Create a github account - Sign in . 
 2. Got to  > https://github.com/readthedocs/tutorial-template/ > Click Use this template
 3. Associate Read the Docs account to Github
 4. Import github repository / Build
 5. Main Page - index.rst
 5. Automate build updates.

Example in a Project

 If you are new to Read the Docs, you may want to refer to the Read the Docs User documentation.
 If you are copying this code in order to get started with your documentation, you need to:

 1. place your docs/ folder alongside your Python project. If you are starting a new project, you can adapt the pyproject.toml example configuration.
 2. use your existing project repository or create a new repository on Github, GitLab, Bitbucket or another host supported by Read the Docs
 3. copy .readthedocs.yaml and the docs/ folder into your project.
 4. customize all the files, replacing example contents.
 5. add your own Python project, replacing the pyproject.toml configuration and lumache.py module
 6. rebuild the documenation locally to see that it works.
 7. finally, register your project on Read the Docs, see Importing Your Documentation.

Optional

 MKDocs Alternative:
 https://github.com/readthedocs-examples/example-mkdocs-basic
 https://gristlabs.github.io/mkdocs-windmill/#customization/
 https://squidfunk.github.io/mkdocs-material/reference/images/#image-alignment

 SPHINX Customization:
 https://docs.readthedocs.io/en/latest/guides/adding-custom-css.html
 https://stackoverflow.com/questions/59821489/dont-display-read-the-docs-sphinx-toc-in-narrow-windows
 https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html

References

 https://readthedocs.org/
 https://docs.readthedocs.io/en/stable/tutorial/
 https://github.com/readthedocs/tutorial-template/
 https://docs.readthedocs.io/en/stable/tutorial/
 https://github.com/readthedocs-examples/example-sphinx-basic
 https://www.tutorialspoint.com/online_markdown_editor.php
 https://github.com/readthedocs/sphinx_rtd_theme/issues/295