La version de PDF que le fichier déclare

Choisir la version que le document annonce, de 1.4 à 2.0, selon ce qu’il contient et selon l’âge des logiciels qui le liront.

Le résultat dans un vrai PDF

Une lettre par destinataire, toutes dans le même fichier

Quatre lettres personnelles derrière un sommaire. Les lettres n’ont pas de numéro de page : chaque destinataire reçoit les pages qui suivent la sienne, autant qu’il en faut. Chaque ligne du sommaire conduit à la lettre concernée.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Trois relevés dans un seul fichier · Une feuille qui mesure ce qu’elle annonce · Un dessin, placé autant de fois qu’on veut

Résumé

Le format PDF a plusieurs générations, comme les voitures ont des millésimes. La première ligne du fichier annonce la sienne, et c’est une promesse : voilà ce qu’il faut savoir faire pour m’afficher entièrement. Un logiciel plus ancien que la version annoncée montre ce qu’il sait et laisse le reste de côté, sans rien dire — c’est pour cela que le choix mérite d’être fait plutôt que subi.

Techniquement

Écrit au premier niveau d’une requête, sous "version"

version fixe la version que déclare la première ligne du fichier. Chaque version apporte ce que la bibliothèque écrit : 1.4 la transparence, le contenu balisé et le paquet de métadonnées ; 1.5 les calques, les doubles pages et les transitions par glissement ; 1.6 l’ouverture sur la liste des pièces jointes et la mise à l’échelle à l’impression ; 1.7 les souhaits que lit une boîte de dialogue d’impression ; 2.0 la taille d’impression soustraite au choix du logiciel de lecture. La version n’est jamais relevée à la place du client : un document qui déclare moins que ce qu’il contient est refusé au moment de l’écriture, en nommant ce qui en demandait plus.

Schéma de la requête

  • version — chaîne, facultative. Absente, le document est écrit en 1.7.
  • Cinq valeurs : "1.4", "1.5", "1.6", "1.7", "2.0".
  • archive fixe la version de son côté : pdfa3b impose 1.7, pdfa4 impose 2.0. Une version écrite dans la requête est appliquée après.
  • Demandes connues : les calques et les flux d’objets veulent 1.5 ; les souhaits d’impression de reading veulent 1.7 ; reading.lock_actual_size et les ordres de tabulation annotations et widgets veulent 2.0.

Une requête entière qui crée un PDF

{
  "version": "2.0",
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 762 },
      "content": ["This file announces PDF 2.0"],
      "font": "sans",
      "font_size": 14
    }
  ]
}

La ligne qui l’envoie, en trois langages

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 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

Voir les prix Voir les exemples