c3s-training

Master repository for the notebooks to be included in the C3S JupyterBook

C3SBook

This repository contains a book of notebooks generated with Jupyter Book. Below are the instructions for working with this project, including how the structure of the notebooks works and how to perform the build and deploy process of the book.

Notebook and Submodule Structure

The book of notebooks is organized using submodules, which allows for maintaining a modular structure and facilitates managing the different topics and sections of the book. Each submodule is a training book and it's uploaded in GitHub as a repository. The submodule structure is defined in the _toc.yml file and stored in notebooks directory.

Building and Deploying the Book

To build and deploy the book of notebooks, follow these steps:

1. Rebuild the Book

To rebuild the book, first remove the existing _build folder and then run the following command to rebuild the book:

rm -rf _build
jupyter-book build --all .

2. Book Deployment

Once the book has been successfully rebuilt, you can deploy it to the gh-pages branch using ghp-import. Run the following command to copy the _build/html folder to the gh-pages branch and deploy the book:

ghp-import -n -p -f _build/html

Run our notebooks

In the notebooks folder, you'll find all the Jupyter notebooks. Additionally, there's a requirements.txt file included, containing the necessary Python libraries for running the notebooks. You can install all the required libraries by executing the following command in your terminal:

pip install -r requirements.txt

To run the notebooks on your local machine, please refer to C3S Book:How to run these tutorials section for detailed instructions.