Saltar al contenido principal
Receta número 148

Recetario · Capítulo 11 · Cómic y manga

Un EPUB de cómic que se lee viñeta a viñeta

Un cómic exportado como PDF, como EPUB fijo con navegación por regiones para leerlo viñeta a viñeta, como EPUB para Kindle y como EPUB de maquetación fluida.

En esta página
Género
Cómics
Salida
Canvas · PDF · EPUB
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.65.0 · postext-pdf ≥ 1.65.0
Licencia
Actualizada el 31 oct 2026
Código MIT · Texto CC BY 4.0

pp. 2–3 de 3

  • Formato 168 × 259 mm
  • 1 columna
  • Comic Neue 10,5/15
  • Bangers
  • 3 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 256 ms
  • 184 líneas de código

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

script.js · líneas 264–279en el código completo
// 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

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.jpg
  • lh-beam.jpg
  • lh-biscuit.jpg
  • lh-maya.jpg
  • lh-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.

Viñeta 1 de la página 2: en la lectura guiada, la primera región, con la cartela y el bocadillo de Maya dentro.

#2 · Incrusta las letras que usan las páginas

script.js · líneas 210–239en el código completo
// 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

script.js · líneas 283–304en el código completo
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

script.js · líneas 36–41en el código completo
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

Sandbox
// ═══ 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

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)
SandboxPDF