nusbaume / nbscuid-adf-sandbox

See https://project.cgd.ucar.edu/projects/ocean-diagnostics-books/eromashkova/nbscuid-adf-sandbox-demo1/adf_quick_run.html for an example of a published demo Jupyter book

nbscuid-adf-sandbox 🦑☁️

How to run

1. Install an environment that contains nbscuid, e.g. with the instructions here
2. Activate this environment (e.g. conda activate nbscuid-dev)
3. Clone this repo, which must be done recursively in order to clone the associated submodules:

git clone --recurse-submodules https://github.com/rmshkv/nbscuid-adf-sandbox.git

4. Navigate to the top-level folder, nbscuid-adf-sandbox

5. Run nbscuid-run config.yml

   NOTE: You can actually run this command from anywhere, just change config.yml to the full path relative to your location.

6. Run nbscuid-build config.yml

   NOTE: The built Jupyter Book files will appear in computed_notebooks/adf-quick-run/_build, try opening index.html!

How to add stuff

Check out the config.yml file. This page has some instructions for how to add new notebooks and their parameters, and this is an example of a config.yml file that uses some more options, including adding scripts.