Pular para o conteúdo principal
Receita número 100

Receitas · Capítulo 10 · Saída e integração

Um livro diagramado sobre a mesa, em 3D

createFolioFromDocument, do pacote postext-folio, abre um capítulo diagramado como um livro em tecido sobre uma mesa de nogueira, conforme config.folio.

Nesta página
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.25.0
Licença
Atualizada em 10 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 129 × 198 mm
  • 1 coluna
  • Literata 9,8/14
  • Fraunces
  • Work Sans
  • 4 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 49 ms
  • 119 linhas de código

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

script.js · linhas 174–185no 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

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

script.js · linhas 34–41no 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 é 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

script.js · linhas 45–57no 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) } } },
] } };

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.

script.js · linhas 61–74no 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 · 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

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

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

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