Saltar al contenido principal
Receta número 92

Recetario · Capítulo 5 · Estructura del libro

Un manual cuyas remisiones apuntan a páginas

Un manual de bicicleta cuyas remisiones dicen «consulta el apartado 3.2, en la página 3», hacia delante y hacia atrás, con números y páginas de la maqueta.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Licencia
Actualizada el 11 oct 2026
Código MIT · Texto CC BY 4.0
  • Formato 148 × 210 mm
  • 1 columna
  • Archivo 9,3/13
  • Archivo Narrow
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 64 ms
  • 131 líneas de código

En pocas palabras

Un manual breve para una bicicleta de cicloturismo. Cuando el texto te manda a otro apartado, da su número y la página en que está, y los dos son enlaces.

Lo que vas a componer

El manual del usuario de una bicicleta de cicloturismo ficticia, la Ardena T3: cuatro páginas A5 en Archivo, con el nombre del modelo en una banda azul marino sobre la primera. Un manual no se lee en orden, así que cada instrucción que depende de otra dice dónde está: consulta el apartado 3.2, en la página 3. Quien lo escribe da un identificador a un encabezado, un párrafo o una frase de un paso y escribe :ref allí donde el texto remite a él; Postext imprime el número, el título o la página y lo convierte en enlace. El índice de la portada se escribe igual, así que mover un apartado, o traducir el manual y dejar que se recomponga, nunca deja un número viejo.

Esta receta responde a

  • ¿Cómo remito a una sección y a la página en que está, y mantengo ambas correctas cuando el libro cambia?

La respuesta corta

script.js · líneas 28–38en el código completo
// In the Markdown, `## Brakes {#sec-brakes}` names a heading, `:anchor{#warn-pressure}`
// a point in a paragraph and `[close the lever]{#step-close-lever}` a phrase in a step.
// `:ref{id="sec-pad-wear"}` prints "section 3.2", `style=page` "page 3", `style=title`
// the heading's words and `style=pageNumber` the bare 3. The page numbers come from the
// previous layout pass: the engine lays the manual out again until they hold.
const crossRefs = {
  section: t({ en: 'section {n}', es: 'apartado {n}' }), // H2 and H3: "section 3.2"
  page: t({ en: 'page {n}', es: 'página {n}' }), // spelt out: a manual is read by anyone
};
// Every reference is a link in the PDF and on screen; this makes it look like one.
const references = { referenceColor: col('orange'), referenceBold: true };

Ingredientes

Tipografía
Archivo, Archivo Narrow (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Nombra aquello a lo que remite el texto

El código es la respuesta corta de arriba. Los títulos llevan un identificador al modo de Pandoc, ### Desgaste de las pastillas {#sec-pad-wear}; el aviso sobre la presión empieza con :anchor{#warn-pressure}, una marca invisible; el último paso para montar la rueda es [cierra la palanca de modo que apunte hacia atrás]{#step-close-lever}, que conserva sus palabras y les pone nombre; y el recuadro se abre con :::callout{#box-wet type="note" title="Con lluvia"}. Una remisión al paso imprime sus palabras; una al recuadro, su título.

#2 · Un destino, cuatro maneras de nombrarlo

:ref{id="sec-pad-wear"} imprime apartado 3.2 con la palabra de crossRefs.section; style=page imprime página 3 con la de crossRefs.page; style=title imprime Desgaste de las pastillas; style=pageNumber, el 3 solo. El índice de la portada combina el número solo, el título y la página sola, así que se lee como un índice de verdad. En inglés las mismas remisiones imprimen section 3.2 y page 3, porque las plantillas siguen el idioma de la edición.

#3 · Las páginas se ajustan solas

El número de página solo se conoce cuando el manual ya está compuesto. El motor lo compone, lee la página en que cayó cada destino y vuelve a componerlo hasta que ninguna remisión cambia, el mismo bucle que rellena un índice. Un texto que crece al traducirlo, o un apartado que pasa delante, cambia las páginas, y las remisiones las siguen hacia delante y hacia atrás.

#4 · Los números salen del contador de nivel 2

script.js · líneas 42–47en el código completo
const H2 = { level: 2, numberingTemplate: '{2}', numberSeparator: '   ', fontFamily: DISPLAY,
  fontWeight: 700, fontSize: pt(15), lineHeight: pt(LEAD * 1.5), color: col('navy'),
  marginTop: pt(LEAD), marginBottom: pt(LEAD / 3) };
const H3 = { level: 3, numberingTemplate: '{2}.{3}', numberSeparator: '  ', fontFamily: DISPLAY,
  fontWeight: 700, fontSize: pt(10.5), lineHeight: pt(LEAD), color: col('ink'),
  marginTop: pt(LEAD / 2), marginBottom: pt(LEAD / 4) };

El manual tiene un solo encabezado de nivel 1, el nombre del modelo en la portada, así que sus apartados se numeran desde el nivel 2: {2} da del 1 al 5 y {2}.{3} da 1.1, 1.2.

#5 · La portada es la apertura de ese título

script.js · líneas 51–73en el código completo
const BAND = 104; // mm from the trim's top
const label = { fontFamily: DISPLAY, fontWeight: 700, textTransform: 'uppercase',
  letterSpacing: pt(1.6), align: 'left' };
const cover = {
  enabled: true,
  minHeight: mm(BAND - PAGE.top + 8), // the contents start 8 mm under the band
  slot: { elements: [
    { kind: 'box', id: 'band', style: { backgroundColor: col('navy') },
      placement: { ...at('page', 'top-left'), size: { width: 'fill', height: mm(BAND) } } },
    { kind: 'box', id: 'stripe', style: { backgroundColor: col('orange') },
      placement: { ...at('page', 'top-left', 0, BAND), size: { width: 'fill', height: mm(2.5) } } },
    { kind: 'text', id: 'kicker', content: '{attr.kicker}', ...label, fontSize: pt(9),
      color: col('tint'), placement: at('container', 'top-left', 0, 6) },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontWeight: 700,
      fontSize: pt(58), lineHeight: 1, color: col('paper'), align: 'left',
      placement: at('container', 'top-left', -1, 30) },
    { kind: 'text', id: 'subtitle', content: '{attr.subtitle}', fontFamily: TEXT,
      fontSize: pt(11), color: col('paper'), align: 'left',
      placement: at('container', 'top-left', 0, 55) },
    { kind: 'text', id: 'edition', content: '{attr.edition}', ...label, fontSize: pt(7.5),
      color: col('tint'), placement: at('container', 'top-left', 0, 74) },
  ] },
};

La banda mide 104 mm, media página, y la cierra una franja naranja. El antetítulo, el subtítulo y la línea de la edición son atributos del encabezado, así que la edición española los cambia en su propio texto.

script.js · líneas 13–20en el código completo
const palette = {
  ink: '#1b1f24', navy: '#1d2c3c', orange: '#b8471b', tint: '#f7e7de', rule: '#d5cfc8',
  muted: '#5c636b', paper: '#ffffff',
};
// Each colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.orange })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 092 · A manual whose references point to pages ══════════
// https://postext.dev/en/cookbook/manual-see-page-references
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Archivo, Archivo Narrow (SIL OFL 1.1) · Needs postext ≥ 1.28.0
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'manual-see-page-references';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a navy cover band and one signal orange for numbers and references
const palette = {
  ink: '#1b1f24', navy: '#1d2c3c', orange: '#b8471b', tint: '#f7e7de', rule: '#d5cfc8',
  muted: '#5c636b', paper: '#ffffff',
};
// Each colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.orange })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Archivo', DISPLAY = 'Archivo Narrow';
const PAGE = { w: 148, h: 210, top: 20, bottom: 20, inner: 18, outer: 15 }; // mm: A5, mirrored
const LEAD = 13; // pt
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });

// #region answer: the words a reference prints, and references that are links
// In the Markdown, `## Brakes {#sec-brakes}` names a heading, `:anchor{#warn-pressure}`
// a point in a paragraph and `[close the lever]{#step-close-lever}` a phrase in a step.
// `:ref{id="sec-pad-wear"}` prints "section 3.2", `style=page` "page 3", `style=title`
// the heading's words and `style=pageNumber` the bare 3. The page numbers come from the
// previous layout pass: the engine lays the manual out again until they hold.
const crossRefs = {
  section: t({ en: 'section {n}', es: 'apartado {n}' }), // H2 and H3: "section 3.2"
  page: t({ en: 'page {n}', es: 'página {n}' }), // spelt out: a manual is read by anyone
};
// Every reference is a link in the PDF and on screen; this makes it look like one.
const references = { referenceColor: col('orange'), referenceBold: true };
// #endregion

// #region numbers: sections 1–5 and 1.1, 1.2… under the one level-1 heading
const H2 = { level: 2, numberingTemplate: '{2}', numberSeparator: '   ', fontFamily: DISPLAY,
  fontWeight: 700, fontSize: pt(15), lineHeight: pt(LEAD * 1.5), color: col('navy'),
  marginTop: pt(LEAD), marginBottom: pt(LEAD / 3) };
const H3 = { level: 3, numberingTemplate: '{2}.{3}', numberSeparator: '  ', fontFamily: DISPLAY,
  fontWeight: 700, fontSize: pt(10.5), lineHeight: pt(LEAD), color: col('ink'),
  marginTop: pt(LEAD / 2), marginBottom: pt(LEAD / 4) };
// #endregion

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

#Abrevia «pág.» en las remisiones

Una obra de consulta con muchas remisiones a página gana sitio con la abreviatura.

-  page: t({ en: 'page {n}', es: 'página {n}' }), // spelt out: a manual is read by anyone
+  page: t({ en: 'p. {n}', es: 'pág. {n}' }),

#Deja las remisiones en negro

Cuando la página está llena de remisiones, déjalas en el color del texto y en negrita; siguen siendo enlaces en el PDF y en pantalla.

-const references = { referenceColor: col('orange'), referenceBold: true };
+const references = { referenceColor: col('ink'), referenceBold: true };

Errores frecuentes

  • Una remisión a un :anchor sin estilo imprime la página, porque un ancla invisible no tiene palabras propias. Usa [palabras]{#id} cuando la remisión deba citar el texto.
  • Un identificador debe ser único en el libro. Las remisiones llegan al primer {#sec-brakes}, y el panel Revisión del Sandbox avisa del segundo como duplicateAnchor.

Créditos

Texto
Texto original, CC BY 4.0
Fuentes
Archivo (SIL OFL 1.1) · Archivo Narrow (SIL OFL 1.1)
SandboxPDF