This is a repo for exploring ways to deploy multiple pathways for the Turing Way Jupyter Book. The goal is:
- Maintain a
main
book, which contains the entire book. - There will be multiple
pathways
which are sets of Turing Way pages which are selected for specific audiences. For example the pages about Reproducibility and Communication may be selected for the DSG pathway. Project Design pages may be selected for the Group-Leader pathway. - We are trying to find a way to deploy multiple pathways, OR to enable access to pathways with good user experience.
The deploy
branch's master folder is the work that deploys to Netlify.
- Clone the source code with
git clone git@github.com:Iain-S/my_jupyter_book.git
- Change to the source code directory with
cd my_jupyter_book
- Set Python 3.8 as the local version to use with
pyenv local 3.8.12
- Make a Python 3.8 virtual environment with
virtualenv venv
- Activate it with
source venv/bin/activate
- Install pre-commit hooks with
pre-commit install
- Build our example book with
jupyter-book build mynewbook
- Build our other editions with
python -m main build mynewbook
- Change to the
html
directory withcd mynewbook/_build/html
- Serve it (for development) with
python -m http.server