ReadTheDocs and Sphinx¶
The powerful and popular Read The Docs service lets you configure your GitHub repository so that every time you push a new version of your software, the documentation gets automatically rebuilt and made available at:
https://readthedocs.org/projects/<project-name>/
Last but not least, once you’ve written your documentation you have to put it somewhere for the world to see! Read the Docs makes this quite simple, and is free for all open source projects.
- Register for an account at https://readthedocs.org
- Click the Import Project button
- Add the URL for a specific repository you want to build docs for
- Sit back and have a drink while Read the Docs does the rest.
It will:
- Pull down your code
- Install your
requirements.txt
- Build HTML, PDF, and ePub of your docs
- Serve it up online at
http://<projectname>.readthedocs.org
Note
View the project page for this tutorial on ReadTheDocs
Read the Docs Features¶
Read the Docs gives you a number of additional features.
- You can add Versions to your project for each tag & branch.
- You can alerts for when your doc build fails
- You can search across the full set of docs
Note
View this tutorial on ReadTheDocs