Bekannte Fehler

Leider gibt es einige Fehler (BugsEin Bug in der Softwareentwicklung ist ein Fehler in der Programmierung, der dazu führt, dass das Programm nicht wie gewünscht funktioniert.) in den CIAbkürzung für „Continuous Integration“ – eine Entwicklungspraxis, bei der Codeänderungen automatisch gebaut, getestet und häufig in ein zentrales Repository integriert werden, um Integrationsprobleme frühzeitig zu erkennen und eine hohe Codequalität sicherzustellen.-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.

PDF-Generierung

Im Rahmen der PDFPortable Document Format/UAUniversal Accessibility-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 PDFPortable Document Format-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 PDFPortable Document Format 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 PDFPortable Document Format 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 PDFPortable Document Format-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, CheckIn der Softwareentwicklung bezeichnet „Check“ in der Regel eine Prüfung oder Überprüfung eines Teils der Software. Beispiele sind Unit-Checks oder Integrationsprüfungen. wird im Quality Component eingeführt