En pocas palabras
Un cómic de dos páginas guardado como PDF de imprenta y como libros electrónicos: uno que conserva las páginas y deja ir de viñeta en viñeta, otro para Kindle y otro con los diálogos como texto.
Lo que vas a componer
El primer capítulo de La luz de Porthcove: una portada y dos páginas de cómic, maquetadas una vez y exportadas de cuatro maneras. El PDF es para imprenta. El EPUB de maqueta fija conserva las páginas impresas y lleva navegación por regiones, así que un lector electrónico puede mostrar el libro viñeta a viñeta, saltando de la llegada al faro a la radio y luego a Maya. Un segundo EPUB fijo añade Kindle Panel View; el adaptable compone cada viñeta como su imagen recortada seguida de sus diálogos. La página lista cada archivo tal como lo abrirá un lector, con su enlace de descarga, en diez idiomas.
Esta receta responde a
- ¿Cómo hago un EPUB de cómic que se lea viñeta a viñeta?
La respuesta corta
// 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
- Funciones
- Cómics en PDF y EPUBExportación a EPUBDivisión en viñetasImagen y recorte de la viñetaPáginas de cómicRotulación de cómicRotular en otros idiomasPersonajes y anclasEstilos de bocadilloZona segura de la imagenPaleta de color semánticaPáginas en un canvasExportación a PDF
- También usa
- Bordes y calles de las viñetasColor del papelCabeceras según el tipo de páginaEstilos de párrafoFuentes incrustadas en el PDFFiguras y tablas como recursosOnomatopeyas
- Tipografía
- Comic Neue, Bangers, Zen Antique, Dela Gothic One, ZCOOL KuaiLe, ZCOOL QingKe HuangYou, Playpen Sans Arabic, Lalezar (SIL OFL 1.1)
- Recursos
lh-arrive.jpglh-beam.jpglh-biscuit.jpglh-maya.jpglh-radio.jpg- Viñeta: Maya llega al faro (Generated With Diffusion Models, original)
- Viñeta: Tomás junto a la radio (Generated With Diffusion Models, original)
- Viñeta: Maya encuentra el problema (Generated With Diffusion Models, original)
- Viñeta: Biscuit dormido sobre el cable (Generated With Diffusion Models, original)
- Viñeta: el faro encendido de noche (Generated With Diffusion Models, original)
Elaboración
#1 · Exporta el mismo documento como EPUB
El código es la respuesta corta de arriba. renderToEpub recibe los documentos que imprime renderToPdf, así que las páginas del EPUB son las del PDF (salida de los cómics). Con layout: 'fixed' y páginas de cómic en el libro, escribe además regions.xhtml: una región panel por viñeta en orden de lectura, cada una un rectángulo en porcentaje de su página, con sus bocadillos, cartelas y onomatopeyas como regiones dentro. El sentido de paso de página sigue el sentido de lectura del cómic, así que las ediciones japonesa y árabe pasan de derecha a izquierda. kindlePanelView: true añade una zona táctil por viñeta y una copia ampliada, con los metadatos que espera Kindle. La versión adaptable no tiene páginas que conservar: cada viñeta es su imagen, recortada como en la página, y luego sus diálogos, «Maya: ¡Biscuit! ¿Y el abuelo?», con los nombres de comics.cast.

#2 · Incrusta las letras que usan las páginas
// 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()) })));
}
Un EPUB de maqueta fija dibuja el texto con las letras que lleva dentro, y una letra que falta se sustituye por la del lector. La rotulación pide redonda, negrita y cursiva; las letras de cómic traen menos, así que cada petición recibe el archivo que eligió loadComicFonts, y un archivo que sirve a los dos pesos entra una sola vez con el rango '400 700'. Las letras japonesas y chinas solo llevan los trozos con los caracteres de su edición, lo que deja el libro japonés en 1,4 MB.
#3 · Vuelve a leer cada archivo
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 los bytes como lo haría un lector: maqueta, sentido de paso, columna vertebral. La lista de cada tarjeta es la propia lectura guiada, leída de regions.xhtml: cinco viñetas y sus regiones de texto, en el orden en que el lector las recorre. Los tres archivos pasan EPUBCheck 5.4 sin errores ni avisos en inglés, japonés y árabe.
#4 · Una maqueta, diez ediciones
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 lleva las palabras de una edición con los mismos identificadores de personaje. Las regiones de las viñetas son iguales en todos los idiomas; las de los bocadillos se mueven con ellos, que se rotulan de nuevo alrededor del texto de cada idioma.
La receta 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 = 'es'; // @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'),
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Quita la edición para Kindle
La navegación por regiones va en todo EPUB fijo; Kindle Panel View solo se suma a ella.
- kindle: await renderToEpub(doc, { ...book, layout: 'fixed', kindlePanelView: true }),#Pon cubierta al libro adaptable
- reflowable: await renderToEpub(doc, { ...book, layout: 'reflowable' }),
+ reflowable: await renderToEpub(doc, { ...book, layout: 'reflowable',
+ cover: { bytes: imageBytes('lh-beam.jpg'), mediaType: 'image/jpeg' } }),Errores frecuentes
- Una letra incrustada una vez por cada peso al que sirve se copiaría cuatro veces; la edición china pesaba 5,3 MB antes de los rangos de peso.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imágenes
- Viñeta: Maya llega al faro · Generated With Diffusion Models · original
- Viñeta: Tomás junto a la radio · Generated With Diffusion Models · original
- Viñeta: Maya encuentra el problema · Generated With Diffusion Models · original
- Viñeta: Biscuit dormido sobre el cable · Generated With Diffusion Models · original
- Viñeta: el faro encendido de noche · Generated With Diffusion Models · original
- Fuentes
- 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 Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


