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.

Unter Windows ist der Installationsvorgang etwas holperig - finde ich…

Python3 sollte über …

In der Powershell können Skripte nicht ohne weiteres ausgeführt werden. Das verhindert ein Schutzmechanismus von Windows.

Um es doch zu ermöglichen, ist z.B. folgendes zu machen, um den „Executionpolicy“ anzupassen:

1. Powershell als Administrator öffnen (das geht über das Startmenü, dort „Powershell“ eingeben und dann un ter den Optionen „Öffnen als Administrator“ wählen.
2. Mit get-executionpolicy überprüfen, wie die Einstellung aktuell ist. Es sollte i.d.R. Restricted eingestellt sein.
3. Mit set-executionpolicy unrestricted den Wert anpassen. Damit ermöglicht man, alle .ps1 Skripte auszuführen.
4. Powershell als normaler Benutzer öffnen.
5. Start-Skript ausführen. Nun sollte es laufen.

Zunächst muss dafür gesorgt werden, dass .ps1-Sktipte per Mausklick nicht mit dem Editor, sondern mit der Powershell geöffnet werden.

Dafür:

1. Rechtsklick auf das Powershell-Skript.
2. Öffnen mit…
3. Andere App auswählen
4. Wählen Sie eine App auf Ihrem PC aus
5. C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
6. Je nach Wunsch die Powershell für alle .ps1 Skripte aktivieren.

Nun sollte das Skript mit einem Mausklick (Doppelklick) gestartet werden.

Dann kann man - je nach Bedarf - auch noch einen Starter auf den Desktop oder sonst wohin bringen. Dafür legt man z.B. per Rechtsklick auf das Start-Skript ein Verknüpfung an, verschiebt diese dann auf den Desktop und benennt sie dort sinnvoll um.