https://kea-doc.readthedocs.io/en/latest/
1.Set up
git clone [email protected]:XYIheng/kea_doc.git
cd kea_doc/docs
pip install -r requirements.txt
(optional) 2.Use vscode RST previewer
Add the following extension to vscode:
reStructuredText Syntax highlighting
Install Esbonio server
pip install esbonio
reboot vscode to apply the changes.
3. Build html
cd kea_doc/docs
# You should delete the build dir every time you modify the file structure of the project
# Or the cache will affect the previewer of the esbonio extension.
rm -r build
make html
This GitHub template includes fictional Python library with some basic Sphinx docs.
Read the tutorial here: