Les finesses typographiques d'une écriture

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 belle écriture cache des raffinements que les livres utilisent depuis des siècles. Certaines paires de lettres se dessinent d'un seul trait pour éviter qu'elles se cognent. Les majuscules peuvent être petites, à hauteur des minuscules, pour un titre discret. Les chiffres peuvent monter et descendre comme des lettres, au lieu d'être tous alignés. Et l'espace entre deux lettres peut se resserrer là où l'écriture le demande. On allume ce qu'on veut, et on obtient une écriture de plus, sous un nom à soi.

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.

font_variants fabrique une police de plus à partir d'une autre, avec des réglages typographiques allumés, et la met à disposition sous son propre nom. La police d'origine reste telle qu'elle est : les deux coexistent dans la même requête. Les quatre réglages s'allument séparément, ce qui permet de montrer côte à côte le même texte avec et sans. La police de base est une police embarquée, une police du client ou une police de la bibliothèque.

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.

font_variants — tableau, facultatif, vide par défaut.
font_variants[].name — chaîne, obligatoire. Le nom de la variante.
font_variants[].from — chaîne, obligatoire. Le nom de la police d'origine : une police embarquée (fonts), une police du client, ou une police de la bibliothèque du serveur.
font_variants[].ligatures — booléen, facultatif, false par défaut. Joint les paires de lettres que la police dessine d'un seul trait.
font_variants[].small_capitals — booléen, facultatif, false par défaut. Dessine les minuscules en petites capitales.
font_variants[].oldstyle_figures — booléen, facultatif, false par défaut. Dessine les chiffres montants et descendants comme des minuscules.
font_variants[].kerning — booléen, facultatif, false par défaut. Resserre l'espace de chaque paire selon ce que la police en dit.

Ce que la variante rend dépend des tables que la police porte : une police sans table de ligatures rend le même texte que sa base. Un nom déjà pris par une autre police est refusé.

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" }],
  "font_variants": [
    { "name": "body_small_capitals", "from": "body", "small_capitals": true }
  ],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
      "content": ["Chapter one"],
      "font": "body_small_capitals",
      "font_size": 16
    }
  ]
}

La ligne qui l'envoie, en trois langages

Les lettres

Emporter sa police dans le document Les anciens programmes de police Type 1 Les quatorze écritures que tout lecteur possède 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.
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.
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.
ligature: Deux lettres dessinées d'un seul tenant parce qu'elles se heurtent quand on les compose séparément, comme un f suivi d'un i. La police porte le dessin joint.

Tous les mots que le site explique