LehrerPDF/doc/erzeugung.md

Erzeugung des PDF-Ausgabedokuments

Zu diesem Zeitpunkt sollte die Konfiguration abgeschlossen sein. Das PDF-Zieldokument kann nun erzeugt werden. Dazu muss das Python-Skript lehrerpdf.pygestartet werden.

Voraussetzungen

Hierzu 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. Die beiden Python-Module xhtml2pdf und markdown müssen installiert sein.

pip3 install xhtml2pdf
pip3 install markdown

Starten des Skripts

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

python3 lehrerpdf.py

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

Verarbeite das Verzeichnis: data/
Verarbeite Datei: data/klasse-5a.csv
Verarbeite Datei: data/klasse-6b.csv
Verarbeite Datei: data/kurs-if-9.csv
Verarbeite Datei: data/kurs-if-ef.csv
Erzeuge PDF-Datei: rm2.pdf
Fertig!

Die Ausgabedatei, dessen Namen das Zielgerät angibt (im obigen Beispiel rm2.pdf für das Ziel Gerät reMarkable 2), wird dabei im Verzeichnis der Eingabedateien abgelegt.

Option: Angabe des Eingabeverzeichnisses

Optional kann an dieser Stelle mit der Option -d das Eingabeverzeichnis festgelegt werden.

Beispiel:

python3 lehrerpdf.py -d /Users/wolfgang/Documents/beispiel/

Das Verzeichnis kann auch hier wieder relativ zum aktuellen Pfad oder als absoluter Pfad angegeben werden.

Die Option -d hat Vorrang vor einer evtl. Konfiguration durch eine Datei config.ini im Verzeichnis des Skripts.