Em poucas palavras
Uma HQ de duas páginas salva como PDF para gráfica e como e-books: um que mantém as páginas e deixa o leitor ir de quadro em quadro, um para Kindle e um com os diálogos em texto simples.
O que você vai compor
O primeiro capítulo de O farol de Porthcove: uma folha de rosto e duas páginas de quadrinhos, diagramadas uma vez e exportadas de quatro maneiras. O PDF vai para a gráfica. O EPUB de layout fixo mantém as páginas impressas e leva navegação por regiões, de modo que o aplicativo de leitura pode mostrar o livro um quadro por vez, aproximando o quadro da chegada, depois o rádio, depois Maya. Um segundo EPUB fixo acrescenta o Kindle Panel View; o refluível compõe cada quadro como sua imagem recortada seguida das falas. A página lista cada arquivo do jeito que o leitor vai abri-lo, com link para baixar, em dez idiomas.
Esta receita responde a
- Como faço para criar um EPUB de quadrinhos que se lê quadro a quadro?
A resposta curta
// The fixed layout keeps every printed page and writes regions.xhtml (EPUB Region-Based
// Navigation): one panel region per panel in reading order, its balloons nested in it.
// kindlePanelView adds Kindle's tap-to-magnify targets; the reflowable book sets each panel
// as its cropped picture followed by its lines as text.
const book = {
metadata: { title: doc.metadata.title, creators: [doc.metadata.author], language: config().locale,
modified: new Date('2026-10-07T00:00:00Z') }, // a fixed date: the same bytes on every run
fonts: await epubFonts([LETTERING, SFX], markdown), // every face the pages set, as bytes
resourceBytes: (fileId) => ({ bytes: imageBytes(fileId), mediaType: 'image/jpeg' }),
onWarning: (w) => console.warn(`[epub] ${w.kind}`, w.family ?? w.fileId ?? w.detail),
};
const epubs = {
fixed: await renderToEpub(doc, { ...book, layout: 'fixed' }),
kindle: await renderToEpub(doc, { ...book, layout: 'fixed', kindlePanelView: true }),
reflowable: await renderToEpub(doc, { ...book, layout: 'reflowable' }),
};
Ingredientes
- Funcionalidades
- Quadrinhos em PDF e EPUBExportação para EPUBDivisão em quadrosArte e enquadramento do quadroPáginas de quadrinhosLetreiramento de quadrinhosLetreiramento em outros idiomasPersonagens e âncorasEstilos de balãoÁrea segura da imagemPaleta de cores semânticaPáginas em um canvasExportação para PDF
- Também usa
- Bordas e sarjetas dos quadrosCor do papelCabeços por tipo de páginaEstilos de parágrafoFontes incorporadas ao PDFFiguras e tabelas como recursosOnomatopeias
- Tipografia
- Comic Neue, Bangers, Zen Antique, Dela Gothic One, ZCOOL KuaiLe, ZCOOL QingKe HuangYou, Playpen Sans Arabic, Lalezar (SIL OFL 1.1)
- Materiais
lh-arrive.jpglh-beam.jpglh-biscuit.jpglh-maya.jpglh-radio.jpg- Panel picture: Maya arrives at the lighthouse (Generated With Diffusion Models, original)
- Panel picture: Tomás at the radio (Generated With Diffusion Models, original)
- Panel picture: Maya finds the problem (Generated With Diffusion Models, original)
- Panel picture: Biscuit asleep on the cable (Generated With Diffusion Models, original)
- Panel picture: the lamp lit at night (Generated With Diffusion Models, original)
Preparo
#1 · Exporte o mesmo documento como EPUB
O código é a resposta curta lá em cima. renderToEpub recebe os documentos que renderToPdf imprime, por isso as páginas do EPUB são as do PDF (saída de quadrinhos). Com layout: 'fixed' e páginas de quadrinhos no livro, ele grava também regions.xhtml: uma região panel por quadro, na ordem de leitura, cada uma um retângulo em porcentagem da página, com balões, recordatórios e onomatopeias como regiões dentro dela. A progressão das páginas segue o sentido de leitura da HQ, por isso as edições japonesa e árabe viram da direita para a esquerda. kindlePanelView: true acrescenta uma área de toque por quadro e uma cópia ampliada, com os metadados que o Kindle espera. A versão refluível não tem páginas a preservar: cada quadro é sua imagem, recortada como na página, e em seguida suas falas, “Maya: Biscuit! Cadê o vovô?”, com os nomes de comics.cast.

#2 · Incorpore as fontes que as páginas usam
// For each weight and style the lettering asks for, the file loadComicFonts chose (the
// nearest one Fontsource ships), only the slices whose characters the book sets. A file that
// serves several weights is embedded once, with a weight range ('400 700').
const inRange = (range, cp) => range.split(',').some((part) => {
const [lo, hi = lo] = part.trim().slice(2).split('-');
return cp >= parseInt(lo, 16) && cp <= parseInt(hi, 16);
});
async function epubFonts(families, text) {
const cps = [...new Set(text)].map((ch) => ch.codePointAt(0));
const byFile = new Map(); // url → the face it serves
for (const family of families) {
const meta = await fontsourceMeta(family);
const asks = [[400, 'normal'], [700, 'normal'], [400, 'italic'], [700, 'italic']];
for (const [weight, style] of asks) {
const w = meta.weights.reduce((a, b) => (Math.abs(b - weight) < Math.abs(a - weight) ? b : a),
400);
const s = style === 'italic' && meta.styles.includes('italic') ? 'italic' : 'normal';
for (const { url, range } of await comicFaceFiles(family, w, s, meta, text)) {
if (range && !cps.some((cp) => inRange(range, cp))) continue;
const face = byFile.get(url) ?? { family, style: s, weights: new Set(), range };
face.weights.add(weight);
byFile.set(url, face);
}
}
}
return Promise.all([...byFile].map(async ([url, { family, style, weights, range }]) => ({
family, style, format: 'woff2', unicodeRange: range,
weight: weights.size > 1 ? `${Math.min(...weights)} ${Math.max(...weights)}` : [...weights][0],
bytes: new Uint8Array(await (await fetch(url)).arrayBuffer()) })));
}
Um EPUB de layout fixo desenha o texto com as fontes que leva dentro, e uma fonte que fica de fora é trocada pela do próprio leitor. O letreiramento pede regular, negrito e itálico; as fontes de quadrinhos trazem menos arquivos, por isso cada pedido recebe o arquivo que loadComicFonts escolheu para ele, e um arquivo que atende aos dois pesos entra uma única vez com o intervalo '400 700'. As fontes japonesas e chinesas levam só as fatias que contêm os caracteres da edição, o que mantém o livro japonês em 1,4 MB.
#3 · 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');
for (const [name, bytes] of Object.entries(epubs)) {
const epub = readEpub(bytes);
const regions = new TextDecoder().decode(epub.files.get(`${epub.root}regions.xhtml`)
?? new Uint8Array());
const panels = regions.split('<li epub:type="panel">').slice(1); // one per panel
const card = el('article', 'width: min(300px, 92vw); padding: 16px; border: 1px solid #2c3038');
const steps = el('ol', 'margin: 8px 0; padding-left: 22px');
steps.append(...panels.map((p, i) => el('li', '', `panel ${i + 1}: ${(p.match(
/epub:type="(balloon|caption|sound-area|text-area)"/g) ?? []).length} text regions`)));
const link = Object.assign(el('a', 'color: #d8a21a', `Download ${RECIPE}-${name}.epub`), {
href: URL.createObjectURL(new Blob([bytes])), download: `${RECIPE}-${name}.epub` });
card.append(el('h2', 'margin: 0; font-size: 15px; color: #f4f1ea', `EPUB 3 · ${name}`),
el('p', 'margin: 4px 0 0', `${epub.layout} · ${epub.pageProgression} · `
+ `${epub.spine.length} documents · ${Math.round(bytes.length / 1024)} KB`),
panels.length ? steps : el('p', '', 'No region navigation: the panels are text.'), link);
shelf.append(card);
}
document.getElementById('pages').before(shelf);
readEpub abre os bytes como faria um aplicativo de leitura: layout, progressão das páginas, spine. A lista sob cada cartão é a própria leitura guiada, lida de regions.xhtml: cinco quadros e suas regiões de texto, na ordem em que o leitor passa por eles. Os três arquivos passam no EPUBCheck 5.4 sem erros nem avisos em inglês, japonês e árabe.
#4 · Um layout, dez edições
const [LETTERING, SFX] = t({
en: ['Comic Neue', 'Bangers'], es: ['Comic Neue', 'Bangers'], ca: ['Comic Neue', 'Bangers'],
ja: ['Zen Antique', 'Dela Gothic One'], zh: ['ZCOOL KuaiLe', 'ZCOOL QingKe HuangYou'],
ar: ['Playpen Sans Arabic', 'Lalezar'], pt: ['Comic Neue', 'Bangers'],
fr: ['Comic Neue', 'Bangers'], de: ['Comic Neue', 'Bangers'], it: ['Comic Neue', 'Bangers'],
});
Cada content.<lang>.md guarda as palavras de uma edição com os mesmos ids de personagem. As regiões dos quadros são iguais em todos os idiomas; as dos balões acompanham os balões, que são letreirados de novo em volta do texto de cada idioma.
A receita completa
// ═══ Postext Cookbook · Nº 148 · A comic EPUB read panel by panel ═══════════════════
// https://postext.dev/en/cookbook/comic-epub-guided-view
// Code: MIT · Text: original (CC BY 4.0) · Pictures: generated with diffusion models
// Fonts: Comic Neue, Bangers and the faces of five editions (OFL) · Needs postext ≥ 1.65.0
//
// A short comic laid out once and exported four ways: a PDF for print, a fixed-layout EPUB
// whose region-based navigation lets a reading system step through it panel by panel, the
// same EPUB with Kindle Panel View, and a reflowable EPUB with each panel's lines as text.
// Each file is read back to list what a reader will find in it.
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { renderToEpub, readEpub } from 'https://esm.sh/postext-epub';
const LANG = 'pt'; // @lang: 'en' | 'es' | 'ca' | 'zh' | 'ar' | 'ja' | 'pt' | 'fr' | 'de' | 'it'
const RECIPE = 'comic-epub-guided-view';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the night sea, the lighthouse red and the yellow of the captions
const palette = {
ink: '#1b2430', // panel borders, lettering and the title page
accent: '#b8322a', // the lighthouse red: title and sound effects
caption: '#f4e7bf', // caption boxes
muted: '#5f6873', // folios and the imprint
paper: '#fdfbf6',
};
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
// #region editions: six editions, each lettered in faces for its script
const [LETTERING, SFX] = t({
en: ['Comic Neue', 'Bangers'], es: ['Comic Neue', 'Bangers'], ca: ['Comic Neue', 'Bangers'],
ja: ['Zen Antique', 'Dela Gothic One'], zh: ['ZCOOL KuaiLe', 'ZCOOL QingKe HuangYou'],
ar: ['Playpen Sans Arabic', 'Lalezar'], pt: ['Comic Neue', 'Bangers'],
fr: ['Comic Neue', 'Bangers'], de: ['Comic Neue', 'Bangers'], it: ['Comic Neue', 'Bangers'],
});
// #endregion
const comics = {
gutter: { horizontal: mm(4), vertical: mm(3) },
panel: { borderWidth: pt(1), borderColor: col('ink'), background: col('paper') },
lettering: { fontFamily: LETTERING, fontSize: pt(8), color: col('ink'), inset: mm(1.5) },
balloonStyles: [{ id: 'speech', stroke: col('ink') }, { id: 'caption', fill: col('caption'),
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
#Deixe de fora a edição para Kindle
A navegação por regiões é gravada em todo EPUB fixo; o Kindle Panel View só se soma a ela.
- kindle: await renderToEpub(doc, { ...book, layout: 'fixed', kindlePanelView: true }),#Dê uma capa ao livro fluido
- reflowable: await renderToEpub(doc, { ...book, layout: 'reflowable' }),
+ reflowable: await renderToEpub(doc, { ...book, layout: 'reflowable',
+ cover: { bytes: imageBytes('lh-beam.jpg'), mediaType: 'image/jpeg' } }),Erros comuns
- Uma fonte incorporada uma vez para cada peso que atende seria copiada quatro vezes; a edição chinesa pesava 5,3 MB antes dos intervalos de peso.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imagens
- Panel picture: Maya arrives at the lighthouse · Generated With Diffusion Models · original
- Panel picture: Tomás at the radio · Generated With Diffusion Models · original
- Panel picture: Maya finds the problem · Generated With Diffusion Models · original
- Panel picture: Biscuit asleep on the cable · Generated With Diffusion Models · original
- Panel picture: the lamp lit at night · Generated With Diffusion Models · original
- Fontes
- Comic Neue (SIL OFL 1.1) · Bangers (SIL OFL 1.1) · Zen Antique (SIL OFL 1.1) · Dela Gothic One (SIL OFL 1.1) · ZCOOL KuaiLe (SIL OFL 1.1) · ZCOOL QingKe HuangYou (SIL OFL 1.1) · Playpen Sans Arabic (SIL OFL 1.1) · Lalezar (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)


