Ce que le document dit de lui-même

En mots de tous les jours

Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.

Sur la tranche d'un classeur, on écrit ce qu'il y a dedans : le titre, qui l'a préparé, de quoi ça parle, de quand ça date. Un document numérique fait pareil, sauf que c'est le logiciel qui lit l'étiquette. Elle sert à retrouver le fichier plus tard, à le classer, à savoir ce qu'on tient sans l'ouvrir. Une entreprise qui a son propre vocabulaire de classement peut ajouter ses propres lignes à cette étiquette.

Pour un développeur

Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.

metadata porte ce que le document déclare sur lui-même. Chaque champ est un champ qu'une norme d'archivage sait faire correspondre entre les entrées propres du document et son paquet de métadonnées : c'est cette correspondance qu'un contrôleur de conformité vérifie. Un vocabulaire propre à l'appelant s'ajoute par schemas, avec ses propriétés et leur description, cette dernière permettant à un validateur d'accepter des noms que la norme n'a jamais connus.

Chaque clé, avec son défaut

La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.

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'il est.
metadata.producer — chaîne, facultative. Ce qui l'a fabriqué.
metadata.created — chaîne, facultative. La date, en ISO 8601, par exemple 2026-08-08T10:00:00+02:00.
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 dire no.
metadata.schemas — tableau, facultatif, vide par défaut. Les vocabulaires propres à l'appelant.
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, vide refusé.
properties[].name, properties[].value, properties[].description — chaînes, toutes obligatoires ; une description vide est refusée.
properties[].value_type — chaîne, facultative, text par défaut. Neuf valeurs : boolean, date, integer, mime_type, proper_name, real, text, uri, url.
properties[].category — chaîne, facultative, internal par défaut. Deux valeurs : internal, external.

Un champ que le paquet de métadonnées ne sait pas porter est prévu pour une version future du schéma. 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.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

{
  "metadata": {
    "title": "Minutes of the board meeting",
    "author": "Claire Vasseur",
    "subject": "Board meeting of 8 August 2026",
    "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
    }
  ]
}

La ligne qui l'envoie, en trois langages

Le document dans son ensemble

Les numéros que le lecteur affiche Cent courriers dans un seul fichier Un fichier lisible dans trente ans 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

Où aller ensuite

Chaque clé d'une requête, en une page Les trente-deux autres réglages d'une requête

Voir les prix Voir les exemples

Glossaire

bibliothèque PDF: Un logiciel que vos propres programmes utilisent pour écrire des documents PDF. Il n'a ni fenêtre ni bouton : votre programme lui dit quoi dessiner, et il rend le fichier fini. Ce site l'appelle aussi le moteur, c'est la même chose sous un autre nom. Le serveur est un second programme, qui contient le moteur et répond à qui lui demande un document par le réseau ; et le service de rendu, c'est ce serveur quand il tourne sur nos machines plutôt que sur les vôtres.
norme: Une règle débattue en commission, publiée sous un numéro que n'importe qui peut acheter et lire, et identique pour toutes les entreprises qui s'en réclament. Dire qu'on la suit peut donc être vérifié face au texte. Une façon de faire qui s'est simplement répandue parce qu'elle marchait est une habitude du métier : utile, très suivie, et qui ne répond devant aucun texte.
la carte d'identité d'un fichier: Le bloc écrit à l'intérieur d'un fichier qui dit ce qu'est ce fichier : son titre, qui l'a fait, quand, et quelles règles il suit. Les moteurs de recherche et les archives le lisent ; un lecteur ne le voit jamais. Son nom technique est XMP.
CMJN: Les quatre encres d'une imprimerie : le cyan (un bleu), le magenta (un rose), le jaune et le noir. Un écran, lui, fabrique ses couleurs avec de la lumière. Un document qui part à l'impression dit donc ses couleurs en encres, et non en couleurs d'écran.

Tous les mots que le site explique