Du texte en paragraphes, avec retraits et tabulations

Mettre plusieurs paragraphes dans un cadre, avec retrait de première ligne, espace entre eux, listes à puces et colonnes de chiffres alignées.

Le résultat dans un vrai PDF

Des listes faites d’un retrait et d’un taquet

Des listes à puces, numérotées et imbriquées, bâties chacune sur un retrait négatif et un taquet de tabulation plutôt que sur un objet de liste dédié : la marque se place dans l’espace que le retrait ouvre, et chaque ligne après la première commence là où la tabulation a posé le texte.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Une page dont les lettres coûtent un octet chacune · Du texte coulé en colonnes · Retraits et espacement des paragraphes

Résumé

Une lettre, un contrat, des conditions générales : du texte qui court, et qui se range tout seul au fur et à mesure. Les lignes peuvent tenir le bord gauche, se placer au milieu, ou s’étirer jusqu’aux deux bords à la fois. Une puce reste seule dans la marge pendant que son texte revient bien aligné en dessous. Et une ligne de petits points peut aller d’un intitulé jusqu’à un prix, à la manière d’un sommaire.

Techniquement

Demandé avec "type": "flow"

Un élément flow prend le texte en une seule chaîne : un retour à la ligne termine un paragraphe, une tabulation avance au taquet suivant, et le résultat entre dans le flux de contenu de la page en texte positionné. Tout le bloc est composé dans une police et une taille uniques, ce qui laisse la place aux réglages de paragraphe, tous mesurés en points : retraits gauche, droit et de première ligne, espace avant et après, position de la première ligne de base et place gardée sous la dernière, alignement de la dernière ligne d’un paragraphe, caractère de points 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 à retrait négatif 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.

Schéma de la requête

Clés obligatoires : rect ; content, chaîne unique ; font ; font_size. Facultatives : align (left par défaut, 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) ; justified_tightening, pris en compte sous justify uniquement, objet aux clés word_gap (0.8 par défaut, espace minimale entre deux mots, en fraction de la largeur d’une espace), letter_spacing (-0.02 par défaut, resserrement maximal de l’approche entre un glyphe et le suivant, en cadratins rapportés au corps du texte) et scaling (97 par défaut, pourcentage de sa largeur en dessous duquel la ligne n’est jamais comprimée), toute autre clé étant refusée : pour ne pas renvoyer un mot à la ligne suivante, la ligne se resserre dans cet ordre et ne garde ce mot que si les trois réglages, poussés à leur limite, suffisent à le faire tenir ; justified_short_line, pris en compte sous justify uniquement, part de la largeur, de 0 à 1, qu’une ligne doit remplir pour être justifiée, une ligne plus courte étant alignée à gauche (0 par défaut) ; overlong (overflow par défaut, break) ; leading (1,2 × font_size par défaut) ; break_after ; break_at_punctuation ; replacing, objet dont chaque clé est un seul caractère, associée à {"each": "…"}, substitué à chaque occurrence du caractère, ou à {"run": "…"}, substitué une seule fois à chaque suite ininterrompue de ce caractère, avant la coupure des lignes, une chaîne vide supprimant le caractère ; color (noir par défaut) ; outline, objet à width, un nombre de points obligatoire, color (noir par défaut) et filled (false par défaut), les lettres cernées d’un trait sur leur pourtour, creuses tant que filled ne les remplit pas aussi ; 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" (par défaut), "ascender", "cap_height" ou {"points": n} ; last_baseline, valant "none" (par défaut), "descender" ou {"points": n}, la place que le bloc garde sous sa dernière ligne de base, celle contre laquelle se mesure l’interligne qui remplit une boîte, de sorte que deux blocs de longueurs différentes finissent sur une même ligne d’encre et non sur une même ligne de base ; leader, un caractère ; tabs, objet à method (relative par défaut, typewriter, ruler), size ({"fraction": n} ou {"points": n}, 7,5 % de la ligne par défaut), ruler (tableau de nombres, vide par défaut), alignments (tableau de left, center, right, decimal, vide par défaut), align_char (. par défaut) ; hanging_list, objet à marker et body, deux nombres, tous deux obligatoires ; fill_leading, objet à un seul limit obligatoire, un nombre de points, l’interligne que prennent les lignes pour que la dernière finisse sur le plancher du rectangle — les lignes sont écartées, et rien d’autre : la place gardée autour d’un paragraphe, la descente sous la dernière ligne de base et la hauteur du texte lui-même restent où elles sont, et un limit inférieur à l’interligne que le bloc prendrait laisse cet interligne où il est ; fit_size, objet à un seul floor obligatoire, un nombre de points, la taille que le bloc trouve lui-même pour que tout son texte tienne dans le rectangle — les tailles essayées descendent depuis celle que le bloc a demandée, chacune coupée à la boîte et pesée contre elle, et la plus grande qui contient le texte est celle à laquelle il est composé, tandis qu’une boîte qu’aucune taille ne remplit compose le texte au floor et le laisse déborder ; absent, le bloc est composé à la taille qu’il a demandée, quoi qu’il en déborde ; pages (vide par défaut) ; id ; relative_to ; transform ; rotate ; layer. Refus croisés : hanging_list avec left_indent, first_line_indent, tabs.method ou tabs.ruler ; fill_leading avec leading ; transform avec rotate. leader prend aussi un objet à la place d’un caractère : text, obligatoire, la chaîne répétée, de n’importe quelle longueur, ". " espaçant les points ; font et font_size, ceux du bloc par défaut ; color, celle du bloc par défaut ; rise, de combien de points au-dessus de la ligne de base les répétitions se posent, en dessous si le nombre est négatif, dessus par défaut ; fit, où les répétitions se placent dans l’espace qu’elles remplissent : from_text (par défaut), posées depuis les mots vers l’extérieur ; from_edge, finissant contre le bord opposé ; grid, sur une grille de la largeur d’une répétition comptée depuis le bord gauche de la boîte, pour que les répétitions de chaque ligne tombent dans les mêmes colonnes ; stretch, autant de répétitions entières qu’il en tient, espacées pour aller d’un bout à l’autre de l’espace. character_spacing, horizontal_scaling et cut_mark se lisent comme sur un bloc de texte. Trois clés font continuer le texte au-delà de son rectangle : continued_in, un tableau de rectangles aussi larges que rect, les boîtes où le texte continue une fois rect rempli, dans l’ordre ; max_lines, un entier, le nombre maximal de lignes qu’une boîte prend quelle que soit sa hauteur, zéro étant lu comme un ; box_break, un caractère lu dans le texte comme la fin d’une boîte, qui termine son paragraphe, ne dessine rien et envoie la suite du texte à la boîte suivante, le caractère de saut de page "\f" étant celui qu’un texte écrit ailleurs contient pour marquer un changement de page. Un bloc qui nomme l’une des trois pose dans chaque boîte les lignes qu’elle tient et ne dessine aucune des lignes restantes une fois la dernière boîte pleine ; une boîte d’une autre largeur que rect est refusée. rule_stacking, sur un élément flow ou text, dit si ce sont les filets qui couvrent les lettres ou l’inverse : "over", la valeur par défaut, trace les filets après les lettres, par-dessus, et "under" les trace d’abord et peint les lettres par-dessus.

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

{
  "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,
      "replacing": {"*": {"each": ""}, " ": {"run": " "}},
      "first_line_indent": 14,
      "space_after": 6,
      "first_baseline": "cap_height",
      "last_baseline": "descender",
      "overlong": "break",
      "tabs": {
        "method": "relative",
        "size": { "points": 36 },
        "ruler": [72, 180],
        "alignments": ["left", "decimal"]
      }
    },
    {
      "type": "flow",
      "rect": {"llx": 72, "lly": 600, "urx": 252, "ury": 630},
      "content": "Delivery\t12.50",
      "font": "serif",
      "font_size": 11,
      "leader": {"text": ". ", "fit": "grid"},
      "tabs": {"method": "ruler", "ruler": [180], "alignments": ["right"]}
    }
  ]
}

La ligne qui l’envoie, en trois langages

Texte

Un bloc de texte posé sur la page Un tampon en travers de la page Une ligne de mots posée le long d’un chemin Une rangée de glyphes demandés par leur numéro Des blocs posés les uns sous les autres, page après page

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les vingt-deux autres choses que l’on peut dessiner

Voir les prix Voir les exemples