Saltar al contingut principal
Recepta número 184

Receptari · Capítol 2 · Text i tipografia

Prosa justificada sense repeticions als extrems de línia

Una pàgina de Clarín composta dues vegades en una mesura estreta: les primeres proves assenyalen cada repetició; les segones la pesen en el tall de línies.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.73.0
Requereix ≥ 1.73.0
Llicència
Actualitzada el 10 de nov. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 115 × 180 mm
  • 1 columna
  • Spectral 9,6/13,4
  • Cormorant Garamond
  • Spectral SC
  • 8 pàgines
  • Nivell
  • Postext 1.73.0
  • Compost en 33 ms
  • 180 línies de codi

En poques paraules

Quan dues línies seguides acaben o comencen amb la mateixa paraula, la vista pot saltar a la línia equivocada. El llibre es compon dues vegades: una ensenya on passa i l'altra talla les línies perquè no passi.

Què compondràs

Dues proves d'una pàgina de butxaca de 115 × 180 mm amb el començament d'¡Adiós, Cordera!, de Clarín, justificat en Spectral sobre una mesura de 83 mm. Una mesura estreta deixa al tallador de línies poques sortides, i en cinc llocs dues línies seguides acaben o comencen igual: con sobre como, lo sobre los, levantar sobre vacilar. Les primeres proves es componen amb stacks: 'warn': no canvien cap tall, avisen de cada repetició, marquen les dues paraules amb una banda vermell pàl·lid i les llisten en una papereta després del colofó. Les segones es componen amb 'avoid', i les cinc desapareixen. L'edició anglesa compon de la mateixa manera el començament d'A Christmas Carol.

Aquesta recepta respon a

  • Com evito que dues línies seguides acabin o comencin amb la mateixa paraula?

La resposta curta

script.js · línies 41–58al codi complet
const bodyText = {
  fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  textAlign: 'justify', firstLineIndent: mm(4), indentAfterHeading: false,
  hyphenation: { enabled: true }, optimalLineBreaking: true, // stacks need the K–P breaker
  avoidWidows: true, avoidOrphans: true, avoidRunts: true,
  // A stack: two lines in a row that end on the same word or the same last characters
  // (“sole” over “sole”), or that start alike (“The” over “the”). 'warn' reports each one
  // and changes nothing; 'avoid' adds stackPenalty to the demerits of every break that
  // makes one, so the breaker sets the paragraph another way where the spacing allows.
  stacks: 'avoid', // the first proof sets 'warn' (see proofs)
  // Three characters by default; the Spanish rule counts a repeated syllable (co-/co-).
  stackMinCharacters: t({ en: 3, es: 2 }),
  // Default 3000, the cost of two hyphens in a row; a monosyllable (“his”, “lo”) costs twice.
  // 3000 kept two stacks of the first proof per edition: 10000 trades them for looser lines.
  stackPenalty: 10000,
  maxWordSpacing: 2, // the default: past it a line is never set, stack or not
};

Ingredients

Tipografia
Spectral, Spectral SC, Cormorant Garamond (SIL OFL 1.1)
Recursos
  • carol-1100.jpg
  • cordera-1100.jpg
  • Painting: Scrooge's counting-house on a foggy Christmas Eve (Generated With Diffusion Models, original)
  • Painting: Rosa, Pinín and the Cordera by the telegraph pole (Generated With Diffusion Models, original)

Elaboració

#1 · Primer avisar, després pesar

script.js · línies 41–58al codi complet
const bodyText = {
  fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  textAlign: 'justify', firstLineIndent: mm(4), indentAfterHeading: false,
  hyphenation: { enabled: true }, optimalLineBreaking: true, // stacks need the K–P breaker
  avoidWidows: true, avoidOrphans: true, avoidRunts: true,
  // A stack: two lines in a row that end on the same word or the same last characters
  // (“sole” over “sole”), or that start alike (“The” over “the”). 'warn' reports each one
  // and changes nothing; 'avoid' adds stackPenalty to the demerits of every break that
  // makes one, so the breaker sets the paragraph another way where the spacing allows.
  stacks: 'avoid', // the first proof sets 'warn' (see proofs)
  // Three characters by default; the Spanish rule counts a repeated syllable (co-/co-).
  stackMinCharacters: t({ en: 3, es: 2 }),
  // Default 3000, the cost of two hyphens in a row; a monosyllable (“his”, “lo”) costs twice.
  // 3000 kept two stacks of the first proof per edition: 10000 trades them for looser lines.
  stackPenalty: 10000,
  maxWordSpacing: 2, // the default: past it a line is never set, stack or not
};

Hi ha repetició quan dues línies seguides acaben en la mateixa paraula o en els mateixos últims caràcters, o comencen igual. stackMinCharacters fixa quants caràcters calen: tres per defecte, amb els espais, sense comptar accents ni majúscules, de manera que Los sobre los compta. 'warn' només avisa, i així qui compon veu on es repeteix un text. 'avoid' suma stackPenalty als demèrits de cada tall que produiria una repetició, i el tallador de Knuth–Plass busca una altra manera de partir el paràgraf. Necessita optimalLineBreaking: el tallador voraç no té demèrits als quals sumar res.

Els manuals de composició en castellà compten la repetició entre els vicis de composició, al costat dels rius i les escales de guionets. En tornar al marge esquerre, la vista es pot enganxar a la paraula repetida a la línia equivocada i llegir dues vegades una línia o saltar-se'n una; al marge dret, la repetició sona a eco. La norma castellana arriba també a la síl·laba repetida, no només a la paraula, i per això l'edició castellana fixa stackMinCharacters en 2.

La penalització per defecte, 3000, és el que costen dos guionets seguits, i una paraula repetida d'una sola síl·laba costa el doble. En aquesta mesura, 3000 deixava dues repeticions a cada edició, perquè l'alternativa era una línia més oberta del que el tallador accepta. Amb 10000 accepta aquestes línies. maxWordSpacing es queda en el valor per defecte, 2: amb un límit més estret el tallador no tenia cap altre tall per triar i 'avoid' no canviava res.

#2 · Marcar les repeticions al text

script.js · línies 173–201al codi complet
// A warning names its first line by its place in the source. The repeated edge of that
// line and the next is found in each line's stretch of the source and the whole word
// around it wrapped in :mark[…]: a band under ordinary text, so the breaks stay the same.
const LETTER = /[\p{L}\p{N}’-]/u;
const edgeOf = (text, n, end) => { // the words at a line's edge holding its first/last n
  const s = text.replace(end ? /[^\p{L}\p{N}]+$/u : /^[^\p{L}\p{N}]+/u, '');
  const cut = end ? s.lastIndexOf(' ', s.length - n) + 1 : s.indexOf(' ', n);
  return end ? s.slice(cut) : s.slice(0, cut < 0 ? undefined : cut);
};
function markStacks(source, doc, stacks) {
  const lines = doc.blocks.flatMap((b) => b.lines.map((line, i) => [line, b.lines[i + 1]]));
  const spans = new Map(); // start → end of each marked word in the source
  for (const w of stacks) {
    const pair = lines.find(([line]) => line.sourceStart === w.sourceStart);
    for (const line of pair?.[1] ? pair : []) {
      const piece = edgeOf(line.text.trim(), w.text.length, w.edge === 'end');
      const range = source.slice(line.sourceStart, line.sourceEnd);
      let from = line.sourceStart
        + (w.edge === 'end' ? range.lastIndexOf(piece) : range.indexOf(piece));
      if (from < line.sourceStart) continue;
      let to = from + piece.length; // a piece of a hyphenated word takes the whole word
      while (from > 0 && LETTER.test(source[from - 1])) from--;
      while (to < source.length && LETTER.test(source[to])) to++;
      if (!/[*_[\]\n]/.test(source.slice(from, to))) spans.set(from, to);
    }
  }
  return [...spans].sort(([x], [y]) => y - x).reduce((md, [from, to]) => `${md.slice(0, from)}`
    + `:mark[${md.slice(from, to)}]{style="stack"}${md.slice(to)}`, source);
}

Cada avís dona la posició al text font de la primera línia, així que l'script busca aquesta línia i la següent al document compost, pren l'extrem repetit de cadascuna i embolica la paraula sencera amb :mark[…]. Una marca pinta una banda sota el text normal i no toca els talls. Només es marquen paraules senceres: una marca sobre mitja paraula canvia com es divideix aquella paraula, i aleshores les línies ja no es tallen on es va trobar l'avís.

Primeres proves, pàgina 2: con sobre como i lo sobre los, a començament de línia.

#3 · Dues proves d'un mateix text

script.js · línies 205–224al codi complet
const quote = (s) => t({ en: `“${s}”`, es: `«${s}»` });
const SIDE = { end: t({ en: 'end', es: 'final' }), start: t({ en: 'start', es: 'principio' }) };
const tally = (n) => t({ en: `${n} stack${n === 1 ? '' : 's'}`,
  es: `${n} repetici${n === 1 ? 'ón' : 'ones'}` });
const byPage = (stacks) => Object.entries(Object.groupBy(stacks, (w) => w.pageIndex + 1))
  .map(([page, list]) => `${t({ en: 'p.', es: 'pág.' })} ${page}: ${list.map((w) =>
    `${quote(w.text)} (${SIDE[w.edge]})`).join(', ')}.`);
const slip = (mode, stacks) => ['', `:::callout{type="proof" title="${mode === 'warn'
  ? t({ en: 'First proof', es: 'Primeras pruebas' })
  : t({ en: 'Second proof', es: 'Segundas pruebas' })}"}`,
`${t({ en: 'Set with', es: 'Compuesto con' })} stacks: '${mode}' · ${tally(stacks.length)}.`,
...byPage(stacks).flatMap((line) => ['', line]), ':::', ''].join('\n');
const build = (md, stacks) => buildDocumentWithFonts({ markdown: md, resources },
  { ...config, bodyText: { ...bodyText, stacks } }, kitFonts(FONTS));
async function proof(mode) {
  const plain = await build(markdown, mode); // pass 1: where the stacks are
  const stacks = (plain.contentWarnings ?? []).filter((w) => w.kind === 'stack');
  return build(markStacks(markdown, plain, stacks) + slip(mode, stacks), mode); // pass 2
}
const docs = { warn: await proof('warn'), avoid: await proof('avoid') };

Cada prova es compon dues vegades. La primera composició troba les repeticions. La segona compon el mateix text amb les marques i una papereta afegida després del colofó, de manera que la papereta cau a l'última pàgina. El pen deixa fora de les pàgines publicades la primera composició de cada prova, el text sense marcar: capture.doc llista les dues composicions marcades, [1, 3].

Segones proves, pàgina 2: els mateixos paràgrafs tallats d'una altra manera, sense cap repetició.

A l'edició anglesa, amb tres caràcters, en queda una: even sobre event, que comparteixen les tres primeres lletres, perquè qualsevol altre tall d'aquell paràgraf costava més.

#4 · L'obertura sobre el text

script.js · línies 62–77al codi complet
const PICTURE = { width: MEASURE, height: 11 * LINE }; // 83 × 52 mm, the painting's 3:2
const at = (to, edge, y, size) => ({ anchor: { to, edge }, offset: { x: mm(0), y: mm(y) },
  ...(size && { size }) });
const opener = {
  enabled: true, minHeight: pt(16 * LEAD), // the text starts on the seventeenth line
  slot: { elements: [
    { kind: 'image', id: 'art', resourceId: '{attr.art}', fit: 'cover', placement: at('container',
      'top', 0, { width: mm(PICTURE.width), height: mm(PICTURE.height) }) },
    { kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: LABEL, fontWeight: 600,
      fontSize: pt(8.5), letterSpacing: pt(1.7), color: col('accent'), align: 'left',
      placement: at('container', 'top-left', PICTURE.height + 5.5) },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, italic: true,
      fontWeight: 500, fontSize: pt(27), lineHeight: 1.05, color: col('ink'), align: 'left',
      placement: at('#kicker', 'below', 1.5, { width: mm(MEASURE), height: 'auto' }) },
  ] },
};

L'atribut art del títol anomena la pintura, així que un sol estil serveix a les dues edicions. minHeight reserva setze línies i el text comença a la dissetena, sobre la mateixa retícula que les pàgines següents.

#5 · Titolets i foli caigut

script.js · línies 81–93al codi complet
const head = (id, content, parity, edge, x, extra = {}, y = 10.5) => ({ kind: 'text', id,
  content, parity, pages: 'body', fontFamily: LABEL, fontWeight: 500, fontSize: pt(8),
  letterSpacing: pt(1.2), color: col('muted'),
  placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(y) } }, ...extra });
const folio = { fontFamily: TEXT, letterSpacing: pt(0), color: col('ink') };
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
  head('verso-author', '{author}', 'even', 'top-left', OUTER + 8),
  head('recto-title', '{title}', 'odd', 'top-right', -(OUTER + 8)),
  head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'odd', 'bottom-right', -OUTER,
  { ...folio, pages: 'opener' }, -11)] }; // the opener's folio sits at the foot

L'autor va a la pàgina parella i el títol a la senar, cadascun al costat del seu foli. A l'obertura no hi ha titolets i el foli baixa al peu.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 184 · Prose without stacks ═════════════════════════════
// https://postext.dev/en/cookbook/prose-without-stacks
// Code: MIT · Text: Dickens, 1843; Clarín, 1893 (public domain) · Paintings: diffusion model
// Fonts: Spectral, Spectral SC, Cormorant Garamond (SIL OFL 1.1) · Needs postext ≥ 1.73.0
//
// A pocket edition set twice from the same text. The first proof keeps the line breaks the
// breaker finds and reports every stack (two lines in a row that end or start alike); the
// second weighs each stack in the breaker's demerits and sets the paragraph another way.
// Each proof marks its stacks in the text and lists them on a slip after the colophon.
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'prose-without-stacks';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a proofreader's red pencil over a warm book ink
const palette = {
  ink: '#241f1b', // text: a warm near-black
  accent: '#8e2f1d', // kicker, the slip's stripe and label: the red of a proof pencil
  mark: '#f4cfc2', // the band under a stacked word, pale enough for ink on top
  tint: '#f5efe6', // the slip's background
  rule: '#d2c8bb', // hairlines
  muted: '#6b6158', // running heads, colophon
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// #endregion
const [TEXT, LABEL, DISPLAY] = ['Spectral', 'Spectral SC', 'Cormorant Garamond'];
const [BODY, LEAD] = [9.6, 13.4]; // pt
const LINE = (LEAD * 25.4) / 72; // mm: one line, 4.73
const [TRIM_W, TRIM_H, TOP, INNER, OUTER, LINES] = [115, 180, 17, 15, 17, 30];
const MEASURE = TRIM_W - INNER - OUTER; // 83 mm: about 50 characters, a narrow pocket measure

// #region answer: stacks reported in the first proof and weighed in the second
const bodyText = {
  fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  textAlign: 'justify', firstLineIndent: mm(4), indentAfterHeading: false,
  hyphenation: { enabled: true }, optimalLineBreaking: true, // stacks need the K–P breaker
  avoidWidows: true, avoidOrphans: true, avoidRunts: true,
  // A stack: two lines in a row that end on the same word or the same last characters
  // (“sole” over “sole”), or that start alike (“The” over “the”). 'warn' reports each one

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Comptar només paraules llargues

Amb cinc caràcters, paraules curtes com lo o los deixen de comptar com a repetició, i el tallador manté els talls més estrets al seu voltant.

-  stackMinCharacters: t({ en: 3, es: 2 }),
+  stackMinCharacters: 5,

#Compondre amb la penalització per defecte

La penalització per defecte estreny més l'espaiat i accepta dues repeticions per edició allà on evitar-les obriria més una línia.

-  stackPenalty: 10000,
+  stackPenalty: 3000,

Errors freqüents

Avís de maquetació · stack

Repetició

Per què. Dues línies seguides d'un paràgraf, en una mateixa columna, acaben amb la mateixa paraula o els mateixos últims bodyText.stackMinCharacters caràcters (3 per defecte, espais inclosos), o comencen igual: «…en la» sobre «…de la». No compten els accents ni les majúscules, i només hi ha repeticions en les escriptures que separen les paraules amb espais. Amb bodyText.stacks a 'warn' s'informa de totes; a 'avoid', de les que el tall de línies va mantenir perquè cap composició dins l'espaiat entre paraules no les evitava per menys que bodyText.stackPenalty. El motor anota cadascuna a doc.contentWarnings amb el text repetit, l'extrem (final o començament), les dues línies i la seva pàgina.

Solució. Posa bodyText.stacks a 'avoid': el tall de línies compon el paràgraf d'una altra manera on l'espaiat entre paraules ho permet. Una repetició que es manté costa més d'evitar que bodyText.stackPenalty: apuja la penalització per canviar-la per línies més soltes, o reescriu una de les dues línies. En un port d'un llibre existent deixa 'warn': el port reprodueix els talls de l'original. Documentació →

  • Les repeticions es busquen a les línies ja tallades. Si canvies el format, el cos o el text, les primeres proves en troben d'altres, així que llegeix els avisos de cada composició i no copiïs posicions d'una d'anterior.
  • Les repeticions es compten dins d'un paràgraf i només en escriptures que separen les paraules amb espais: dos paràgrafs que comencen amb Rosa no fan repetició, i un text en xinès o en japonès no avisa mai de cap.

Crèdits

Text
  • A Christmas Carol (1843), the opening of Stave One, from Project Gutenberg eBook #46, with typographic quotes and dashes · Charles Dickens · domini públic
  • ¡Adiós, Cordera!, the opening of the story, from El Señor y lo demás son cuentos (Madrid, 1919), with « » quotation marks · Leopoldo Alas, Clarín · domini públic
Imatges
  • Painting: Scrooge's counting-house on a foggy Christmas Eve · Generated With Diffusion Models · original
  • Painting: Rosa, Pinín and the Cordera by the telegraph pole · Generated With Diffusion Models · original
Fonts
Spectral (SIL OFL 1.1) · Spectral SC (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1)
Sandbox