Couper un mot trop long

Cet exemple compose deux fois le même paragraphe dans une colonne trop étroite pour l'un de ses mots : toute mise en page finit par rencontrer le mot qui ne rentre pas — un nom chimique, un mot composé allemand, une adresse web, une référence de commande à laquelle personne n'a pensé. Le mot surgit en production, sur un enregistrement sur mille, longtemps après que l'équipe a validé la mise en page, et il revient avec la référence suivante, quelle que soit la largeur donnée à la colonne. C'est le réglage overlong qui décide : overflow laisse le mot entier dépasser du bord, break le coupe après le dernier glyphe qui tient.

Laissé tranquille, le mot dépasse le bord droit et sort de la colonne, mord la marge et parfois quitte le papier — honnête, et laid. Si on lui dit de se couper, il est coupé après la dernière lettre qui tient et le reste passe à la ligne suivante : rien ne s'échappe plus de la colonne, quoi qu'il y arrive. Le choix se fait bloc par bloc, parce qu'une cellule étroite et un paragraphe de texte courant ne veulent pas la même réponse.

Ce que montre cet exemple

• Le même paragraphe qui déborde de la colonne, puis tenu à l'intérieur.
• Les deux compositions l'une au-dessus de l'autre sur la même page du PDF.
• Le même choix sur un bloc de texte, sur une cellule de tableau et sur du texte qui change de style en cours de route ; cet exemple ne montre que le bloc de texte.

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 13.6 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.