Saltar al contingut principal
Recepta número 100

Receptari · Capítol 10 · Sortida i integració

Un llibre compost sobre la taula, en 3D

createFolioFromDocument, del paquet postext-folio, obre un capítol compost com un llibre en tela sobre una taula de noguera, amb l'aspecte de config.folio.

En aquesta pàgina
Nivell
Intermedi
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 anglès: encara no hi ha edició en català
  • Format 129 × 198 mm
  • 1 columna
  • Literata 9,8/14
  • Fraunces
  • Work Sans
  • 4 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 49 ms
  • 119 línies de codi

En poques paraules

El primer capítol d'una novel·la curta, mostrat com un llibre de debò obert sobre una taula. Passes les pàgines amb el ratolí, i el paper, la coberta i la taula es trien a la configuració.

Què compondràs

El primer capítol de The Ferryman’s Ledger, una novel·la curta en pàgina de 129 × 198 mm, obert com un llibre sobre una taula de noguera. La coberta és de tela verd ampolla, les pàgines són d'un paper esponjat de color crema dels que es fan servir en novel·la, i el lector agafa la pàgina dreta per la vora i la passa: el full es corba i projecta la seva ombra sobre el de sota. El text es compon una vegada amb buildDocument, i una crida al paquet postext-folio converteix aquesta composició en el llibre. Tot allò de què està fet el llibre (paper, enquadernació, taula, llum, l'angle de la vista) va a la configuració, de manera que el mateix document porta el seu aspecte a la pestanya Folio del Sandbox.

Aquesta recepta respon a

  • Com mostro el meu document com un llibre en 3D les pàgines del qual el lector passa amb la mà?
  • Com veig l'enquadernació, la coberta, el paper i la llum d'un llibre abans d'enviar-lo a impremta?

La resposta curta

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

Ingredients

Tipografia
Literata, Fraunces, Work Sans (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Digues de què està fet el llibre

script.js · línies 34–41al codi complet
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 el llegeix el visor 3D i res més: la composició, el canvas, el PDF i l'HTML l'ignoren, així que canviar el paper no mou ni una línia. bookWove és un paper esponjat per a novel·la, i amb 70 g/m² al seu gruix específic dona un full d'unes 112 µm; el visor el multiplica pel nombre de pàgines per obtenir el gruix del bloc. El color de la tela està enllaçat amb l'accent de la paleta, el mateix verd de l'avanttítol i els folis.

#2 · Una obertura tranquil·la i les capçaleres

script.js · línies 45–57al codi complet
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ítol comença a un terç de l'alçada d'una pàgina senar, sota un avanttítol que surt dels atributs del títol. En 3D una obertura enfonsada es llegeix com en una novel·la impresa: el blanc del cap de la pàgina és el primer que veu el lector en obrir les cobertes.

script.js · línies 61–74al codi complet
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 · Obre el document com un llibre

El codi és la resposta curta de més amunt. createFolioFromDocument rep un contenidor i el document compost: pinta cada pàgina amb renderPageToCanvas a la mida exacta de l'espai de pàgina, només al voltant de la doble pàgina oberta, i encaixa el llibre al contenidor. El contenidor necessita una alçada pròpia o el llibre no hi té lloc. textureBaseUrl apunta a les taules fotografiades de postext.dev; sense aquest paràmetre, la noguera es dibuixa amb mapes procedurals.

La recepta 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',

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

#Una rústica sobre roure, amb llum de dia

Canvia tres paràmetres i el mateix capítol és una coberta tova sobre una taula clara; no es torna a compondre res.

-  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 full en un altre paper

Un mostrari de papers imprimeix cada full en el seu propi paper amb :::paper, i el banc de proves canvia tots els paràmetres en directe amb setAppearance.

Errors freqüents

Error freqüent

El visor Folio pren la mida del seu contenidor

createFolioFromDocument encaixa el llibre a l'element que li dones, amb els botons i el comptador de pàgines als marges. Un element sense alçada (un div buit en el flux normal) no mostra res: dona-li una alçada en CSS. Visor de llibre en 3D (Folio) →

Crèdits

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