write_own_notes.json
Le fichier JSON de l’exemple « Les notes qu’un programme se laisse ». Une épreuve d’imprimerie dont le fichier contient le tirage, la page sa plaque et la gamme de couleurs, placée deux fois, son encre. Rien n’en est dessiné et aucun logiciel de lecture ne le montre : tout cela est destiné au programme qui l’a écrit.
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.
À quoi sert cet exemple
Une imprimerie envoie une épreuve et la récupère trois jours plus tard, une note au crayon dans la marge. Pour reprendre le travail, il lui faut savoir à quel tirage la feuille appartient, pour quelle plaque la page a été composée, et pour quelle encre la gamme de couleurs a été tracée — et rien de tout cela ne regarde celui qui tient la feuille. Cela voyage donc sous le document plutôt que dessus : le fichier contient le tirage, la page sa plaque, et la gamme de couleurs, placée deux fois sur cette page, l’encre pour laquelle elle a été réglée.
Ce que montre cet exemple
- Le fichier contient le tirage, la page sa plaque, le dessin l’encre sur laquelle il a été réglé.
- Chaque paquet est rangé sous le nom du programme qui l’a laissé, et daté d’un moment.
- Rien n’en est dessiné, et aucun logiciel de lecture n’en montre quoi que ce soit.