Saul's Docs
If you'd like to develop on and build the docs book, you should:
pip install -r requirements.txt
(it is recommended you do this within a virtual environment)docs/_build/
directoryjupyter-book build docs/
A fully-rendered HTML version of the book will be built in docs/_build/html/
.
The html version of the book is hosted on the gh-pages
branch of this repo. A GitHub actions workflow has been created that automatically builds and pushes the book to this branch on a push or pull request to main.
If you wish to disable this automation, you may remove the GitHub actions workflow and build the book manually by:
ghp-import -n -p -f docs/_build/html
This will automatically push your build to the gh-pages
branch. More information on this hosting process can be found here.
We welcome and recognize all contributions. You can see a list of current contributors in the contributors tab.
This project is created using the excellent open source Jupyter Book project and the executablebooks/cookiecutter-jupyter-book template.