Ein Dokument, das sich vorlesen lässt
Jemand, der Ihnen am Telefon einen Brief vorliest, beginnt oben, folgt den Sätzen in der Reihenfolge, in der sie geschrieben wurden, und hält nicht an, um die darüber gedruckte Anschrift vorzulesen: Er sieht, welcher Teil die Nachricht ist. Eine Software, die ein Dokument vorliest, sieht nichts davon. Sie hat nur die Markierungen auf der Seite, in der Reihenfolge, in der das Programm sie aufgetragen hat — oft die Überschrift, dann die Seitenzahl, dann der Rumpf —, sodass ein blinder Leser die Seitenzahl mitten in einem Satz zu hören bekommt.
Dieses Dokument trägt eine zweite Kopie seiner selbst, die niemand sieht: eine Liste, die sagt, dies ist eine Überschrift, dies ein Absatz, dies eine Tabelle mit drei Zeilen, und dies ist die Reihenfolge, in der sie zu lesen sind. Der Kolumnentitel und die Seitenzahl stehen dort als Dekoration, sodass sie nie laut gesagt werden. Nichts sieht anders aus — öffnen Sie die Datei, und Sie sehen zwei gewöhnliche Seiten.
Die Datei unten beansprucht keine Norm: Sie trägt die Struktur und sagt nichts darüber, an welches Regelwerk sie sich halten will. Diese Angabe ist eine hinzuzufügende Zeile, und gegen sie wird dann eine Prüfung ausgeführt — daher wird dasselbe Beispiel zweimal zusätzlich geschrieben, einmal mit den Barrierefreiheitsregeln der neueren Norm, einmal mit der Archivierungsstufe, die verlangt, dass jede Markierung auf der Seite für einen Buchstaben steht. Jede der beiden geht zu veraPDF, bevor eine Änderung in die Bibliothek gelangt, und eine Ablehnung hält die Prüfung an Ort und Stelle an.
Was dieses Beispiel zeigt
- Zwei Seiten mit Überschriften, Absätzen und einer dreizeiligen Tabelle, jedes sagt, was es ist.
- Der Kolumnentitel und die Seitenzahl als Dekoration markiert und nie vorgelesen.
- Dasselbe Beispiel, erneut mit Angabe der Regeln geschrieben, veraPDF übergeben — einem kostenlosen Programm, das nie von uns gehört hat — und auf beiden Stufen akzeptiert, die es dann beansprucht.
Der Quellcode, vollständig
Nichts ist weggelassen und nichts vereinfacht: Das ist das Programm genau so, wie es läuft, für den Entwickler, der diese Bibliothek nutzt.
Die dritte ist die Beschreibung selbst: eine schlichte Liste dessen, was die Seite sagen muss, und das wird dem Dienst gesendet.
Den Rust-Quellcode lesen
Den Python-Quellcode lesen
Den JSON-Quellcode lesen
Das Dokument selbst
Das Dokument auf Englisch öffnen
Das Dokument auf Französisch öffnen
Das Dokument auf Deutsch öffnen
Das Dokument auf Spanisch öffnen
Das Dokument auf Italienisch öffnen
Das Dokument auf Portugiesisch öffnen