Couper aux barres obliques et aux traits d'union

Si on ne coupe qu'aux espaces, un chemin de fichier devient un mot très long. Un mot composé aussi, et une référence de pièce pleine de barres obliques aussi — et c'est précisément de cela qu'un document technique est fait. Une colonne confortable pour de la prose est bien trop étroite pour eux, et l'élargir pour satisfaire le pire d'entre eux gâche la page pour tout le reste.

La coupure garde le caractère sur la ligne à laquelle il appartient : la barre oblique reste en fin de ligne du haut au lieu d'ouvrir celle du bas. Aucun trait d'union n'est inventé : rien n'est ajouté au texte qui n'y était pas écrit.

Ce que montre cet exemple

• Des points de coupure permis après une barre oblique et après un trait d'union.
• Le caractère de coupure gardé en fin de la ligne qu'il termine.
• De longs chemins repliés sans inventer de trait d'union.

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

Optimisé, ce document pèse 11.9 ko — au moins 85 % de moins que ce qu'écriraient la plupart des générateurs de PDF

Le document est plus léger qu'avant, et chaque page a exactement le même aspect. Voir la ligne de ce document dans le tableau de tous les exemples.