5 Contributors’ Guide
In this guide, we collect useful information for authors and contributors to the book.
5.1 Local rendering instructions
By default, the book is rendered automatically through GitHub actions when you merge to main
. However, if you want to preview the book locally, you can do so by following these instructions:
Clone the repo for this book somewhere on your computer. Navigate using a terminal to the folder containing the repository.
Add the Julia kernel to Jupyter. This is currently tested with Julia 1.9, your results may vary with different versions of julia.
# Load the current environment using Pkg; Pkg.activate("."); Pkg.instantiate() # Import IJulia using IJulia # Call a notebook. You can close it once you call this -- # we only need to run notebook() once for it to build the # jupyter kernel for Julia. notebook()
If you get an error message about jupyter
not being found, you may need to build IJulia
first. This
Install Quarto.
Render the website from the root of this folder with
quarto render
Optionally, if you want to preview the HTML version of the page before you merge it to
main
, you can runquarter preview