Es müssen alle Schritte (Installieren, Testen, Aktualisieren) ausgeführt werden!
Falls du nicht am LaTeX-Kurs teilnimmst, ist TeXLive optional. Dann kannst du allerdings kein TeX in matplotlib benutzen (führt zu weniger schönen Plots).
Falls du nur am LaTeX-Kurs teilnehmen willst, solltest du mindestens VSCodium (oder einen anderen Texteditor) und TeXLive installieren.
Wichtig
Befehle, die ins Terminal eingegeben werden sollen, starten mit $. Gib die Befehle Zeile für Zeile ein, ohne das $-Zeichen, und bestätige sie mit Enter.
Es werden die Installationsschritte für die verbreitetsten Distributionen angegeben. Führe nur die Befehle für deine eigene Distribution (z. B. Ubuntu) aus.
Der sudo
Befehl verleiht weitreichende Administratorrechte,
jede Eingabe mit einem sudo
Befehl muss penibel geprüft werden.
Debian, Ubuntu, Mint:
$ sudo apt update
$ sudo apt upgrade
$ sudo apt install git make curl
Fedora:
$ sudo dnf install git make curl libxcrypt-compat
Arch Linux:
$ sudo pacman -S git make curl libxcrypt-compat
Die Binärdateien, die Microsoft bei VSCode zur Verfügung stellt, sind proprietär und enthalten Tracking Software. Deswegen empfehlen wir VSCodium, eine Open-Source-Variante von VSCode.
Debian, Ubuntu, Mint:
Lade die Datei codium_<VERSION>_amd64.deb
von
github.com/VSCodium/vscodium/releases herunter und öffne sie mit
dem Software-Center (Doppelklick auf den Download). Klicke auf Installieren
.
Fedora
Lade die Datei codium_<VERSION>_el7.x86_64.rpm
von
github.com/VSCodium/vscodium/releases herunter und öffne sie mit
dem Software-Center (Doppelklick auf den Download). Klicke auf Installieren
.
Arch Linux
$ sudo pacman -S code
Hier müssen im Terminal die folgenden Zeilen eingegeben werden:
$ cd ~/.local
$ curl -LO "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
$ bash Miniforge3-$(uname)-$(uname -m).sh -p ~/.local/conda
Die Lizenzvereinbarung musst du je nach Größe des Terminals mit Enter
bis zum Ende erweitern.
Und dann kannst du sie mit yes
akzeptieren.
Den Ort der Installation haben wir im dritten Befehl gesetzt, die Abfrage bestätigst du mit Enter
.
Do you wish the installer to initialize Miniforge3 by running conda init? yes
.
Damit ist die allgemeine Python-Umgebung installiert.
Wichtig
Für den folgenden Schritt musst du dein Terminal schließen und ein neues Terminal öffnen.
Im Anschluss erstellst du jetzt noch eine spezielle Python-Umgebung für den Toolbox Workshop mittels:
$ mamba create -y -n toolbox python=3.13 ipython numpy matplotlib scipy uncertainties sympy
Diese startest du mit
$ mamba activate toolbox
Nach erfolgreicher Installation kannst du die Installationsdatei noch löschen
$ rm ~/.local/Miniforge3-*.sh
Nur bei Fedora Distributionen
Installieren der Perl
dependencies von latexmk
.
Für Fedora >= 41:
$ sudo dnf install -y $(dnf repoquery --providers-of=requires latexmk | grep perl)
Für Fedora <= 40:
$ sudo dnf install -y $(dnf repoquery --requires --resolve latexmk | grep perl)
Ab hier weiter für alle Linux Distributionen:
Im Terminal lädst du mit folgenden drei Befehlen das Installationsskript herunter und führst es dann mit dem letzten aus.
$ cd ~/.local
$ curl -L http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz | tar xz
$ TEXLIVE_INSTALL_PREFIX=~/.local/texlive ./install-tl-*/install-tl
Die Installation startet man mit I
und Enter
.
Nach der Installation muss dem System mitgeteilt werden, wo LaTeX installiert wurde,
das passiert in der Datei ~/.bashrc
.
Führe dazu folgenden Befehl im Terminal aus:
$ echo 'export PATH="$HOME/.local/texlive/2025/bin/x86_64-linux:$PATH"' >> ~/.bashrc
Jetzt einmal das Terminal schließen und für die weiteren Schritte ein neues öffnen. In dem neuen Terminal die folgenden Befehle eingeben:
$ tlmgr option autobackup -- -1
$ tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet
$ luaotfload-tool --update --force
Falls diese Installation aufgrund von zu geringem Speicherplatz nicht funktioniert, gibt es diese Möglichkeit, eine minimale Version von TeXLive zu installieren.
Jetzt noch die Installation testen!
Im folgenden Abschnitt zeigen wir dir, wie du testen kannst, dass die Installationen funktioniert haben und somit entspannt in den Workshop starten kannst.
Öffne ein Terminal und gib
$ git
ein. Es sollte die Git-Hilfe erscheinen.
Git einstellen: Schreibe die Folgende Zeilen, mit den eigenen Daten, nacheinander ins Terminal:
$ git config --global user.name "Max Mustermann"
$ git config --global user.email "max.mustermann@udo.edu"
$ git config --global rebase.stat true
$ git config --global merge.conflictstyle diff3
Um git beizubringen, VSCodium als Editor zu benutzen:
$ git config --global core.editor "codium --wait"
Ebenfalls im Terminal:
$ mamba activate toolbox
$ ipython
Das Programm ipython sollte starten und du bekommst statt des $
einen
nummerierten Prompt, gib nun folgende Befehle nacheinander ein.
In [1]: %matplotlib
In [2]: import matplotlib.pyplot as plt
In [3]: import numpy as np
In [4]: import scipy
In [5]: import sympy
In [6]: import uncertainties
In [7]: plt.plot([1, 2, 4])
Es sollte ein Fenster mit einem Plot erscheinen, schließe das Fenster und beende ipython mit
In [8]: quit
Führe ebenfalls im Terminal
$ make
aus. Es sollte folgende Ausgabe oder das deutsche Äquivalent erscheinen:
make: *** No targets specified and no makefile found. Stop.
Im Terminal:
$ luatex
Es sollte folgende oder ähnliche Ausgabe erscheinen:
This is LuaTeX, Version 1.22.0 (TeX Live 2025)
restricted system commands enabled.
**
Mit Strg
+ c
kannst du den Aufruf beenden.
Als Nächstes testen wir ein Programm für das Literaturverzeichnis,
$ biber
Es sollte die Biber-Hilfe erscheinen. Mit dem folgenden Befehl sollte die Dokumentation von TeXLive geöffnet werden (in einem PDF-Betrachter).
$ texdoc texlive
$ sudo apt update
$ sudo apt upgrade
Im Terminal:
$ mamba update -n toolbox --all
Im Terminal:
$ tlmgr update --self --all --reinstall-forcibly-removed