Skip to content

Commit

Permalink
fix: Erklärung für das Leeren des Notebook-Caches
Browse files Browse the repository at this point in the history
  • Loading branch information
schnaitter committed Feb 27, 2025
1 parent e846f3d commit 880c59b
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion entwicklung/jupyter_book.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Installieren Sie nun alle für das Projekt/die OER benötigten Programme und Pro

Wenn Sie im lokalen Ordner Ihres Git Repositoriums sind, können Sie die Webansicht der OER mit `jb build .` neu bauen lassen. Am Ende des Befehls finden Sie einen `file://`-Link zur Startseite, den Sie in einem Browser öffnen können. Wenn das nicht klappt, oder Sie besondere Anforderungen haben, dann nutzen Sie am besten einen lokalen HTTP-Server, um die Dateien zu hosten (bspw. `python3 -m http.server -d _build/html`) und gehen Sie im Browser zur angezeigten URL.

Wenn Sie lokale Dateien anpassen – bspw. wenn Sie an Ihrem Buch weiterschreiben – müssen Sie immer zuerst `jb build .` ausführen, bevor die Änderungen im Browser sichtbar werden. Gibt es hierbei Probleme, so kann es helfen zuerst "aufzuräumen" mit `jb clean .`. Wenn Sie danach wieder `jb build .` ausführen, so werden alle Seiten, auch die, die Sie nicht geändert haben, neu gebaut. Dieser Schritt des Aufräumens und Bauens mittels `jb clean . && jb build .` ist insbesondere dann nötig, wenn Sie etwas am Inhaltsverzeichnis (`_toc.yml`) geändert haben.
Wenn Sie lokale Dateien anpassen – bspw. wenn Sie an Ihrem Buch weiterschreiben – müssen Sie immer zuerst `jb build .` ausführen, bevor die Änderungen im Browser sichtbar werden. Gibt es hierbei Probleme, so kann es helfen zuerst "aufzuräumen" mit `jb clean .`. Ist Cacheing aktiviert (`execute.execute_notebooks: cache` in `_config.yml`), so kann der Cache für ausgeführte Jupyter Notebooks mit `jb clean --all .` geleert werden. Wenn Sie danach wieder `jb build .` ausführen, so werden alle Seiten, auch die, die Sie nicht geändert haben, neu gebaut. Dieser Schritt des Aufräumens und Bauens mittels `jb clean . && jb build .` ist insbesondere dann nötig, wenn Sie etwas am Inhaltsverzeichnis (`_toc.yml`) geändert haben.

## Updates der verwendeten Programmbibliotheken
In der Datei `requirements.txt` werden die jeweils verwendeten Versionen der Programmbibliotheken hinterlegt. Ändert sich die Datei, so sollten Sie Ihre lokale Entwicklungsumgebung aktualisieren.
Expand Down

0 comments on commit 880c59b

Please sign in to comment.