Saltar al contingut principal
Recepta número 104

Receptari · Capítol 2 · Text i tipografia

Una novel·la curta en català, amb la partició de l'IEC

El transplantat d'Oller, complet, en una butxaca de 32 pàgines: síl·labes catalanes segons l'IEC, l·l tallada com il- | lusió i un gravat per capítol.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.57.0 · postext-pdf ≥ 1.57.0
Llicència
Actualitzada el 22 d’oct. del 2026
Codi MIT · Text MIT
  • Mostra en castellà: encara no hi ha edició en català
  • Format 120 × 185 mm
  • 1 columna
  • Gentium Book Plus 9,8/14
  • Cormorant Garamond
  • Cormorant SC
  • 32 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 163 ms
  • 180 línies de codi

En poques paraules

Una novel·la curta sencera en català, composta com un llibre de butxaca. Els mots es tallen a final de línia com demanen les normes catalanes, també la ela geminada amb punt volat.

Què compondràs

El transplantat de Narcís Oller sencer, amb el text de les seves Obres completes (Barcelona, 1928), en un llibre de butxaca de 12 × 18,5 cm i 32 pàgines. Abans dels quatre capítols hi ha una avantportada, un frontispici amb el forner davant del seu forn, la portada en Cormorant Garamond cursiva i vermella, i una nota sobre l'edició. Cada capítol s'obre sota un gravat de dotze línies d'alçada, amb el seu número romà en vermell. El text, en Gentium Book Plus de 9,85 pt, es parteix per síl·labes catalanes com demana l'Institut d’Estudis Catalans: almenys dues lletres a cada costat, cap tall entre vocals en hiat ni just després d'un apòstrof, i titil·laven es talla titil- | laven, amb el guionet al lloc del punt volat. Els diàlegs porten guió i les citacions, «cometes baixes».

Aquesta recepta respon a

  • Com aconsegueixo una bona justificació i partició de mots en textos en castellà, francès o alemany?
  • Com dono a cada capítol la seva pròpia foto, el seu color o una variant d'obertura?
  • Com componc il·lustracions sense numerar: ornaments, vinyetes, logotips?
  • Com escric guions de diàleg, anys a l'inici de paràgraf, preus i símbols literals sense que el Markdown els interpreti malament?

La resposta curta

script.js · línies 49–64al codi complet
const LOCALE = 'ca'; // the exact bundled code: 'ca-ES' resolves to it too (postext ≥ 1.14)
const bodyText = { // config().bodyText
  fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  firstLineIndent: mm(4.5), indentAfterHeading: false,
  // The defaults justify, hyphenate in config().locale and break by Knuth–Plass. With 'ca'
  // the dictionary follows the IEC: two letters on each side (ter-ra, cai-xa), no split in
  // a hiatus (cièn-cia) or after an apostrophe (s’ha-via), l·l broken with the hyphen for the
  // dot. From 1.30 the face is asked for its Catalan forms too: this one has a single dot.
  // compounds: false divides arrossegar-se only at its own hyphen (Llibre d’estil, VI 2.5).
  hyphenation: { compounds: false },
  // Spaces from 0.7× to 1.6×, then up to 10‰ of tracking; a last line under 22 characters is
  // a runt. A line that must keep d’inaugurar-se whole still opens to 1.94× on page 7.
  maxWordSpacing: 1.6, minWordSpacing: 0.7, maxJustifyTracking: 10, runtMinCharacters: 22,
  hyphenateAcrossColumns: false, // no page ends on a divided word
};

Ingredients

Tipografia
Gentium Book Plus, Cormorant Garamond, Cormorant SC (SIL OFL 1.1)
Recursos
  • cap1-1200.jpg
  • cap2-1200.jpg
  • cap3-1200.jpg
  • cap4-1200.jpg
  • frontis-1000.jpg
  • Engraving, frontispiece: the baker at his oven's door (Generated With Diffusion Models, original)
  • Engraving, chapter I: the night train into Barcelona (Generated With Diffusion Models, original)
  • Engraving, chapter II: the village street in autumn (Generated With Diffusion Models, original)
  • Engraving, chapter III: the Rambla at dawn (Generated With Diffusion Models, original)
  • Engraving, chapter IV: the old man by the railway (Generated With Diffusion Models, original)

Elaboració

#1 · El català pel seu codi

El codi és la resposta curta de dalt. locale: 'ca' tria els patrons catalans, que des de postext 1.14 segueixen el Llibre d’estil de l'IEC (llengües admeses). Són els mateixos patrons que fa servir TeX, amb almenys dues lletres a cada costat del tall en lloc de les tres del paquet d'npm, així que ter-ra, cai-xa i plu-ja es poden tallar. Les vocals en hiat no se separen (cièn-cia, ca-mions), però una i entre vocals obre la seva síl·laba (fe-ia). La ela geminada es talla entre les seves dues l: la línia acaba en titil- i la següent comença per laven, sense punt volat en cap de les dues, i Knuth–Plass mesura la línia sense el punt.

Pàgina 27: titil·laven a final de línia, compost titil- | laven. És l'única l·l que cau a final de línia en aquestes 32 pàgines.

compounds: false deixa sencers el verb i el seu pronom llevat del seu propi guionet (arrossegar- | se), que és el tall que prefereix l'IEC (partició de mots). Costa una línia fluixa: a la pàgina 7, la línia anterior a d’inaugurar-se obre els seus espais fins a 1,88 vegades, tot i que maxJustifyTracking: 10 absorbeix l'excés a les altres.

#2 · Una pàgina de butxaca de línies senceres

script.js · línies 38–45al codi complet
const TRIM = { width: 120, height: 185 }; // mm
const [TOP, INNER, OUTER, LINES] = [18, 16, 15, 29];
const MEASURE = TRIM.width - INNER - OUTER; // 89 mm: about 63 characters of Gentium Book Plus
const page = {
  width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
  margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - LINES * LINE),
    left: mm(INNER), right: mm(OUTER), mirror: true }, // left is the inner margin on a recto
};

El marge inferior surt del format, el marge superior i LINES, així que la caixa admet 29 línies de 14 pt i tota pàgina plena acaba a la mateixa línia de base. La mesura de 89 mm dona uns 63 caràcters de Gentium Book Plus. mirror: true manté el marge de 16 mm al llom a totes dues pàgines (marges simètrics).

#3 · Una obertura per als quatre capítols

script.js · línies 68–83al codi complet
// # II {style="capitol" art="cap2"}: the art attribute names the picture's resource.
const PICTURE = { width: MEASURE, height: 12 * LINE }; // 89 × 59.3 mm: twelve lines, 3:2
const chapter = { id: 'capitol',
  breakBefore: { enabled: true, parity: 'any' }, // a chapter opens on the next page, either side
  marginBottom: pt(0), // the opener's own height already ends on a line
  advancedDesign: { enabled: true, minHeight: pt(16 * LEAD), slot: { elements: [
    { kind: 'image', id: 'art', resourceId: '{attr.art}',
      placement: at('container', 'top', 0, 0,
        { width: mm(PICTURE.width), height: mm(PICTURE.height) }) },
    // The numeral and its rule hang from the container's top, a fixed drop under the picture.
    text('numeral', '{titleText}', DISPLAY, 21, at('container', 'top', 0, PICTURE.height + 4),
      { fontWeight: 600, color: col('vermell'), lineHeight: 1 }),
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.5), color: col('vermell'),
      placement: { ...at('container', 'top', 0, PICTURE.height + 13), size: { width: mm(8) } } },
  ] } },
};

resourceId: '{attr.art}' dibuixa la imatge que indica el títol, així que # II {style="capitol" art="cap2"} obre el capítol II sota el seu propi gravat amb el mateix estil que els altres (atributs de títol). minHeight guarda setze línies, dotze per al gravat i quatre per al número i el seu filet, així que el text comença a la línia disset de la pàgina, igual a tots els capítols.

#4 · Quatre pàgines abans del capítol I

script.js · línies 87–116al codi complet
const front = (id, elements, { minHeight, ...extra } = {}) => ({ id,
  breakBefore: { enabled: true, parity: 'any' }, marginBottom: pt(0),
  header: { elements: [] }, footer: { elements: [] }, ...extra,
  advancedDesign: { enabled: true, ...(minHeight && { minHeight }), slot: { elements } } });
const FRONTIS = { width: MEASURE, height: MEASURE * 1.5 }; // mm: the engraving is 2:3
const headingStyles = [
  front('avantportada', [text('title', '{titleText}', DISPLAY, 19,
    at('container', 'top', 0, 9 * LINE), { italic: true, fontWeight: 500, lineHeight: 1 })]),
  front('frontis', [
    { kind: 'image', id: 'art', resourceId: '{attr.art}',
      placement: at('container', 'top', 0, 0,
        { width: mm(FRONTIS.width), height: mm(FRONTIS.height) }) },
    text('legend', '{titleText}', LABEL, 8.5, at('container', 'top', 0, FRONTIS.height + 5),
      { ...caps(8.5, 1.4, 'muted') }),
  ]),
  front('portada', [
    text('author', '{author}', LABEL, 10, at('container', 'top', 0, 5 * LINE),
      caps(10, 2.2, 'ink')),
    text('title', '{titleText}', DISPLAY, 34, at('container', 'top', 0, 8 * LINE),
      { italic: true, fontWeight: 500, color: col('vermell'), lineHeight: 1 }),
    text('subtitle', '{subtitle}', DISPLAY, 13, at('container', 'top', 0, 8 * LINE + 17),
      { italic: true, fontWeight: 500 }),
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.5), color: col('vermell'),
      placement: { ...at('container', 'top', 0, 8 * LINE + 29), size: { width: mm(14) } } },
  ]),
  // The note sits low on the verso behind the title, its label a line above it.
  front('nota', [text('label', '{titleText}', LABEL, 8.5, at('container', 'top', 0, 13 * LINE),
    caps(8.5, 1.4))], { minHeight: pt(15 * LEAD) }),
  chapter,
];

Cada peça dels preliminars és un títol de primer nivell amb estil propi: # El transplantat {style="portada"} imprimeix l'autor i el subtítol del frontmatter i el títol com a títol. Cada estil repeteix el seu salt de pàgina, perquè un estil hereta el del seu nivell, i buida la capçalera i el peu, així que aquestes pàgines no porten capçaleres ni folis. El frontispici cau a la pàgina 2, parella, i queda davant de la portada.

#5 · L'autor a la parella, el títol a la senar

script.js · línies 120–134al codi complet
const SHIFT = (INNER - OUTER) / 2; // mm: the text block's centre is off the page's centre
const head = (id, content, parity, edge, x, y = 10, pages = 'body') => ({
  kind: 'text', id, content, parity, pages, ...caps(8, 1.3, 'muted'),
  placement: at('page', edge, x, y),
});
const folio = { fontFamily: TEXT, fontWeight: 400, letterSpacing: pt(0), color: col('ink') };
const header = { elements: [
  { ...head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER), ...folio },
  head('verso-author', '{author}', 'even', 'top', -SHIFT),
  head('recto-title', '{title}', 'odd', 'top', SHIFT),
  { ...head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER), ...folio },
] };
const drop = (parity, x) => ({ ...head(`drop-${parity}`, '{pageNumber}', parity, 'bottom', x,
  -11, 'opener'), ...folio });
const footer = { elements: [drop('odd', SHIFT), drop('even', -SHIFT)] };

parity posa l'autor a les pàgines parelles i el títol a les senars; pages: 'body' les treu de les obertures, on va un foli al peu amb pages: 'opener'. SHIFT centra cada capçalera sobre la caixa, que està desplaçada mig mil·límetre del centre de la pàgina perquè els dos marges no mesuren el mateix.

#6 · Cinc gravats, sense peu

script.js · línies 138–154al codi complet
const resourceTypes = [{ id: 'gravat', name: 'Gravat', namePlural: 'Gravats', shortLabel: 'Gravat',
  captionPrefix: '', numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal' }];
const PICTURES = { // id: [file, width, height, alt text in the book's language]
  frontis: ['frontis-1000.jpg', 1000, 1500, 'Un carrer de poble al capvespre. A la porta del forn, '
    + 'on cremen les flames, el forner, gras i somrient, amb davantal blanc i els braços creuats.'],
  cap1: ['cap1-1200.jpg', 1200, 800, 'De nit, el tren baixa cap a Barcelona: rengleres de fanals, '
    + 'la muntanya de Montjuïc i la lluna sobre el mar. Un pagès treu el cap per la finestreta.'],
  cap2: ['cap2-1200.jpg', 1200, 800, 'Un carrer de poble buit en una nit de tardor. Per la porta '
    + 'baixa de la ferreria, el manyà pica l’enclusa enmig d’una estrella d’espurnes.'],
  cap3: ['cap3-1200.jpg', 1200, 800, 'La Rambla a trenc d’alba des d’un balcó. Un fanaler apaga '
    + 'el gas amb la perxa; al fons, els pals dels vaixells del port.'],
  cap4: ['cap4-1200.jpg', 1200, 800, 'Capvespre als afores. Un vell de cabells blancs, assegut '
    + 'al caire del desmunt, mira la via del tren, que es perd recta fins a l’horitzó.'],
};
const resources = Object.entries(PICTURES).map(([id, [fileId, w, h, altText]]) => ({
  id, typeId: 'gravat', kind: 'bitmap', createdAt: 0, updatedAt: 0, altText,
  bitmap: { fileId, format: 'jpeg', width: w, height: h } }));

Les imatges són d'un tipus de recurs amb captionPrefix buit, així que res no les numera ni les retola. Cadascuna es declara amb la seva mida en píxels i es carrega amb el seu identificador de fitxer abans de compondre. Abans de desar-les es va portar el seu blanc al crema de la pàgina i el seu negre a la tinta del text, així que s'imprimeixen com a part de la pàgina i no com a fotos enganxades a sobre.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 104 · A Catalan novella, hyphenated by the IEC rules ═══════
// https://postext.dev/en/cookbook/catalan-pocket-novella
// Code: MIT · Text: N. Oller, El transplantat, 1928 (PD, Viquitexts) · Pictures: diffusion models
// Fonts: Gentium Book Plus, Cormorant Garamond, Cormorant SC (OFL) · Needs postext ≥ 1.57.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'es'; // @lang: the language of the sample document (the sample is Catalan in both)
const RECIPE = 'catalan-pocket-novella';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
  ink: '#2a2320', // text: a warm near-black, the pictures' ink too
  vermell: '#953222', // the one accent: chapter numerals, rules, the title page's title
  muted: '#6e6359', // running heads, the edition's note, the colophon
  paper: '#f5efe1', // a cream book paper, the pictures' white
};
// 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' } })),
  { id: 'main-color', name: 'vermell (defaults)', value: { hex: palette.vermell, model: 'hex' } },
];
const [TEXT, DISPLAY, LABEL] = ['Gentium Book Plus', 'Cormorant Garamond', 'Cormorant SC'];
const [BODY, LEAD] = [9.85, 14]; // pt: body and leading, the pitch of every vertical measure
const LINE = (LEAD * 25.4) / 72; // mm: one line, 4.94
const at = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
  offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const text = (id, content, fontFamily, size, placement, extra = {}) => ({ kind: 'text', id,
  content, fontFamily, fontSize: pt(size), color: col('ink'), align: 'center',
  overflow: 'wrap', placement, ...extra }); // a long title takes a second line
const caps = (size, tracking, color = 'vermell') => ({ fontFamily: LABEL, fontSize: pt(size),
  fontWeight: 600, letterSpacing: pt(tracking), color: col(color) });

// #region page: a 12 × 18.5 cm pocket book; the text block holds 29 whole lines
const TRIM = { width: 120, height: 185 }; // mm
const [TOP, INNER, OUTER, LINES] = [18, 16, 15, 29];
const MEASURE = TRIM.width - INNER - OUTER; // 89 mm: about 63 characters of Gentium Book Plus
const page = {
  width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
  margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - LINES * LINE),
    left: mm(INNER), right: mm(OUTER), mirror: true }, // left is the inner margin on a recto
};
// #endregion

// #region answer: Catalan by its own code: l·l breaks as il- | lusió, no word splits its hiatus

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

#Que els pronoms també es tallin

Amb el compounds: true per defecte, d’inaugurar-se es talla dins del verb, d’i- | naugurar-se, i la pàgina 7 perd la seva línia fluixa: cap línia del llibre passa d'1,6 vegades. El tall titil- | laven continua a la pàgina 27. El preu és una i sola després de l'apòstrof a final de línia.

-  hyphenation: { compounds: false },
+  hyphenation: { compounds: true },

#Obrir cada capítol en pàgina senar

parity: 'odd' afegeix una pàgina en blanc abans d'un capítol que començaria en parella, com en una edició més folgada. El capítol IV, que s'obre a la pàgina 26, passa a la 27 després d'una pàgina en blanc.

-  breakBefore: { enabled: true, parity: 'any' }, // a chapter opens on the next page, either side
+  breakBefore: { enabled: true, parity: 'odd' },

Errors freqüents

Error freqüent

Un estil de títol hereta el salt de pàgina del seu nivell

Una entrada de headingStyles pren del seu nivell de títol tot allò que no fixa, també breakBefore. Un índex o un colofó amb estil sobre un H1 després d'un :::pagebreak hereta la paritat 'odd' i cau darrere d'una pàgina en blanc. Dona a aquest estil breakBefore: { enabled: false }. Estils de títol →

Error freqüent

Valors d'atribut: sense { ni }; cometes simples si porten "

Un valor d'atribut acaba a la clau de tancament, així que no pot contenir { ni }. Un valor que porti cometes dobles va entre cometes simples; el signe de dòlar no dona problemes. Atributs de títol →

  • Mira com compon l·l una font de text abans de quedar-te-la. Des de postext 1.30 el locale del document és també la llengua en què es compon el text (fins a 1.29 era la de la pàgina que mostrava el llibre), i cada font respon al català a la seva manera. Gentium Book Plus té un sol punt volat per a totes les llengües, amb 0,17 em entre les dues l. Crimson Pro, que va compondre aquest llibre fins a 1.29, eixampla el punt a 0,59 em en català i deixa un forat a intel·ligent. Alegreya i Literata dibuixen un punt més tancat només on els arriben les dues l en una mateixa peça, així que il·lustrats surt d'una manera en un paràgraf amb cursives i d'una altra en un que no en té.
  • Copia el text de Viquitexts amb les seves cursives: Oller marca tentu, Ensanxe i palacio com a col·loquials o castellanes, i una exportació en text pla les perd. Acara els mots dubtosos amb el facsímil del volum de 1928: sis vegades la transcripció porta tom- on el verb és tornar (tomà, tomaré, tomar), i una vegada jom per jorn.
  • Amb 6800 paraules, els cinc fitxers de contingut i el kit deixen l'script compost en uns 69 KB. Un llibre sencer és la mostra més llarga que cap en un pen; una obra més llarga va en un paquet .postext.

Crèdits

Text
  • El transplantat, complete, from the Obres completes, vol. VI (Barcelona, 1928), with misprints corrected, no opening ¿ ¡ and today’s dialogue dashes · Narcís Oller · domini públic
  • The note to the edition · Postext Cookbook · original
Imatges
  • Engraving, frontispiece: the baker at his oven's door · Generated With Diffusion Models · original
  • Engraving, chapter I: the night train into Barcelona · Generated With Diffusion Models · original
  • Engraving, chapter II: the village street in autumn · Generated With Diffusion Models · original
  • Engraving, chapter III: the Rambla at dawn · Generated With Diffusion Models · original
  • Engraving, chapter IV: the old man by the railway · Generated With Diffusion Models · original
Fonts
Gentium Book Plus (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1) · Cormorant SC (SIL OFL 1.1)
SandboxPDF