mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-26 10:21:53 +00:00
25 lines
862 B
Markdown
25 lines
862 B
Markdown
# Start9 Labs Documentation
|
|
|
|
## Environment Setup
|
|
|
|
Install [python3](https://docs.python-guide.org/starting/install3/osx/)
|
|
|
|
Install sphinx: `brew install sphinx-doc`
|
|
|
|
Python dependencies:
|
|
```
|
|
pip3 install sphinx-autobuild
|
|
pip3 install sphinx-book-theme
|
|
```
|
|
|
|
## To Develop
|
|
|
|
This project uses [Sphinx](https://www.sphinx-doc.org/en/master/usage/installation.html) and [Restructured Text](https://thomas-cokelaer.info/tutorials/sphinx/rest_syntax.html)
|
|
|
|
`./source/conf.py` is the configuration source for the Sphinx project.
|
|
|
|
The navigation structure is aligned with the folder/file organization under `./source/`. This is where the individual page `.rst` files live and can be edited.
|
|
|
|
If any css or table of contents organization changes, run: `make clean html`
|
|
|
|
To activate a live-reload environment on `localhost:8000`, run: `sphinx-autobuild source build/html` |