Saltar al contenido principal
Receta número 5

Recetario · Capítulo 4 · Cabeceras y folios

Cabeceras según la paridad en un libro de ensayos

Cabeceras por paridad y tipo de página: el título del libro en las pares, el del ensayo cortado en las impares y solo un folio al pie en las aperturas.

En esta página

pp. 30–31 · 2–3 de 5

  • Formato 132 × 198 mm
  • 1 columna
  • Baskervville 10,2/14
  • Alegreya SC
  • Libre Caslon Display
  • 5 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 56 ms
  • 174 líneas de código

En pocas palabras

Cinco páginas de un libro de ensayos de bolsillo. Enseña a poner el título del libro en lo alto de las páginas de la izquierda y el del ensayo en las de la derecha.

Lo que vas a componer

Las páginas 29 a 33 de los Ensayos de Montaigne en edición de bolsillo y traducción nueva: el capítulo IV entero y el arranque del V. Las pares llevan el título del libro en versales espaciadas, y las impares, el del ensayo en cursiva, cortado con puntos suspensivos porque el del capítulo IV tiene 87 caracteres. Cada folio va en una pestaña sepia en el margen exterior, a 3 mm de un filete de 0,5 pt en el borde de la caja. Las aperturas solo tienen un folio al pie, y la página en blanco anterior al capítulo V no lleva cabecera ni folio. El texto va en Baskervville sobre papel ahuesado; los títulos, en Libre Caslon Display, y los folios y el título del libro, en Alegreya SC. La configuración define todas las cabeceras, así que la del motor (Open Sans de 8 pt, en azul) no se imprime.

Esta receta responde a

  • ¿Cómo pongo cabeceras: el título del libro en la página izquierda, el del capítulo en la derecha y el folio por fuera?
  • ¿Cómo oculto las cabeceras en las aperturas y las páginas en blanco, o pinto una página par en blanco con el color de la parte?
  • ¿Cómo evito que los títulos, las negritas y las viñetas salgan en azul?

La respuesta corta

script.js · líneas 67–95en el código completo
const GAP = 3; // mm from the tab to the divider, which lands on the text block's edge
const HEAD = 12; // mm from the top edge of the page to the top of the tab
const CAP = t({ en: 60.5, es: 66.8 }); // mm: the head's widest line, set per edition so
// essay IV's is cut after 'false' and 'objetos'; a short running title suits any title
const page = (edge) => ({ to: 'page', edge }); // the trim box (gotcha: negative-offsets)
const header = { elements: [
  // Verso (even): tab | divider | THE BOOK'S TITLE from the frontmatter
  folio({ id: 'folio-even', parity: 'even', pages: 'body', anchor: page('top-left'),
    x: OUTER - GAP - TAB, y: HEAD }),
  divider({ id: 'rule-even', parity: 'even', from: 'folio-even', edge: 'right-of', x: GAP }),
  { kind: 'text', id: 'book', content: '{title}', parity: 'even', pages: 'body',
    fontFamily: 'Alegreya SC', fontSize: pt(FOLIO_PT), lineHeight: LINE / FOLIO_PT,
    color: col('muted'), textTransform: 'uppercase', letterSpacing: pt(1.3),
    placement: { anchor: { to: '#rule-even', edge: 'right-of' }, // top: the tab's top
      offset: { x: mm(2.5), y: pt(PAD.top) } } }, // PAD.top down: on the folio's baseline
  // Recto (odd): the essay's title, cut short with an ellipsis | divider | tab.
  folio({ id: 'folio-odd', parity: 'odd', pages: 'body', anchor: page('top-right'),
    x: -(OUTER - GAP - TAB), y: HEAD }), // from the right edge, a negative x runs inwards
  divider({ id: 'rule-odd', parity: 'odd', from: 'folio-odd', edge: 'left-of', x: -GAP }),
  { kind: 'text', id: 'essay', content: '{chapterTitle}', parity: 'odd', pages: 'body',
    fontFamily: 'Baskervville', italic: true, fontSize: pt(TITLE_PT),
    lineHeight: LINE / TITLE_PT, color: col('muted'),
    overflow: 'ellipsis-end', // stated, though a running head's default
    placement: { anchor: { to: '#rule-odd', edge: 'left-of' },
      offset: { x: mm(-2.5), y: pt(PAD.top) }, size: { maxWidth: mm(CAP) } } },
] };
// Openers: no head, only a drop folio HEAD above the page's foot, centred under the text block.
const footer = { elements: [folio({ id: 'drop-folio', parity: 'all', pages: 'opener',
  anchor: { to: 'container', edge: 'bottom' }, y: -HEAD })] };

Ingredientes

Tipografía
Baskervville, Libre Caslon Display, Alegreya SC (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Sustituye la cabecera azul de serie

script.js · líneas 14–26en el código completo
const palette = {
  ink: '#1f1b16', // text: a warm near-black, never #000
  sepia: '#8a5a2b', // the one accent: folio tabs, dividers, opener plates (5.3:1 on paper)
  muted: '#6f6558', // running heads, verse glosses, the colophon (5.2:1 on paper)
  paper: '#f8f4ec', // a warm off-white page; also the type reversed out of the sepia
};
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' } })),
  // Text-style defaults (headings, bold, italic, lists, boxes) link to 'main-color':
  // pointed at the sepia, none of them prints in the engine's blue.
  { id: 'main-color', name: 'sepia (defaults)', value: { hex: palette.sepia, model: 'hex' } },
];

Cada color de la configuración enlaza con una de estas entradas. Si dejas header sin definir, el motor dibuja su cabecera de serie: {title} en las impares y {chapterTitle} en las pares sobre un filete de 1 pt, en Open Sans 600 de 8 pt y en azul #295AA3 (cabeceras y pies). Si main-color toma el valor del sepia, cambian los colores por defecto del texto y también el de esa cabecera, pero su letra, su filete y el lado en que va cada título siguen siendo los del motor. Por eso aquí cada cabecera se escribe entera, con cada color enlazado a una entrada de la paleta. La negrita, la cursiva y las referencias también toman main-color por defecto, y bodyText les devuelve el color de la tinta.

#2 · Todas las cabeceras salen de una pestaña

script.js · líneas 31–48en el código completo
const FOLIO_PT = 7.5; // pt: the folio, and the book's title in capitals beside it
const TITLE_PT = 8.8; // pt: the essay's title, whose italic lowercase reads small at 7.5
const LINE = FOLIO_PT * 1.2; // pt: the folio and both titles share this line box and baseline
const PAD = { top: 1, bottom: 1.4 }; // pt: 0.4 pt more below for the descending 3, 5, 7, 9
const TAB = 7.5; // mm: the tab's width
const TAB_H = LINE + PAD.top + PAD.bottom; // pt: the tab's height, which the divider matches
const folio = ({ id, parity, pages, anchor, x = 0, y }) => ({
  kind: 'text', id, content: '{pageNumber}', parity, pages, fontFamily: 'Alegreya SC',
  fontSize: pt(FOLIO_PT), fontWeight: 700, lineHeight: LINE / FOLIO_PT, color: col('paper'),
  box: { backgroundColor: col('sepia'), borderRadius: mm(2), // a pill; the number is centred
    padding: { top: pt(PAD.top), bottom: pt(PAD.bottom) } }, // by default in both directions
  placement: { anchor, offset: { x: mm(x), y: mm(y) }, size: { width: mm(TAB) } },
});
const divider = ({ id, parity, from, edge, x }) => ({
  kind: 'rule', id, parity, pages: 'body', direction: 'vertical', thickness: pt(0.5),
  color: col('sepia'), placement: { anchor: { to: `#${from}`, edge }, offset: { x: mm(x) },
    size: { height: pt(TAB_H) } },
});

La respuesta corta ancla a 'page' la pestaña de cada cabecera, así que sus desplazamientos se miden desde el corte. Desde la esquina top-right, una x positiva saca la pestaña de la página; por eso la de la impar la lleva negativa. De la pestaña cuelga el filete, y del filete, el título (colocación de elementos). Las medidas de la pestaña van en constantes porque las demás piezas se miden a partir de ellas. El filete mide TAB_H de alto. El folio y los dos títulos comparten una caja de línea de 9 pt, y la línea de base de un texto de diseño cae al 80 % de la altura de esa caja, así que los tres quedan sobre la misma línea de base con cualquier cuerpo.

Página 30, par: pestaña, filete y título del libro, hacia dentro desde el margen exterior.
Página 31, impar: el título del ensayo, recortado antes del filete y de la pestaña del margen exterior.

#3 · Márgenes en espejo y líneas enteras

script.js · líneas 52–63en el código completo
const TRIM = { width: 132, height: 198 }; // mm
const TOP = 22; // mm: the top margin, which holds the heads (gotcha: header-paints-over-text)
const INNER = 15; // mm
const OUTER = 21; // mm: the outer margin, where the folio tabs hang
const LINES = 31; // whole lines of LEAD in the text block, so full pages end level
const MEASURE = TRIM.width - INNER - OUTER; // the text block's width: 96 mm
const geometry = { // left is the inner margin on a recto; mirror swaps it on the versos
  width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, // 150 dpi is for the screen
  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 },
};

Con mirror: true, el margen right es el exterior en la página impar y pasa a la izquierda en la par, así que OUTER es siempre el del corte delantero, donde cuelgan las pestañas. El margen inferior se calcula a partir del formato, del margen superior y de LINES, de modo que la caja de texto tiene exactamente LINES líneas de LEAD (aquí, 31 de 14 pt), tenga el formato o el margen superior que tenga. Toda página llena acaba en la línea 31, y por eso dos páginas enfrentadas, como la 30 y la 31, terminan a la misma altura.

#4 · La apertura muestra el título entero

script.js · líneas 99–121en el código completo
const PLATE = 26; // mm: a square plate at the head of the text block
const opener = {
  enabled: true,
  minHeight: mm(58), // the text of every essay starts on the same line
  slot: { elements: [
    { kind: 'box', id: 'plate', style: { backgroundColor: col('sepia') },
      placement: { anchor: { to: 'container', edge: 'top-left' },
        size: { width: mm(PLATE), height: mm(PLATE) } } },
    { kind: 'text', id: 'numeral', content: '{attr.num}', fontFamily: 'Libre Caslon Display',
      fontSize: pt(48), lineHeight: 1, color: col('paper'),
      placement: { anchor: { to: '#plate', edge: 'align-top' }, // the plate's own box, where
        size: { width: mm(PLATE), height: mm(PLATE) } } }, // the text centres by default
    { kind: 'text', id: 'book', content: '{subtitle}', fontFamily: 'Alegreya SC',
      fontSize: pt(8.5), letterSpacing: pt(1.4), color: col('sepia'), align: 'left',
      placement: { anchor: { to: 'container', edge: 'top-left' },
        offset: { x: mm(PLATE + 4.5), y: mm(PLATE - 2.9) } } }, // its baseline on the plate's foot
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: 'Libre Caslon Display',
      fontSize: pt(20), lineHeight: 1.12, color: col('ink'), align: 'left',
      overflow: 'wrap', // an opener shows the whole title; the running head cuts it
      placement: { anchor: { to: '#plate', edge: 'below' }, offset: { y: mm(6) },
        size: { width: mm(MEASURE) } } },
  ] },
};

La apertura compone el título completo con overflow: 'wrap', partido en cada \\ de la línea del encabezado. Solo una apertura a toda la página respeta esos saltos, y de ahí el span: 'page' del nivel (saltos de línea en los títulos). En la cabecera, {chapterTitle} da siempre el título en una sola línea, y los puntos suspensivos cortan esa línea. El número romano sale del atributo {num="IV"} del título, y las versalitas junto a la placa, del subtitle del frontmatter.

#5 · Cada ensayo abre en página impar

script.js · líneas 139–147en el código completo
  headings: { // 400, the face's only weight: the default 700 would ask for one that is missing
    fontFamily: 'Libre Caslon Display', fontWeight: 400, color: col('ink'),
    levels: [
      // 'odd' puts every opener on a recto, adding a blank verso when one is needed;
      // span: 'page' makes the design an opener, where a \\ in the title breaks the line.
      { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
        marginTop: pt(0), marginBottom: pt(0), advancedDesign: opener },
    ],
  },

Con 'odd', a un ensayo que termina en impar le sigue una página par en blanco. Aquí el capítulo IV acaba en una impar, de modo que la 32 queda en blanco y el V abre en la 33. El pages: 'body' de las cabeceras las deja fuera de las páginas en blanco y de las aperturas (las páginas cuyo primer bloque es este título). El pages: 'opener' del pie imprime el folio solo en las aperturas (elementos de texto).

#6 · Los folios empiezan en 29

script.js · líneas 251–255en el código completo
// 28 pages come before this one, so recto and verso, the mirrored margins and the odd/even
// heads follow the book page (gotcha: parity-page1-recto); the folios start at 29.
const continuation = { pageIndexOffset: 28, pageNumbering: { startAt: 29 } };
const doc = await buildDocumentWithFonts({ markdown, continuation }, config(), kitFonts(FONTS));
showPages(doc, { title: t({ en: 'Running heads by parity', es: 'Cabeceras según la paridad' }) });

parity se calcula a partir del lugar que ocupa la página en el libro, y el folio no interviene. pageIndexOffset: 28 suma 28 al índice de cada página, así que las impares y las pares, los márgenes en espejo y las cabeceras de cada lado siguen la página del libro. Después, pageNumbering.startAt numera estas páginas del 29 al 33. Sin ese desplazamiento, la primera página compuesta es impar, sea cual sea su folio. Con el folio 29 coincide por casualidad, pero con startAt: 30 el título del libro caería en la 31 y el del ensayo en la 32, cada uno en el lado equivocado de la doble página.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 005 · Running heads by parity ═══════════════════════════════
// https://postext.dev/en/cookbook/running-heads-by-parity
// Code: MIT · Text: Montaigne, tr. Cotton (PD, Gutenberg #3600); es: new translation (MIT)
// Fonts: Baskervville, Libre Caslon Display, Alegreya SC (SIL OFL 1.1) · Needs postext ≥ 1.57.0
// Pages 29 to 33 of a pocket Montaigne. Versos carry the book's title and rectos the essay's,
// the folios sit in tabs in the outer margin, and an opener prints only a folio at the foot.
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'running-heads-by-parity';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: four colours with semantic ids; main-color points at the sepia
const palette = {
  ink: '#1f1b16', // text: a warm near-black, never #000
  sepia: '#8a5a2b', // the one accent: folio tabs, dividers, opener plates (5.3:1 on paper)
  muted: '#6f6558', // running heads, verse glosses, the colophon (5.2:1 on paper)
  paper: '#f8f4ec', // a warm off-white page; also the type reversed out of the sepia
};
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' } })),
  // Text-style defaults (headings, bold, italic, lists, boxes) link to 'main-color':
  // pointed at the sepia, none of them prints in the engine's blue.
  { id: 'main-color', name: 'sepia (defaults)', value: { hex: palette.sepia, model: 'hex' } },
];
// #endregion
const LEAD = 14; // pt: the body leading, the pitch of the baseline grid

// #region tab: the folio tab and its divider, the two pieces every head is built from
const FOLIO_PT = 7.5; // pt: the folio, and the book's title in capitals beside it
const TITLE_PT = 8.8; // pt: the essay's title, whose italic lowercase reads small at 7.5
const LINE = FOLIO_PT * 1.2; // pt: the folio and both titles share this line box and baseline
const PAD = { top: 1, bottom: 1.4 }; // pt: 0.4 pt more below for the descending 3, 5, 7, 9
const TAB = 7.5; // mm: the tab's width
const TAB_H = LINE + PAD.top + PAD.bottom; // pt: the tab's height, which the divider matches
const folio = ({ id, parity, pages, anchor, x = 0, y }) => ({
  kind: 'text', id, content: '{pageNumber}', parity, pages, fontFamily: 'Alegreya SC',
  fontSize: pt(FOLIO_PT), fontWeight: 700, lineHeight: LINE / FOLIO_PT, color: col('paper'),
  box: { backgroundColor: col('sepia'), borderRadius: mm(2), // a pill; the number is centred
    padding: { top: pt(PAD.top), bottom: pt(PAD.bottom) } }, // by default in both directions
  placement: { anchor, offset: { x: mm(x), y: mm(y) }, size: { width: mm(TAB) } },
});
const divider = ({ id, parity, from, edge, x }) => ({
  kind: 'rule', id, parity, pages: 'body', direction: 'vertical', thickness: pt(0.5),
  color: col('sepia'), placement: { anchor: { to: `#${from}`, edge }, offset: { x: mm(x) },
    size: { height: pt(TAB_H) } },
});

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

#Pon un titulillo corto a los títulos largos

Escribe el titulillo en la línea del encabezado, {num="IV" short="Los objetos falsos"}, e imprime el atributo en lugar del título entero; un capítulo sin short no imprime nada ahí.

-  { kind: 'text', id: 'essay', content: '{chapterTitle}', parity: 'odd', pages: 'body',
+  { kind: 'text', id: 'essay', content: '{attr.short}', parity: 'odd', pages: 'body',

#Deja que los ensayos abran en cualquier página

Con 'any', cada ensayo empieza en la página siguiente, par o impar, y nunca se añade una página en blanco. La placa cuelga de la esquina superior izquierda de la caja de texto y el folio del pie va centrado bajo ella, así que los dos quedan igual en par que en impar.

-      { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
+      { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },

#Pinta de sepia la página en blanco

Un elemento box con pages: 'blank' solo se imprime en las páginas que añade el salto a impar: en esta edición llena de sepia la página 32, y la edición inglesa, que no tiene página en blanco, no cambia.

 const footer = { elements: [folio({ id: 'drop-folio', parity: 'all', pages: 'opener',
-  anchor: { to: 'container', edge: 'bottom' }, y: -HEAD })] };
+  anchor: { to: 'container', edge: 'bottom' }, y: -HEAD }),
+  { kind: 'box', id: 'blank-leaf', pages: 'blank', style: { backgroundColor: col('sepia') },
+    placement: { anchor: page('top-left'),
+      size: { width: mm(TRIM.width), height: mm(TRIM.height) } } }] };

Errores frecuentes

Error frecuente

Los desplazamientos negativos relativos al contenedor no pintan nada

El texto de diseño de ancho automático se limita a su contenedor, así que un desplazamiento negativo respecto al contenedor lo saca fuera y no se pinta nada. Ancla esos elementos a la página o a la sangre con desplazamientos explícitos en mm, o dales un ancho fijo. Anclaje de elementos de diseño →

Error frecuente

Los elementos de cabecera y pie se pintan encima del texto

Los elementos de cabecera y pie se pintan sobre la página y el área de texto no les deja sitio. Mantenlos dentro de los márgenes, que son los que les reservan el espacio. Cabeceras y folios →

Error frecuente

La página 1 es impar: planifica con números físicos

La página 1 queda a la derecha y la 2 es la primera página par, así que planifica los pliegos con números de página físicos: una apertura en página par queda frente a la impar que la sigue. Saltos de página y de columna →

Aviso de maquetación · designTextTruncated

Texto de diseño recortado

Por qué. Un elemento de texto de un diseño (un titulillo, un folio, una apertura de capítulo, una página de parte, una fila de parte del índice) era más ancho que su sitio y perdió parte de una línea: se cortó con puntos suspensivos, como pide su overflow, o se recortó con tinta fuera de su caja con overflow: 'clip'. Los titulillos, los folios y las filas de parte del índice terminan en puntos suspensivos por defecto; los diseños de encabezado y de parte pasan de línea salvo que el elemento diga otra cosa. Un titulillo recortado en todas las páginas de un capítulo se avisa una sola vez.

Solución. Pon overflow: 'wrap' en el elemento para repartir el texto en más líneas, dale más sitio (un size.width o maxWidth mayor, un fontSize menor, un letterSpacing más apretado) o acorta el texto. Deja los puntos suspensivos donde el diseño es una sola línea, como en un titulillo; el aviso solo confirma entonces lo que se cortó. Documentación →

Comprobación del Sandbox · headerFooterUnknownPlaceholder

Marcador desconocido

Por qué. Un texto de diseño usa un marcador {nombre} que no existe, así que se imprime tal cual.

Solución. Usa un marcador admitido ({pageNumber}, {chapterTitle}, {title}, {attr.x}…), o escribe {{ y }} para llaves literales. Documentación →

Comprobación del Sandbox · headerFooterMetadataMissing

Falta el metadato del marcador

Por qué. Un marcador como {author} o {title} no tiene valor en los metadatos del documento, así que se imprime vacío.

Solución. Añade el valor al frontmatter, entre comillas, o quita el marcador. Documentación →

  • CAP está fijado en cada edición para el título del ensayo IV, el único que muestra aquí una cabecera. Los puntos suspensivos van tras la última palabra entera que cabe, y esa palabra puede ser una preposición: con 64 mm esta cabecera acabaría en «…sus pasiones sobre…». Un libro de títulos largos necesita el titulillo corto de las variantes.
  • En la edición inglesa, subir minWordSpacing de 0,7 a 0,75 deja la primera línea del ensayo V («Quintus Marcius, the Roman legate…») sin ningún corte dentro de la horquilla, y sus espacios entre palabras se abren hasta 2,4 veces su ancho normal. En la española no pasa. Después de cualquier cambio, revisa las líneas más abiertas que lista la captura.

Créditos

Texto
Fuentes
Baskervville (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Alegreya SC (SIL OFL 1.1)
Sandbox