Les notes qu’un programme laisse pour lui-même
Laisser dans le document des données pour le programme qui l’a écrit, rangées sous le nom de ce programme et datées. Aucun logiciel de lecture ne les montre.
Le résultat dans un vrai PDF
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.
Résumé
Un imprimeur envoie une épreuve et la récupère trois jours plus tard. Pour reprendre le travail, il lui faut savoir à quel tirage la feuille appartient — et cela ne regarde pas celui qui tient la feuille. Cela voyage donc sous le document au lieu d’être dessus. Ce que vous laissez est rangé sous le nom de votre propre programme, de sorte que deux programmes qui laissent des notes dans le même fichier ne lisent jamais celles de l’autre, et le tout porte la date du moment où votre programme y a touché pour la dernière fois. Rien n’en est dessiné, et cela voyage avec le fichier partout où il va.
Techniquement
Écrit au premier niveau d’une requête, sous
"private_data"
private_data écrit le /PieceInfo du catalogue du document et le /LastModified posé à côté, sous le nom privé qu’énonce program. Ce que contient private est une chaîne que le client compose, et le service l’écrit telle quelle : rien ici ne la lit, ne l’analyse ni ne lui impose de forme. Une page reçoit les siennes par page_private_data, et un dessin nommé par drawings[].private_data, chacun rangé sous son propre programme de la même façon. Une pièce est du PDF 1.3 sur une page et du 1.4 sur le catalogue : cela ne fait donc pas monter la version annoncée par le document au-delà de celle que la bibliothèque écrit déjà.
Schéma de la requête
-
private_data— objet, facultatif ; absent, aucune pièce n’est laissée. -
private_data.program— chaîne, obligatoire. Le nom sous lequel vos données sont rangées, et ce qui empêche deux programmes de se marcher dessus. -
private_data.modified— chaîne, obligatoire, un horodatage ISO 8601. Le moment où votre programme a modifié pour la dernière fois ce qu’il a laissé. -
private_data.private— chaîne, obligatoire. Les données elles-mêmes, telles que votre programme les a composées. Elles sont écrites telles quelles.
Portée : le document entier. page_private_data laisse les mêmes sur une page, et drawings[].private_data sur un dessin nommé.
Une requête entière qui crée un PDF
{
"private_data": {
"program": "PressDesk",
"modified": "2026-09-07T08:15:00+02:00",
"private": "{\"run\":47,\"press\":\"K4\",\"proof\":3}"
},
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
"content": ["A proof, and the run it belongs to underneath it"],
"font": "sans",
"font_size": 12
}
]
}Le document dans son ensemble
Les numéros que montre le logiciel de lecture Cent courriers dans un seul fichier Ce que le document dit de lui-même Ce que le document dit de lui-même, dit une seule fois Un texte que personne ne peut copier Les notes qu’un programme laisse sur une page Les données qu’un programme accroche à un passage d’encre Un fichier encore lisible dans des dizaines d’années La norme d’impression que le document déclare La norme d’impression variable déclarée par le document Le mot de passe qui l’ouvre, et ce qu’on peut en faire Une facture qu’un humain et une machine lisent L’adresse à partir de laquelle se lisent les liens relatifs La version de PDF que le fichier déclare Les extensions de PDF dont le fichier dit se servir Ce qu’une image dit d’elle-même, et comment elle est lue Les pièces jointes du document, à côté de ses pages Des fichiers que le document nomme sans les contenir Les pièces jointes, présentées en portefeuille Les pièces jointes que revendique une page Les pièces jointes que revendique une police La fiche d’identité propre à une police Les pièces jointes que revendique la fiche du document Une fiche de document rédigée ailleurs Les zones d’une page où un lecteur mesure La fiche d’identité que contient une seule page La norme d’accessibilité que le document déclare Les normes contre lesquelles le document fini est mesuré
Où aller ensuite
Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête