Em poucas palavras
O primeiro capítulo de um romance curto, mostrado como um livro de verdade aberto sobre uma mesa. Você vira as páginas com o mouse, e o papel, a capa e a mesa são escolhidos nas configurações.
O que você vai compor
O primeiro capítulo de The Ferryman’s Ledger, um romance curto em página de 129 × 198 mm, aberto como um livro sobre uma mesa de nogueira. A capa é dura, revestida de tecido verde-garrafa, as páginas são de um papel creme encorpado de romance, e o leitor pega a página da direita pela borda e a vira: a folha se curva e projeta a sombra sobre a página de baixo. O texto é composto uma vez com buildDocument; uma chamada ao pacote postext-folio transforma essa diagramação no livro. Tudo aquilo de que o livro é feito (papel, encadernação, mesa, luz, o ângulo da vista) faz parte da configuração, por isso o mesmo documento leva sua aparência para a aba Folio do Sandbox.
Esta receita responde a
- Como mostro meu documento como um livro em 3D cujas páginas o leitor vira com a mão?
- Como visualizo a encadernação, a capa, o papel e a iluminação de um livro antes de mandá-lo para a gráfica?
A 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('–')),
});
Ingredientes
- Funcionalidades
- Visualizador de livro em 3D (Folio)Papel, encadernação, mesa e luz (Folio)Páginas em um canvasAberturas desenhadasAtributos de títuloCabeços e fóliosCabeços por tipo de páginaMargens espelhadasViúvas, órfãs e linhas curtasEstilos de parágrafoPaleta de cores semânticaFontes antes da diagramação
- Tipografia
- Literata, Fraunces, Work Sans (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Diga de que o livro é feito
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 é lido pelo visualizador 3D e por mais nada: a diagramação, o canvas, o PDF e a saída HTML o ignoram, de modo que trocar o papel não move uma linha. bookWove é um papel de romance encorpado, e 70 g/m² com esse volume dá uma folha de uns 112 µm de espessura; o visualizador multiplica isso pelo número de páginas para obter a espessura do miolo. A cor do tecido está ligada à cor de destaque da paleta, o mesmo verde do chapéu e dos fólios.
#2 · Uma abertura discreta e os cabeços
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) } } },
] } };
O capítulo começa a um terço da altura de uma página ímpar, sob um chapéu tirado dos atributos do título. Em 3D, uma abertura rebaixada se lê como num romance impresso: o branco no alto da página é a primeira coisa que o leitor vê ao abrir a capa.
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 · Abra o documento como livro
O código está na resposta curta, mais acima. createFolioFromDocument recebe um contêiner e o documento diagramado: pinta cada página com renderPageToCanvas no tamanho exato de um espaço de página, só em volta da página dupla aberta, e encaixa o livro no contêiner. O contêiner precisa de uma altura própria, senão o livro não tem espaço. textureBaseUrl aponta para as mesas fotografadas em postext.dev; sem ele, a nogueira é desenhada com mapas procedurais.
A receita 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',
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Uma brochura sobre carvalho, com luz do dia
Mude três ajustes e o mesmo capítulo vira um livro de capa mole sobre uma mesa clara; nada é diagramado de novo.
- 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 folha num papel diferente
Um mostruário de papéis imprime cada folha no próprio papel com :::paper, e a bancada de ajustes muda todos os ajustes ao vivo com setAppearance.
Erros comuns
Erro comum
O visualizador Folio assume o tamanho do seu contêiner
createFolioFromDocument encaixa o livro no elemento que você passa, com os botões e o contador de páginas nas margens. Um elemento sem altura (um div vazio no fluxo normal) não mostra nada: defina uma altura para ele em CSS. Visualizador de livro em 3D (Folio) →
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Literata (SIL OFL 1.1) · Fraunces (SIL OFL 1.1) · Work Sans (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


