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
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
- Funciones
- Separación silábica e idioma del documentoCorte de líneas óptimo (Knuth–Plass)Cubiertas, portadas y colofonesAperturas diseñadasImágenes en los diseños de páginaEstilos de títuloAtributos de títuloTextos, filetes y cajas en los diseños de páginaCapítulos que abren en página imparCabeceras y foliosCabeceras según el tipo de páginaMárgenes simétricosColor del papelEstilos de párrafoTipos de recurso propiosViudas, huérfanas y líneas cortasMetadatos del documentoPaleta de color semánticaExportación a PDFFuentes incrustadas en el PDF
- Tipografía
- Gentium Book Plus, Cormorant Garamond, Cormorant SC (SIL OFL 1.1)
- Recursos
cap1-1200.jpgcap2-1200.jpgcap3-1200.jpgcap4-1200.jpgfrontis-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.

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
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
// # 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
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
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
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
// ═══ 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
localedel 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
- Receta
- Ignacio Ferro
- 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)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


