Saltar al contenido principal
Receta número 47

Recetario · Capítulo 4 · Cabeceras y folios

Guía de paseos con pestañas de índice

Guía de bolsillo con un estilo de encabezado por paseo, cuya paleta cambia la pestaña del corte, las paradas, el tono del recuadro y la página en blanco previa.

pp. 6–7 de 7

  • Formato 120 × 200 mm
  • 1 columna
  • Albert Sans 9,4/13,2
  • Asap Condensed
  • DM Serif Display
  • 7 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 52 ms
  • 245 líneas de código

En pocas palabras

Una guía de bolsillo de paseos por Lisboa. Cada paseo tiene su color, que aparece en una pestaña en el borde de la página para encontrarlo con el pulgar.

Lo que vas a componer

Las siete primeras páginas de Lisboa a pie, guía de bolsillo de 120 × 200 mm. La cubierta es una pared de azulejos azules y blancos con el título en una placa enmarcada como un rótulo de calle lisboeta, y la página 2 presenta los tres paseos con un plano de sus rutas. Cada paseo tiene un color, terracota para Alfama y amarillo para la Baixa, y una pestaña en el corte lleva ese color y su número a la misma altura en cada página del paseo. Con el paseo cambian también la banda de la apertura, las paradas, la cabecera de la página impar y el tono del recuadro «No te lo pierdas». La página par en blanco que empuja el paseo 2 a una impar va pintada de su amarillo y lleva su número. El texto es Albert Sans en bandera; los nombres, DM Serif Display, y los rótulos, Asap Condensed.

Esta receta responde a

  • ¿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 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 añado una pestaña numerada («RECUADRO 1-1»), un icono de esquina o un icono al margen con un filete?
  • ¿Cómo añado muestras de color como leyenda en el texto, los pies o las notas de tabla?

La respuesta corta

script.js · líneas 60–81en el código completo
// '# Alfama {style="alfama"}' opens a section that runs to the next level-1 heading. Its
// palette gives band, bandInk, onBand and wash the walk's values on the section's pages,
// in the page furniture and in the text alike.
const walkStyles = Object.keys(WALKS).map((id) => ({ id, palette: WALKS[id] }));
// The tab has one size and one place on every page, hanging from the foot of the opener
// band; only its colour and its number change from walk to walk.
const TAB = { y: BAND, width: 7, height: 24 }; // mm
const tab = (parity, edge) => text(`tab-${parity}`, '{chapterNumber}', {
  ...label, fontSize: pt(11), fontWeight: 700, color: col('onBand'), align: 'center',
  verticalAlign: 'middle', overflow: 'clip', box: { backgroundColor: col('band') },
  parity, pages: 'all', // the walk's first page is an 'opener' page: the tab goes there too
}, { ...at('bleed', edge, 0, TAB.y), ...size(mm(TAB.width), mm(TAB.height)) });
const tabs = [tab('odd', 'top-right'), tab('even', 'top-left')]; // on the fore-edge
// The blank verso that pushes a walk onto a recto belongs to that walk (gotcha:
// section-last-wins), so the field takes the next walk's colour and its numeral the number.
const blankPage = [
  box('field', { backgroundColor: col('band') },
    { ...at('bleed', 'top-left', 0, 0), ...size('fill', 'fill') }),
  tileImage('field-tiles', 'tiles-page', 'top-left', 'fill', 'auto'),
  text('field-number', '{chapterNumber}', { ...display, fontSize: pt(220), lineHeight: 1,
    color: col('onBand'), overflow: 'clip' }, at('page', 'bottom-left', MARGIN.outer, -24)),
].map((el) => ({ ...el, pages: 'blank' }));

Ingredientes

Tipografía
Albert Sans, DM Serif Display, Asap Condensed (SIL OFL 1.1)
Recursos
  • Los azulejos, el plano de las rutas y sus pines, dibujados en código (Ignacio Ferro, CC BY 4.0)

Elaboración

#1 · Nombra los colores que cambia un paseo

script.js · líneas 16–40en el código completo
const palette = {
  ink: '#1b2430', // text: a blue-black
  paper: '#fffdf8', // the page
  band: '#1f4e9c', // the section colour: tile blue until a walk replaces it
  bandInk: '#1d4a94', // the section colour for type on paper
  onBand: '#ffffff', // type set on the band
  wash: '#e8eef8', // the section's box tint
  muted: '#5e6875', // running heads, notes, chip outlines
};
// Each walk's values for those four. Baixa yellow is too light for white type, so its
// onBand is the ink. The text is recoloured by value, so the four base values must differ.
const WALKS = {
  alfama: { band: '#b9533a', bandInk: '#a1432b', onBand: '#ffffff', wash: '#f7e7e0' },
  baixa: { band: '#e2b23d', bandInk: '#7d5a0f', onBand: '#1b2430', wash: '#fbf0d5' },
  belem: { band: '#2b7a78', bandInk: '#236866', onBand: '#ffffff', wash: '#e1eeed' },
};
const NAMES = { alfama: 'Alfama', baixa: 'Baixa', belem: 'Belém' };
// A walk's palette follows the paletteId; the hex beside it is the colour's base value.
const col = (id) => ({ hex: palette[id] ?? WALKS[id].band, model: 'hex', paletteId: id });
const entry = (id, hex) => ({ id, name: id, value: { hex, model: 'hex' } });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => entry(id, hex)),
  ...Object.entries(WALKS).map(([id, w]) => entry(id, w.band)), // for :swatch{color="alfama"}
  entry('main-color', palette.ink), // the engine's defaults link here: nothing prints blue
];

La palette de un estilo de encabezado sustituye entradas por su id en las páginas de su sección (estilos de encabezado), así que todo color que deba seguir al paseo se enlaza a una de cuatro entradas: band para los campos de color, la pestaña y los círculos de las paradas; bandInk para el texto sobre papel; onBand para el texto sobre un campo, y wash para el recuadro. El blanco sobre el amarillo de la Baixa da un contraste de 2:1, así que el onBand de ese paseo es la tinta, con 8:1. Los elementos de diseño siguen el id, mientras que el texto se recolorea por valor: un color igual al hex base de una entrada toma el valor del paseo, y por eso los cuatro valores base son distintos. El título del recuadro en la página 4 y la línea que te manda al paseo 2 en la página 5 son texto en bandInk, y los dos salen en terracota.

#2 · Deja las cabeceras en las páginas de texto

script.js · líneas 85–107en el código completo
const head = (id, content, parity, placement, style = {}) => ({ ...text(id, content, {
  ...label, fontSize: pt(7.8), letterSpacing: pt(1.3), color: col('muted'), overflow: 'clip',
  ...style }, placement), parity, pages: 'body' }); // never on openers or blank pages
const folio = { fontSize: pt(8.5), fontWeight: 700, color: col('ink') };
// Anchored to the page: from its top-right corner a negative x runs inwards
// (gotcha: negative-offsets).
const heads = [
  head('verso-folio', '{pageNumber}', 'even', at('page', 'top-left', MARGIN.outer, HEAD.y), folio),
  head('verso-title', '{title}', 'even', at('page', 'top-left', MARGIN.outer + HEAD.gap, HEAD.y)),
  head('recto-title', `${t({ en: 'Walk', es: 'Paseo' })} {chapterNumber} · {chapterTitle}`, 'odd',
    at('page', 'top-right', -(MARGIN.outer + HEAD.gap), HEAD.y), { color: col('bandInk') }),
  head('recto-folio', '{pageNumber}', 'odd', at('page', 'top-right', -MARGIN.outer, HEAD.y), folio),
];
// Array order is paint order: the blank page's field comes last and covers the tab there.
const header = { elements: [...heads, ...tabs, ...blankPage] };
// A walk's first page has no running head: its folio drops to the foot.
const footer = { elements: [{ ...head('drop-folio', '{pageNumber}', 'all',
  at('container', 'top', 0, 7), folio), pages: 'opener', align: 'center' }] };
// Page 2 comes before Walk 1, where {chapterNumber} is empty, so its header has no tabs. With
// the level's break off (gotcha: style-inherits-break), it is a 'body' page.
const introStyle = { id: 'intro', numbered: false, header: { elements: heads },
  breakBefore: { enabled: false }, advancedDesign: { enabled: false },
  fontSize: pt(24), lineHeight: pt(2 * LEAD), marginBottom: pt(LEAD / 2) };

Tras la composición, cada página recibe una función (elementos de texto). La primera página de un paseo es opener, porque su título fuerza un salto de página; la página de relleno antes de una impar es blank, y las demás son body. Las cabeceras llevan pages: 'body', así que no salen en las aperturas de las páginas 3 y 7 ni en la página en blanco 6, y el folio al pie lleva 'opener'. La página par imprime el {title} del frontmatter, y la impar, Paseo {chapterNumber} · {chapterTitle} en bandInk, terracota en la página 5. Las pestañas de la respuesta corta llevan 'all'. El campo de la página en blanco va después en la lista, y como el orden de la lista es el orden de pintado, tapa la pestaña en la página 6. La introducción de la página 2 va antes del paseo 1 y allí {chapterNumber} está vacío, así que su estilo lleva un header propio con las cuatro cabeceras y sin pestañas. Sin él, la página 2 imprimiría una pestaña azul vacía.

#3 · Abre cada paseo bajo su banda y numera sus paradas

script.js · líneas 111–138en el código completo
const walkLevel = { level: 1, breakBefore: { enabled: true, parity: 'odd' }, // a recto
  // The band ends 30 mm into the text area; a floor of 8 grid lines, with nothing added
  // under it, starts the text 7.3 mm below the band.
  marginBottom: pt(0), advancedDesign: { enabled: true, minHeight: pt(8 * LEAD), slot: {
    elements: [
      box('band', { backgroundColor: col('band') },
        { ...at('bleed', 'top-left', 0, 0), ...size('fill', mm(BAND)) }),
      tileImage('tiles', 'tiles-band', 'top-right', 'auto', mm(BAND)),
      text('kicker', `${t({ en: 'Walk', es: 'Paseo' })} {chapterNumber}`, { ...label,
        fontSize: pt(9), letterSpacing: pt(2), color: col('onBand') },
      at('page', 'top-left', MARGIN.inner, 17)), // walks open on rectos: inner is left
      text('title', '{titleText}', { ...display, fontSize: pt(34), lineHeight: 1,
        color: col('onBand') }, { ...at('#kicker', 'below', 0, 1), ...size(mm(70), 'auto') }),
      text('route', '{attr.route}', { fontFamily: 'Albert Sans', italic: true, fontSize: pt(10),
        color: col('onBand') }, { ...at('#title', 'below', 0, 1.5), ...size(mm(70), 'auto') }),
    ] } } };
const STOP = 5.4; // mm: the diameter of a stop's circle
const stopLevel = { level: 3, numberingTemplate: '{3}', // restarts at every walk
  // A grid line above a stop and no margin under it, so the circle can sit 3.2 mm down its
  // two grid lines: about 8.3 mm of white above a stop and 2.1 under it, 6.4 between paragraphs.
  marginTop: pt(LEAD), marginBottom: pt(0), advancedDesign: { enabled: true, slot: { elements: [
    text('number', '{number}', { ...label, fontSize: pt(9), fontWeight: 700, align: 'center',
      verticalAlign: 'middle', color: col('onBand'), overflow: 'clip',
      box: { backgroundColor: col('band'), borderRadius: mm(STOP / 2) } },
    { ...at('container', 'top-left', 0, 3.2), ...size(mm(STOP), mm(STOP)) }),
    text('name', '{titleText}', { ...display, fontSize: pt(13.5), lineHeight: 1.1,
      color: col('ink') }, { ...at('#number', 'right-of', 2.4, 0.2), ...size('fill', 'auto') }),
  ] } } };

La banda se ancla al sangrado, que aquí es el corte, y entra 30 mm en el área de texto. El diseño termina con la banda, y minHeight reserva ocho líneas de la rejilla base, 37,3 mm; la apertura ocupa la mayor de las dos alturas, así que en las páginas 3 y 7 el texto empieza 7,3 mm bajo la banda. Cada parada es un encabezado de nivel 3 cuyo diseño pone {number} en un círculo de 5,4 mm relleno de band. La plantilla {3} vuelve a empezar en cada paseo, porque un encabezado de nivel 1 reinicia los contadores inferiores, y los pines del plano llevan los mismos números. Una parada lleva una línea de rejilla de margen encima y ninguna debajo, y su círculo baja 3,2 mm dentro de las dos líneas que ocupa el título. Quedan unos 8,3 mm de blanco sobre el círculo y 2,1 mm bajo él; entre párrafos hay 6,4 mm.

#4 · Cuelga un azulejo del recuadro y deja los chips en tinta

script.js · líneas 166–181en el código completo
const calloutStyles = [{ id: 'dontmiss', title: t({ en: 'Don’t miss', es: 'No te lo pierdas' }),
  background: col('wash'), // one device: the walk's tint
  // The tile hangs half off the box's outer side, flush with its top: the left side on a verso.
  // With 6.5 mm of padding on both sides the title stays in line with the box's text there too.
  // The tile's colours are drawn into the SVG, so it stays tile blue in every walk.
  padding: { top: mm(3.4), right: mm(6.5), bottom: mm(3.4), left: mm(6.5) },
  icon: { kind: 'resource', resourceId: 'tile', size: mm(10), position: 'corner',
    cornerSide: 'outer' },
  titleStyle: { ...label, fontSize: pt(8.5), fontWeight: 700, letterSpacing: pt(1.5),
    color: col('bandInk') },
  body: { fontSize: pt(9), lineHeight: pt(12.4), color: col('ink') } }];
// The facts are ink on paper in every walk: the walk's colour is kept for the tab, the stops
// and the box, and a chip linked to 'band' would follow it too.
const chipStyles = [{ id: 'fact', background: col('paper'), borderColor: col('muted'),
  borderWidth: pt(0.6), borderRadius: mm(0.8), paddingX: mm(1.4), paddingY: mm(0.5),
  fontFamily: 'Asap Condensed', fontSize: em(0.92), color: col('ink'), bold: true }];

El recuadro solo lleva el tono claro del paseo, sin filete ni borde, y un azulejo dibujado en código en su esquina (estilos de recuadro). cornerSide: 'outer' cuelga el azulejo medio fuera del lado exterior del recuadro, a ras de su borde superior; en la página 4, par, es el lado izquierdo, donde empieza el título. Con 6,5 mm de relleno a los dos lados, el título libra el azulejo y se alinea con el texto del recuadro en cualquiera de las dos páginas. La paleta del paseo cambia el tono y el título, pero el azulejo sigue azul, porque sus colores van dibujados en el SVG. Un chip enlazado a band tomaría también el color del paseo; aquí los datos se quedan al margen, así que los chips van en tinta sobre papel, con un contorno gris en muted, iguales en todos los paseos.

#5 · Haz la leyenda del plano con muestras de color

script.js · líneas 529–543en el código completo
const map = svg('routes', MAP.width, MAP.height, { placement: { position: 'here' }, ...t({ en: {
  caption: 'The three walks. The numbered pins are the stops in the text.',
  note: ':swatch{color="alfama"} Walk 1, Alfama · :swatch{color="baixa"} Walk 2, Baixa · '
    + ':swatch{color="belem"} Walk 3, Belém, 6 km west (inset)',
  altText: 'Map of central Lisbon north of the river: the yellow route runs from the '
    + 'waterfront up the Baixa grid to Rossio; the terracotta route climbs east from the '
    + 'cathedral through Alfama. An inset shows the teal Belém route.',
}, es: {
  caption: 'Los tres paseos. Los pines numerados son las paradas del texto.',
  note: ':swatch{color="alfama"} Paseo 1, Alfama · :swatch{color="baixa"} Paseo 2, Baixa · '
    + ':swatch{color="belem"} Paseo 3, Belém, 6 km al oeste (en el detalle)',
  altText: 'Plano del centro de Lisboa al norte del río: la ruta amarilla sube desde el '
    + 'muelle por la cuadrícula de la Baixa hasta el Rossio; la terracota sube hacia el este '
    + 'desde la catedral por Alfama. En un detalle, la ruta verde azulada de Belém.',
} }) });

El plano es un recurso SVG que va donde está ::resource{id="routes"}, con un tipo de recurso propio para que su pie diga «Plano 1». En la nota, tres muestras de color hacen de leyenda de las rutas: :swatch{color="alfama"} y las de baixa y belem. Una muestra de color acepta el id de una entrada de la paleta (formato en línea). La paleta recibe de WALKS una entrada por paseo, y el dibujo toma los colores de las rutas del mismo objeto, así que la leyenda coincide con las rutas y con las pestañas. Los números de los pines se dibujan con trazos, así que el plano no lleva ninguna fuente.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 047 · Walking guide with thumb tabs ═══════════════════
// https://postext.dev/en/cookbook/walking-guide-thumb-tabs
// Code: MIT · Text: original (CC BY 4.0) · Map and tiles: drawn in code (CC BY 4.0)
// Fonts: Albert Sans, DM Serif Display, Asap Condensed (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// A pocket guide to Lisbon. Each walk is a heading style that sets four colours, and the tab,
// the stop numbers, the box's tint and title and the blank page before the walk take them.
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'walking-guide-thumb-tabs';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: 'band' and three partners are the entries a walk overrides
const palette = {
  ink: '#1b2430', // text: a blue-black
  paper: '#fffdf8', // the page
  band: '#1f4e9c', // the section colour: tile blue until a walk replaces it
  bandInk: '#1d4a94', // the section colour for type on paper
  onBand: '#ffffff', // type set on the band
  wash: '#e8eef8', // the section's box tint
  muted: '#5e6875', // running heads, notes, chip outlines
};
// Each walk's values for those four. Baixa yellow is too light for white type, so its
// onBand is the ink. The text is recoloured by value, so the four base values must differ.
const WALKS = {
  alfama: { band: '#b9533a', bandInk: '#a1432b', onBand: '#ffffff', wash: '#f7e7e0' },
  baixa: { band: '#e2b23d', bandInk: '#7d5a0f', onBand: '#1b2430', wash: '#fbf0d5' },
  belem: { band: '#2b7a78', bandInk: '#236866', onBand: '#ffffff', wash: '#e1eeed' },
};
const NAMES = { alfama: 'Alfama', baixa: 'Baixa', belem: 'Belém' };
// A walk's palette follows the paletteId; the hex beside it is the colour's base value.
const col = (id) => ({ hex: palette[id] ?? WALKS[id].band, model: 'hex', paletteId: id });
const entry = (id, hex) => ({ id, name: id, value: { hex, model: 'hex' } });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => entry(id, hex)),
  ...Object.entries(WALKS).map(([id, w]) => entry(id, w.band)), // for :swatch{color="alfama"}
  entry('main-color', palette.ink), // the engine's defaults link here: nothing prints blue
];
// #endregion
const TRIM = { width: 120, height: 200 }; // a pocket guide
// Mirrored, and tighter than a book's at top and foot: a pocket guide keeps 164 mm of text.
const MARGIN = { top: 18, bottom: 18, inner: 14, outer: 16 };
const MEASURE = TRIM.width - MARGIN.inner - MARGIN.outer; // 90 mm, about 55 characters
const LEAD = 13.2; // body leading in pt: the baseline grid
const BAND = 48; // mm: a walk opener's colour band, from the top edge
const HEAD = { y: 10, gap: 7 }; // running heads from the top edge; folio to title (mm)

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

#Deja sin pintar la página par en blanco

Sin el campo, la página 6 conserva su pestaña: pages: 'all' la imprime también en la página en blanco, en el amarillo del paseo 2 y con un 2.

-const header = { elements: [...heads, ...tabs, ...blankPage] };
+const header = { elements: [...heads, ...tabs] };

#Añade el tercer paseo

WALKS ya tiene los colores de Belém y walkStyles su estilo, así que basta un título. El paseo empieza en la página 9, y la 8, que queda en blanco, va pintada de verde azulado con un 3 blanco.

+# Belém {style="belem" route="Del monasterio a la torre"}
+
+El tranvía 15 va de la Praça da Figueira a Belém junto al río.

Errores frecuentes

Error frecuente

Una página toma la cabecera de la última sección que empieza en ella

Cuando dos estilos de título empiezan en la misma página, esta toma la cabecera, el pie y la paleta del último. Una página en blanco de separación pertenece al capítulo anterior, y el relleno de paridad al siguiente. Cabeceras por sección →

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

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

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 →

  • La página 6 existe porque el paseo 1 termina en la página 5, impar. Un paseo que termina en página par no deja página en blanco, y entonces el color del paseo siguiente solo se ve en sus propias páginas.
  • Antes del primer paseo numerado, {chapterNumber} está vacío, así que un elemento que lo imprima, como la pestaña, necesita allí un estilo que lo deje fuera.

Créditos

Texto
Texto original, CC BY 4.0
Imágenes
  • Los azulejos, el plano de las rutas y sus pines, dibujados en código · Ignacio Ferro · CC BY 4.0
Fuentes
Albert Sans (SIL OFL 1.1) · DM Serif Display (SIL OFL 1.1) · Asap Condensed (SIL OFL 1.1)
Sandbox