Posaune

Vertretungsplan-Anzeige für das St. Benno Gymnasium

Live-Demo - Erläuterung

Setup

Voraussetzungen

• Unix-Shell
• Benutzer mit Administratorrechten
• Paket-Manager: apt, dnf oder pacman
• curl

Installation

Die Posaune kann per curl heruntergeladen und installiert werden:

curl -sSL https://raw.githubusercontent.com/Operators-Diaries/posaune/main/scripts/install.sh | bash

Dafür ist beim ersten Ausführen wahrscheinlich die Eingabe des Systempassworts nötig. (Das Verzeichnis, in dem dieser Befehl ausgeführt wurde sei als ~ bezeichnet) Die Installation erzeugt das Verzeichnis ~/posaune.

Zu beachten

• Es kann sinnvoll sein, browserseitig die Zoomstufe zu erhöhen. Normalerweise speichert der Browser das für eine Domain, sodass es nur einmal eingestellt werden muss.

Konfiguration

Nach dem ersten Starten wird eine Datei ~/posaune/config.toml mit Standardwerten angelegt.

Die Konfigurationsparameter werden nur beim Start des Servers ausgelesen.

Alle Parameter, die in der config.toml nicht gesetzt sind, können über den vermächtnis-Key aus einer anderen Konfiguration übernommen werden, die in einer Datei ~/posaune/configurations.toml unter jenem Key liegt. Letztere Datei kann aus beliebigen Quellen bezogen werden.

Starten

Ein fertiges Start-Skript liegt in ~/posaune/scripts/start.sh. Seine Ausführung muss lediglich als Schedule im System hinterlegt werden - beispielsweise mit crontab. Zu beachten ist, dass das Skript mit bash und nicht mit sh ausgeführt werden muss.