write_tagged_pictures.json
Die JSON-Datei des Beispiels „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.
Diese Datei ist eine Anfrage: Eine Anwendung sendet sie über das Netz an den Server, der das PDF erzeugt und zurücksendet. Sie erzeugt dieselbe Seite wie die Rust- und die Python-Fassung dieses Beispiels. Eine Anfrage nennt jede Datei, die sie verwendet, nie ihren Inhalt; der Aufruf trägt die Anfrage und die Dateien zusammen. Eine Schrift, die der Server bereits vorhält, etwa DejaVuSans, wird ohne Anhang genannt. Senden Sie die Anfrage an die Adresse, die die API-Seite angibt.
Die Bibliothek zeichnet die Überschrift und die Seitenzahl Zeile für Zeile und nennt die Schrift, bevor sie sagt, wo die Zeile steht; die Anfrage verlangt jede davon als kleinen Textblock, der angibt, wo seine eigene erste Zeile hinkommt. Die verborgene Kopie der Seite wird in der Datei der Bibliothek um die Überschrift herum eine Spur früher eröffnet als in dieser und wird so oder so gleich gelesen. Die Bibliothek erfasst das Dokument außerdem unter einem Titel; eine Anfrage gibt einen Titel zusammen mit allem anderen an, was eine Datei über sich sagt, und diese hier sagt nichts über sich, also wird ihre Datei unter keinem Namen erfasst. Nichts davon wird auf die Seite gezeichnet, und die beiden Dokumente stimmen Punkt für Punkt überein.
Diese Anfrage nennt Dateien, die sie nicht trägt: hqf_development.png, indexed_16colours.png, logo.png. Jede davon reist neben der Anfrage, im selben Aufruf, als mitgelieferter Teil, genau so benannt, wie die Anfrage sie hier nennt — die Beschreibung sagt, welcher Name welche Rolle spielt, Sie benennen Ihre Dateien also, wie Sie möchten. Eine Anfrage, die eine Datei nennt, von der der Aufruf nichts trägt, wird abgelehnt.
Wofür dieses Beispiel da ist
Lesen Sie eine Teileliste am Telefon vor, und Sie sagen, was jedes Bild zeigt: den Deckel, das Typenschild, die kleine Temperaturanzeige. Eine Software, die ein Dokument vorliest, sagt gar nichts, denn ein Bild ist für sie nur ein Bild — und in einer Liste, in der das Bild die Spalte ist, die einen Artikel vom anderen unterscheidet, ist das keine verlorene Verzierung. Die ganze Zeile verstummt.
Was dieses Beispiel zeigt
- Drei Artikel in einer Liste, jeder durch ein Bild statt durch ein Wort benannt.
- Ein Satz an jedem Bild, den man an seiner Stelle hört.
- Jede Zelle nennt die Spalte, zu der sie gehört, sodass eine Zeile als Zeile vorgelesen wird und nicht als vier verstreute Wörter.