An ongoing collection of my notes.
pip install -U cookiecutter jupyter-book
-
cookiecutter git@github.com:executablebooks/cookiecutter-jupyter-book.git
-
cd <book-name>
-
python -m venv .venv
-
source .venv/bin/activate
-
pip install -r requirements.txt
-
git init
jupyter-book build <book-name>/
Test build locally before deploying. Update requirements.txt to include any new packages required to build package.
Push changes to GitHub and GitHub Actions should do the rest.
I had to change the path for 'Upload the book's HTML as an artifact' in deploy.yml from _build/html
to {book-name}/_build.html