Saltar al contenido principal
Receta número 11

Recetario · Capítulo 10 · Salida e integración

Un solo original, ediciones impresa y de pantalla

Las dos ediciones salen de una configuración: htmlViewer.overrides guarda el diseño oscuro y applyHtmlViewerOverrides lo fusiona antes de componer el HTML.

En esta página
  • Formato 225 × 297 mm
  • 2 columnas, medianil de 7 mm
  • Newsreader 10/14
  • Gloock
  • Reddit Sans
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 85 ms
  • 238 líneas de código

En pocas palabras

La sección del tiempo de una revista, hecha dos veces con el mismo texto. Enseña cómo unos mismos ajustes dan una versión impresa a columnas y otra oscura, de una sola columna, para leer en pantalla.

Lo que vas a componer

Apuntes del tiempo, la sección de otoño de una pequeña revista, compuesta dos veces con el mismo Markdown. En papel es un número de 225 × 297 mm: una portadilla azul lluvia, tres apuntes que se abren bajo una banda gris niebla, dos columnas justificadas dibujos de un pluviómetro y una rosa de los vientos, y una fotografía de un valle con niebla. En pantalla es una sola columna en bandera, en Newsreader gris claro sobre fondo casi negro, con texto HTML que se puede seleccionar y copiar, sin portadilla, bandas ni folios. El panel se abre por el pluviómetro, reducido a la altura del panel y dibujado en colores de noche, junto a su página impresa. Más arriba está la apertura de Lluvia; si arrastras la esquina del panel, el texto se recompone al nuevo tamaño. El diseño de pantalla ocupa nueve claves de htmlViewer.overrides, en la misma configuración que el impreso.

Esta receta responde a

  • ¿Cómo muestro el mismo documento en HTML, en una vista de lectura con desplazamiento que se adapte a la pantalla?
  • ¿Cómo doy a la edición de pantalla un diseño más sencillo que a la impresa, con una sola configuración?

La respuesta corta

script.js · líneas 61–87en el código completo
// config() stores it as htmlViewer: { overrides: screenOverrides() }; canvas and PDF ignore it.
const screenOverrides = () => ({
  colorPalette: paletteOf(night), // arrays are replaced whole: the night values
  parts: { page: false }, // no divider page; the part still names the notes after it
  // 96 dpi: the mm and pt inherited from print render at their CSS size.
  page: { dpi: 96, margins: { top: px(40), bottom: px(40), mirror: false } },
  layout: { layoutType: 'single', // one column
    fitFiguresToPage: true }, // tall figures shrink to the pane; off by default, as in print
  bodyText: { fontSize: px(17), lineHeight: px(27), textAlign: 'left' }, // ragged for reading
  // Heading levels merge on `level`: the print level keeps everything not restated here.
  headings: { levels: [{ level: 1, span: 'column', breakBefore: { enabled: false },
    marginTop: px(40), marginBottom: px(26),
    advancedDesign: { minHeight: px(0), slot: { elements: screenOpener } } }] }, // no band air
  footer: { elements: [] }, // a scrolling page runs no folios (print's header is empty already)
  captionStyle: { fontSize: px(13), gap: px(10) },
  paragraphStyles: [{ ...colophon, fontSize: px(13), lineHeight: px(20) }], // restated whole
});
// The host owns the page size: the pane's, in CSS pixels (gotcha: viewer-settings-sandbox-only).
// Wide panes get wider margins, so the measure stops at MEASURE.
const MEASURE = 470; // px: about 65 characters of Newsreader at 17 px
const MIN_SIDE = 34; // px: the side margins of a narrow pane
function screenConfig({ width, height }) {
  const merged = applyHtmlViewerOverrides(config()); // print + overrides, a fresh object
  const side = px(Math.max(MIN_SIDE, (width - MEASURE) / 2));
  return { ...merged, page: { ...merged.page, width: px(width), height: px(height),
    margins: { ...merged.page.margins, left: side, right: side } } };
}

Ingredientes

Tipografía
Newsreader, Gloock, Reddit Sans (SIL OFL 1.1)
Recursos
  • valley-1610.jpg
  • Niebla de irradiación en un valle al amanecer (figura 2) (Generated With Diffusion Models, original)
  • El pluviómetro, la rosa de los vientos y la lluvia de la portadilla, dibujados con código en las dos paletas (Ignacio Ferro, CC BY 4.0)

Elaboración

#1 · Un juego de nombres de color, dos juegos de valores

script.js · líneas 15–24en el código completo
const day = { ink: '#1b222b', rain: '#3d6f9e', slate: '#2d3a4a', fog: '#e9edf1',
  rule: '#c8d0d8', muted: '#5f6a76', paper: '#ffffff' };
const night = { ink: '#e6e8eb', rain: '#9cc3e6', slate: '#56657a', fog: '#1b2129',
  rule: '#2e3742', muted: '#98a2ae', paper: '#111418' };
const paletteOf = (values) => // main-color: the engine's defaults follow the rain blue
  Object.entries({ ...values, 'main-color': values.rain })
    .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// Every colour names its palette entry: text, captions, the openers' design elements and the
// reference colour follow whichever palette the config carries. The hex is the day value.
const col = (id) => ({ hex: day[id], model: 'hex', paletteId: id });

Cada color de la configuración remite a un identificador de la paleta; el hex que lleva al lado es solo el valor de día, de reserva. Por eso a la edición de pantalla le basta cambiar un array para pasar a los colores de noche. Los ajustes de pantalla de la respuesta corta se fusionan clave a clave, y los niveles de encabezado por level; cualquier otro array, colorPalette incluido, se sustituye entero. main-color forma parte de la paleta, de modo que también cambian los valores por defecto del motor que dependen de él. La paleta nueva llega a todos los colores enlazados con ella: el texto, los pies de figura, los elementos de diseño de las aperturas y el color de las remisiones.

#2 · Aperturas: banda en papel, solo palabras en pantalla

script.js · líneas 30–57en el código completo
const text = (id, content, fontFamily, style) => ({ kind: 'text', id, content, fontFamily,
  color: col('ink'), align: 'left', ...style,
  overflow: 'wrap' }); // titles break onto more lines
const kicker = text('kicker', '{partTitle} · {attr.kicker}', 'Reddit Sans',
  { fontWeight: 600, textTransform: 'uppercase', color: col('rain') });
const title = text('title', '{titleText}', 'Gloock');
const lead = text('lead', '{attr.lead}', 'Newsreader', { italic: true, hyphenate: true });
const at = (to, edge, y, x = px(0)) => ({ anchor: { to, edge }, offset: { x, y } });
const under = (id, y, width) => ({ ...at(`#${id}`, 'below', y), size: { width } });
const band = (y, height) => ({ ...at('bleed', 'top-left', y), size: { width: 'fill', height } });
const fromTop = (y, x) => at('container', 'top-left', y, x);
// minHeight sets the reservation: the band's foot below the top margin, plus AIR. The band hangs
// from the bleed and counts too, but ends higher (gotcha: opener-reserves-anchored).
const printOpener = { enabled: true, minHeight: mm(BAND - TOP + AIR), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('fog') },
    placement: band(mm(0), mm(BAND)) },
  { kind: 'rule', id: 'horizon', direction: 'horizontal', thickness: pt(2), color: col('rain'),
    placement: band(mm(BAND - 0.7), pt(2)) }, // 2 pt is 0.7 mm: the rule ends at the band's foot
  { ...kicker, fontSize: pt(8), letterSpacing: pt(1.8), placement: fromTop(mm(12)) },
  { ...title, fontSize: pt(54), lineHeight: 1.04, placement: under('kicker', mm(2.5), mm(150)) },
  { ...lead, fontSize: pt(11.5), lineHeight: 1.36, placement: under('title', mm(4), mm(118)) },
] } };
const screenOpener = [
  { ...kicker, fontSize: px(12), letterSpacing: px(2.6), placement: fromTop(px(4)) },
  { ...title, fontSize: px(48), lineHeight: 1.05, placement: under('kicker', px(6), 'fill') },
  { ...lead, fontSize: px(18), lineHeight: 1.45, color: col('muted'),
    placement: under('title', px(10), 'fill') },
];

Los elementos de antetítulo, título y entradilla se definen una vez y se copian en los dos diseños, así que las dos ediciones muestran los mismos atributos del encabezado: {attr.kicker}, {attr.lead} y el {partTitle} de la parte. En papel, un encabezado de primer nivel abre página y abarca las dos columnas, y su diseño cuelga una banda gris niebla desde el sangrado. minHeight reserva la altura de la banda por debajo del margen superior, más AIR, los 9 mm que separan la banda de la primera línea. Los títulos impresos van a 54 pt porque cada uno es una sola palabra corta y el único texto grande de su página. En pantalla, el mismo nivel pasa a ser un título en columna, sin banda ni aire. El ajuste se fusiona por level, así que todo lo que no repite se queda como en la edición impresa.

#3 · Una portadilla que solo existe en papel

script.js · líneas 91–107en el código completo
const onField = { color: col('paper'), lineHeight: 1 };
const parts = {
  margins: { top: mm(212), left: mm(24), right: mm(40) }, // the fence's list sits low
  bodyStyle: { fontSize: pt(13), lineHeight: pt(19), color: col('paper'),
    numberColor: col('paper') },
  design: { elements: [
    { kind: 'box', id: 'field', style: { backgroundColor: col('rain') },
      placement: band(mm(0), 'fill') },
    { kind: 'image', id: 'strokes', resourceId: 'rain', placement: band(mm(0), 'fill') },
    text('series', '{title}', 'Reddit Sans', { ...onField, fontWeight: 600, fontSize: pt(9),
      letterSpacing: pt(2.4), textTransform: 'uppercase', placement: fromTop(mm(30), mm(24)) }),
    text('numeral', '{number}', 'Gloock', { ...onField, fontSize: pt(190),
      placement: under('series', mm(10), mm(150)) }),
    text('name', '{titleText}', 'Gloock', { ...onField, fontSize: pt(60),
      placement: under('numeral', mm(-6), mm(150)) }),
  ] },
};

En la edición impresa, :::part abre la portadilla azul lluvia: una caja a sangre por los cuatro lados, un elemento de imagen con trazos de lluvia que dejan libre el texto, el número y el título que da la línea :::part, y la lista de apuntes en blanco. Los ajustes de pantalla ponen parts.page: false, así que no se abre ninguna página ni se compone la lista. La parte sigue aplicando su número y su título a los apuntes que vienen detrás, y el antetítulo de pantalla dice «Otoño · Apunte 1», igual que el impreso.

#4 · Dibuja cada figura dos veces

script.js · líneas 201–234en el código completo
// The valley is a photograph, one JPEG in assets/ that both editions share, at its pixels.
const photo = { kind: 'bitmap', svg: undefined,
  bitmap: { fileId: 'valley-1610.jpg', format: 'jpeg', width: 1610, height: 690 } };
const figure = (id, edition, [width, height], placement, caption, alt) => ({ id,
  typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0, placement,
  svg: { fileId: `${id}-${edition}.svg`, width, height },
  caption: caption && t(caption), altText: alt && t(alt) }); // the HTML edition's <img alt>
const figures = (edition) => [
  figure('gauge', edition, [900, 1260], { position: 'auto', span: 'column' }, {
    en: 'The rain gauge in section: the funnel feeds a tube with a tenth of its area.',
    es: 'El pluviómetro en sección: el embudo vierte en un tubo con la décima parte de su área.',
  }, {
    en: 'Rain falls on a funnel set in a can sunk in the lawn; the funnel drains into a narrow '
      + 'tube, half full, beside a graduated measuring stick.',
    es: 'La lluvia cae en un embudo sobre un vaso hundido en el césped; el embudo vierte en un '
      + 'tubo estrecho, medio lleno, junto a una regla graduada.' }),
  { ...figure('valley', edition, [1610, 690], { position: 'bottom', span: 'page' }, {
    en: 'Radiation fog at dawn: cold air drains off the hills overnight and fills the valley.',
    es: 'Niebla de irradiación al amanecer: el aire frío baja de las lomas y llena el valle.',
  }, {
    en: 'A valley between wooded hills lies under layers of fog at sunrise, with a church '
      + 'tower, trees and a river showing through it, seen from a fenced bank.',
    es: 'Un valle entre lomas boscosas yace bajo la niebla al amanecer; asoman la torre de '
      + 'una iglesia, árboles y un río, vistos desde un ribazo con una cerca.' }), ...photo },
  figure('rose', edition, [900, 900], { position: 'top', span: 'column' }, {
    en: 'Where a year of morning winds came from at the garden station: west and south-west.',
    es: 'De dónde vino el viento de un año de mañanas en el jardín: del oeste y del suroeste.',
  }, {
    en: 'A wind rose of sixteen petals on three rings; the longest petals point west and '
      + 'south-west, the shortest east.',
    es: 'Una rosa de los vientos de dieciséis pétalos sobre tres anillos; los más largos '
      + 'apuntan al oeste y al suroeste, los más cortos al este.' }),
  figure('rain', 'field', [2250, 2970]), // drawn by the part design, never cited: unnumbered
];

Cambiar la paleta no recolorea un SVG, así que cada dibujo se hace una vez por paleta. El valle es una fotografía, un solo JPEG para las dos ediciones. figures(edition) crea los mismos recursos para las dos ediciones, y cada uno apunta al archivo de su edición: gauge-day.svg en papel y gauge-night.svg en pantalla. Identificadores, pies, textos alternativos y colocación no cambian, de modo que cada :ref del Markdown lleva a la misma figura, con el mismo número, en las dos ediciones. En la de pantalla, el texto alternativo va en el alt de cada <img>, donde lo encuentra un lector de pantalla.

#5 · Aloja la edición de pantalla

script.js · líneas 354–382en el código completo
const FOLDED = 200; // px: a pane narrower or shorter than this is hidden or squeezed; skip it
if (!pane.clientHeight) { // no style.css: a height, and a corner to drag the pane smaller, but
  // not under 400 px, where an opener can take a whole page and push its text to the next
  pane.style.cssText = 'height:580px;min-height:400px;min-width:240px;overflow:auto;resize:both';
}
pane.style.background = night.paper; // the pane's own ground, beside the pages and the scrollbar
const shadow = pane.attachShadow({ mode: 'open' }); // the page's selectors cannot reach in, and
// the edition's root resets the text properties it would inherit (letter-spacing…) by itself
const inShadow = `<style>::selection{background:${night.rain}55}</style>`; // the night blue
let size = '';
function showScreen() {
  const [width, height] = [pane.clientWidth, pane.clientHeight];
  if (`${width}×${height}` === size || width < FOLDED || height < FOLDED) return; // same, or folded
  const first = !size; // the first build opens on Figure 1's page, like the print proof
  size = `${width}×${height}`;
  const screenDoc = buildDocument({ markdown, resources: figures('night') },
    screenConfig({ width, height }));
  const place = pane.scrollTop / pane.scrollHeight; // the reader's place, kept across rebuilds
  shadow.innerHTML = inShadow + renderToHtml(screenDoc,
    { mode: 'single', padding: 0, resourceImageUrl: imageUrl });
  const fig = first && screenDoc.pages.find((page) => holds(page, 'gauge')); // 'single' mode
  pane.scrollTop = fig ? fig.index * height : place * pane.scrollHeight; // stacks pane-tall pages
  screenLabel.textContent =
    `${t({ en: 'Screen', es: 'Pantalla' })} · HTML · ${width} × ${height} px`;
}
showScreen();
let timer = 0; // debounced; its first call, on observe(), finds the size unchanged
new ResizeObserver(() => { clearTimeout(timer); timer = setTimeout(showScreen, 150); })
  .observe(pane);

Cada página de pantalla es tan alta como el panel, así que fitFiguresToPage reduce el pluviómetro hasta que quepa en una página con su pie (disposición). A 96 ppp, la resolución de referencia de CSS, los milímetros y puntos heredados de la edición impresa se ven a su tamaño nominal (integrar el visor HTML). La receta escribe las líneas con posición absoluta de renderToHtml dentro de un Shadow DOM, adonde no llegan los selectores de la página. Las propiedades heredadas, como letter-spacing, sí cruzan esa frontera, y la raíz de la edición las restablece por su cuenta, porque el motor midió las líneas sin ellas. Las páginas HTML son transparentes si nada las pinta, así que page.backgroundColor toma de la paleta el papel nocturno. El ResizeObserver espera 150 ms y solo recompone, con una config() nueva, cuando cambia el ancho o el alto del panel; después vuelve a desplazar el panel a la misma proporción de su altura, para que el lector siga por donde iba.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 011 · One source, print and screen editions ═══════════
// https://postext.dev/en/cookbook/print-and-screen-editions
// Code: MIT · Text: original (CC BY 4.0) · Drawings: code (CC BY 4.0) · Photo: diffusion models
// Fonts: Newsreader, Gloock, Reddit Sans (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, prepareFonts, withLoadedFonts, renderPageToCanvas, renderToHtml,
  applyHtmlViewerOverrides, registerResourceImage, defaultResourceTypes,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'print-and-screen-editions';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: one set of colour ids, two sets of values: day for paper, night for screens
const day = { ink: '#1b222b', rain: '#3d6f9e', slate: '#2d3a4a', fog: '#e9edf1',
  rule: '#c8d0d8', muted: '#5f6a76', paper: '#ffffff' };
const night = { ink: '#e6e8eb', rain: '#9cc3e6', slate: '#56657a', fog: '#1b2129',
  rule: '#2e3742', muted: '#98a2ae', paper: '#111418' };
const paletteOf = (values) => // main-color: the engine's defaults follow the rain blue
  Object.entries({ ...values, 'main-color': values.rain })
    .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// Every colour names its palette entry: text, captions, the openers' design elements and the
// reference colour follow whichever palette the config carries. The hex is the day value.
const col = (id) => ({ hex: day[id], model: 'hex', paletteId: id });
// #endregion
const px = (value) => ({ value, unit: 'px' }); // screen sizes, written as CSS pixels
const [TOP, BAND, AIR] = [22, 86, 9]; // mm: top margin, the fog band's depth, air under it

// #region opener: print opens each note under a fog band; the screen keeps the words only
const text = (id, content, fontFamily, style) => ({ kind: 'text', id, content, fontFamily,
  color: col('ink'), align: 'left', ...style,
  overflow: 'wrap' }); // titles break onto more lines
const kicker = text('kicker', '{partTitle} · {attr.kicker}', 'Reddit Sans',
  { fontWeight: 600, textTransform: 'uppercase', color: col('rain') });
const title = text('title', '{titleText}', 'Gloock');
const lead = text('lead', '{attr.lead}', 'Newsreader', { italic: true, hyphenate: true });
const at = (to, edge, y, x = px(0)) => ({ anchor: { to, edge }, offset: { x, y } });
const under = (id, y, width) => ({ ...at(`#${id}`, 'below', y), size: { width } });
const band = (y, height) => ({ ...at('bleed', 'top-left', y), size: { width: 'fill', height } });
const fromTop = (y, x) => at('container', 'top-left', y, x);
// minHeight sets the reservation: the band's foot below the top margin, plus AIR. The band hangs
// from the bleed and counts too, but ends higher (gotcha: opener-reserves-anchored).
const printOpener = { enabled: true, minHeight: mm(BAND - TOP + AIR), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('fog') },
    placement: band(mm(0), mm(BAND)) },
  { kind: 'rule', id: 'horizon', direction: 'horizontal', thickness: pt(2), color: col('rain'),
    placement: band(mm(BAND - 0.7), pt(2)) }, // 2 pt is 0.7 mm: the rule ends at the band's foot
  { ...kicker, fontSize: pt(8), letterSpacing: pt(1.8), placement: fromTop(mm(12)) },

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

#Lee de día

Quita la paleta nocturna y usa los valores de día para el panel y las figuras; la edición de pantalla tendrá entonces páginas blancas, texto en tinta oscura y los dibujos de día.

-  colorPalette: paletteOf(night), // arrays are replaced whole: the night values
   parts: { page: false }, // no divider page; the part still names the notes after it
@@
-pane.style.background = night.paper; // the pane's own ground, beside the pages and the scrollbar
+pane.style.background = day.paper; // the pane's own ground, beside the pages and the scrollbar
@@
-  const screenDoc = buildDocument({ markdown, resources: figures('night') },
+  const screenDoc = buildDocument({ markdown, resources: figures('day') },

#Dale a la apertura impresa un número de capítulo sobre una banda de color

Para una apertura impresa más rotunda, con una banda saturada y un número de capítulo grande, consulta Apertura de capítulo sobre banda a sangre; los ajustes de pantalla no cambian.

Errores frecuentes

Error frecuente

La salida HTML no tiene filetes, retícula ni marcas, y es transparente

renderToHtml no dibuja filetes de columna, rejilla base ni marcas de corte, y sus páginas son transparentes si no le pasas un fondo, lo que en una página oscura deja texto oscuro sobre oscuro. Edición de lectura en HTML →

Error frecuente

Algunos ajustes de htmlViewer solo existen en el Sandbox

htmlViewer.maxCharsPerLine, columnGap y optimalLineBreaking los lee el visor del Sandbox, no renderToHtml. En tu propia página, dimensiona tú la página y pasa mode y columnGap a renderToHtml; las correcciones se aplican con applyHtmlViewerOverrides. Edición de lectura en HTML →

Error frecuente

Una apertura reserva altura hasta su elemento anclado más bajo

Una apertura de diseño avanzado reserva la altura de su elemento más bajo, y cuentan también los anclados a la página o a la sangre que quedan por debajo del título, así que un adorno al pie de la página empuja el texto a la siguiente. Dale a ese elemento reserve: false (desde postext 1.5): se pinta donde está anclado y no reserva nada. Los elementos que siguen a la propia banda (anclados a su pie, o de altura 'fill') nunca fijan su altura. Aperturas diseñadas →

  • Mantén el panel en 400 px de alto como mínimo (el min-height de la receta). En un panel estrecho de menos de unos 350 px de alto, la apertura de pantalla es más alta que la caja de texto de la página; entonces ocupa la página entera y el primer párrafo del apunte empieza en la siguiente.
  • Da tamaño al panel antes de componer. Un panel sin ancho, oculto o aplastado en una fila flex, daría una página de ancho cero; por eso showScreen() descarta un panel más estrecho o más bajo que FOLDED, 200 px.

Créditos

Texto
Texto original, CC BY 4.0
Imágenes
  • Niebla de irradiación en un valle al amanecer (figura 2) · Generated With Diffusion Models · original
  • El pluviómetro, la rosa de los vientos y la lluvia de la portadilla, dibujados con código en las dos paletas · Ignacio Ferro · CC BY 4.0
Fuentes
Newsreader (SIL OFL 1.1) · Gloock (SIL OFL 1.1) · Reddit Sans (SIL OFL 1.1)
Sandbox