Points de coupure après une barre oblique ou un trait 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.

Le troisième réglage ne nomme aucun caractère : c’est la ponctuation elle-même qui indique où un mot peut être coupé. Une barre oblique ou un trait d’union à l’intérieur d’un mot autorise la coupure ; la barre oblique qui ouvre un chemin reste en revanche avec le nom qu’elle introduit, une fraction n’est jamais coupée et une parenthèse n’est jamais séparée de son contenu.

Le quatrième réglage coupe lui aussi là où la ponctuation l’autorise, mais chaque mot composé y est écrit avec un trait d’union insécable : les chemins passent toujours à la ligne, tandis qu’un mot composé comme « fac-similé » reste entier sur sa ligne.

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é à la fin de la ligne qu’il termine.
  • De longs chemins renvoyés à la ligne sans inventer de trait d’union.
  • Coupures déduites de la ponctuation, sans caractère à nommer.
  • Un trait d’union insécable, qui garde le mot composé sur une seule ligne.

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.

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