Saltar al contenido principal
Receta número 103

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

Un banco de pruebas para los ajustes de Folio

Un formulario con cada ajuste de config.folio maneja un visor postext-folio con setAppearance: papel, encuadernación, tapas, mesa y luz cambian al vuelo.

En esta página
  • Muestra en inglés: aún no hay edición en español
  • Formato 110 × 160 mm
  • 1 columna
  • Source Serif 4 9,3/12,4
  • Outfit
  • 10 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 51 ms
  • 144 líneas de código

En pocas palabras

Un librito de bolsillo en 3D junto a un panel de controles. Cambia el papel, la encuadernación, la mesa o la luz y el libro cambia en el acto, sin componerse otra vez.

Lo que vas a componer

Six Knots, un libro de bolsillo de diez páginas a 110 × 160 mm, abierto en Folio junto a un panel con todos los ajustes de config.folio. Elige un papel y las hojas cambian de color, superficie y rigidez; pasa de rústica a tapa dura y aparece una caja alrededor del bloque; elige la caja en lugar de las cubiertas impresas, tela o piel, una mesa, una luz, una inclinación. El libro se compone una vez. Cada cambio llega al visor con setAppearance, así que no se mueve ninguna línea ni se vuelve a pintar ninguna página, y bajo el formulario aparecen los ajustes como el código que se pega en config.folio.

Esta receta responde a

  • ¿Cómo veo la encuadernación, la cubierta, el papel y la luz de un libro antes de mandarlo a imprenta?
  • ¿Cómo muestro mi documento como un libro en 3D cuyas páginas el lector pasa con la mano?

La respuesta corta

script.js · líneas 196–220en el código completo
const book = createFolioFromDocument(document.getElementById('folio'), doc, {
  // The look starts from doc.config.folio; setAppearance replaces it on every change.
  appearance: { textureBaseUrl: 'https://postext.dev/folio/textures' },
  onChange: ({ pages }) => kitStatus(`${doc.pages.length} pages · open at `
    + pages.map((i) => i + 1).join('–')),
});
function update() {
  const folio = folioOf();
  // Only the appearance changes: the pages keep their paintings, nothing is laid out again.
  book.setAppearance({ folio });
  show('grammage-out', `${folio.paper.grammage} g/m²`);
  show('intensity-out', folio.lighting.intensity.toFixed(2));
  show('tilt-out', `${folio.tilt}°`);
  document.getElementById('folio-json').textContent = `folio: ${JSON.stringify(folio, null, 2)}`;
}
form.addEventListener('input', update);
// A stock sets its own weight: picking one moves the weight slider to the stock's.
const WEIGHTS = { uncoated: 90, bookWove: 80, coatedMatte: 115, coatedSilk: 115,
  coatedGloss: 115, bible: 40, newsprint: 48, cardStock: 250 };
form.elements['paper.type'].addEventListener('change', (event) => {
  form.elements['paper.grammage'].value = WEIGHTS[event.target.value];
  update();
});
document.getElementById('reset-view').addEventListener('click', () => book.resetView());
update();

Ingredientes

Tipografía
Source Serif 4, Outfit (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Nombra los campos como la configuración

script.js · líneas 72–86en el código completo
const form = document.getElementById('controls');
const hex = (value) => ({ hex: value, model: 'hex' });
function folioOf() { // 'paper.grammage' → { paper: { grammage } }, typed by the input
  const folio = {};
  for (const el of form.elements) {
    if (!el.name || el.type === 'button' || el.tagName === 'OUTPUT') continue;
    const value = el.type === 'checkbox' ? el.checked : el.type === 'range' ? Number(el.value)
      : el.type === 'color' ? hex(el.value) : el.value;
    const [group, key] = el.name.split('.');
    if (key) (folio[group] ??= {})[key] = value;
    else folio[group] = value;
  }
  return folio;
}
const show = (name, value) => { form.elements[name].value = value; };

Cada campo del formulario se llama como su ruta en config.folio (paper.grammage, binding.cover, lighting.environment), de modo que un solo bucle convierte el formulario en el objeto que recibe el visor: números de los deslizadores, booleanos de las casillas y un color { hex, model } del selector. Ese mismo objeto es el config.folio del documento cuando el pen lo compone, así que el Sandbox abre el libro tal como empieza el formulario.

#2 · Cubiertas que el visor pasa como tapas

script.js · líneas 40–61en el código completo
const field = { kind: 'box', id: 'field', style: { backgroundColor: col('brick') },
  placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(TRIM_H) } } };
const flush = { numbered: false, span: 'page', footer: { elements: [] },
  margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = (id, title, extra = {}) => ({ id, ...flush, ...extra, advancedDesign: {
  enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field, ...title] } } });
const headingStyles = [
  cover('cover', [
    text('title', '{titleText}', { fontFamily: SANS, fontWeight: 700, fontSize: pt(40),
      lineHeight: 0.92, color: col('cream') },
    { ...at('page', 'top-left', INNER, 30), size: { width: mm(80) } }),
    text('strap', '{attr.strap}', { fontFamily: 'Source Serif 4', italic: true,
      fontSize: pt(11), lineHeight: 1.3, color: col('cream') },
    { ...at('#title', 'below', 0, 6), size: { width: mm(72) } }),
    text('author', '{author}', caps(7, col('cream')), at('page', 'bottom-left', INNER, -16)),
  ]),
  cover('back', [
    text('strap', '{attr.strap}', { fontFamily: 'Source Serif 4', italic: true,
      fontSize: pt(11), lineHeight: 1.3, color: col('cream'), align: 'center' },
    { ...at('page', 'center', 0, 0), size: { width: mm(76) } }),
  ], { breakBefore: { enabled: true, parity: 'even' } }), // the back: always a verso
];

Con binding.cover: 'pages' la primera página es la tapa delantera y la última la trasera, si cae en una página par. El estilo de la contracubierta salta a página par, así que el libro acaba siempre en una página par y giran las dos tapas. Cambia el formulario a A case round the pages y esas dos páginas giran como hojas corrientes dentro de una caja de tela.

#3 · Cambia el libro sin rehacerlo

El código es la respuesta corta de arriba. setAppearance({ folio }) sustituye los ajustes del documento y vuelve a dibujar la escena: grosor y rigidez del papel, la caja, los mapas de la mesa y la luz. Las páginas conservan su pintura, así que el cambio aparece en el fotograma siguiente. Cada tipo de papel trae su gramaje, por eso al elegir uno se mueve el deslizador del peso; resetView() devuelve la cámara a su sitio después de que el lector gire el libro arrastrando con el botón derecho.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 103 · A bench for the Folio viewer's settings ═══════════════
// https://postext.dev/en/cookbook/folio-settings-bench
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Source Serif 4, Outfit (SIL OFL 1.1) · Needs postext ≥ 1.26.0
//
// A pocket book of knots, laid out once and opened in postext-folio next to a form of every
// folio setting: paper, binding, covers, desk, light and tilt. Each change goes to the viewer
// with setAppearance, so the book is redrawn in place and no page is laid out or painted
// again. The settings as code sit under the form, ready to paste into config.folio.
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { createFolioFromDocument } from 'https://esm.sh/postext-folio';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'folio-settings-bench';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: brick red for the covers and the knot numbers, a warm ink for the text
const palette = {
  ink: '#24211f',
  brick: '#9a3b2e', // the cover field, kickers and folios
  cream: '#f6efe2', // type on the covers
  muted: '#6f6860',
};
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' } })),
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.brick, model: 'hex' } },
];
// #endregion
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER] = [110, 160, 15, 17, 14, 12]; // mm: a pocket
const LEAD = 12.4; // pt
const SANS = 'Outfit';
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, overflow: 'wrap',
  align: 'left', placement, ...look });
const caps = (size, color) => ({ fontFamily: SANS, fontSize: pt(size), fontWeight: 600,
  letterSpacing: pt(size * 0.16), textTransform: 'uppercase', color });

// #region covers: a full-page colour field on page 1 and on the last page
const field = { kind: 'box', id: 'field', style: { backgroundColor: col('brick') },
  placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(TRIM_H) } } };
const flush = { numbered: false, span: 'page', footer: { elements: [] },
  margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = (id, title, extra = {}) => ({ id, ...flush, ...extra, advancedDesign: {
  enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field, ...title] } } });
const headingStyles = [
  cover('cover', [
    text('title', '{titleText}', { fontFamily: SANS, fontWeight: 700, fontSize: pt(40),

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

#Empieza en tapa dura con caja de tela

Cambia los valores iniciales del formulario en index.html; el documento y el Sandbox los siguen.

-        <option value="hardcover">Hardcover</option><option value="paperback" selected>Paperback</option>
+        <option value="hardcover" selected>Hardcover</option><option value="paperback">Paperback</option>

#Un libro con su aspecto en la configuración

Un libro sobre la mesa escribe los mismos ajustes una vez en config.folio, sin formulario, y el muestrario pone un papel distinto en cada hoja.

Errores frecuentes

Error frecuente

El visor Folio toma el tamaño de su contenedor

createFolioFromDocument encaja el libro en el elemento que le das, con los botones y el contador de páginas en sus márgenes. Un elemento sin altura (un div vacío en el flujo normal) no muestra nada: dale una altura en CSS. Visor de libro en 3D (Folio) →

Error frecuente

cover: 'pages' necesita un número par de páginas para la tapa trasera

Con binding.cover en 'pages' la primera página gira como tapa delantera, y la última como tapa trasera solo si cae en un verso. Con un número impar de páginas el libro tiene tapa delantera y no trasera: complétalo hasta un número par o deja la caja. Papel, encuadernación, mesa y luz (Folio) →

Créditos

Texto
Texto original, CC BY 4.0
Fuentes
Source Serif 4 (SIL OFL 1.1) · Outfit (SIL OFL 1.1)
Sandbox