Saltar al contenido principal
Receta número 100

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

Un libro compuesto sobre la mesa, en 3D

createFolioFromDocument, del paquete postext-folio, abre un capítulo compuesto como un libro en tela sobre una mesa de nogal, con el aspecto de config.folio.

En esta página
  • Muestra en inglés: aún no hay edición en español
  • Formato 129 × 198 mm
  • 1 columna
  • Literata 9,8/14
  • Fraunces
  • Work Sans
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 49 ms
  • 119 líneas de código

En pocas palabras

El primer capítulo de una novela corta, mostrado como un libro de verdad abierto sobre una mesa. Pasas las páginas con el ratón, y el papel, la tapa y la mesa se eligen en la configuración.

Lo que vas a componer

El primer capítulo de The Ferryman’s Ledger, una novela corta en página de 129 × 198 mm, abierto como un libro sobre una mesa de nogal. La tapa es de tela verde botella, las páginas son un papel ahuecado color crema de los que se usan en novela, y el lector toma la página derecha por el borde y la pasa: la hoja se curva y proyecta su sombra sobre la de abajo. El texto se compone una vez con buildDocument, y una llamada al paquete postext-folio convierte esa composición en el libro. Todo aquello de lo que está hecho el libro (papel, encuadernación, mesa, luz, el ángulo de la vista) va en la configuración, de modo que el mismo documento lleva su aspecto a la pestaña Folio del Sandbox.

Esta receta responde a

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

La respuesta corta

script.js · líneas 174–185en el código completo
const stage = document.createElement('section');
stage.id = 'folio';
stage.ariaLabel = 'The book in 3D';
stage.style.cssText = 'height: min(78vh, 720px); margin: 0 auto; max-width: 1280px';
document.getElementById('pages').before(stage);
createFolioFromDocument(stage, doc, {
  // The paper, binding, desk and light come from doc.config.folio. Only the photographed
  // desk is the host's choice: without textureBaseUrl the walnut is drawn procedurally.
  appearance: { textureBaseUrl: 'https://postext.dev/folio/textures' },
  onChange: ({ pages }) => kitStatus(`${doc.pages.length} pages · open at `
    + pages.map((i) => doc.pages[i].pageLabel || i + 1).join('–')),
});

Ingredientes

Tipografía
Literata, Fraunces, Work Sans (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Di de qué está hecho el libro

script.js · líneas 34–41en el código completo
const folio = {
  tilt: 26, // degrees from straight above: enough to see the depth of the page block
  paper: { type: 'bookWove', grammage: 70, shade: col('cream') }, // a bulky cream novel paper
  binding: { type: 'hardcover', cover: 'case', coverMaterial: 'cloth',
    coverColor: col('accent') }, // the case wraps the pages; boards a little larger
  surface: { type: 'walnut' },
  lighting: { environment: 'studio', intensity: 1, shadows: true },
};

config.folio lo lee el visor 3D y nada más: la composición, el canvas, el PDF y el HTML lo ignoran, así que cambiar el papel no mueve ni una línea. bookWove es un papel ahuecado para novela, y con 70 g/m² a su mano da una hoja de unas 112 µm; el visor la multiplica por el número de páginas para el grosor del bloque. El color de la tela está enlazado con el acento de la paleta, el mismo verde del antetítulo y los folios.

#2 · Una apertura tranquila y las cabeceras

script.js · líneas 45–57en el código completo
const opener = { enabled: true, minHeight: mm(50), slot: { elements: [
  { kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: 'Work Sans',
    fontSize: pt(7.5), fontWeight: 600, letterSpacing: pt(1.5), textTransform: 'uppercase',
    color: col('accent'), align: 'left',
    placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(10) } } },
  { kind: 'text', id: 'title', content: '{titleText}', fontFamily: 'Fraunces', fontSize: pt(28),
    lineHeight: 1.05, fontWeight: 600, color: col('ink'), align: 'left', overflow: 'wrap',
    placement: { anchor: { to: '#kicker', edge: 'below' }, offset: { y: mm(3) },
      size: { width: mm(90) } } },
  { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.25), color: col('accent'),
    placement: { anchor: { to: '#title', edge: 'below' }, offset: { y: mm(4.5) },
      size: { width: mm(12) } } },
] } };

El capítulo empieza a un tercio de la altura de una página impar, bajo un antetítulo que sale de los atributos del encabezado. En 3D una apertura hundida se lee como en una novela impresa: el blanco de la cabeza de la página es lo primero que ve el lector al abrir las tapas.

script.js · líneas 61–74en el código completo
const head = (id, content, parity, edge, x, extra = {}) => ({ kind: 'text', id, content, parity,
  pages: 'body', fontFamily: 'Work Sans', fontSize: pt(7), fontWeight: 500,
  letterSpacing: pt(1.1), textTransform: 'uppercase', color: col('muted'),
  placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(11) } }, ...extra });
const folioNumber = { fontWeight: 600, color: col('accent') };
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folioNumber),
  head('verso-author', '{author}', 'even', 'top-left', OUTER + 8),
  head('recto-title', '{title}', 'odd', 'top-right', -(OUTER + 8)),
  head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folioNumber),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'bottom', 0,
  { ...folioNumber, pages: 'opener', placement: { anchor: { to: 'page', edge: 'bottom' },
    offset: { y: mm(-11) } } })] };

#3 · Abre el documento como un libro

El código es la respuesta corta de arriba. createFolioFromDocument recibe un contenedor y el documento compuesto: pinta cada página con renderPageToCanvas al tamaño exacto del hueco de página, solo alrededor de la doble página abierta, y encaja el libro en el contenedor. El contenedor necesita una altura propia o el libro no tiene sitio. textureBaseUrl apunta a las mesas fotografiadas de postext.dev; sin él, el nogal se dibuja con mapas procedurales.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 100 · A laid-out book on the desk, in 3D ═══════════════════
// https://postext.dev/en/cookbook/folio-book-on-a-desk
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Literata, Fraunces, Work Sans (SIL OFL 1.1) · Needs postext ≥ 1.25.0
//
// A chapter of a short novel, laid out on a trade-book page and opened with postext-folio as a
// cloth-bound book lying on a walnut desk. Take the right-hand page by its edge and drag it
// over, click a page, or use the arrow keys. The flat pages follow under the book.
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-book-on-a-desk';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: semantic colours, every one linked by id
const palette = {
  ink: '#211d1a', // text: a warm near-black
  accent: '#2f5d50', // bottle green: kicker, rule, folios, and the cloth of the case
  rule: '#c9bfae', // the colophon's hairline
  muted: '#6d655c', // running heads and the colophon
  cream: '#f7f0e1', // the book wove the pages are printed on (the 3D paper only)
};
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.accent, model: 'hex' } },
];
// #endregion
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER] = [129, 198, 20, 22, 17, 15]; // mm: B-format
const LEAD = 14; // pt: the body leading

// #region folio: what the book is made of and where it lies; layout never reads it
const folio = {
  tilt: 26, // degrees from straight above: enough to see the depth of the page block
  paper: { type: 'bookWove', grammage: 70, shade: col('cream') }, // a bulky cream novel paper
  binding: { type: 'hardcover', cover: 'case', coverMaterial: 'cloth',
    coverColor: col('accent') }, // the case wraps the pages; boards a little larger
  surface: { type: 'walnut' },
  lighting: { environment: 'studio', intensity: 1, shadows: true },
};
// #endregion

// #region opener: a sunk chapter opening, kicker, title and a short rule
const opener = { enabled: true, minHeight: mm(50), slot: { elements: [
  { kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: 'Work Sans',
    fontSize: pt(7.5), fontWeight: 600, letterSpacing: pt(1.5), textTransform: 'uppercase',
    color: col('accent'), align: 'left',

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

#Una rústica sobre roble, con luz de día

Cambia tres ajustes y el mismo capítulo es una tapa blanda sobre una mesa clara; no se vuelve a componer nada.

-  binding: { type: 'hardcover', cover: 'case', coverMaterial: 'cloth',
-    coverColor: col('accent') }, // the case wraps the pages; boards a little larger
-  surface: { type: 'walnut' },
-  lighting: { environment: 'studio', intensity: 1, shadows: true },
+  binding: { type: 'paperback', cover: 'case', coverMaterial: 'paper',
+    coverColor: col('accent') },
+  surface: { type: 'oak' },
+  lighting: { environment: 'daylight', intensity: 1, shadows: true },

#Cada hoja en otro papel

Un muestrario de papeles imprime cada hoja en su propio papel con :::paper, y el banco de ajustes cambia todos los ajustes en vivo con setAppearance.

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) →

Créditos

Texto
Texto original, CC BY 4.0
Fuentes
Literata (SIL OFL 1.1) · Fraunces (SIL OFL 1.1) · Work Sans (SIL OFL 1.1)
Sandbox