write_tagged_pictures.json
Le fichier JSON de l’exemple « Une liste dont les images parlent aussi ». Une liste de pièces dont la première colonne est une image plutôt qu’un mot. Chaque image donne la phrase qu’on entend à sa place, si bien que rien de cette liste n’échappe à qui ne la voit pas. Sur la page, les images restent de simples images.
Ce fichier est une requête : une application l’envoie par le réseau au serveur, qui crée le PDF et le renvoie. Il crée la même page que les versions Rust et Python de cet exemple. Une requête nomme chaque fichier qu’elle emploie, jamais le contenu de ces fichiers ; l’appel transmet la requête et les fichiers ensemble. Une police que le serveur détient déjà, comme DejaVuSans, se nomme sans rien y joindre. Envoyez la requête à l’adresse que donne la page de l’API.
La bibliothèque trace le titre et le numéro de page une ligne à la fois, en nommant la police avant de dire où la ligne se pose ; la requête demande chacun d’eux comme un petit bloc de texte qui indique où va sa propre première ligne. La copie cachée de la page s’ouvre un peu plus tôt autour du titre dans le fichier de la bibliothèque que dans celui-ci, et se lit de la même façon des deux côtés. La bibliothèque enregistre aussi le document sous un titre ; une requête indique un titre en même temps que tout ce que le fichier dit de lui-même, et celle-ci ne dit rien d’elle-même : son fichier est donc enregistré sans nom. Rien de tout cela n’est tracé sur la page, et les deux documents se superposent au point près.
Cette requête nomme des fichiers qu’elle ne contient pas : hqf_development.png, indexed_16colours.png, logo.png. Chacun voyage à côté de la requête, dans le même appel, comme une pièce fournie nommée exactement comme la requête la nomme ici — la description dit quel nom joue quel rôle, vous nommez donc vos fichiers comme vous voulez. Une requête qui nomme un fichier dont l’appel ne contient rien est refusée.
À quoi sert cet exemple
Lisez une liste de pièces au téléphone et vous dites ce que montre chaque image : le couvercle, la plaque signalétique, le petit indicateur de température. Un logiciel qui lit un document à voix haute, lui, ne dit rien du tout, parce qu’une image n’est pour lui qu’une image — et dans une liste où l’image est la colonne qui distingue un article d’un autre, ce n’est pas une décoration perdue. C’est la ligne entière qui devient muette.
Ce que montre cet exemple
- Trois articles dans une liste, chacun désigné par une image plutôt que par un mot.
- Une phrase attachée à chaque image, entendue à sa place.
- Chaque cellule nommant la colonne à laquelle elle appartient, si bien qu’une ligne est lue comme une ligne et non comme quatre mots épars.