Ce que le document dit de lui-même
Donner au fichier son titre, son auteur, son sujet, sa date, et au besoin des entrées tirées de votre propre vocabulaire.
Le résultat dans un vrai PDF
Deux pages identiques qui dessinent la structure d’une facture avec des traits et des rectangles, sans un mot de texte : le fichier fait une douzaine de kilooctets et n’incorpore aucune police.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Un document qui se lit librement et demande à ne pas être copié · Un document qui demande un mot de passe pour s’ouvrir · Tous les codes-barres linéaires sur une page
Résumé
Sur le dos d’un classeur, on écrit ce qu’il y a dedans : le titre, qui l’a préparé, de quoi il traite, de quand il date. Un document numérique fait de même, sauf que c’est le logiciel qui lit l’étiquette — et il dit aussi de quel programme le document est sorti : un logiciel de comptabilité, un tableur, un logiciel de dessin. Tout cela est là pour retrouver le fichier plus tard, pour le ranger, pour savoir ce qu’on tient sans l’ouvrir.
Techniquement
Écrit au premier niveau d’une requête, sous
"metadata"
metadata écrit le dictionnaire /Info du document et son paquet XMP /Metadata, et les garde concordants : chaque champ est écrit dans les deux, que les normes d’archivage exigent identiques. Les entrées de metadata.info sont les seules à n’aller que dans le dictionnaire, faute de propriété du paquet qui leur corresponde. Un vocabulaire propre au client s’ajoute par schemas, avec ses propriétés et leurs descriptions ; ce sont ces descriptions qui permettent à un vérificateur d’accepter des noms inconnus de la norme. La clé de premier niveau information_dictionary mise à false retire le dictionnaire /Info et ne conserve que le paquet, quelle que soit la version que déclare la requête.
Schéma de la requête
-
metadata— objet, facultatif, absent par défaut. -
metadata.title— chaîne, facultative. Le titre du document. -
metadata.author— chaîne, facultative. Qui l’a écrit. -
metadata.subject— chaîne, facultative. Ce qu’est le document. -
metadata.keywords— chaîne, facultative. Les mots par lesquels on retrouve le document. -
metadata.creator— chaîne, facultative. Le logiciel dans lequel le document d’origine a été écrit. -
metadata.producer— chaîne, facultative. Ce qui l’a créé. -
metadata.created— chaîne, facultative. La date, en ISO 8601, par exemple2026-08-08T10:00:00+02:00. -
metadata.modified— chaîne, facultative. La date de la dernière modification du document, sous les mêmes formes. Un document qui n’en déclare aucune a été modifié pour la dernière fois au moment de sa création. -
metadata.trapped— chaîne, facultative. Trois valeurs :yes,no,unknown. Dit si le document a été préparé pour l’étalement de l’encre en presse. Ne rien dire n’a pas le même sens que direno. -
metadata.schemas— tableau, facultatif, vide par défaut. Les vocabulaires propres au client. -
schemas[].name,schemas[].namespace,schemas[].prefix— chaînes, toutes obligatoires. Les préfixes que la bibliothèque se réserve sont refusés. -
schemas[].properties— tableau, obligatoire ; un tableau vide est refusé. -
properties[].name,properties[].description— chaînes, toutes deux obligatoires ; une description vide est refusée. -
properties[].value— obligatoire. Une chaîne, ou une liste ou une structure sous forme d’objet :{"seq": […]}pour une liste ordonnée,{"bag": […]}pour une liste non ordonnée,{"alt": […]}pour des variantes,{"structure": [{"field": name, "value": …}, …]}pour des champs nommés, imbriqués aussi profondément que le type le prévoit. Un texte en plusieurs langues s’écrit{"lang_alt": [{"language": tag, "text": …}, …]}: la version que retient le logiciel de lecture quand aucune langue n’est demandée vient en premier, sous l’étiquettex-default. -
properties[].value_type— chaîne ou objet, facultatif,textpar défaut. Neuf mots :boolean,date,integer,mime_type,proper_name,real,text,uri,url. Une liste s’écrit{"seq": item},{"bag": item}ou{"alt": item}, ses éléments étant un mot ou une structure ; une structure s’écrit{"structure": …}. Le motlang_altfait lire la valeur comme un texte en plusieurs langues : sont refusés un texte sans version, une version qui ne nomme pas sa langue et une même langue donnée deux fois, majuscules et minuscules confondues. -
Une structure déclare
name,namespace,prefix,descriptionetfields, chaque champ ayant unname, unvalue_typeet unedescription. Elle est décrite dans le paquet de métadonnées à côté de son schéma, pour qu’un validateur d’archivage contrôle aussi ses champs. Une valeur dont la forme ne correspond pas à son type est refusée. -
properties[].category— chaîne, facultative,internalpar défaut. Deux valeurs :internal,external. -
metadata.declarations— tableau, facultatif. Les spécifications auxquelles le document déclare se conformer, chacune{"conforms_to": address, "claims": […]}, une affirmation indiquantby, qui la fait,date,credentials, ce qui qualifie son auteur, etreport, l’adresse du rapport sur lequel elle repose. Une déclaration ne prouve rien : rien ne confronte le fichier à la spécification qu’elle nomme.
Les propriétés sont écrites dans le paquet quoi qu’il arrive ; leur description l’est à côté d’elles quand le document déclare une norme qui demande à pouvoir les retrouver.
Archivage : un document qui déclare pdfa3b écrit ce qu’il dit de lui-même aux deux endroits, tandis qu’un document qui déclare pdfa4 n’écrit que le paquet — cette norme-là ne comporte aucune entrée. Une requête qui nomme une entrée par metadata.info sous pdfa4 est refusée, l’entrée n’ayant nulle part où aller.
Une requête entière qui crée un PDF
{
"metadata": {
"schemas": [
{
"name": "Board papers",
"namespace": "https://example.test/ns/board/",
"prefix": "board",
"properties": [
{
"name": "Sitting",
"value": "2026-08-08",
"description": "The day the board sat",
"value_type": "date",
"category": "external"
},
{
"name": "Present",
"value": { "bag": ["Claire Vasseur", "Jan de Vries"] },
"description": "Who sat",
"value_type": { "bag": "proper_name" }
},
{
"name": "Resolutions",
"value": {
"seq": [
{
"structure": [
{ "field": "Number", "value": "1" },
{ "field": "Carried", "value": "True" }
]
}
]
},
"description": "What the board resolved, in order",
"value_type": {
"seq": {
"name": "Resolution",
"namespace": "https://example.test/ns/resolution/",
"prefix": "res",
"description": "One resolution put to the vote",
"fields": [
{
"name": "Number",
"value_type": "integer",
"description": "Its number in the minutes"
},
{
"name": "Carried",
"value_type": "boolean",
"description": "Whether it was carried"
}
]
}
}
}
]
}
],
"title": "Minutes of the board meeting",
"author": "Claire Vasseur",
"subject": "Board meeting of 8 August 2026",
"creator": "The board secretariat system",
"created": "2026-08-08T10:00:00+02:00"
},
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 768 },
"content": ["Minutes of the board meeting"],
"font": "sans",
"font_size": 18
}
]
}
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, dit une seule fois Un texte que personne ne peut copier Les notes qu’un programme laisse pour lui-même 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