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
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
- Funcions
- Visor de llibre en 3D (Folio)Paper, enquadernació, taula i llum (Folio)Pàgines en un canvasObertures dissenyadesAtributs de títolCapçaleres i folisCapçaleres segons el tipus de pàginaMarges simètricsVídues, òrfenes i línies curtesEstils de paràgrafPaleta de color semànticaFonts abans de compondre
- 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
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
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.
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
// ═══ 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
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Literata (SIL OFL 1.1) · Fraunces (SIL OFL 1.1) · Work Sans (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


