Der ganze Installationsvorgang kann mit dem Skript TagungInstall.sh durchgeführt werden. Dieses Skript verschicke ich bei Bedarf per eMail. Das Skript macht allerdings auch nichts anderes als was im Folgenden beschrieben ist.

In aller Regel ist auf Linux-Systemen Python 3 installiert. Falls nicht, muss man es über die üblichen Repositories nachholen. Unter Umständen muss man zusätzlich python3-venv installieren.

Unter macOS ist das Programm bisher nicht getestet. In jedem Fall muss Python 3 installiert werden, evt. zusätzlich die Bibliothek venv für Virtuelle Umgebungen (Virtual Environments).

Es wird dringend empfohlen (und im Folgenden vorausgesetzt), die GUI innerhalb einer Virtuellen Umgebung laufen zu lassen. Dafür:

1. Ein Verzeichnis für die GUI anlegen, z.B.

mkdir Tagung'

2. Dort eine virtuelle Umgebung anlegen:

cd Tagung
python3 -m venv .venv

Damit wird innerhalb des Verzeichnisses Tagung eine Virtuelle Umgebung namens .venv angelegt.

3. Die Virtuelle Umgebung aktivieren:

source .venv/bin/activate

4. Nach Beendigung der Arbeit die Virtuelle Umgebung deaktivieren:

deactivate

Dafür wechseln wir wieder in die Virtuelle Umgebung und installieren das Paket dort:

1. In das Verzeichnis wechseln:

cd Tagung

2. Die Virtuelle Umgebung aktivieren:

source .venv/bin/activate

3. Das Paket ug_tagung installieren:

pip install ug_tagung

4. Das Programm einmalig im Setup-Modus laufen lassen:

python -m ug_tagung.Tagung --setup

5. Es sollten nun einige Dateien in das aktuelle Verzeichnis kopiert worden sein. Darunter die beiden Skripte TagungStart.sh und TagungUpgrade.sh.

6. Diese beiden Skripte ausführbar machen, etwa mit

chmod a+x TagungStart.sh TagungUpgrade.sh

7. Die Virtuelle Umgebung deaktivieren:

deactivate

Optional können, wenn man die GUI später per Mausklick ausführen möchte, für die beiden genannten Skripte Starter angelegt werden, einen für TagungStart.sh und einen für TagungUpgrade.sh. Mit dem ersten wird später die GUI gestartet, mit dem anderen werden - falls verfügbar - Upgrades installiert.

In beiden Fällen muss das Arbeitsverzeichnis angegeben werden, etwa „Ausführen in:“ Dort ist etwa /home/…/Tagung anzugeben. In beiden Fällen sollte, wenn die Option besteht, etwa „Im Terminal ausführen“ aktiviert werden.