JupyterBooks cookbook

# Mostly from this https://jupyterbook.org/en/stable/start/your-first-book.html
# Install globally or in venv
pip install jupyter-book

# Create a template jupyter-book
jupyter-book create mynewbook

# Build book
cd mynewbook
jupyter-book build .

# To publish to git
pip install ghp-import
# Do a ghp-import from the html folder to the gh-pages branch
ghp-import -n -p -f _build/html
#
# Once done, it should take a few minutes until the book is available at
# https://<user>.github.io/<myonlinebook>/.

#
# To check pages locally
# If on windows simply open with explorer or directly from browser the pages in the filesystem.
# If on WSL2 or want to go through a server, simply start the python http server
python -m http.server 8000