En pocas palabras
Un cuento corto compuesto una vez para imprimir y guardado como dos libros electrónicos: uno que conserva cada página impresa y otro cuyo texto el móvil o el lector electrónico recompone a su tamaño.
Lo que vas a componer
¡Adiós, Cordera!, el cuento de Clarín, en tres capítulos sobre una página de 120 × 190 mm, con portada, página de créditos al dorso y una apertura hundida en cada capítulo; la edición inglesa compone dieciocho fábulas de Esopo con el mismo diseño. El libro se compone una vez, capítulo a capítulo, y esa composición da dos archivos EPUB 3. El de maquetación fija conserva cada página impresa: las aperturas, las cabeceras y los cortes de línea, en la Caslon incrustada. El de maquetación fluida conserva el texto y su estructura, y el sistema de lectura lo vuelve a componer en un móvil o en una pantalla de tinta electrónica. Los dos se descargan desde la página y los dos pasan EPUBCheck, el validador del W3C.
Esta receta responde a
- ¿Cómo exporto mi libro a EPUB, con páginas fijas o con texto fluido?
La respuesta corta
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
- Funciones
- Exportación a EPUBLibros construidos capítulo a capítuloAperturas diseñadasEstilos de títuloAtributos de títuloCabeceras y foliosCabeceras según el tipo de páginaMárgenes simétricosColor del papelEstilos de párrafoViudas, huérfanas y líneas cortasMetadatos del documentoPaleta de color semánticaFuentes antes de componer
- Tipografía
- Libre Caslon Text, Libre Caslon Display, Jost (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Compón el libro por 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 compone cada capítulo como un documento propio y pasa de uno a otro el número de página y la paridad, así que docs es la misma lista que imprimiría renderToPdf. El escritor de EPUB lee esa lista: cada capítulo es una entrada del índice de navegación, y el archivo de maquetación fluida escribe un documento XHTML por capítulo. La portada y su página de créditos forman el primer capítulo, y su frontmatter da el título, el subtítulo y el autor del libro.
#2 · Dale al escritor los archivos de las fuentes
// 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 };
})));
Las fuentes que cargó el navegador no son archivos que el escritor pueda leer, así que el código vuelve a pedir los mismos woff2 de Fontsource, que el navegador ya tiene en caché. Cada uno entra en el EPUB como un archivo con su regla @font-face. Sin ellos, la maquetación fija colocaría el texto compuesto en Caslon con una fuente del lector, y las líneas ya no cabrían en su medida.
#3 · Escribe las dos versiones
El código es la respuesta corta de arriba. layout: 'fixed' escribe un documento XHTML por página impresa, al tamaño de la página refilada y con texto de verdad, que se puede seleccionar; layout: 'reflowable' rehace los párrafos a partir de las líneas compuestas, quita los guiones que añadieron los cortes de línea y saca una hoja de estilos de la configuración. Una fecha modified fija hace que cada ejecución dé los mismos bytes. Los metadatos salen del frontmatter del primer capítulo, de modo que el título y el autor del archivo son los que se imprimen en la portada.
#4 · Lee cada archivo de vuelta
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 el archivo como lo abre un sistema de lectura: el orden de lectura (spine), el índice, la lista de páginas y la maquetación. El archivo fijo tiene una entrada por página; el de maquetación fluida, cuatro, una por capítulo. Los dos llevan la lista de los folios impresos, así que una cita de la página 9 se encuentra en cualquiera de ellos. El enlace <a download> da nombre a los bytes; nada pasa por un servidor.
La receta 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 = 'es'; // @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'),
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
#Pon una imagen de cubierta a la maquetación fija
Pinta la portada en un canvas y pásala como cubierta; showsFirstPage le dice al escritor que no la añada como una página más.
+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 });#Imprime los mismos capítulos en PDF
renderToPdf(docs, …), de postext-pdf, recibe la misma lista, así que el PDF, el EPUB y la pantalla salen de una sola composición. La novela catalana de bolsillo muestra el lado del PDF.
Errores frecuentes
Error frecuente
renderToEpub solo incrusta las fuentes que le pasas
Las fuentes que ha cargado el navegador no son archivos que postext-epub pueda leer: pasa en options.fonts los bytes de cada fuente que usan las páginas (los mismos woff2 de Fontsource que cargó la página). Una fuente que falte se avisa como missingFont, y el sistema de lectura compone ese texto con una suya, que en una maquetación fija ya no cabe en las líneas con que se compuso la página. Incrusta solo fuentes cuya licencia lo permita. Exportación a EPUB →
El archivo de maquetación fluida conserva el texto de un título, pero no su diseño: el antetítulo de cada apertura es un elemento de diseño y no forma parte del texto. Lo que el lector tenga que ver va en el propio título o en el texto.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Dieciocho fábulas de Three Hundred Æsop’s Fables, traducidas del griego por George Fyler Townsend (Londres, 1867), con las mayúsculas iniciales de cada fábula en minúscula · Aesop, tr. George Fyler Townsend · dominio público
- ¡Adiós, Cordera!, completo, de El Señor y lo demás, son cuentos (Madrid, 1893), con sus cinco partes agrupadas en tres capítulos, raya en los diálogos y comillas « » · Leopoldo Alas, Clarín · dominio público
- Fuentes
- Libre Caslon Text (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Jost (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)


