# Jupyterbook: Erste Schritte

* dsci-lab starten


Neues Demo-Jupyterbook erstellen:

* wechsle in das Verzeichnis c, neues Jupyterbook anlegen:

```
cd c
jb create mein-python
```

Das neu angelegte Buch builden:

```
jb build mein-python
```

Es wird eine Website erzeugt. Html-Ergebnis in Firefox öffnen:

> Or paste this line directly into your browser bar:
>     file:///home/dsci/c/test/_build/html/index.html


Das neu angelegte Buch in pdf übersetzen:
```
jb build mein-python --builder pdflatex
```

Das pdf-Buch anschauen:

```
atril _build/latex/book.pdf &
```
 

Dieses Jupyterbook erweitern um ein weiteres Notebook:

* Öffne die Seite <http://jbusse.de/dsci-lab/t_ki150.html>
* Oben rechts Pfeil, "Download source file" > `ipynb`: Speichern in das Verzeichnis `mein-python`

Wieder das Jupyterbook builden. Wir sehen eine Warnung:

> checking consistency... /home/dsci/c/test/t_ki150.ipynb: WARNING: document isn't included in any toctree

Warnung erkennen, Problem lösen:

* `t_ki150.ipynb` aufnehmen in die Datei `_toc.yml`
* neu builden
* Firefox beenden, html-Ergebis neu öffenen: Viola!



## Notebook `t_ki150.ipynb` editieren

Neues Terminal aufmachen, dort Jupyter Notebook starten:

```
cd
jupyter notebook
```

Es öffnet sich ein neues Firefox-Fenster. Wir blicken über den Browser auf unser Dateisystem.
* Navigiere in das Verzeichnis `c/mein-python/`
* öffne die Datei `t_ki150.ipynb` mit einem einfachen Klick.
* Editiere die Datei, speichern

Dann wieder im anderen, noch offenen Terminal neu builden!