Un rapport qui se met en page tout seul

Placer une page à la main, c’est savoir avant d’écrire un mot quelle hauteur fera chaque paragraphe. Traduisez-en un et tous les nombres du dessous sont faux ; ajoutez une ligne à un tableau et la note de bas de page se pose sur le numéro de page. L’addition arrive des mois plus tard, quand le rapport doit changer et que rien dans le code ne dit lesquels de ses nombres le tenaient debout.

L’endroit où les deux pages se séparent n’est pas choisi à la main non plus, et c’est pourquoi le rapport français et l’anglais ci-dessous sortent d’un seul et même programme : le français est plus long, la coupure tombe ailleurs, et rien n’a eu à être ajusté pour cela. La seule hauteur que quelqu’un ait fixée dans cet exemple est celle où se pose le numéro de page — et elle appartient à la page, pas à ce qui est dit dessus.

Ce que montre cet exemple

  • Des blocs empilés dans l’ordre de lecture : du texte, un tableau, des filets et des espaces.
  • Un tableau coupé entre deux lignes, sa ligne d’en-tête reprise sur la page suivante.
  • Un paragraphe gardé d’un seul tenant plutôt que laissé avec une ligne toute seule.

Le code source complet

Rien n’est omis et rien n’est simplifié : c’est le programme exactement tel qu’il tourne, pour le développeur qui utilise cette bibliothèque. La troisième est la description elle-même : une simple liste de ce que la page doit dire, et c’est elle qu’on envoie au service.

Voir le code Rust Voir le code Python Voir le code JSON

Le document lui-même

Ouvrir le document en anglais Ouvrir le document en français Ouvrir le document en allemand Ouvrir le document en espagnol Ouvrir le document en italien Ouvrir le document en portugais

Exemples proches de celui-ci

Couper un mot trop long

Un mot plus long que la colonne qui le contient : la bibliothèque le laisse entier, le coupe au bord de la colonne, ou le coupe en finissant la ligne par un trait d’union.

Points de coupure après une barre oblique ou un trait d’union

Une colonne justifiée, quatre fois : des chemins de fichiers et des mots composés qui débordent faute de point de coupure, puis qui passent à la ligne là où une coupure est permise après une barre oblique ou un trait d’union, ensuite partout où leur ponctuation l’autorise, enfin avec des traits d’union insécables qui gardent chaque mot composé entier.

Une pile mise en page à la main, cadre par cadre

Un bon de livraison réparti dans deux cadres, le second reprenant là où le premier s’est arrêté, et une affiche dont l’image ne tient dans aucun cadre ; chaque cadre indique ce qu’il est advenu de sa pile.

Une police derrière la police

Une même ligne d’états composée deux fois : d’abord dans la police de l’entreprise seule, où les caractères dont elle n’a pas le glyphe sortent en cases vides ; puis avec une seconde police derrière elle, qui trace ces caractères.

Tous les exemples, par sujet