Building the book

Running Quarto locally

• @ this needs to be revised to explain the local book building with quarto
• @ also check in installation instructions the kernel registration in the environment versus the below system-wide kernel registration

If you’d like to build the book yourself you should:

1. Fork this repository
2. Run mamba env create -f ci/envs/coastal.yml
3. Run mamba activate coastal
4. Run jupyter-book build book

A fully-rendered HTML version of the book will be built in book/_build/html/.

Known issue: If you use nb_conda_kernels to expose your environments, you might run into kernelspec errors when building the book. Until this issue is fixed, a workaround is to add the environments manually to the kernselspec:

1. Run mamba activate coastal
2. Run python -m ipykernel install --user --name conda-env-coastal-py --display-name "conda-env-coastal-py"