Du texte en paragraphes, avec retraits et tabulations

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.

C'est le morceau qui sert à écrire un vrai texte suivi : plusieurs paragraphes les uns sous les autres, comme dans une lettre ou un contrat. Vous décidez du retrait de la première ligne, de l'espace laissé entre deux paragraphes, et de la façon dont les lignes se rangent : au bord gauche, au milieu, ou bien étirées jusqu'aux deux bords. Vous pouvez aussi demander une liste à puces, où la puce reste seule à gauche et le texte revient bien aligné en dessous. Et si vous voulez une ligne de petits points qui va d'un intitulé jusqu'au prix, à la manière d'un sommaire, il suffit de la demander.

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.

Un article flow prend le texte en une seule chaîne : un retour à la ligne termine un paragraphe, une tabulation avance au taquet suivant. Tout le bloc est composé dans une police et une taille uniques, ce qui laisse la place aux réglages de paragraphe : retraits gauche, droit et de première ligne, espace avant et après, position de la première ligne de base, alignement de la dernière ligne d'un paragraphe, caractère de conduite. Les taquets se règlent par pas relatifs, à la machine à écrire, ou par une règle de positions explicites, chacun aligné à gauche, au centre, à droite ou sur un caractère décimal. La liste à puce est un raccourci qui pose d'un coup le retrait gauche, le retrait de première ligne et le taquet du corps de la liste.

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.

Clés obligatoires : rect ; content, chaîne unique ; font ; font_size. Facultatives : align (défaut left, puis right, center, justify) ; last_align, alignement de la dernière ligne de chaque paragraphe (absent : comme le reste, sauf sous justify où elle se range à gauche) ; overlong (overflow par défaut, break) ; leading (défaut 1,2 × font_size) ; break_after ; color (défaut noir) ; shadow (dx, dy, color, les trois obligatoires) ; left_indent, right_indent, first_line_indent, nombres de points, le dernier acceptant une valeur négative qui sort la première ligne à gauche des autres ; space_before, space_after ; first_baseline, valant "leading" (défaut), "ascender", "cap_height" ou {"points": n} ; leader, un caractère ; tabs, objet à method (relative par défaut, typewriter, ruler), size ({"fraction": n} ou {"points": n}, défaut 7,5 % de la ligne), ruler (tableau de nombres, défaut vide), alignments (tableau de left, center, right, decimal, défaut vide), align_char (défaut .) ; hanging_list, objet à marker et body, les deux nombres obligatoires ; pages (défaut vide) ; id ; relative_to ; transform ; rotate ; layer. Refus croisés : hanging_list avec left_indent, first_line_indent, tabs.method ou tabs.ruler ; transform avec rotate.

Une requête entière qui le dessine

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

{
  "standard_fonts": [{"name": "serif", "face": "times_roman"}],
  "items": [
    {
      "type": "flow",
      "rect": {"llx": 72, "lly": 640, "urx": 523, "ury": 780},
      "content": "First paragraph, set in one font.\nSecond paragraph, indented.",
      "font": "serif",
      "font_size": 11,
      "first_line_indent": 14,
      "space_after": 6
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

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.

ligne de base

La ligne invisible sur laquelle les lettres posent, celle qui est réglée en travers d'une page de cahier. Où atterrit une ligne de texte se dit par où atterrit sa ligne de base, et l'écart entre deux d'entre elles est ce qui fait paraître un texte aéré ou serré.

Tous les mots que le site explique