write_flow_break.json
Le fichier JSON de l’exemple « 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.
Ce fichier est une requête : une application l’envoie par le réseau au serveur, qui crée le PDF et le renvoie. Il crée la même page que les versions Rust et Python de cet exemple. Une requête nomme chaque fichier qu’elle emploie, jamais le contenu de ces fichiers ; l’appel transmet la requête et les fichiers ensemble. Une police que le serveur détient déjà, comme DejaVuSans, se nomme sans rien y joindre. Envoyez la requête à l’adresse que donne la page de l’API.
À quoi sert cet exemple
Cet exemple compose trois 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, et une marque de coupure, quand on en donne une, termine par un trait d’union chaque ligne qu’une coupure achève.
Ce que montre cet exemple
- Le même paragraphe qui déborde de la colonne, puis tenu à l’intérieur, puis tenu à l’intérieur avec un trait d’union à chaque coupure.
- Les trois 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.