in-a-nutshell.md

# In a Nutshell

After reading all the steps, it is time to summarize everything for faster code snippet searching.

1. Download the TU Delft template

    ```bash
    ??????????????????????????????
    ```

2. Create the environment

    ```bash
    conda create --name=<env-name> python=3.7
    conda activate <env-name>
    conda install pip
    pip install -r requirements.txt
    ```

3. Build your book

    ```bash
    jupyter-book build --all <book-path>
    ```

4. Create and configure Git

    ```bash
   git init
   git add .
   git commit -m "first commit"
   git remote add origin git@gitlab.com:username/projectpath.git
   git push origin master
   ```

5. Pull, commit, and push new content
   ```bash
   git pull origin master
   git add .
   git commit -m "commit message"
   git push origin master
   ```

6. Publish your book

   ```bash
   git checkout --orphan <gl-pages-version>
   git reset
   git add _build/html/*
   git commit -m "New book version <version>"
   git push origin <gl-pages-version> --force
   git update-ref -d HEAD
   git reset
   git checkout master --force
   ```

7. Email to TU Delft

    Email ??????????? with topic ????????????????? and include the link to the book. If the book is a newer version, please, state also the old link in oder to be updated accordingly.