Schild2Halbjahr/doc/verarbeitung.md

Anstoßen der Verarbeitung

a) Zusammenstellen des Eingabeverzeichnisses 'input/'

Das Pythonskript sucht im Ordner schild2halbjahr/ nach einem Verzeichnis input/. Ist dies nicht vorhanden, wird das Verzeichnis beispielinput/ für die Verarbeitung verwendet.

Legen Sie also - sofern noch nicht vorhanden - das Unterverzeichnis input/ an und fügen Sie dort die beiden bereits exportierten Dateien SchuelerLeistungsdaten.dat und SchuelerLernabschnittsdaten.dat ein bzw. erstellen Sie dort die beiden Dateien epoche.csv (optional) und config.ini. Kopieren Sie bei Bedarf diese beiden Dateien aus dem Beispiel-Verzeichnis beispielinput/ und passen Sie diese entsprechend an.

b) Voraussetzungen

Um das Skript zu starten sind einige Voraussetzungen zu erfüllen:

1. Auf dem eingesetzten Rechner muss Python auf der Kommandozeile installiert sein. (Das vorliegende Skript wurde unter Python 3.13 entwickelt und getestet. Es sollte aber auch mit älteren Python Versionen lauffähig sein.) Da Python plattformunabhängig ist, ist auch das vorliegende Projekt plattformunabhängig.

2. Das Python-Modul xhtml2pdf muss installiert sein.

pip3 install xhtml2pdf

c) Starten des Skripts

Nun kann das Skript auf der Kommandozeile gestartet werden. Dazu muss es aus dem Skriptverzeichnis heraus gestartet werden.

python3 konferenz.py

Auf der Konsole werden die Verarbeitungsschritte dokumentiert und auch evtl. Fehler bei der Verarbeitung angezeigt:

Eingabeverzeichnis input/ existiert nicht, verarbeite beispielinput/ ...
Lese die Daten ein...
Erzeuge HTML-Folien...
Erzeuge PDF-Ausdruck in Farbe...
Erzeuge PDF-Ausdruck in SW...
Erzeuge PDF-Notenübersichten für die SI...
Fertig!

Die Ausgabedateien werden in den Ordnern output/html/ und /output/pdf/ erzeugt bzw. aktualisiert.