Les notes qu'un programme laisse pour lui-même
Laissez 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.
Résumé
Une imprimerie 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 c'est daté 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 porte private est une chaîne que l'appelant compose, et le service l'écrit telle quelle : rien ici ne la lit, ne l'analyse ni ne la tient à une forme. Une page porte 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 porte donc pas la version annoncée plus haut que ce 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, exigé. 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, exigé, un horodatage ISO 8601. Le moment où votre programme a changé pour la dernière fois ce qu'il a laissé. -
private_data.private— chaîne, exigé. 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 Les notes qu'un programme laisse sur une page Un fichier encore lisible dans des dizaines d'années La norme d'impression que le document revendique 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 contre laquelle les liens se lisent La version de PDF que le fichier déclare 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 Les fichiers contenus, présentés en portefeuille Les pièces jointes d'une page 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