Em poucas palavras
Um livrinho de fábulas diagramado uma vez para impressão e salvo como dois e-books: um que mantém cada página impressa e outro cujo texto o celular ou o leitor digital recompõe no tamanho.
O que você vai compor
Fables of Aesop, dezoito fábulas em três livros numa página de 120 × 190 mm, com folha de rosto, página de créditos no verso dela e uma abertura rebaixada para cada livro. A edição em espanhol compõe ¡Adiós, Cordera!, de Clarín, em três capítulos na mesma página. O livro é diagramado uma vez, capítulo por capítulo, e essa diagramação vira dois arquivos EPUB 3. O de layout fixo mantém cada página impressa: as aberturas, os cabeços e as quebras de linha, na Caslon incorporada. O arquivo refluível mantém o texto e a estrutura, e o aplicativo de leitura o recompõe num celular ou numa tela de tinta eletrônica. Os dois podem ser baixados da página, e os dois passam no EPUBCheck do W3C.
Esta receita responde a
- Como exporto meu livro em EPUB, com páginas fixas ou com texto refluível?
A resposta curta
const { title, subtitle, author } = docs[0].metadata; // the first chapter's front matter
const book = {
metadata: { title, subtitle, creators: [author], language: LANG,
rights: t({ en: 'Public domain', es: 'Dominio público' }),
// A fixed date gives the same bytes on every run; the identifier (a urn:uuid) comes
// from the title, the author and the language, so a new version keeps its place.
modified: new Date('2026-10-04T00:00:00Z') },
// Every face the pages use, as bytes: a face left out is set in the reader's own
// (gotcha: epub-embeds-given-fonts).
fonts: await epubFonts(FONTS),
onWarning: (w) => console.warn(`[epub] ${w.kind}`, w.family ?? w.fileId ?? w.detail),
};
// The same documents renderToPdf would print: one per chapter, in book order.
const fixed = await renderToEpub(docs, { ...book, layout: 'fixed' });
const reflowable = await renderToEpub(docs, { ...book, layout: 'reflowable' });
Ingredientes
- Funcionalidades
- Exportação para EPUBLivros compostos capítulo a capítuloAberturas desenhadasEstilos de títuloAtributos de títuloCabeços e fóliosCabeços por tipo de páginaMargens espelhadasCor do papelEstilos de parágrafoViúvas, órfãs e linhas curtasMetadados do documentoPaleta de cores semânticaFontes antes da diagramação
- Tipografia
- Libre Caslon Text, Libre Caslon Display, Jost (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Diagrame o livro em capítulos
// Each line spans the measure and centres its text; the rule centres under the title.
const text = (id, content, fontFamily, size, placement, extra = {}) => ({ kind: 'text', id,
content, fontFamily, fontSize: pt(size), color: col('ink'), align: 'center',
overflow: 'wrap', lineHeight: 1.15, ...extra,
placement: { ...placement, size: { width: 'fill', height: 'auto' } } });
const rule = (id, below, y) => ({ kind: 'rule', id, direction: 'horizontal', thickness: pt(0.75),
color: col('accent'),
placement: { ...at(below, 'below', (MEASURE - 10) / 2, y), size: { width: mm(10) } } });
const titlePage = { id: 'title-page', header: { elements: [] }, footer: { elements: [] },
marginBottom: pt(0), advancedDesign: { enabled: true, minHeight: mm(120), slot: { elements: [
text('author', '{author}', LABEL, 9, at('container', 'top-left', 0, 30), caps(9)),
text('title', '{titleText}', DISPLAY, 34, at('#author', 'below', 0, 8)),
rule('rule', '#title', 6),
text('subtitle', '{subtitle}', TEXT, 11, at('#title', 'below', 0, 13), { italic: true }),
] } } };
const opener = { enabled: true, minHeight: mm(56), slot: { elements: [
text('kicker', '{attr.kicker}', LABEL, 8, at('container', 'top-left', 0, 14), caps(8)),
text('title', '{titleText}', DISPLAY, 28, at('#kicker', 'below', 0, 4)),
rule('rule', '#title', 5),
] } };
buildBundle diagrama cada capítulo como um documento próprio, levando os números de página e a paridade de um para o outro, por isso docs é o array que renderToPdf imprimiria. O gravador de EPUB lê o mesmo array: cada capítulo vira uma entrada de navegação, e o arquivo refluível grava um documento XHTML por capítulo. A folha de rosto e a página de créditos são o primeiro capítulo, e o front matter dele traz o título, o subtítulo e o autor do livro.
#2 · Entregue ao gravador os arquivos das fontes
// Only the latin files: they hold every letter of both samples. A text beyond Latin-1 would
// add each family's latin-ext file with its unicodeRange.
const epubFonts = (faces) => Promise.all(Object.entries(faces).flatMap(([family, specs]) =>
specs.map(async (spec) => {
const [weight, style] = [parseInt(spec, 10), spec.endsWith('i') ? 'italic' : 'normal'];
const id = fontsourceId(family);
const res = await fetch(`https://cdn.jsdelivr.net/npm/@fontsource/${id}@5/files/`
+ `${id}-latin-${weight}-${style}.woff2`);
if (!res.ok) throw new Error(`Fontsource has no ${family} ${weight} ${style}`);
const bytes = new Uint8Array(await res.arrayBuffer());
return { family, weight, style, format: 'woff2', bytes };
})));
As fontes que o navegador carregou não são arquivos que o gravador consiga ler, de modo que o código busca de novo os mesmos arquivos woff2 do Fontsource; o navegador já os tem em cache. Cada um vira um arquivo de fonte no EPUB e uma regra @font-face. Sem eles, o layout fixo poria o texto composto em Caslon numa fonte do próprio leitor, e as linhas deixariam de caber na medida.
#3 · Grave as duas versões
O código é a resposta curta lá em cima. layout: 'fixed' grava um documento XHTML por página impressa, no tamanho da página refilada, com texto de verdade e selecionável; layout: 'reflowable' reconstrói os parágrafos a partir das linhas compostas, tira os hífens que as quebras de linha acrescentaram e deriva uma folha de estilos da configuração. Uma data modified fixa faz cada execução gerar os mesmos bytes. Os metadados vêm do front matter do primeiro capítulo, por isso o título e o autor do arquivo são os impressos na folha de rosto.
#4 · Leia cada arquivo de volta
const el = (tag, css, text) => Object.assign(document.createElement(tag),
{ textContent: text ?? '' }, { style: css });
const shelf = el('section', 'display: flex; flex-wrap: wrap; gap: 16px; justify-content: center;'
+ 'padding: 24px 16px 0; color: #d9d5cc; font: 13px/1.5 system-ui, sans-serif');
shelf.id = 'epub';
for (const [layout, bytes] of [['fixed', fixed], ['reflowable', reflowable]]) {
const epub = readEpub(bytes); // what a reading system opens: spine, contents, page list
const file = `${RECIPE}-${layout}.epub`;
const card = el('article', 'width: min(420px, 92vw); padding: 16px 18px;'
+ 'border: 1px solid #2c3038; border-radius: 6px; background: #15181d');
const spine = el('ol', 'margin: 8px 0; padding-left: 22px; max-height: 9em; overflow: auto');
spine.append(...epub.spine.map((item) => el('li', '', item.path.slice(epub.root.length))));
const link = el('a', 'color: #d8a21a', `Download ${file}`);
link.href = URL.createObjectURL(new Blob([bytes], { type: 'application/epub+zip' }));
link.download = file;
card.append(el('h2', 'margin: 0; font-size: 15px; color: #f4f1ea', `EPUB 3 · ${epub.layout}`),
el('p', 'margin: 4px 0 0', `${epub.spine.length} documents in the spine · `
+ `${epub.toc.length} contents entries · ${epub.pageList.length} print pages · `
+ `${Math.round(bytes.length / 1024)} KB`), spine, link);
shelf.append(card);
}
document.getElementById('pages').before(shelf);
kitStatus(`${docs.length} documents laid out · two EPUB 3 files`);
readEpub abre o arquivo como um aplicativo de leitura faz: o spine na ordem de leitura, o sumário, a lista de páginas e o layout. O arquivo fixo tem uma entrada de spine por página; o refluível tem quatro, uma por capítulo. Os dois levam uma lista de páginas com os fólios impressos, por isso o leitor consegue seguir uma citação até a página 9 em qualquer um deles. O link <a download> dá um nome de arquivo aos bytes; nada passa por um servidor.
A receita completa
// ═══ Postext Cookbook · Nº 115 · One book, two EPUB 3 files: fixed and reflowable ════
// https://postext.dev/en/cookbook/epub-fixed-and-reflowable
// Code: MIT · Text: Aesop, tr. G. F. Townsend, 1867; L. Alas, Clarín, 1893 (PD) · Pictures: none
// Fonts: Libre Caslon Text, Libre Caslon Display, Jost (SIL OFL 1.1) · Needs postext ≥ 1.65.0
//
// A small book of three chapters, laid out once with buildBundle and written as two EPUB 3
// files with postext-epub: a fixed layout that keeps every printed page, and reflowable text
// that a phone or an e-reader sets again. Each file is read back with readEpub to list what
// a reading system will open, with a link to download it.
import {
buildBundle, prepareFonts, withLoadedFonts, renderPageToCanvas,
} from 'https://esm.sh/postext';
import { renderToEpub, readEpub } from 'https://esm.sh/postext-epub';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'epub-fixed-and-reflowable';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: semantic colours, every one linked by id
const palette = {
ink: '#211e1b', // text: a warm near-black
accent: '#2d5872', // Prussian blue: kickers, rules, folios
rule: '#c8c0b4', // the title page's hairline
muted: '#6b645d', // running heads and the imprint
paper: '#fbf8f1', // an off-white page, kept in the fixed-layout EPUB
};
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 [TEXT, DISPLAY, LABEL] = ['Libre Caslon Text', 'Libre Caslon Display', 'Jost'];
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER] = [120, 190, 20, 22, 16, 15]; // mm
const MEASURE = TRIM_W - INNER - OUTER; // 89 mm: about 62 characters of Libre Caslon Text
const LEAD = 13.5; // pt: the body leading
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const caps = (size, color = 'accent') => ({ fontFamily: LABEL, fontSize: pt(size),
fontWeight: 600, letterSpacing: pt(size * 0.2), textTransform: 'uppercase', color: col(color) });
// #region openers: a title page, then each chapter sunk under its kicker and a short rule
// Each line spans the measure and centres its text; the rule centres under the title.
const text = (id, content, fontFamily, size, placement, extra = {}) => ({ kind: 'text', id,
content, fontFamily, fontSize: pt(size), color: col('ink'), align: 'center',
overflow: 'wrap', lineHeight: 1.15, ...extra,
placement: { ...placement, size: { width: 'fill', height: 'auto' } } });
const rule = (id, below, y) => ({ kind: 'rule', id, direction: 'horizontal', thickness: pt(0.75),
color: col('accent'),
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
#Dê uma imagem de capa ao layout fixo
Pinte a folha de rosto num canvas e passe-a como capa; showsFirstPage diz ao gravador para não acrescentá-la como uma página à parte.
+const canvas = document.createElement('canvas');
+renderPageToCanvas(docs[0].pages[0], docs[0], canvas, { scale: 2 });
+const png = await new Promise((done) => canvas.toBlob(done, 'image/png'));
+const cover = { bytes: new Uint8Array(await png.arrayBuffer()), mediaType: 'image/png',
+ showsFirstPage: true };
-const fixed = await renderToEpub(docs, { ...book, layout: 'fixed' });
+const fixed = await renderToEpub(docs, { ...book, layout: 'fixed', cover });#Imprima os mesmos capítulos em PDF
renderToPdf(docs, …), do postext-pdf, recebe o mesmo array, de modo que o PDF, o EPUB e a tela saem de uma única diagramação. A novela catalã de bolso mostra o lado do PDF.
Erros comuns
Erro comum
renderToEpub incorpora só as fontes que você passa
As fontes carregadas pelo navegador não são arquivos que o postext-epub consiga ler: passe em options.fonts os bytes de cada fonte que as páginas usam (os mesmos arquivos woff2 do Fontsource que a página carregou). Uma fonte que ficar de fora é informada como missingFont, e o sistema de leitura compõe esse texto com uma fonte própria, que em um layout fixo já não cabe nas linhas com que a página foi composta. Incorpore só fontes cuja licença permita. Exportação para EPUB →
O arquivo refluível mantém o texto de um título, mas não o design: o antetítulo de cada abertura (Book I) é um elemento de design, por isso não está no texto. Ponha as palavras que o leitor precisa ver no próprio título ou no texto.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Eighteen fables from Three Hundred Æsop’s Fables, translated from the Greek by George Fyler Townsend (London, 1867), the opening capitals of each fable set in lower case · Aesop, tr. George Fyler Townsend · domínio público
- ¡Adiós, Cordera!, complete, from El Señor y lo demás, son cuentos (Madrid, 1893), its five parts grouped in three chapters, with dialogue dashes and « » quotation marks · Leopoldo Alas, Clarín · domínio público
- Fontes
- Libre Caslon Text (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Jost (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)


