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

Beispiele in der Nähe

Ein Blatt, das misst, was es angibt

Drei Lineale — Zentimeter, Zoll und Punkt — auf einer Seite, die dem, was sie druckt, sagt, sie genau in der gezeichneten Größe auszugeben und nichts anderes anzubieten. Legen Sie ein Maßband an den gedruckten Bogen, und Sie können es selbst prüfen.

Ein Register, dessen Seiten sagen, woher sie stammen

Zwei Sitzungen in einer Datei gebunden. Jede Seite trägt einen eigenen Vermerk — was sie ist, wessen Hand sie geschrieben hat, der Tag, an dem sie geschrieben wurde —, das Foto auf der zweiten Seite trägt ebenfalls einen, und jede Transkription ist an die Seite gebunden, die sie transkribiert, statt an die Datei insgesamt.

Eine Datei, die ihre eigenen Einträge erklärt

Das Aktenzeichen einer Registratur, die Abteilung, aus der es stammt, das Datum, bis zu dem das Dokument aufzubewahren ist, und seine Einstufung, in einer Datei, die ein Archiv noch annimmt. Keine Archivregel weiß, was ein Aufbewahrungsdatum ist; jeder Eintrag trägt daher eine Beschreibung seiner selbst, und diese Beschreibung lässt eine Prüfsoftware eine Angabe akzeptieren, die Sie allein erfunden haben. Eine zweite Seite fügt einen Ausleihvermerk hinzu, dessen Einträge ein Ja oder Nein, ein Dateityp, ein Personenname, eine Messung und zwei Webadressen sind, und gibt dieser Seite einen eigenen verborgenen Vermerk.

Ein Lieferschein, der seine eigene Bestellung kennt

Jede Zeile des Scheins trägt die Bestellung, für die sie kommissioniert wurde, die Artikelnummer und das Regal, aus dem sie stammt, und druckt nichts davon. Die Stelle, an der der Fahrer unterschreibt, trägt die Tour und den Transporter, und eine neben der Falzmarke trägt nichts außer ihrem eigenen Platz.

Eine Liste, deren Bilder ebenfalls sprechen

Eine Teileliste, deren erste Spalte ein Bild statt eines Wortes ist. Jedes Bild trägt den Satz, den jemand an seiner Stelle hört, sodass in der Liste nichts für einen Leser verloren geht, der sie nicht sehen kann. Auf der Seite sind die Bilder einfach Bilder.

Eine getaggte Anzeige, die sagt, was jeder Teil ist

Eine Lieferanzeige, deren verborgene Struktur angibt, wo jedes Element steht, wofür eine Abkürzung steht und zu welchen Überschriften jede Tabellenzelle gehört, mit Kolumnentitel, Seitenzahl und Zeilennummern als Seitenbeiwerk markiert; dann jede Listennummerierung und jede Rolle, die ein Element erhalten kann.

Jedes Beispiel, nach Thema