/website

JupyterBook for SnowEx Hackweek 2021

Primary LanguageJupyter NotebookMIT LicenseMIT

SnowEx Hackweek 2021 JupyterBook Website

Deploy

https://snowex-hackweek.github.io/website

Run tutorials on JupyterHub

** NOTE: this is the preferred way to run tutorials, because you will have access to some external resources like s3://snowex-data **

  1. Log onto http://snowex.hackweek.io (you need to be a member of https://github.com/snowex-hackweek)
  2. Clone this repository git clone https://github.com/snowex-hackweek/website
  3. Navigate to tutorial notebook you want to run: cd website/book/tutorials/raster

Run tutorials on BinderHub

badge

badge

Run tutorials locally

First install Docker if you don't have it

git clone https://github.com/snowex-hackweek/website
cd website/book/tutorials
docker compose up

GitHub Deployment (changing book contents)

The repository comes with a preconfigured GitHub Actions script so that any commits to the main branch are deployed the the GitHub Pages hosted website.

Local Development (adding tutorials)

To add a tutorial as a jupyter notebook under ./book/tutorials, you'll want to use a consistent environment. The best approach for this is to use a Docker Image (this ensures tutorials run in the same environment whether it is your laptop, the event JupyterHub, or some other server):

git clone https://github.com/snowex-hackweek/website
cd website
docker run uwhackweek/snowex:latest -v $PWD:/home/jovyan jb build book

About JupyterBook

https://jupyterbook.org

Contact