write_own_notes.json
Le fichier JSON de l'exemple « Les notes qu'un programme se laisse ». Une épreuve d'imprimerie qui porte le tirage sur le fichier, la plaque sur la page et l'encre sur la gamme de couleurs placée deux fois. Rien n'en est dessiné et aucun logiciel de lecture ne le montre : c'est là pour le 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 donne la même page que les versions Rust et Python de cet exemple. Une requête nomme chaque fichier qu'elle emploie, jamais son contenu ; l'appel porte 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 contre 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 porte le tirage, la page porte sa plaque, et la gamme de couleurs, placée deux fois sur cette page, porte l'encre contre laquelle elle a été réglée.
Ce que montre cet exemple
- Le fichier porte le tirage, la page sa plaque, le dessin l'encre contre 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.