Emporter sa police dans le document

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.

Une écriture est un fichier, comme une photo. Si le document se contente de dire « écris ça en telle écriture », il faut que la machine qui l'ouvre la possède déjà — et souvent elle ne l'a pas. La solution est simple : on glisse l'écriture dans le document lui-même. Le fichier pèse un peu plus lourd, et en échange il s'affiche exactement pareil sur n'importe quel écran et chez n'importe quel imprimeur.

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.

fonts porte les polices TrueType ou OpenType que la requête transporte elle-même, encodées en base64, chacune sous le nom par lequel les éléments la désignent. Un nom de police est résolu avant que quoi que ce soit soit dessiné, et dans trois endroits, du plus précis au plus général : les polices embarquées de la requête, celles conservées pour le client, celles de la bibliothèque du serveur. Le serveur ne conserve une police du client que si son droit le prévoit. Seul le sous-ensemble réellement utilisé est écrit dans le document.

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.

fonts — tableau, facultatif, vide par défaut.
fonts[].name — chaîne, obligatoire. Le nom sous lequel les éléments écrivent avec cette police, dans leur clé font.
fonts[].data — chaîne, obligatoire. Les octets du fichier de police, encodés en base64. Un encodage illisible est refusé en nommant la police.

Une police embarquée peut servir de base à une variante typographique (font_variants) et de maillon d'une chaîne de secours (font_chains). Un document qui déclare une norme d'archivage écrit ses polices dedans : c'est ce que fonts fait, là où les quatorze faces normalisées de standard_fonts ne voyagent pas avec le fichier.

Une requête entière qui le dessine

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

Un nom ci-dessous tient lieu d'un fichier de police : mettez le fichier encodé à sa place, ou envoyez le fichier lui-même à côté de la description, comme une partie du même appel.

{
  "fonts": [{ "name": "body", "data": "PASTE_THE_FONT_FILE_BASE64_HERE" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
      "content": ["Set in a font the file carries with it"],
      "font": "body",
      "font_size": 14
    }
  ]
}

La ligne qui l'envoie, en trois langages

Les lettres

Les anciens programmes de police Type 1 Les quatorze écritures que tout lecteur possède Les finesses typographiques d'une écriture Une écriture dont vous dessinez les lettres Une écriture de secours pour les signes rares

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.
octet: L'unité dans laquelle se compte le poids d'un fichier, comme un colis se compte en grammes. Mille octets font un kilo-octet, un million font un méga-octet — la taille d'une photo prise avec un téléphone. Un PDF d'une page pèse ici entre six mille et cent vingt mille, donc cent PDF tiennent dans la place de cinq photos.
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.
police: Le dessin de chaque lettre, de chaque chiffre et de chaque signe qu'un document écrit, rangé dans un fichier à part. Un PDF emporte à l'intérieur de lui-même les polices dans lesquelles il est composé : c'est pour cela qu'il s'ouvre à l'identique sur une machine qui ne les a jamais eues. Sans elles, un lecteur en met une autre à la place, et la mise en page bouge.
police allégée: Ne garder dans le fichier que les lettres réellement écrites, au lieu de tout l'alphabet de la police d'écriture. Une police contient des milliers de dessins ; une facture en emploie quelques dizaines. Ne garder que celles-là, c'est ce qui rend ces fichiers si légers.
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é.
serveur: Une machine qui attend des appels et y répond, jour et nuit, sans personne devant elle. Celle qui dessine les documents ici porte le moteur et rend les pages finies ; celle où tourne votre site est une autre machine qui fait le même genre de travail.
base64: Une façon d'écrire un fichier — une police, une image — avec seulement des lettres et des chiffres ordinaires, pour qu'il puisse voyager dans un texte. Cela grossit la chose d'environ un tiers et ne change rien d'autre.
TrueType: L'une des deux formes sous lesquelles arrive un fichier de police, et la plus courante. Elle porte le dessin de chaque lettre et de quoi la garder lisible en petit. Un document emporte le fichier avec lui.
OpenType: La forme la plus large d'un fichier de police : elle accepte les deux sortes de dessins de lettres et porte en plus les finesses typographiques — les paires qui se resserrent, les chiffres qui s'alignent en colonne, les petites capitales.

Tous les mots que le site explique