Saltar al contingut principal
Recepta número 11

Receptari · Capítol 10 · Sortida i integració

Un sol original, edicions impresa i de pantalla

Les dues edicions surten d'una configuració: htmlViewer.overrides desa el disseny fosc i applyHtmlViewerOverrides el fusiona abans de compondre l'HTML.

En aquesta pàgina
Nivell
Avançat
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 225 × 297 mm
  • 2 columnes, espai entre columnes de 7 mm
  • Newsreader 10/14
  • Gloock
  • Reddit Sans
  • 4 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 85 ms
  • 238 línies de codi

En poques paraules

La secció del temps d'una revista, feta dues vegades amb el mateix text. Mostra com una mateixa configuració dona una versió impresa a columnes i una altra de fosca, d'una sola columna, per llegir en pantalla.

Què compondràs

Apuntes del tiempo, la secció de tardor d'una revista petita, composta dues vegades amb el mateix Markdown. En paper és un número de 225 × 297 mm: una avantportada blau pluja, tres apunts que s'obren sota una banda gris boira, dues columnes justificades, dibuixos d'un pluviòmetre i d'una rosa dels vents, i una fotografia d'una vall amb boira. En pantalla és una sola columna en bandera, en Newsreader gris clar sobre fons gairebé negre, amb text HTML que es pot seleccionar i copiar, sense avantportada, bandes ni folis. El tauler s'obre pel pluviòmetre, reduït a l'alçada del tauler i dibuixat en colors de nit, al costat de la seva pàgina impresa. Més amunt hi ha l'obertura de Lluvia; si arrossegues la cantonada del tauler, el text es recompon a la mida nova. El disseny de pantalla ocupa nou claus de htmlViewer.overrides, a la mateixa configuració que l'imprès.

Aquesta recepta respon a

  • Com mostro el mateix document en HTML, en una vista de lectura amb desplaçament que s'adapti a la pantalla?
  • Com dono a l'edició de pantalla un disseny més senzill que a la impresa, amb una sola configuració?

La resposta curta

script.js · línies 61–87al codi complet
// 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 } } };
}

Ingredients

Tipografia
Newsreader, Gloock, Reddit Sans (SIL OFL 1.1)
Recursos
  • valley-1610.jpg
  • Radiation fog in a valley at dawn (Figure 2) (Generated With Diffusion Models, original)
  • The rain gauge, the wind rose and the part page's rain, drawn in code in both palettes (Ignacio Ferro, CC BY 4.0)

Elaboració

#1 · Un joc de noms de color, dos jocs de valors

script.js · línies 15–24al codi complet
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ó remet a un identificador de la paleta; l'hex que porta al costat és només el valor de dia, de reserva. Per això a l'edició de pantalla li n'hi ha prou de canviar un array per passar als colors de nit. La configuració de pantalla de la resposta curta es fusiona clau a clau, i els nivells de títol per level; qualsevol altre array, colorPalette inclòs, se substitueix sencer. main-color forma part de la paleta, de manera que també canvien els valors per defecte del motor que en depenen. La paleta nova arriba a tots els colors que hi estan enllaçats: el text, els peus de figura, els elements de disseny de les obertures i el color de les remissions.

#2 · Obertures: banda en paper, només paraules en pantalla

script.js · línies 30–57al codi complet
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') },
];

Els elements d'avanttítol, títol i entradeta es defineixen una vegada i es copien als dos dissenys, així que les dues edicions mostren els mateixos atributs del títol: {attr.kicker}, {attr.lead} i el {partTitle} de la part. En paper, un títol de primer nivell obre pàgina i abasta les dues columnes, i el seu disseny penja una banda gris boira des de la sang. minHeight reserva l'alçada de la banda per sota del marge superior, més AIR, els 9 mm que separen la banda de la primera línia. Els títols impresos van a 54 pt perquè cadascun és una sola paraula curta i l'únic text gran de la seva pàgina. En pantalla, el mateix nivell passa a ser un títol en columna, sense banda ni aire. La configuració es fusiona per level, així que tot el que no repeteix queda com a l'edició impresa.

#3 · Una avantportada que només existeix en paper

script.js · línies 91–107al codi complet
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)) }),
  ] },
};

A l'edició impresa, :::part obre l'avantportada blau pluja: una caixa a sang pels quatre costats, un element d'imatge amb traços de pluja que deixen lliure el text, el número i el títol que dona la línia d'obertura, i la llista d'apunts en blanc. La configuració de pantalla posa parts.page: false, així que no s'obre cap pàgina ni es compon la llista. La part continua aplicant el seu número i el seu títol als apunts que vénen al darrere, i l'avanttítol de pantalla diu «Otoño · Apunte 1», igual que l'imprès.

#4 · Dibuixa cada figura dues vegades

script.js · línies 201–234al codi complet
// 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
];

Canviar la paleta no canvia els colors d'un SVG, així que cada dibuix es fa una vegada per paleta. La vall és una fotografia, un sol JPEG per a les dues edicions. figures(edition) crea els mateixos recursos per a les dues edicions, i cadascun apunta al fitxer de la seva edició: gauge-day.svg en paper i gauge-night.svg en pantalla. Identificadors, peus, textos alternatius i col·locació no canvien, de manera que cada :ref del Markdown porta a la mateixa figura, amb el mateix número, a les dues edicions. A la de pantalla, el text alternatiu va a l'alt de cada <img>, on el troba un lector de pantalla.

#5 · Allotja l'edició de pantalla

script.js · línies 354–382al codi complet
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 és tan alta com el tauler, així que fitFiguresToPage redueix el pluviòmetre fins que hi càpiga en una pàgina amb el seu peu (disposició). A 96 ppp, la resolució de referència de CSS, els mil·límetres i punts heretats de l'edició impresa es veuen a la seva mida nominal (integrar el visor HTML). La recepta escriu les línies amb posició absoluta de renderToHtml dins d'un Shadow DOM, on no arriben els selectors de la pàgina. Les propietats heretades, com ara letter-spacing, sí que travessen aquesta frontera, i l'arrel de l'edició les restableix pel seu compte, perquè el motor va mesurar les línies sense aquestes propietats. Les pàgines HTML són transparents si res no les pinta, així que page.backgroundColor pren de la paleta el paper nocturn. El ResizeObserver espera 150 ms i només recompon, amb una config() nova, quan canvia l'amplada o l'alçada del tauler; després torna a desplaçar el tauler a la mateixa proporció de la seva alçada, perquè el lector continuï per on anava.

La recepta 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)) },

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

#Llegeix de dia

Treu la paleta nocturna i fes servir els valors de dia per al tauler i les figures; l'edició de pantalla tindrà llavors pàgines blanques, text en tinta fosca i els dibuixos de dia.

-  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') },

#Dona a l'obertura impresa un número de capítol sobre una banda de color

Per a una obertura impresa més rotunda, amb una banda saturada i un número de capítol gran, consulta Obertura de capítol sobre banda a sang; la configuració de pantalla no canvia.

Errors freqüents

Error freqüent

La sortida HTML no té filets, retícula ni marques, i és transparent

renderToHtml no dibuixa filets de columna, retícula de base ni marques de tall, i les seves pàgines són transparents si no li passes un fons, cosa que en una pàgina fosca deixa text fosc sobre fosc. Edició de lectura en HTML →

Error freqüent

Alguns paràmetres d'htmlViewer només existeixen al Sandbox

htmlViewer.maxCharsPerLine, columnGap i optimalLineBreaking els llegeix el visor del Sandbox, no renderToHtml. A la teva pròpia pàgina, dimensiona tu mateix la pàgina i passa mode i columnGap a renderToHtml; les correccions s'apliquen amb applyHtmlViewerOverrides. Edició de lectura en HTML →

Error freqüent

Una obertura reserva alçada fins al seu element ancorat més baix

Una obertura de disseny avançat reserva l'alçada del seu element més baix, i també hi compten els ancorats a la pàgina o a la sang que queden per sota del títol, així que un ornament al peu de la pàgina empeny el text a la següent. Dona a aquest element reserve: false (des de postext 1.5): es pinta on està ancorat i no reserva res. Els elements que segueixen la mateixa banda (ancorats al seu peu, o d'alçada 'fill') no en fixen mai l'alçada. Obertures dissenyades →

  • Mantén el tauler a 400 px d'alçada com a mínim (el min-height de la recepta). En un tauler estret de menys d'uns 350 px d'alçada, l'obertura de pantalla és més alta que la caixa de text de la pàgina; llavors ocupa la pàgina sencera i el primer paràgraf de l'apunt comença a la següent.
  • Dona mida al tauler abans de compondre. Un tauler sense amplada, ocult o aixafat en una fila flex donaria una pàgina d'amplada zero; per això showScreen() descarta un tauler més estret o més baix que FOLDED, 200 px.

Crèdits

Text
Text original, CC BY 4.0
Imatges
  • Radiation fog in a valley at dawn (Figure 2) · Generated With Diffusion Models · original
  • The rain gauge, the wind rose and the part page's rain, drawn in code in both palettes · Ignacio Ferro · CC BY 4.0
Fonts
Newsreader (SIL OFL 1.1) · Gloock (SIL OFL 1.1) · Reddit Sans (SIL OFL 1.1)
Sandbox