Saltar al contingut principal
Recepta número 16

Receptari · Capítol 2 · Text i tipografia

Castellà justificat en una novel·la de butxaca

El començament de Marianela en edició de butxaca: partició de mots del castellà, espais de menys d'1,7×, caplletra alçada i el plànol com a Figura 1.

En aquesta pàgina

pp. 8–9 · 1–2 de 5

  • Mostra en castellà: encara no hi ha edició en català
  • Format 115 × 180 mm
  • 1 columna
  • Gentium Book Plus 10/13,8
  • Libre Bodoni
  • Marcellus SC
  • 5 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 56 ms
  • 177 línies de codi

En poques paraules

Les primeres pàgines d'una novel·la castellana de 1878 en edició de butxaca. Ensenya a deixar igualats els espais entre paraules, partint les paraules per les seves síl·labes.

Què compondràs

El començament de Marianela (1878), de Galdós, en una edició de butxaca d'11,5 × 18 cm, amb un plànol conjectural de les mines de Socartes davant del capítol I. Sobre el títol, en Libre Bodoni cursiva, va capítulo primero en versaletes i escrit amb lletres; el text, en Gentium Book Plus, comença a un quart de l'alçada de la pàgina amb una caplletra alçada de color sang de bou. Les paraules es parteixen per síl·labes (hie-rro, esta-blecimiento) i els espais no passen d'1,7 vegades la seva amplada normal; cap paràgraf no acaba amb la resta d'una paraula partida. Els diàlegs porten guió llarg, el mateix que obre i tanca els incisos del narrador. La consigna del viatger va entre «cometes llatines», i entre “angleses” a la nota final, que la cita dins d'una altra cita. El plànol és la Figura 1, citada en el text com [fig. 1]. Les capçaleres, en Marcellus SC, porten l'autor a les parelles i el títol a les senars.

Aquesta recepta respon a

  • Com aconsegueixo una bona justificació i partició de mots en textos en castellà, francès o alemany?
  • Com evito vídues, òrfenes i últimes línies d'una sola paraula, i mantinc cada títol amb el seu text?
  • 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?
  • Com aconsegueixo les etiquetes «Figura» i «Taula» en la llengua del meu document?
  • Com afegeixo a una obertura una línia d'autor, una entradeta o un primer paràgraf amb caplletra?

La resposta curta

script.js · línies 47–62al codi complet
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' }));

Ingredients

Tipografia
Gentium Book Plus, Libre Bodoni, Marcellus SC (SIL OFL 1.1)
Recursos
  • The conjectural map of the Socartes mines, drawn in code in the page’s palette (Ignacio Ferro, MIT)

Elaboració

#1 · Síl·labes del castellà, espais continguts

El codi és a la resposta curta, més amunt. Els patrons de partició de mots del castellà els tria locale: 'es', igual que una etiqueta regional com 'es-ES' o 'es-MX'; les regles de l'anglès americà, que són les del locale per defecte, partirien cabal-los, hi-erro i establec-imiento (llengües admeses). La justificació, Knuth–Plass i les regles de vídues i òrfenes vénen activades de sèrie. A més, en una mesura de 86 mm cal contenir els espais: amb el maxWordSpacing: 2 per defecte, vuit línies passen d'1,6× i la més oberta arriba a 1,89×; amb 1,7, la més oberta es queda en 1,65×, perquè llavors l'algorisme parteix hie-rro i ca-lles (límits d'espaiat entre paraules). Per sobre del límit una línia costa molt més, però continua sent vàlida, així que en una mesura més estreta, si no hi ha un tall millor, s'hi pot passar. runtMinCharacters: 26 evita les restes de paraula partida que deixa passar el valor per defecte, 20 amplades d'espai: siem- / pre adelante. passa a ser Adelante, / siempre adelante., i So- / cartes [fig. 1]., de / Socartes [fig. 1]. (línies curtes).

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

script.js · línies 35–43al codi complet
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 marge inferior es calcula a partir del format, del marge superior i de LINES, així que la caixa té exactament 30 línies de 13,8 pt i tota pàgina plena acaba a la mateixa línia de base, com es veu a les pàgines 10 i 11. Amb mirror: true, el marge interior, de 15 mm, queda al costat del llom a les dues pàgines, i l'exterior, de 14 mm, al costat del tall (marges simètrics), i en la mesura de 86 mm hi caben uns 57 caràcters de Gentium Book Plus a 10 pt.

#3 · El capítol en lletres i una caplletra alçada

script.js · línies 66–95al codi complet
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 surt de l'atribut ordinal del mateix títol (atributs d'encapçalament). Un nivell numerat amb '{1:ordinal}' escriuria la paraula tot sol, però la làmina que precedeix el capítol també és un títol de nivell 1, així que aquest nivell no porta comptador. La caplletra pertany al nivell del capítol: el seu dropCap obre el primer paràgraf després de cada títol de nivell 1, i el paràgraf s'escriu al Markdown tal com es llegeix (caplletres). lines: 1 amb un fontSize de tres interlineats en fa una caplletra alçada, recolzada a la primera línia de base; la primera línia s'escurça el que mesuren la lletra i la separació per defecte, i es justifica amb la resta del paràgraf. La lletra sobresurt per sobre de la primera línia, i el paràgraf li reserva aquest espai en línies senceres: aquí, dues (RISE), així que minHeight acaba l'obertura a SINK - RISE línies i la primera línia de text continua caient a la línia SINK, a un quart de la caixa. El marginBottom: 0 del nivell del capítol substitueix el marge per defecte, que afegiria una línia en blanc. Un paràgraf amb caplletra no sagna la primera línia.

Pàgina 9: l'avanttítol i el títol del capítol, i la caplletra alçada al costat de la primera línia del text justificat.

#4 · El plànol, davant del capítol, com a Figura 1

script.js · línies 120–141al codi complet
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' col·loca el plànol on és ::resource{id="plano"}, sota un títol propi. Aquest títol converteix la pàgina 8 del llibre en una obertura, i a les obertures no s'imprimeixen capçaleres. El seu estil deixa buit el peu de pàgina i fixa el seu propi salt, de manera que la làmina queda davant del capítol I, sense capçalera ni foli, encara que els capítols comencin en pàgina senar (estils d'encapçalament). Els tipus en castellà de la resposta curta imprimeixen Figura 1. al peu del plànol (sense resourceTypes diria Figura 1.1, numerada per capítol) i Fig. 1 en el text, que el case="lower" del :ref del Markdown converteix en fig. 1. La referència va entre claudàtors, que a les edicions castellanes assenyalen allò que l'editor afegeix al text de l'autor.

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

script.js · línies 99–116al codi complet
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' posa l'autor a les parelles i 'odd' el títol a les senars, i pages: 'body' els deixa fora de l'obertura, on només apareix el foli al peu, l'element amb pages: 'opener'. Cada capçalera s'ancora a la pàgina i SHIFT la desplaça al centre de la caixa, que queda mig mil·límetre fora del centre de la pàgina perquè el marge interior i l'exterior no fan el mateix. Per això mateix el foli al peu té una versió per a cada paritat. Els folis van en Gentium, perquè en Marcellus SC l'1 i el 0 es confonen amb la I i la O.

#6 · La puntuació castellana, al Markdown

script.js · línies 145–153al codi complet
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, l'última, es tanca amb tres estils de paràgraf. Els asteriscs, de Bodoni i de color sang de bou, van centrats després d'un :::space{lines=2}, perquè les línies en blanc no afegeixen espai. La nota de l'edició va en cos 8,3 amb 11 pt d'interlineat, i el colofó, en cos 7,5 i en el gris de les capçaleres. La nota es queda en el color del text; si la poses en gris, l'estil necessita també un italicColor, o el títol Marianela, en cursiva, surt més fosc que la resta. Al Markdown, el diàleg comença amb guió llarg (—) i mai amb guionet, perquè un guionet seguit d'un espai al principi de la línia obre una llista. 1878. al començament de la nota obriria una llista numerada, i per això porta al davant un unidor de paraules (U+2060). Els asteriscs van escapats (\*); sense la barra, el primer obriria una llista amb pics i els altres dos una cursiva, i la línia desapareixeria.

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

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 pàgina senar

Amb 'odd', davant d'un capítol que hagués de començar en pàgina parella s'afegeix una pàgina en blanc, com en una edició menys atapeïda. El capítol I ja comença en senar, i la làmina conserva la seva pàgina perquè el seu estil fixa el seu propi salt.

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

#Numera les figures per capítol

Si es deixen els tipus en castellà tal com vénen, les figures es numeren dins de cada títol de primer nivell: el plànol passa a ser la Figura 1.1, i la referència, fig. 1.1.

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

Errors freqüents

Error freqüent

«1998. » o «- » al començament d'un paràgraf obren una llista

Un paràgraf que comença per un número, un punt i un espai, o per un guionet i un espai, es converteix en un element de llista. Posa un unidor de paraules (U+2060) davant del número i escriu els diàlegs amb guió llarg. Escapaments i caràcters literals →

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 →

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 →

  • Amb una caiguda de nou línies en lloc de vuit, la pàgina 11 es quedava una línia curta, perquè avoidWidows no deixa que un paràgraf comenci a l'última línia de la pàgina. Després de qualsevol canvi en la configuració o en el text, revisa el peu de totes les pàgines.
  • RISE és el nombre de línies que la caplletra alçada deixa lliures per sobre del text. Amb una altra lletra o un altre cos, aquest espai canvia: una inicial més petita potser en necessita només una, i llavors el text comença una línia més amunt, tret que minHeight canviï amb ella.
  • Cap d'aquestes fonts no porta l'asterisme ⁂ (U+2042) al seu fitxer latin de Fontsource, així que el navegador l'agafaria d'una font del sistema. Als llibres castellans, a més, el que és habitual són tres asteriscs espaiats.

Crèdits

Text
  • Marianela (1878), the opening of chapter I, “Perdido”, with today’s spelling and punctuation · Benito Pérez Galdós · domini públic
  • The edition’s note and the map’s caption · Postext Cookbook · original
Imatges
  • The conjectural map of the Socartes mines, drawn in code in the page’s palette · Ignacio Ferro · MIT
Fonts
Gentium Book Plus (SIL OFL 1.1) · Libre Bodoni (SIL OFL 1.1) · Marcellus SC (SIL OFL 1.1)
Sandbox