Saltar al contingut principal
Recepta número 65

Receptari · Capítol 3 · Títols i obertures

Clàssic de butxaca: capítols breus seguits

Dom Casmurro en butxaca: capítols breus seguits, amb títols dibuixats a la columna i sense línies ni títols solts als salts de pàgina.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text MIT

pp. 212–213 · 2–3 de 7

  • Mostra en castellà: encara no hi ha edició en català
  • Format 110 × 178 mm
  • 1 columna
  • Tinos 9,5/12,6
  • Abril Fatface
  • League Spartan
  • 7 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 67 ms
  • 167 línies de codi

En poques paraules

Cinc pàgines d'una novel·la clàssica brasilera en format de butxaca. Cada capítol curt comença just després de l'anterior, i cap pàgina no comença ni acaba amb una línia solta.

Què compondràs

Cinc pàgines del final de Dom Casmurro (Machado de Assis, 1899), en el portuguès original, compostes com a llibre de butxaca de 110 × 178 mm per a una col·lecció inventada, la Coleção Casuarina. Les precedeixen una coberta en bandes pruna, crema i pruna, amb el títol en Abril Fatface i el segell safrà de la col·lecció, i una làmina pintada del mar esvalotat de Flamengo, generada amb models de difusió, davant de la 213. El text va del final del CXVIII al del CXXIII, i cap capítol no obre pàgina. Cadascun comença dues línies per sota del final de l'anterior (tres en el CXIX, per omplir la 213), amb un numeral romà en pruna, el títol en versals espaiades i un filet curt safrà. A la 214 en comencen dos; a la 215 i la 216, un. Totes les pàgines de text tret de l'última acaben a la línia 33, i cap no comença amb una línia sola.

Aquesta recepta respon a

  • Com evito vídues, òrfenes i últimes línies d'una sola paraula, i mantinc cada títol amb el seu text?
  • Com aconsegueixo columnes arran del peu i una última pàgina equilibrada (justificació vertical)?
  • Com numero els títols (1, 1.1, 1.1.1) i dono a cada nivell un estil diferent?
  • Com poso capçaleres: el títol del llibre a la pàgina esquerra, el del capítol a la dreta i el foli per fora?

La resposta curta

script.js · línies 37–59al codi complet
// Machado's chapters run a page or two, so none opens a page. The level's break is off (the
// H1 default would open each chapter on a recto) and a chapter starts two lines under the last.
const [NUMERAL, TITLE, TRACK, GAP] = [14, 7.5, 1.3, 1.6]; // pt, pt, pt, mm
const RULE_Y = NUMERAL * PT + GAP + TITLE * 1.2 * PT + GAP; // mm: under the title's line
const chapterHead = { enabled: true, slot: { elements: [ // no span: the head stays in the text
  { kind: 'text', id: 'numeral', content: '{number}', fontFamily: DISPLAY, fontSize: pt(NUMERAL),
    lineHeight: 1, color: col('plum'), align: 'center',
    placement: { ...at('container', 'top'), size: { width: 'fill' } } },
  { kind: 'text', id: 'title', content: '{titleText}', ...caps(TITLE, TRACK), color: col('ink'),
    align: 'center', overflow: 'wrap', // a long title takes a second line
    placement: { anchor: { to: '#numeral', edge: 'below' }, offset: { y: mm(GAP) },
      size: { width: 'fill' } } },
  { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1), color: col('saffron'),
    placement: { ...at('container', 'top', 0, RULE_Y), size: { width: mm(8) } } },
] } }; // 11.7 mm deep: the head takes three lines, and the text under it stays on the grid
const chapters = { level: 1, numberingTemplate: '{1:I}', // {number} prints CXIX, CXX…
  fontSize: pt(TITLE), // the hidden heading line, measured in the headings' face
  breakBefore: { enabled: false }, marginTop: pt(2 * LEAD), advancedDesign: chapterHead };
// The keep rules are on by default. avoidWidows keeps widowMinLines (2) lines of a paragraph
// at the foot of a page, and headings.keepWithNext takes the head along when the paragraph
// moves on; avoidOrphans keeps two lines at the head of the next page; avoidRunts weighs a
// last line shorter than about 20 characters as a fault. Column balancing adds lines above
// a head so that the page ends on line 33.

Ingredients

Tipografia
Tinos (Apache 2.0) · Abril Fatface, League Spartan (SIL OFL 1.1)
Recursos
  • plate-1100.jpg
  • The plate of the sea off Flamengo under the Sugarloaf, a painting (Generated With Diffusion Models, original)
  • The casuarina roundel, drawn in code in the book’s palette (Ignacio Ferro, MIT)

Elaboració

#1 · Encadena els capítols, cada títol amb el seu text

script.js · línies 37–59al codi complet
// Machado's chapters run a page or two, so none opens a page. The level's break is off (the
// H1 default would open each chapter on a recto) and a chapter starts two lines under the last.
const [NUMERAL, TITLE, TRACK, GAP] = [14, 7.5, 1.3, 1.6]; // pt, pt, pt, mm
const RULE_Y = NUMERAL * PT + GAP + TITLE * 1.2 * PT + GAP; // mm: under the title's line
const chapterHead = { enabled: true, slot: { elements: [ // no span: the head stays in the text
  { kind: 'text', id: 'numeral', content: '{number}', fontFamily: DISPLAY, fontSize: pt(NUMERAL),
    lineHeight: 1, color: col('plum'), align: 'center',
    placement: { ...at('container', 'top'), size: { width: 'fill' } } },
  { kind: 'text', id: 'title', content: '{titleText}', ...caps(TITLE, TRACK), color: col('ink'),
    align: 'center', overflow: 'wrap', // a long title takes a second line
    placement: { anchor: { to: '#numeral', edge: 'below' }, offset: { y: mm(GAP) },
      size: { width: 'fill' } } },
  { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1), color: col('saffron'),
    placement: { ...at('container', 'top', 0, RULE_Y), size: { width: mm(8) } } },
] } }; // 11.7 mm deep: the head takes three lines, and the text under it stays on the grid
const chapters = { level: 1, numberingTemplate: '{1:I}', // {number} prints CXIX, CXX…
  fontSize: pt(TITLE), // the hidden heading line, measured in the headings' face
  breakBefore: { enabled: false }, marginTop: pt(2 * LEAD), advancedDesign: chapterHead };
// The keep rules are on by default. avoidWidows keeps widowMinLines (2) lines of a paragraph
// at the foot of a page, and headings.keepWithNext takes the head along when the paragraph
// moves on; avoidOrphans keeps two lines at the head of the next page; avoidRunts weighs a
// last line shorter than about 20 characters as a fault. Column balancing adds lines above
// a head so that the page ends on line 33.

El nivell de capítol porta el salt desactivat, i marginTop col·loca cada títol dues línies per sota de l'última del capítol anterior. El seu disseny no porta span, així que el títol es dibuixa dins de la columna, en un bloc de tres línies d'alçada, i el text que va a sota cau a la retícula de base (salt de pàgina previ, extensió i disseny avançat). Les regles de cohesió conserven els valors per defecte. Els paràgrafs de quatre línies que segueixen el CXIX i el CXXI deixen dues línies al peu de la seva pàgina i en passen dues a la següent; amb avoidOrphans: false es partirien en tres i una, i les pàgines 214 i 215 començarien amb una línia sola (òrfenes, vídues i línies curtes). L'equilibratge de columnes afegeix sobre el CXIX una tercera línia de blanc, i amb ella la pàgina 213 acaba a la línia 33 (equilibratge de columnes).

Pàgina 213: el capítol CXIX comença tres línies per sota del final del CXVIII i conserva dues línies del seu text al peu.

#2 · Compon una pàgina de 33 línies, amb partició de mots portuguesa

script.js · línies 63–70al codi complet
const bodyText = { fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD),
  color: col('ink'), referenceColor: col('ink'), // a :ref added later prints in ink
  firstLineIndent: mm(5) }; // every paragraph indented, the first after a head too
const page = { sizePreset: 'custom', width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150,
  backgroundColor: col('paper'),
  margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - LINES * LEAD * PT), // 16.3 mm
    left: mm(INNER), right: mm(OUTER), mirror: true } };
const LOCALE = 'pt'; // the Portuguese hyphenation patterns

El marge inferior fa 16,3 mm, el que queda dels 178 mm d'alçada després del marge superior de 15 mm i 33 línies de 12,6 pt, així que totes les pàgines plenes acaben a la mateixa línia. Tinos, que té les mateixes amplades que la Times New Roman, compon uns 59 caràcters per línia en la mesura de 84 mm a 9,5 pt. locale: 'pt' parteix les paraules amb els patrons portuguesos: at-tracção, af-fluencia, genealogica-mente (llengües admeses). Tots els paràgrafs porten sagnat, també el primer després d'un títol, com és costum a les edicions portugueses i brasileres, i per a això n'hi ha prou amb el valor per defecte d'indentAfterHeading.

#3 · Posa el títol del llibre a la pàgina parella i el capítol a la senar

script.js · línies 74–87al codi complet
const SHIFT = (INNER - OUTER) / 2; // mm: the text block sits off the page's centre
const [HEAD_Y, FOLIO_Y] = [8.5, 167]; // mm below the top edge
const head = (id, content, parity, x) => ({ kind: 'text', id, content, parity,
  pages: 'body', // never on the cover or the plate, which are opener pages
  ...caps(7.5, TRACK), color: col('muted'), align: 'center',
  placement: at('page', 'top', x, HEAD_Y) });
const folio = (id, parity, edge, x) => ({ kind: 'text', id, content: '{pageNumber}', parity,
  pages: 'body', ...caps(7.5, 0), color: col('ink'), placement: at('page', edge, x, FOLIO_Y) });
const header = { elements: [
  head('verso-title', '{title}', 'even', -SHIFT), // the title in the frontmatter
  head('recto-chapter', '{chapterTitle}', 'odd', SHIFT), // last chapter begun on or before it
] };
const footer = { elements: [folio('verso-folio', 'even', 'top-left', OUTER),
  { ...folio('recto-folio', 'odd', 'top-right', -OUTER), align: 'right' }] };

{title} imprimeix el títol de les metadades del document, i {chapterTitle}, el de l'últim capítol que comença a la pàgina o abans, així que la 217 anomena el CXXIII, que va començar a la 216 (elements de text). La 213 anomena el CXIX, que comença al peu, tot i que les seves primeres 25 línies tanquen el CXVIII. {chapterTitleAtTop} anomena en canvi el capítol amb què obre la pàgina, però aquest extracte no porta el títol del CXVIII. SHIFT porta les capçaleres al centre de la caixa de text, a 1 mm del centre de la pàgina, perquè el marge interior fa 2 mm més que l'exterior.

#4 · Dibuixa la coberta i la làmina com a títols

script.js · línies 91–134al codi complet
// span: 'page', in one column too, makes each an opener page: its art runs past the foot of
// the text column, and no running head or folio prints on it. Each design reaches the foot of
// the page, so the heading reserves the whole page and the text starts on the next one.
const onPage = (y, size) => ({ ...at('page', 'top', 0, y), ...(size && { size }) });
const cover = { id: 'cover', numbered: false, span: 'page',
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'box', id: 'top-band', style: { backgroundColor: col('plum') },
      placement: { ...at('page', 'top-left'), size: { width: 'fill', height: mm(62) } } },
    { kind: 'text', id: 'author', content: '{author}', ...caps(10, 2.4), color: col('paper'),
      align: 'center', placement: at('page', 'top', 0, 44) },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontSize: pt(44),
      lineHeight: 1, color: col('plum'), align: 'center', overflow: 'wrap',
      placement: onPage(72, { width: 'fill' }) },
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.5),
      color: col('saffron'), placement: onPage(111, { width: mm(12) }) },
    { kind: 'box', id: 'foot-band', style: { backgroundColor: col('plum') },
      placement: { ...at('page', 'top-left', 0, 124), size: { width: 'fill', height: mm(54) } } },
    { kind: 'image', id: 'roundel', resourceId: 'roundel',
      placement: onPage(133, { width: mm(20) }) },
    { kind: 'text', id: 'series', content: 'Coleção Casuarina', ...caps(7.5, 1.8),
      color: col('saffron'), align: 'center', placement: at('page', 'top', 0, 159) },
  ] } } };
// The plate faces the first page of text: the morning sea off Flamengo, captioned with the
// line of chapter CXXIII it illustrates, which the heading carries in its quote attribute.
const plate = { id: 'plate', numbered: false, span: 'page',
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'image', id: 'sea', resourceId: 'sea',
      placement: { ...at('page', 'top-left'), size: { width: 'fill', height: 'fill' } } },
    { kind: 'text', id: 'label', content: '{titleText}', ...caps(7.5, 1.6), color: col('saffron'),
      align: 'center', placement: at('page', 'top', 0, 146) },
    { kind: 'text', id: 'quote', content: '{attr.quote}', fontFamily: TEXT, italic: true,
      fontSize: pt(8.6), lineHeight: 1.35, color: col('paper'), align: 'center', overflow: 'wrap',
      placement: onPage(152, { width: mm(78) }) },
  ] } } };
const resources = [
  { id: 'roundel', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
    svg: { fileId: 'roundel.svg', width: 60, height: 60 },
    altText: 'The series mark: a casuarina tree in a ring.' },
  // The plate is a painting, a JPEG in assets/ cut to the trim, declared at its pixels.
  { id: 'sea', typeId: 'figure', kind: 'bitmap', createdAt: 0, updatedAt: 0,
    bitmap: { fileId: 'plate-1100.jpg', format: 'jpeg', width: 1100, height: 1780 },
    altText: 'A heavy morning sea under the Sugarloaf, a low sun, and a lone swimmer among '
      + 'the breakers.' },
];

Totes dues són estils d'encapçalament amb numbered: false, així que el primer capítol numerat continua sent el CXIX. span: 'page' les converteix en pàgines d'obertura. Sense això, la banda del peu de la coberta i la imatge de la làmina es tallen a la vora inferior de la caixa de text, i la capçalera i el foli s'imprimeixen sobre totes dues pàgines. El peu de la làmina surt del seu títol: CAPÍTULO CXXIII és el text del títol, i la cita en cursiva, el seu atribut quote (atributs d'encapçalament). Cada disseny arriba al peu de la seva pàgina, així que el títol reserva la pàgina sencera i el text comença a la següent sense cap :::pagebreak.

#5 · Digues al fragment en quin punt del llibre és

script.js · línia 276al codi complet
const continuation = { headings: { h1: 118, h2: 0, h3: 0, h4: 0, h5: 0, h6: 0 } };

continuation.headings dona els comptadors de títols amb què comença el fragment. Amb h1: 118, el primer títol numerat és el capítol CXIX; sense això, els cinc capítols surten numerats del I al V. numberingTemplate: '{1:I}', al nivell de capítol, posa aquests números en romans, i el disseny els imprimeix amb {number}. :::numbering{startAt=212}, després de la coberta, numera la làmina com a 212 i les pàgines de text de la 213 a la 217 (:::numbering).

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 065 · Pocket classic: short chapters that run on ═══════════
// https://postext.dev/en/cookbook/short-chapters-run-on
// Code: MIT · Text: Machado de Assis, Dom Casmurro, 1899 (PD, Gutenberg #55752) · Plate: painted
// Fonts: Tinos (Apache 2.0), Abril Fatface, League Spartan (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the viewer's title; the sample is Portuguese
const RECIPE = 'short-chapters-run-on';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
  ink: '#24202a', // the text: a violet near-black
  paper: '#f6f1e6', // the pocket book's paper
  plum: '#4f2a49', // the series colour: cover bands, the chapter numerals
  saffron: '#d9a03c', // the second ink: rules and drawings, never text on paper (2.1:1)
  muted: '#6b616e', // the running heads and the colophon (5.2:1 on paper)
};
// Each colour names its palette entry and carries its hex.
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' } })),
  // The default bold and italic colours link to main-color, set here to the ink, not blue.
  { id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
const [TEXT, DISPLAY, LABEL] = ['Tinos', 'Abril Fatface', 'League Spartan'];
const TRIM = { width: 110, height: 178 }; // mm: a pocket book
const [TOP, INNER, OUTER] = [15, 14, 12]; // mm; mirrored, so the inner margin is at the spine
const [BODY, LEAD, LINES] = [9.5, 12.6, 33]; // pt, pt, and the lines of a full page
const PT = 25.4 / 72; // mm per point
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const caps = (size, track) => ({ fontFamily: LABEL, fontWeight: 600, fontSize: pt(size),
  letterSpacing: pt(track), textTransform: 'uppercase' });

// #region answer: chapters that run on, each under a centred head drawn in the column
// Machado's chapters run a page or two, so none opens a page. The level's break is off (the
// H1 default would open each chapter on a recto) and a chapter starts two lines under the last.
const [NUMERAL, TITLE, TRACK, GAP] = [14, 7.5, 1.3, 1.6]; // pt, pt, pt, mm
const RULE_Y = NUMERAL * PT + GAP + TITLE * 1.2 * PT + GAP; // mm: under the title's line
const chapterHead = { enabled: true, slot: { elements: [ // no span: the head stays in the text
  { kind: 'text', id: 'numeral', content: '{number}', fontFamily: DISPLAY, fontSize: pt(NUMERAL),
    lineHeight: 1, color: col('plum'), align: 'center',
    placement: { ...at('container', 'top'), size: { width: 'fill' } } },
  { kind: 'text', id: 'title', content: '{titleText}', ...caps(TITLE, TRACK), color: col('ink'),
    align: 'center', overflow: 'wrap', // a long title takes a second line
    placement: { anchor: { to: '#numeral', edge: 'below' }, offset: { y: mm(GAP) },
      size: { width: 'fill' } } },

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

#Obre cada capítol en una pàgina nova

Amb un salt abans de cada capítol, les cinc pàgines de text passen a ser set: la 214 porta només el CXIX, el seu títol i quatre línies, i la 213, on no comença cap capítol, pren com a capçalera el títol de la làmina, CAPÍTULO CXXIII.

-  breakBefore: { enabled: false }, marginTop: pt(2 * LEAD), advancedDesign: chapterHead };
+  breakBefore: { enabled: true, parity: 'any' }, marginTop: pt(2 * LEAD),
+  advancedDesign: chapterHead };

#Posa el número del capítol a la pàgina senar

{chapterNumber} imprimeix el numeral del mateix capítol del qual surt el títol: CXIX · NÃO FAÇA ISSO, QUERIDA.

-  head('recto-chapter', '{chapterTitle}', 'odd', SHIFT),
+  head('recto-chapter', '{chapterNumber} · {chapterTitle}', 'odd', SHIFT),

Errors freqüents

Error freqüent

avoidWidows vigila el peu de la columna, i avoidOrphans, el capdamunt

Postext dona nom propi a les dues línies soles: avoidWidows (widowMinLines, widowPenalty) evita que la primera línia d'un paràgraf quedi sola al peu d'una columna, i avoidOrphans (orphanMinLines, orphanPenalty), que l'última quedi sola al capdamunt de la següent. Molts manuals d'estil fan servir els dos noms al revés, així que tria l'opció pel lloc on actua. Totes dues vénen activades, tret d'una retícula de caràcters (cjk.grid): allà avoidWidows ve desactivada, i avoidOrphans també a la regió del Japó, perquè la pàgina contingui les línies que la retícula compta (des de postext 1.28). Funcionen com a penalitzacions: la composició compara cadascuna amb les línies buides que deixaria respectar-la. Vídues, òrfenes i línies curtes →

Error freqüent

:::numbering s'aplica a la pàgina següent

:::numbering canvia el compte a partir de la pàgina següent que comença, no de l'actual. Col·loca'l just després d'un :::pagebreak (amb paritat odd abans del primer capítol) perquè la numeració nova comenci on vols. Preliminars en romans →

  • Si puges widowMinLines a 3, el paràgraf de quatre línies que segueix el CXIX no té per on partir-se: tres línies i una obririen la pàgina 214 amb una línia sola. El títol passa a la pàgina següent amb el seu text i la 213 acaba sis línies abans.
  • Si el CXVIII creix unes quantes línies, al CXIX només li queda lloc per a una línia sota el seu títol. keepWithNext porta llavors el títol a la pàgina 214, i la 213 acaba quatre o cinc línies abans del peu; amb keepWithNext: false, el títol tanca la 213 sense text a sota.
  • La làmina és un H1, així que {chapterTitle} hi recorre: una pàgina de text en què no ha començat cap capítol des de la làmina, com la 213 quan el CXIX passa a la següent, porta com a capçalera CAPÍTULO CXXIII. Amb runningChapter: false a l'estil de la làmina, les capçaleres la passen per alt.
  • Amb avoidRunts desactivat, l'última línia del llibre porta manhã. sola en lloc de nadador da manhã.
  • Aquests salts de pàgina valen només per a aquest text a 9,5 sobre 12,6 pt en una mesura de 84 mm. Si canvies el text, el cos o la mesura, torna a mirar el peu de cada pàgina i el blanc sobre cada títol.

Crèdits

Text
  • Dom Casmurro (1899), from the end of chapter CXVIII to the end of chapter CXXIII, in the spelling of the Garnier edition, with one transcription slip corrected (homens, chapter CXXIII) · Machado de Assis · domini públic
  • The colophon, and the series name Coleção Casuarina (invented for this recipe) · Postext Cookbook · original
Imatges
  • The plate of the sea off Flamengo under the Sugarloaf, a painting · Generated With Diffusion Models · original
  • The casuarina roundel, drawn in code in the book’s palette · Ignacio Ferro · MIT
Fonts
Tinos (Apache 2.0) · Abril Fatface (SIL OFL 1.1) · League Spartan (SIL OFL 1.1)
Sandbox