La version de PDF que le fichier déclare

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.

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.

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.

version fixe la version que la première ligne du fichier déclare. 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 glissées ; 1.6 l'ouverture sur la liste des pièces jointes et la mise à l'échelle à l'impression ; 1.7 les souhaits d'une boîte de dialogue d'impression ; 2.0 la taille d'impression retirée au lecteur. Rien n'est relevé à la place de l'appelant : un document qui déclare moins que ce qu'il porte est refusé à l'écriture, en nommant la partie qui demandait davantage.

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.

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

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

{
  "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 le lecteur affiche Cent courriers dans un seul fichier Ce que le document dit de lui-même Un fichier lisible dans trente ans Une facture qu'un humain et une machine lisent L'adresse contre laquelle les liens se lisent 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.
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.
transparence: De la peinture qui laisse revenir ce qui est dessous, dans une proportion annoncée. C'est ce qui fait qu'une mention posée en travers d'une page laisse lire le texte qu'elle recouvre, et qu'un surlignage est un surlignage et non un pâté. Le fichier dit quelle part passe ; celui qui dessine la page calcule la couleur qui en résulte.
PDF balisé: Un PDF qui range son texte en plus de le dessiner : ceci est un titre, ceci un tableau, cette case appartient à cette colonne. C'est ce qui permet au logiciel qui lit à voix haute, ou au programme qui récupère les chiffres, de comprendre la page.
requête: Un appel au service : vous envoyez ce que le document doit dire, et vous recevez le document. Votre facture compte ces appels, un par document. Le nombre de pages d'un document n'est jamais compté.
calque: Un groupe nommé de choses dessinées sur une page, que le lecteur peut afficher ou masquer, comme un calque posé sur un plan. Un plan peut garder ses cotes sur l'un et ses notes sur l'autre, et un calque peut être réglé pour s'afficher à l'écran et rester hors de l'impression.
annotation: Quelque chose posé sur une page plutôt que dessiné dedans : un rectangle cliquable, une case où taper, un bouton. Cela occupe sa propre place sur la feuille et c'est ce qui fait qu'un PDF répond à un clic.

Tous les mots que le site explique