Bekannte Fehler
Leider gibt es einige Fehler (Bugs) in den CI-Komponenten, die wir bisher nicht beheben konnten. An dieser Stelle möchten wir diese transparent machen und Sie einladen, das Projekt gerne mit Verbesserungsvorschlägen zu unterstützen.
Bitte erstellen Sie für Fehler ein Issue im Document Writing Tools Projekt.
PDF-Generierung
Im Rahmen der PDF/UA-Generierung sind uns folgende Fehler bekannt:
Kommas in Alt-Texten von Bildern
Aufgrund der Maßnahmen zur möglichst automatisierten Integration von Glossar und Abkürzungsverzeichnis und
der Einbettung als <abbr>-Elemente in den Text, wurde der Verarbeitungsprozess der PDF-Generierung angepasst.
Wir nutzen nun Pandoc, um nach einer Reihe an Vorverarbeitungsschritten den LaTeX-Code des Dokuments zu generieren.
Das eigentliche Rendern des PDFs erfolgt dann über die lualatex-Engine. Diese wird von uns mehrfach angesprochen,
damit sich die Verzeichnisse und Querverweise korrekt einbetten lassen. Leider ist es uns bisher nicht gelungen,
Kommas in den Alt-Texten von Bildern zu escapen. Das hat dazu geführt, dass Bilder mit Kommas im Alt-Text
nicht korrekt in das PDF eingebettet werden.
Als aktueller Workaround werden Kommas in Alt-Texten von Bildern automatisch entfernt.
Workaround eingeführt in: document-writing-ci-components@51685fe0
Fußnoten beim Hervorheben von Ergänzungen
Aktuell unterstützen wir Fußnoten in der Hervorhebung von Ergänzungen in dem PDF nicht. Die Logik des Mechanismus zum Hervorheben von Ergänzungen muss LaTeX-Elemente an den richtigen Stellen einfügen, um die Hervorhebung zu ermöglichen. Wir stützen uns zum Hervorheben auf Markdown-Kommentar-basierte Auszeichnungen. Wir müssten in der aktuellen Implementierung die Auflösung bzw. das Matching von Fußnotenreferenz zu Fußnotentext sehr aufwendig implementieren.
Workaround eingeführt in: document-writing-ci-components@23c4c610
Umlaute im Glossar oder Abkürzungsverzeichnis
Beginnt ein Eintrag im Glossar oder Abkürzungsverzeichnis mit einem Umlaut, führt dies zu Fehlern in der PDF-Generierung.
Beispiel: öV: öffentliche Verwaltung
Scheinbar sortiert das Packet glossary die Einträge der Akronyme nach dem Alphabet (ohne Umlaute) und setzt dafür
im Hintergrund jeweils ein glsgroupheading. Einträge, wo der Key mit einem Umlaut beginnt, können nicht verarbeitet
werden - zum Beispiel: AöV würde wieder funktionieren.
Workaround: keiner, Check wird im Quality Component eingeführt