Configuration : veuves, orphelines et équilibrage

#Orphelines, veuves, lignes creuses et règles de maintien

Voir Césure et justification pour le mécanisme de ces pénalités. Cette section est la référence des clés de bodyText qui les pilotent.

Au-delà de la césure et des limites d’espacement, la configuration du texte courant expose les règles souples qui empêchent les coupures de paragraphe maladroites du point de vue de la structure. Toutes sont injectées comme pénalités (demerits) dans l’algorithme de coupure des lignes de Knuth-Plass : elles orientent la mise en page vers des coupures propres sans jamais imposer de règle stricte. Réglez les valeurs *Penalty sur 0 pour désactiver en pratique l’une d’entre elles.

À propos des lignes creuses. Une ligne creuse est la dernière ligne d’un paragraphe trop courte pour passer pour une vraie ligne de texte : en général un ou deux mots courts échoués en fin de paragraphe. Comme la vérification repose sur la longueur en pixels de la ligne rapportée à la largeur normale de l’espace, runtMinCharacters s’adapte automatiquement au corps en cours. Un mot court visuellement plus large que runtMinCharacters × spaceWidth ne pose pas de problème ; un mot plus étroit (ou vraiment isolé) attire la pénalité de ligne creuse. Le seuil compte des espaces entre les mots, qui sont environ deux fois moins larges que les lettres : la valeur par défaut de 20 correspond à une dernière ligne d’environ 8 à 12 lettres. Toute ligne creuse coûte la pénalité entière : entre deux fins sous le seuil, le moteur de coupure garde les lignes plus serrées au-dessus ; gradedRuntPenalty évalue plutôt chacune selon ce qui lui manque, et la fin la plus longue l’emporte. Pour les esprits mathématiques : avec la runtPenalty par défaut de 1000, éviter une ligne creuse l’emporte sur tout autre jeu de coupures qui demanderait un étirement de l’espacement des mots allant jusqu’à environ r≈2,15.

Souples, pas strictes. Aucune de ces règles ne peut empêcher une coupure : le moteur produit toujours une mise en page. Ce sont des pénalités : l’algorithme met en balance la « badness », le coût de la césure, la régularité des classes d’ajustement et ces pénalités structurelles dans une seule optimisation globale, et retient le jeu de coupures au coût total le plus bas. Si vous avez besoin d’une garantie plus ferme, augmentez la pénalité ; si un document se lit mieux avec une pénalité relâchée, diminuez-la.

#Équilibrage des colonnes

Les éditeurs attendent que chaque colonne commence en haut de la page et se termine au ras de son bas. Les règles de coupure (protection contre les veuves et les orphelines, titres gardés avec leur texte, figures indivisibles) laissent naturellement des colonnes courtes, avec une ou plusieurs lignes vides de la grille de ligne de base en bas. Quand l’équilibrage est activé, le moteur fait ce que ferait un compositeur, en appliquant ses leviers par ordre de priorité éditoriale :

1. Un encadré qui ferme la colonne : un encadré qui termine une colonne courte est descendu exactement de la place libre sous son pied, si bien que son bord inférieur tombe sur la dernière case de la grille de la page, à la hauteur de la dernière ligne de la colonne voisine. Il prend cette place même quand elle fait moins d’une ligne, tant que rien ne passe dans une autre colonne. Par défaut, ce levier passe avant tous les autres et prend tout l’écart, si bien qu’un encadré qui annote le paragraphe au-dessus de lui peut se retrouver plusieurs lignes plus bas ; closingBox: 'last' laisse les titres, les fins de liste et les autres leviers d’espacement prendre d’abord les lignes entières, l’encadré ne prenant que ce qu’ils laissent, et closingBox: 'off' ne le déplace jamais.
2. Images avec zone sûre : une image dotée d’une zone sûre (Resource.safeArea, voir Format de document › Zone sûre) placée en ligne dans la colonne courte, ou flottant en tête ou au pied de cette seule colonne, grandit par lignes entières de la grille, recadrée dans sa zone sûre, jusqu’à ce que la colonne soit pleine ou que le recadrage atteigne la zone sûre. Une image plus haute ne laisse aucun trou sur la page : ce levier passe donc avant tout ajout d’espace ; un flottant en tête de colonne sur une page ou une bande dont les têtes de colonne restent alignées (voir plus bas) ne grandit pas. Enregistré comme flexFigure. Il n’a pas de réglage propre : seule une image dont la ressource marque une zone sûre peut grandir.
3. Titres : des lignes entières de la grille sont ajoutées à la marge supérieure des titres de la colonne courte. Quand plusieurs lignes sont nécessaires et que la colonne contient plusieurs titres, les lignes sont réparties entre eux, la plus grande part allant toujours au titre le plus important (un h2 reçoit plus qu’un h3). Les titres placés tout en haut d’une colonne ne reçoivent jamais d’espace supplémentaire, pour que les colonnes continuent de commencer en haut de la page, sauf un titre placé juste sous une figure ou un tableau qui ouvre sa colonne sur une page dont le flux continue : la place va au-dessus de ce titre, sous la figure. Un titre prend au plus maxLinesBeforeLoose lignes de cette façon (deux par défaut) avant que les leviers suivants soient essayés, et ses lignes supplémentaires, jusqu’à maxLinesPerHeading, seulement quand ceux-ci n’ont plus rien à donner.
4. Fins de liste : quand les titres ne peuvent pas absorber tout l’écart, une ligne de la grille est ajoutée là où se termine une liste ou une énumération (un espace après une liste se lit naturellement), avec un plafond par fin de liste.
5. Sous les formules, les encadrés et les figures : ensuite, une ligne de la grille va sous une formule hors texte ou un encadré après lesquels le texte reprend (stretchAfterDisplays ; elle se lit comme la marge propre de l’élément), et sous une figure ou un tableau qui ouvre la colonne (stretchAfterFloats, plafonné par maxLinesAfterFloat).
6. Paragraphes lâches : en dernier recours, un paragraphe de la colonne est recoupé avec une ligne de plus (le \looseness=+1 de TeX), en choisissant le paragraphe le plus long pour que l’espacement supplémentaire entre les mots se dilue de façon invisible. La solution lâche n’est acceptée que si chaque ligne reste sous bodyText.maxWordSpacing : le gris typographique ne dépasse jamais la limite que vous avez déjà configurée. Nécessite bodyText.optimalLineBreaking.

Sur une grille de caractères (cjk.grid, voir Composition chinoise › La grille de caractères), chaque caractère occupe une case d’un em de large et chaque ligne suit le pas de ligne de la grille, qui est aussi la grille de ligne de base. L’équilibrage y est désactivé par défaut, comme en texte vertical : une page composée ligne à ligne sur une grille, à la manière dont GB/T 9704 compte 22 lignes de 28 caractères, laisse une colonne courte telle quelle. Une configuration qui pose enabled: true obtient des leviers qui respectent la grille : les titres, les fins de liste, les formules hors texte et les figures prennent des lignes entières de la grille, de sorte que le texte qui les suit se déplace par rangées entières, et gridLines: 'off' les exclut pour une norme qui n’a aucune rangée vide à donner. Un paragraphe chinois ou japonais ne s’allonge d’une ligne que si aucun intervalle entre deux de ses caractères ne s’élargit au-delà de maxTracking, et ses lettres ne reçoivent aucune approche : une ligne à qui il manque un caractère répartit un em sur ses intervalles, bien au-delà des 0,01 em par défaut, si bien que sur une grille de cases entières le levier des paragraphes lâches ne trouve généralement rien. L’encadré qui ferme une colonne et les images avec zone sûre sont hors grille par conception et fonctionnent comme partout ailleurs.

La dernière colonne d’une page n’est équilibrée que si la page se poursuit naturellement sur la suivante : la page de fin d’un chapitre se termine légitimement plus court. Une telle page, ainsi qu’une bande finale coupée à niveau par trailing, garde aussi ses têtes de colonne alignées : aucune ligne n’est ajoutée sous une figure ou un tableau qui ouvre l’une de ses colonnes (le levier après flottant), et un titre ou un encadré qui ouvre une colonne sous une telle figure reste en tête, quoi que dise stretchAfterFloats, de même que le titre placé juste sous une ouverture span: 'page' dans la colonne de l’ouverture, de sorte qu’une colonne ne commence jamais plus bas que sa voisine dans le seul but d’aligner les pieds.

#Quel levier a agi

La mise en page enregistre chaque levier qu’elle a appliqué, sur le bloc auquel elle l’a appliqué : block.balancing dans le VDT que renvoie buildDocument. Une épreuve, un test ou un rapport peut ainsi dire pourquoi une colonne se termine au ras du bas, et quelles colonnes aucun levier n’a pu fermer. Les blocs que l’équilibrage n’a pas touchés ne portent pas de balancing, et un document construit avec enabled: false n’en a aucun.

Sur une grille de caractères, le document dit pourquoi une colonne peut se terminer court : doc.gridBalancing vaut { off: true } quand l’équilibrage est désactivé parce que la page est sur une grille et que la configuration ne l’active pas, et { gridLines: 'off' } quand il tourne sans les leviers à lignes entières ; une colonne restée courte porte column.gridRefused, les leviers que la grille lui a refusés ('looseParagraph' quand un paragraphe ne pouvait gagner sa ligne qu’en écartant ses caractères hors de leurs cases, les leviers à lignes entières avec gridLines: 'off'). Les deux sont absents hors grille.

interface VDTBalancing {
  levers: BalanceLever[]; // usually one: a paragraph after a list can take the list-end line and run a line long too
  spaceAbove: number;     // px the spacing levers added above the block (0 when only looseParagraph or flexFigure fired)
  bodyGrowth?: number;    // flexFigure: px the picture grew, cropped within its safe area
  extraLines?: number;    // looseParagraph: lines the paragraph gained
  tracking?: number;      // looseParagraph: the tracking that gained them, in thousandths of an em (0 = word spacing alone)
}
type BalanceLever = 'trailingCallout' | 'flexFigure' | 'heading' | 'listEnd' | 'afterDisplay' | 'afterFloat' | 'looseParagraph';

Les coupes à niveau sont enregistrées sur les colonnes qu’elles coupent : column.bandCapped vaut true sur chaque colonne coupée à niveau (la bande qu’un encadré sur toute la largeur de la page laisse derrière lui, une bande finale), et column.trailingCap marque en plus la bande finale d’un chapitre ou du document (trailing).

import { buildDocument } from 'postext';
 
const doc = buildDocument(content, config);
for (const page of doc.pages) {
  page.columns.forEach((column, i) => {
    const levers: string[] = column.blocks.flatMap((block) => block.balancing?.levers ?? []);
    if (column.trailingCap) levers.push('closing band cut level');
    else if (column.bandCapped) levers.push('band cut level');
    if (levers.length > 0) console.log(`page ${page.index + 1}, column ${i + 1}: ${levers.join(', ')}`);
  });
}
// page 3, column 1: heading, heading
// page 3, column 2: listEnd, looseParagraph