Des fichiers que le document nomme sans les contenir
Faire pointer le document vers un fichier rangé à côté de lui ou servi depuis une adresse, listé avec ses pièces jointes sans voyager à l’intérieur.
Le résultat dans un vrai PDF
Un dossier d’appel d’offres de trois lots
Trois lots, chacun joint au document comme un fichier séparé, décrits par les colonnes que le document définit lui-même — lot, jour d’envoi, montant — et triés du plus récent au plus ancien. La page de garde reprend les mêmes colonnes en clair, pour les logiciels de lecture qui n’affichent pas les fichiers joints.
Résumé
Certains fichiers sont trop lourds pour entrer dans un document : les relevés bruts d’une enquête, la vidéo d’une salle d’exposition. Le document peut quand même les désigner. Il les recense parmi ses pièces jointes, avec une phrase qui dit ce qu’est chacun, et le logiciel de lecture ouvre le fichier depuis le dossier placé à côté du document, ou va le chercher à son adresse. Rien du fichier ne voyage avec le document.
Techniquement
Écrit au premier niveau d’une requête, sous
"referenced_files"
Chaque entrée s’écrit comme une description de fichier dont le contenu est un chemin ou une adresse plutôt qu’un flux : un chemin du document vers un fichier placé à côté, ses parties séparées par une barre oblique et lues depuis le dossier qui contient le document, ou une adresse commençant par son protocole et écrite en ASCII sur 7 bits. Le fichier est désigné par son nom comme une pièce jointe l’est — par une page dans page_files, une image dans images, une partie dans document_parts — et listé parmi les fichiers du document, où le logiciel de lecture ouvre le chemin ou va chercher l’adresse. Le serveur ne va rien chercher. Un nom qu’une pièce jointe a déjà pris est repris, la pièce jointe restant rattachée au document entier.
Schéma de la requête
-
referenced_files— tableau, facultatif, vide par défaut. -
referenced_files[].name— chaîne, obligatoire. Le nom sous lequel le reste de la requête désigne le fichier. -
referenced_files[].payload— objet, obligatoire, contenant une seule des deux clés :beside, un chemin du document au fichier, résolu depuis le dossier qui contient le document (un chemin depuis la racine, un lecteur, une adresse ou une barre oblique inverse sont refusés) ;at, l’adresse d’où le fichier est servi, commençant par son protocole et écrite en ASCII sur 7 bits. -
referenced_files[].description— chaîne, obligatoire. Ce qu’est le fichier, en mots, pour la personne qui lit la liste des fichiers que le document nomme. -
referenced_files[].relationship— chaîne, obligatoire. Ce qu’est le fichier pour le document : une valeur parmisource,alternative,data,supplement,unspecified.
Un document qui nomme un fichier de cette façon déclare "version": "2.0", sinon le rendu revient en 400 ; un document qui déclare une partie de PDF/A n’en nomme aucun. Le fichier lui-même n’est jamais lu : un chemin qui ne mène nulle part est écrit quand même.
Une requête entière qui crée un PDF
{
"version": "2.0",
"referenced_files": [
{
"name": "readings",
"payload": { "beside": "survey/readings.csv" },
"description": "Every reading of the 2026 survey",
"relationship": "data"
}
],
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
"content": ["The survey, and the file of its readings beside 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 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 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