Saltar al contenido principal
Receta número 16

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

Español justificado en una novela de bolsillo

El comienzo de Marianela en edición de bolsillo: separación silábica del español, espacios de menos de 1,7×, capitular alzada y el plano como Figura 1.

pp. 8–9 · 1–2 de 5

  • Formato 115 × 180 mm
  • 1 columna
  • Gentium Book Plus 10/13,8
  • Libre Bodoni
  • Marcellus SC
  • 5 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 56 ms
  • 177 líneas de código

En pocas palabras

Las primeras páginas de una novela española de 1878 en edición de bolsillo. Enseña a dejar parejos los espacios entre palabras, partiendo las palabras por sus sílabas.

Lo que vas a componer

El comienzo de Marianela (1878), de Galdós, en una edición de bolsillo de 11,5 × 18 cm, con un plano conjetural de las minas de Socartes frente al capítulo I. Sobre el título, en Libre Bodoni cursiva, va capítulo primero en versalitas y escrito con letras; el texto, en Gentium Book Plus, empieza a un cuarto de la altura de la página con una capitular alzada color sangre de toro. Las palabras se parten por sílabas (hie-rro, esta-blecimiento) y los espacios no pasan de 1,7 veces su ancho normal; ningún párrafo termina con el resto de una palabra partida. Los diálogos llevan raya, la misma que abre y cierra los incisos del narrador. La consigna del viajero va entre «comillas latinas», y entre “inglesas” en la nota final, que la cita dentro de otra cita. El plano es la Figura 1, citada en el texto como [fig. 1]. Las cabeceras, en Marcellus SC, llevan el autor en las pares y el título en las impares.

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 evito viudas, huérfanas y últimas líneas de una sola palabra, y mantengo cada título con su texto?
  • ¿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?
  • ¿Cómo consigo las etiquetas «Figura» y «Tabla» en el idioma de mi documento?
  • ¿Cómo añado a una apertura una línea de autor, una entradilla o un primer párrafo con capitular?

La respuesta corta

script.js · líneas 47–62en el código completo
const LOCALE = 'es'; // config().locale: Spanish hyphenation, and Spanish caption labels
const bodyText = { // config().bodyText
  fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  referenceBold: false, // '[fig. 1]' reads in roman, like the words around it
  firstLineIndent: mm(4), indentAfterHeading: false, // a paragraph after a heading starts flush
  // The defaults justify, hyphenate, break by Knuth–Plass and keep widows and orphans out.
  // Long Spanish words on an 86 mm measure need two more settings. Spaces under 1.7×: at
  // the default 2×, eight lines here open past 1.6×; at 1.7 it hyphenates hie-rro, ca-lles.
  // A last line under 26 space widths is a runt; at 20, 'siem- / pre adelante.' got through.
  maxWordSpacing: 1.7, runtMinCharacters: 26,
};
// config().resourceTypes: the built-in types, 'Figura' and 'Fig.' in Spanish, renumbered
// through the book (Figura 1) where the default counts by chapter (Figura 1.1).
const resourceTypes = defaultResourceTypes(LOCALE)
  .map((type) => ({ ...type, numberingTemplate: '{n}', resetOn: 'never' }));

Ingredientes

Tipografía
Gentium Book Plus, Libre Bodoni, Marcellus SC (SIL OFL 1.1)
Recursos
  • El plano conjetural de las minas de Socartes, dibujado en código con la paleta de la página (Ignacio Ferro, MIT)

Elaboración

#1 · Sílabas del español, espacios contenidos

El código está en la respuesta corta, más arriba. Los patrones de separación silábica del español los elige locale: 'es', igual que una etiqueta regional como 'es-ES' o 'es-MX'; las reglas del inglés americano, que son las del locale por defecto, partirían cabal-los, hi-erro y establec-imiento (idiomas admitidos). La justificación, Knuth–Plass y las reglas de viudas y huérfanas vienen activadas de serie. Además, en una medida de 86 mm hay que contener los espacios: con el maxWordSpacing: 2 por defecto, ocho líneas pasan de 1,6× y la más abierta llega a 1,89×; con 1,7, la más abierta se queda en 1,65×, porque entonces el algoritmo parte hie-rro y ca-lles (límites de espaciado entre palabras). Por encima del límite una línea cuesta mucho más, pero sigue siendo válida, así que en una medida más estrecha, si no hay un corte mejor, puede pasarse. runtMinCharacters: 26 evita los restos de palabra partida que deja pasar el valor por defecto, 20 anchos de espacio: siem- / pre adelante. pasa a ser Adelante, / siempre adelante., y So- / cartes [fig. 1]., de / Socartes [fig. 1]. (líneas cortas).

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

script.js · líneas 35–43en el código completo
const TRIM = { width: 115, height: 180 }; // mm: 11.5 × 18 cm
const [TOP, INNER, OUTER] = [16, 15, 14]; // mm: a pocket page keeps its margins tight
const LINES = 30; // lines of LEAD per page, so every full page ends on the same line
const MEASURE = TRIM.width - INNER - OUTER; // 86 mm: about 57 characters of Gentium at 10 pt
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 * LEAD * 25.4) / 72),
    left: mm(INNER), right: mm(OUTER), mirror: true }, // left is inner on a recto
};

El margen inferior se calcula a partir del formato, del margen superior y de LINES, así que la caja tiene exactamente 30 líneas de 13,8 pt y toda página llena acaba en la misma línea de base, como se ve en las páginas 10 y 11. Con mirror: true, el margen interior, de 15 mm, queda del lado del lomo en las dos páginas, y el exterior, de 14 mm, del lado del corte (márgenes simétricos), y en la medida de 86 mm caben unos 57 caracteres de Gentium Book Plus a 10 pt.

#3 · El capítulo en letras y una capitular alzada

script.js · líneas 66–95en el código completo
const [LABEL_Y, RULE_Y, TITLE_Y] = [4, 10.5, 13.5]; // mm below the top of the text block
const SINK = 8; // lines of LEAD above the text: the chapter drops a quarter of the page
const INITIAL = 3 * LEAD; // pt: the initial's size, three leads
const RISE = 2; // lines of LEAD the raised initial keeps clear above the first line
const centred = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) } });
const opener = {
  enabled: true,
  slot: { elements: [
    // The ordinal is written in the heading, # Perdido {ordinal="primero"}: the plate before
    // the chapter is a level-1 heading too, so the level carries no counter.
    { kind: 'text', id: 'chapter', content: 'capítulo {attr.ordinal}', ...smallCaps,
      placement: centred(LABEL_Y) },
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6),
      color: col('oxblood'), placement: { ...centred(RULE_Y), size: { width: mm(9) } } },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, italic: true,
      fontSize: pt(26), lineHeight: 1.1, color: col('ink'), align: 'center',
      overflow: 'wrap', // a longer title takes a second line
      placement: centred(TITLE_Y) },
  ] },
  // The text starts SINK lines down; the initial's rise takes the last RISE of them.
  minHeight: pt((SINK - RISE) * LEAD),
};
// parity 'any': each chapter opens on the next page, as pocket books do.
// marginBottom replaces the level's default, a blank line of its own. The first paragraph
// of the chapter opens with a raised initial: lines: 1 stands it on the first baseline,
// three leads tall, and the paragraph keeps its rise clear above it.
const chapter = { level: 1, breakBefore: { enabled: true, parity: 'any' },
  marginBottom: pt(0), advancedDesign: opener,
  dropCap: { lines: 1, fontFamily: DISPLAY, fontWeight: 700, fontSize: pt(INITIAL),
    color: col('oxblood') } };

capítulo primero sale del atributo ordinal del propio título (atributos de encabezado). Un nivel numerado con '{1:ordinal}' escribiría la palabra él solo, pero la lámina que precede al capítulo también es un encabezado de nivel 1, así que este nivel no lleva contador. La capitular pertenece al nivel del capítulo: su dropCap abre el primer párrafo tras cada encabezado de nivel 1, y el párrafo se escribe en el Markdown tal como se lee (letras capitulares). lines: 1 con un fontSize de tres interlineados la convierte en una capitular alzada, apoyada en la primera línea de base; la primera línea se acorta lo que miden la letra y el espacio por defecto que la separa del texto, y se justifica con el resto del párrafo. La letra sobresale por encima de la primera línea, y el párrafo deja libre ese saliente en líneas enteras: aquí dos (RISE), así que minHeight cierra la apertura a SINK - RISE líneas y la primera línea del texto sigue cayendo en la línea SINK, a un cuarto de la altura de la página. El marginBottom: 0 del nivel del capítulo sustituye al margen por defecto, que añadiría una línea en blanco. Un párrafo con capitular pierde la sangría de primera línea.

Página 9: el antetítulo y el título del capítulo, y la capitular alzada junto a la primera línea del texto justificado.

#4 · El plano, enfrente del capítulo, como Figura 1

script.js · líneas 120–141en el código completo
const MAP_H = 112; // mm: a frontispiece map, the measure wide
const resources = [{
  id: 'plano', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
  svg: { fileId: 'plano.svg', width: MEASURE, height: MAP_H }, // the ratio: set column-wide
  placement: { position: 'here' }, // where ::resource{id="plano"} stands, not a float
  caption: 'El camino de Golfín: de Villafangosa, por la pasadera y el cerro, al talud de '
    + 'las minas de Socartes.',
  note: 'Plano conjetural dibujado para esta edición a partir del capítulo primero.',
  altText: 'Plano: abajo, la villa, el río y la pasadera; en medio, un cerro arbolado; arriba, '
    + 'las minas en gradas. Un punteado lleva de la villa al talud de las minas.',
}];
// The plate's heading, # Las minas de Socartes {style="lamina"}, opens a page the heads skip.
const frontispiece = {
  id: 'lamina', // its own break, or it takes the chapter's (gotcha: style-inherits-break)
  breakBefore: { enabled: true, parity: 'any' }, marginBottom: pt(0),
  footer: { elements: [] }, // no drop folio
  advancedDesign: { enabled: true, slot: { elements: [{ kind: 'text', id: 'name',
    content: '{titleText}', ...smallCaps, // a line down: the plate centres on the page
    placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: pt(LEAD) } } }] } },
};
const captionStyle = { fontFamily: TEXT, fontSize: pt(8.3), gap: mm(2),
  labelColor: col('oxblood'), descriptionItalic: true, note: { color: col('muted') } };

position: 'here' coloca el plano donde está ::resource{id="plano"}, bajo un título propio. Ese título convierte la página 8 del libro en una apertura, y en las aperturas no se imprimen cabeceras. Su estilo deja vacío el pie de página y fija su propio salto, de modo que la lámina queda frente al capítulo I, sin cabecera ni folio, aunque los capítulos empiecen en página impar (estilos de encabezado). Los tipos en español de la respuesta corta imprimen Figura 1. en el pie del plano (sin resourceTypes diría Figura 1.1, numerada por capítulo) y Fig. 1 en el texto, que el case="lower" del :ref del Markdown convierte en fig. 1. La referencia va entre corchetes, que en las ediciones españolas señalan lo que el editor añade al texto del autor.

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

script.js · líneas 99–116en el código completo
const [HEAD_Y, DROP_Y] = [9, -10]; // mm: heads from the top edge, drop folio from the foot
const head = (id, content, parity, edge, x, y = HEAD_Y, pages = 'body') => ({
  kind: 'text', id, content, parity, pages, // running heads skip the openers
  fontFamily: LABEL, fontSize: pt(8), letterSpacing: pt(1.2), color: col('muted'),
  placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(y) } },
});
const SHIFT = (INNER - OUTER) / 2; // mm: the text block's centre is off the page's centre
// Folios in the text face (Marcellus SC's 1 and 0 read as I and O), on the heads' baseline.
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', -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,
  DROP_Y, 'opener'), ...folio }); // a chapter can open on either side of the spread
const footer = { elements: [drop('odd', SHIFT), drop('even', -SHIFT)] };

parity: 'even' pone el autor en las pares y 'odd' el título en las impares, y pages: 'body' los deja fuera de la apertura, donde solo aparece el folio al pie, el elemento con pages: 'opener'. Cada cabecera se ancla a la página y SHIFT la desplaza al centro de la caja, que queda medio milímetro fuera del centro de la página porque el margen interior y el exterior no miden lo mismo. Por eso mismo el folio al pie tiene una versión para cada paridad. Los folios van en Gentium, porque en Marcellus SC el 1 y el 0 se confunden con la I y la O.

#6 · La puntuación española, en el Markdown

script.js · líneas 145–153en el código completo
const paragraphStyles = [
  { id: 'asterismo', fontFamily: DISPLAY, fontSize: pt(11), color: col('oxblood'),
    textAlign: 'center' },
  // In ink: a muted note would need italicColor too, for its italic Marianela.
  { id: 'nota', fontSize: pt(8.3), lineHeight: pt(LEAD * 0.8), firstLineIndent: pt(0),
    marginTop: pt(LEAD) },
  { id: 'colofon', fontSize: pt(7.5), color: col('muted'), textAlign: 'center',
    firstLineIndent: pt(0), marginTop: pt(LEAD / 2) },
];

La página 12, la última, se cierra con tres estilos de párrafo. Los asteriscos, de Bodoni y en color sangre de toro, van centrados tras un :::space{lines=2}, porque las líneas en blanco no añaden espacio. La nota de la edición va en cuerpo 8,3 con 11 pt de interlineado, y el colofón, en cuerpo 7,5 y en el gris de las cabeceras. La nota se queda en el color del texto; si la pones en gris, el estilo necesita también un italicColor, o el título Marianela, en cursiva, sale más oscuro que el resto. En el Markdown, el diálogo empieza con raya (—) y nunca con guion, porque un guion seguido de un espacio al principio de la línea abre una lista. 1878. al comienzo de la nota abriría una lista numerada, y por eso lleva delante un unidor de palabras (U+2060). Los asteriscos van escapados (\*); sin la barra, el primero abriría una lista con viñetas y los otros dos una cursiva, y la línea desaparecería.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 016 · Justified Spanish in a pocket novel ═════════════════
// https://postext.dev/en/cookbook/spanish-pocket-novel
// Code: MIT · Text: B. Pérez Galdós, Marianela, 1878 (PD, Gutenberg #17340) · Map: drawn in code
// Fonts: Gentium Book Plus, Libre Bodoni, Marcellus SC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, renderPageToCanvas, defaultResourceTypes, registerResourceImage,
  inlineSvgFonts,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document (this recipe is Spanish only)
const RECIPE = 'spanish-pocket-novel';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
  ink: '#1e1b18', // text: a warm near-black
  oxblood: '#8b2e2a', // the one accent: chapter label, rule, initial, asterisks, route
  muted: '#6d645a', // running heads, the map's paths, the caption's credit
  paper: '#f7f2e8', // an ivory book paper
  slag: '#c8553d', moss: '#6f7a4f', water: '#58707f', // the map: mined earth, woods, river
};
// col(id): a colour linked to its palette entry, in text styles and design slots alike.
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: 'oxblood (defaults)', value: { hex: palette.oxblood, model: 'hex' } },
];
const TEXT = 'Gentium Book Plus'; // the text face
const DISPLAY = 'Libre Bodoni'; // the chapter's title and the initial
const LABEL = 'Marcellus SC'; // small capitals: chapter label, running heads, map names
const [BODY, LEAD] = [10, 13.8]; // pt: the body size, and its leading: the grid's pitch
const smallCaps = { fontFamily: LABEL, fontSize: pt(9), letterSpacing: pt(1.6), // 2 labels
  color: col('oxblood'), align: 'center' };

// #region page: a pocket paperback; the text block holds 30 whole lines
const TRIM = { width: 115, height: 180 }; // mm: 11.5 × 18 cm
const [TOP, INNER, OUTER] = [16, 15, 14]; // mm: a pocket page keeps its margins tight
const LINES = 30; // lines of LEAD per page, so every full page ends on the same line
const MEASURE = TRIM.width - INNER - OUTER; // 86 mm: about 57 characters of Gentium at 10 pt
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 * LEAD * 25.4) / 72),
    left: mm(INNER), right: mm(OUTER), mirror: true }, // left is inner on a recto
};
// #endregion

// #region answer: Spanish syllables, word spaces under 1.7×, captions that say Figura
const LOCALE = 'es'; // config().locale: Spanish hyphenation, and Spanish caption labels
const bodyText = { // config().bodyText

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

#Abre cada capítulo en página impar

Con 'odd', delante de un capítulo que fuera a empezar en página par se añade una página en blanco, como en una edición menos apretada. El capítulo I ya empieza en impar, y la lámina conserva su página porque su estilo fija su propio salto.

-const chapter = { level: 1, breakBefore: { enabled: true, parity: 'any' },
+const chapter = { level: 1, breakBefore: { enabled: true, parity: 'odd' },

#Numera las figuras por capítulo

Si se dejan los tipos en español tal como vienen, las figuras se numeran dentro de cada encabezado de primer nivel: el plano pasa a ser la Figura 1.1, y la referencia, fig. 1.1.

-const resourceTypes = defaultResourceTypes(LOCALE)
-  .map((type) => ({ ...type, numberingTemplate: '{n}', resetOn: 'never' }));
+const resourceTypes = defaultResourceTypes(LOCALE);

Errores frecuentes

Error frecuente

«1998. » o «- » al principio de un párrafo abren una lista

Un párrafo que empieza por un número, un punto y un espacio, o por un guion y un espacio, se convierte en un elemento de lista. Pon un unidor de palabras (U+2060) antes del número y escribe los diálogos con raya. Escapes y caracteres literales →

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 →

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 →

  • Con una caída de nueve líneas en lugar de ocho, la página 11 se quedaba una línea corta, porque avoidWidows no deja que un párrafo empiece en la última línea de la página. Después de cualquier cambio en los ajustes o en el texto, revisa el pie de todas las páginas.
  • RISE es el número de líneas que la capitular alzada deja libres por encima del texto. Otra fuente u otro cuerpo cambian lo que sobresale la letra: una capitular menor puede necesitar una sola línea, y entonces el texto empieza una línea más arriba, salvo que minHeight cambie con ella.
  • Ninguna de estas fuentes trae el asterismo ⁂ (U+2042) en su archivo latin de Fontsource, así que el navegador lo sacaría de una fuente del sistema. En los libros españoles, además, lo habitual son tres asteriscos espaciados.

Créditos

Texto
  • Marianela (1878), comienzo del capítulo I, «Perdido», con la ortografía y la puntuación actuales · Benito Pérez Galdós · dominio público
  • La nota a la edición y el pie del plano · Postext Cookbook · original
Imágenes
  • El plano conjetural de las minas de Socartes, dibujado en código con la paleta de la página · Ignacio Ferro · MIT
Fuentes
Gentium Book Plus (SIL OFL 1.1) · Libre Bodoni (SIL OFL 1.1) · Marcellus SC (SIL OFL 1.1)
Sandbox