Saltar al contenido principal
Receta número 104

Recetario · Capítulo 2 · Texto y tipografía

Una novela corta en catalán, con la división del IEC

El transplantat de Oller, completo, en un bolsillo de 32 páginas: sílabas catalanas según el IEC, l·l cortada como il- | lusió y un grabado por capítulo.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.57.0 · postext-pdf ≥ 1.57.0
Licencia
Actualizada el 22 oct 2026
Código MIT · Texto MIT

pp. 2–3 de 32

  • Formato 120 × 185 mm
  • 1 columna
  • Gentium Book Plus 9,8/14
  • Cormorant Garamond
  • Cormorant SC
  • 32 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 163 ms
  • 180 líneas de código

En pocas palabras

Una novela corta entera en catalán, compuesta como un libro de bolsillo. Las palabras se cortan a final de línea como piden las normas catalanas, también la ele doble con punto.

Lo que vas a componer

El transplantat de Narcís Oller entero, con el texto de sus Obres completes (Barcelona, 1928), en un libro de bolsillo de 12 × 18,5 cm y 32 páginas. Antes de los cuatro capítulos van una anteportada, un frontispicio con el panadero ante su horno, la portada en Cormorant Garamond cursiva y roja, y una nota sobre la edición. Cada capítulo se abre bajo un grabado de doce líneas de alto, con su número romano en rojo. El texto, en Gentium Book Plus de 9,85 pt, se divide por sílabas catalanas como pide el Institut d’Estudis Catalans: al menos dos letras a cada lado, ningún corte entre vocales en hiato ni justo después de un apóstrofo, y titil·laven se corta titil- | laven, con el guion en el lugar del punto volado. Los diálogos llevan raya y las citas, «cometes baixes».

Esta receta responde a

  • ¿Cómo consigo una buena justificación y separación silábica en textos en español, francés o alemán?
  • ¿Cómo doy a cada capítulo su propia foto, su color o una variante de apertura?
  • ¿Cómo compongo ilustraciones sin numerar: adornos, viñetas, logotipos?
  • ¿Cómo escribo rayas de diálogo, años al principio de párrafo, precios y símbolos literales sin que el Markdown los malinterprete?

La respuesta corta

script.js · líneas 49–64en el código completo
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
};

Ingredientes

Tipografía
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
  • Grabado, frontispicio: el panadero a la puerta del horno (Generated With Diffusion Models, original)
  • Grabado, capítulo I: el tren nocturno llega a Barcelona (Generated With Diffusion Models, original)
  • Grabado, capítulo II: la calle del pueblo en otoño (Generated With Diffusion Models, original)
  • Grabado, capítulo III: la Rambla al amanecer (Generated With Diffusion Models, original)
  • Grabado, capítulo IV: el viejo junto a la vía (Generated With Diffusion Models, original)

Elaboración

#1 · El catalán por su código

El código es la respuesta corta de arriba. locale: 'ca' elige los patrones catalanes, que desde postext 1.14 siguen el Llibre d’estil del IEC (idiomas admitidos). Son los mismos patrones que usa TeX, con al menos dos letras a cada lado del corte en lugar de las tres del paquete de npm, así que ter-ra, cai-xa y plu-ja pueden cortarse. Las vocales en hiato no se separan (cièn-cia, ca-mions), pero una i entre vocales abre su sílaba (fe-ia). La ela geminada se corta entre sus dos l: la línea acaba en titil- y la siguiente empieza por laven, sin punto volado en ninguna de las dos, y Knuth–Plass mide la línea sin el punto.

Página 27: titil·laven a final de línea, compuesta titil- | laven. Es la única l·l que cae a final de línea en estas 32 páginas.

compounds: false deja enteros el verbo y su pronombre salvo por su propio guion (arrossegar- | se), que es el corte que prefiere el IEC (separación silábica). Cuesta una línea floja: en la página 7, la línea anterior a d’inaugurar-se abre sus espacios hasta 1,88 veces, aunque maxJustifyTracking: 10 absorbe el exceso en las demás.

#2 · Una página de bolsillo de líneas enteras

script.js · líneas 38–45en el código completo
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 margen inferior sale del formato, el margen superior y LINES, así que la caja admite 29 líneas de 14 pt y toda página llena acaba en la misma línea base. La medida de 89 mm da unos 63 caracteres de Gentium Book Plus. mirror: true mantiene el margen de 16 mm en el lomo en las dos páginas enfrentadas (márgenes simétricos).

#3 · Una apertura para los cuatro capítulos

script.js · líneas 68–83en el código completo
// # 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}' dibuja la imagen que indica el título, así que # II {style="capitol" art="cap2"} abre el capítulo II bajo su propio grabado con el mismo estilo que los demás (atributos de título). minHeight guarda dieciséis líneas, doce para el grabado y cuatro para el número y su filete, así que el texto empieza en la línea diecisiete de la página, igual en todos los capítulos.

#4 · Cuatro páginas antes del capítulo I

script.js · líneas 87–116en el código completo
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 pieza de los preliminares es un encabezado de primer nivel con estilo propio: # El transplantat {style="portada"} imprime el autor y el subtítulo del frontmatter y el título como título. Cada estilo repite su salto de página, porque un estilo hereda el de su nivel, y vacía la cabecera y el pie, así que estas páginas no llevan cabeceras ni folios. El frontispicio cae en la página 2, par, y queda enfrente de la portada.

#5 · El autor en la par, el título en la impar

script.js · líneas 120–134en el código completo
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 pone el autor en las páginas pares y el título en las impares; pages: 'body' las saca de las aperturas, donde va un folio al pie con pages: 'opener'. SHIFT centra cada cabecera sobre la caja, que está medio milímetro desplazada del centro de la página porque los dos márgenes no miden lo mismo.

#6 · Cinco grabados, sin pie

script.js · líneas 138–154en el código completo
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 } }));

Las imágenes son de un tipo de recurso con captionPrefix vacío, así que nada las numera ni las rotula. Cada una se declara con su tamaño en píxeles y se carga con su identificador de archivo antes de componer. Antes de guardarlas se llevó su blanco al crema de la página y su negro a la tinta del texto, así que se imprimen como parte de la página y no como fotos pegadas encima.

La receta 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

El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

Variantes

#Que los pronombres también se corten

Con el compounds: true por defecto, d’inaugurar-se se corta dentro del verbo, d’i- | naugurar-se, y la página 7 pierde su línea floja: ninguna línea del libro pasa de 1,6 veces. El corte titil- | laven sigue en la página 27. El precio es una i suelta tras el apóstrofo a final de línea.

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

#Abrir cada capítulo en página impar

parity: 'odd' añade una página en blanco antes de un capítulo que empezaría en par, como en una edición más holgada. El capítulo IV, que se abre en la página 26, pasa a la 27 tras una página en blanco.

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

Errores frecuentes

Error frecuente

Un estilo de título hereda el salto de página de su nivel

Una entrada de headingStyles toma de su nivel de título todo lo que no fija, también breakBefore. Un índice o un colofón con estilo sobre un H1 tras un :::pagebreak hereda la paridad 'odd' y cae detrás de una página en blanco. Dale a ese estilo breakBefore: { enabled: false }. Estilos de título →

Error frecuente

Valores de atributo: sin { ni }; comillas simples si llevan "

Un valor de atributo termina en la llave de cierre, así que no puede contener { ni }. Un valor que lleve comillas dobles va entre comillas simples; el signo de dólar no da problemas. Atributos de título →

  • Mira cómo compone l·l una fuente de texto antes de quedarte con ella. Desde postext 1.30 el locale del documento es también el idioma en el que se compone el texto (hasta 1.29 era el de la página que mostraba el libro), y cada fuente responde al catalán a su manera. Gentium Book Plus tiene un solo punto volado para todos los idiomas, con 0,17 em entre las dos l. Crimson Pro, que compuso este libro hasta 1.29, ensancha el punto a 0,59 em en catalán y deja un hueco en intel·ligent. Alegreya y Literata dibujan un punto más cerrado solo donde les llegan las dos l en una misma pieza, así que il·lustrats sale de una manera en un párrafo con cursivas y de otra en uno sin ellas.
  • Copia el texto de Viquitexts con sus cursivas: Oller marca tentu, Ensanxe y palacio como coloquiales o castellanas, y una exportación en texto plano las pierde. Coteja las palabras dudosas con el facsímil del volumen de 1928: seis veces la transcripción trae tom- donde el verbo es tornar (tomà, tomaré, tomar), y una vez jom por jorn.
  • Con 6800 palabras, los cinco archivos de contenido y el kit dejan el script compuesto en unos 69 KB. Un libro entero es la muestra más larga que cabe en un pen; una obra más larga va en un paquete .postext.

Créditos

Texto
  • El transplantat, completo, de las Obres completes, vol. VI (Barcelona, 1928), con las erratas corregidas, sin ¿ ¡ iniciales y con los diálogos marcados con raya como hoy · Narcís Oller · dominio público
  • La nota a la edición · Postext Cookbook · original
Imágenes
  • Grabado, frontispicio: el panadero a la puerta del horno · Generated With Diffusion Models · original
  • Grabado, capítulo I: el tren nocturno llega a Barcelona · Generated With Diffusion Models · original
  • Grabado, capítulo II: la calle del pueblo en otoño · Generated With Diffusion Models · original
  • Grabado, capítulo III: la Rambla al amanecer · Generated With Diffusion Models · original
  • Grabado, capítulo IV: el viejo junto a la vía · Generated With Diffusion Models · original
Fuentes
Gentium Book Plus (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1) · Cormorant SC (SIL OFL 1.1)
SandboxPDF