Saltar al contenido principal
Receta número 25

Recetario · Capítulo 10 · Salida e integración

Un PDF de verdad con las mismas fuentes incrustadas

Un programa de mano exportado a PDF. Cada fuente se descarga una sola vez, para FontFace y para el PDF, y cada título se convierte en un marcador.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licencia
Actualizada el 10 oct 2026
Código MIT · Texto CC BY 4.0
  • Muestra en inglés: aún no hay edición en español
  • Formato 148 × 210 mm
  • 1 columna
  • Crimson Text 10/13,3
  • Fraunces
  • Tenor Sans
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 54 ms
  • 180 líneas de código

En pocas palabras

El programa de cuatro páginas de un recital al atardecer. Enseña a guardarlo como un PDF idéntico a la pantalla, con sus fuentes dentro y cada título en la lista de marcadores para saltar a él.

Lo que vas a componer

El programa de mano, en inglés, de un recital al atardecer, Home from Sea: cuatro páginas A5 para soprano, violonchelo y arpa. La cubierta es azul petróleo, con el título en Fraunces cursiva dorada y filas de escamas de olas doradas que suben desde el pie. Dentro, el orden del programa es una tabla con el encabezado azul en versales de Tenor Sans y el total sobre fondo claro. Las notas van en Crimson Text justificado, y los poemas de las tres canciones, de Longfellow, Stevenson y Tennyson, conservan las sangrías de sus ediciones impresas. El botón Build the PDF genera el archivo que mandarías al público o colgarías en la web de la sala. Sus páginas coinciden línea a línea con la pantalla. Incrusta solo las cinco fuentes que cargó el navegador, y cada título es un marcador. Para imprenta, mira el PDF con sangrado y CMYK.

Esta receta responde a

  • ¿Cómo exporto un PDF de verdad en el navegador, con las fuentes incrustadas?
  • ¿Por qué cambian mis cortes de línea o se solapan las palabras en el PDF, y cómo cargo bien las fuentes?

La respuesta corta

script.js · líneas 15–51en el código completo
// Hook-up: `await registerFaces()` before the first build; `renderToPdf(doc, { fontProvider })`.
const files = new Map(); // 'crimson-text-latin-600-normal' → its WOFF2 (gotcha: latin-subset)
function fontFile(family, weight, style) {
  const id = family.toLowerCase().replaceAll(' ', '-'), file = `${id}-latin-${weight}-${style}`;
  if (!files.has(file)) {
    files.set(file, fetch(`https://cdn.jsdelivr.net/npm/@fontsource/${id}@5/files/${file}.woff2`)
      .then((res) => {
        if (!res.ok) throw new Error(`Fontsource has no ${family} ${weight} ${style}`);
        return res.arrayBuffer();
      }));
  }
  return files.get(file);
}
const facesOf = (family) => (FONTS[family] ?? []).map((spec) =>
  ({ spec, weight: parseInt(spec, 10), style: spec.endsWith('i') ? 'italic' : 'normal' }));

// The screen: a FontFace per face, from those bytes, before the first build.
const registerFaces = () => Promise.all(Object.keys(FONTS).flatMap((family) =>
  facesOf(family).map(async ({ weight, style }) => {
    const face = new FontFace(family, await fontFile(family, weight, style),
      { weight: `${weight}`, style });
    document.fonts.add(await face.load());
  })));

// The PDF: the same bytes as TrueType. renderToPdf asks for each face the pages paint and no
// other. A face FONTS lacks gets the closest one it has, and is logged as a stand-in: the
// status line should list none.
const embedded = new Set(), standIns = new Set(); // shown once the PDF is ready
async function fontProvider(family, weight, style) {
  if (!FONTS[family]) throw new Error(`${family} is not in FONTS: no page was set in it`);
  const cost = (f) => (f.style === style ? 0 : 1000) + Math.abs(f.weight - weight);
  const best = facesOf(family).reduce((a, b) => (cost(b) < cost(a) ? b : a));
  const asked = `${weight}${style === 'italic' ? 'i' : ''}`;
  embedded.add(`${family} ${best.spec}`);
  if (asked !== best.spec) standIns.add(`${family} ${asked} → ${best.spec}`);
  return decompressWoff2(new Uint8Array(await fontFile(family, best.weight, best.style)));
}

Ingredientes

Tipografía
Crimson Text, Fraunces, Tenor Sans (SIL OFL 1.1)
Recursos
  • Las olas seigaiha de la cubierta, dibujadas en código con la paleta de la página (Ignacio Ferro, CC BY 4.0)

Elaboración

#1 · Una descarga por fuente (peso y estilo), para la página y para el PDF

El código es la respuesta corta de arriba. Postext mide cada palabra con las fuentes que el navegador tiene cargadas al componer, y el PDF dibuja cada línea donde la dejó esa composición. Si el PDF incrusta otro archivo, como la instancia por defecto de una fuente variable o una fuente de reserva del sistema, cada palabra sigue en su sitio, pero sus letras tienen otro ancho, así que las palabras se solapan o dejan huecos. Por eso la receta descarga cada fuente una sola vez. Con sus bytes se crea un FontFace antes de la primera composición, y el proveedor de fuentes pasa esos mismos bytes por decompressWoff2 para el PDF, de modo que la exportación no descarga ninguna fuente.

#2 · Primero las fuentes, después la composición

script.js · líneas 363–367en el código completo
await registerFaces(); // the answer: every face in FONTS, from its own bytes
await loadSvg('cover.svg', coverArt(PAGE.width, PAGE.height, WAVES));
// Every face is declared by now; one FONTS forgot would come from Fontsource, for the screen only.
const doc = await buildDocumentWithFonts({ markdown, resources }, config(), kitFonts(FONTS));
showPages(doc, { title: 'Home from Sea · a recital programme' });

registerFaces() no se resuelve hasta que se hayan cargado todas las fuentes de FONTS, así que la primera composición ya mide con las fuentes que va a incrustar el PDF. No hace falta una segunda, porque FONTS enumera todas las fuentes que componen las páginas, y buildDocumentWithFonts encuentra ya declaradas todas las fuentes que busca (Cargar las fuentes antes de componer). Esa comprobación solo sirve para la pantalla. Si a FONTS le falta una fuente, el motor se la pide al kit, carga el archivo de Fontsource y vuelve a componer sin avisar en la consola, pero el PDF recibe igualmente la fuente más próxima de las que tiene el proveedor.

#3 · La exportación y la lista de lo que incrustó

script.js · líneas 371–386en el código completo
const bar = Object.assign(document.createElement('progress'), { max: 1, value: 0 });
const list = (faces) => [...faces].join(', ') || 'none';
offerPdf(() => {
  document.getElementById('pt-actions').prepend(bar);
  return renderToPdf(doc, {
    fontProvider, // the answer: the page's own font files
    resourceBytes: imageBytes, // the cover drawing, as vector paths
    outlines: true, // the default, spelled out: each heading becomes a bookmark
    onProgress: ({ phase, pages, totalPages }) => {
      bar.value = pages / totalPages;
      const says = { prepare: 'fonts and cover embedded', pages: `page ${pages} of ${totalPages}`,
        save: `embedded: ${list(embedded)} · stand-ins: ${list(standIns)}` };
      kitStatus(`PDF · ${says[phase]}`);
    },
  });
}, `${RECIPE}.pdf`);

renderToPdf llama a onProgress en tres fases: prepare cuando ya ha incrustado las fuentes y la cubierta, pages tras cada página y save antes de escribir el archivo. Solo pide al proveedor las fuentes que pintan las páginas, aquí cinco. La línea de estado enumera los cinco archivos que sirvió el proveedor, que son exactamente los de FONTS, y ninguna sustituta. Una sustituta delata una fuente que falta en FONTS. Si quitas Crimson Text 600, la línea muestra Crimson Text 600 → 400 y la negrita de The Harbour Consort, en la página 4, sale con el peso normal. La vista previa de CodePen no puede mostrar un PDF, así que offerPdf, del kit, cambia el botón por dos enlaces: uno abre el PDF en otra pestaña y el otro lo descarga (Generación de PDF).

#4 · El árbol de títulos es el árbol de marcadores

script.js · líneas 108–116en el código completo
const headings = { fontFamily: 'Fraunces', fontWeight: 300, color: col('band'),
  marginTop: pt(0), marginBottom: pt(0), // a two-line H2 carries its own space above
  levels: [ // a section opens on the next page, left or right: a programme has no blank pages
    { level: 1, breakBefore: { enabled: true, parity: 'any' }, advancedDesign: opener },
    { level: 2, ...H2 },
  ] };
// The performers: a top-level bookmark, no break, no opener (gotcha: style-inherits-break).
const aside = { id: 'aside', breakBefore: { enabled: false }, advancedDesign: { enabled: false },
  ...H2, marginTop: pt(LEAD) };

En el panel de marcadores del PDF aparecen el título de la cubierta, Programme con About the music debajo, The texts con sus tres canciones y The performers. Los marcadores reproducen los niveles de encabezado, así que el índice del PDF se decide al elegir esos niveles: aquí, un H1 por sección y un H2 por canción. The performers tiene un estilo de encabezado propio, un H1 sin salto de página ni apertura, de modo que comparte la página 4 con el poema de Tennyson y aun así tiene un marcador de primer nivel. El \\ que parte en dos el título de la cubierta queda como un espacio en el marcador.

#5 · Título y autor desde el frontmatter

script.js · líneas 80–93en el código completo
const cover = {
  id: 'cover', span: 'page', header: { elements: [] }, footer: { elements: [] },
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'image', id: 'night', resourceId: 'cover',
      placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill' } } },
    text('consort', '{author}', at('page', 'top', 18), label(8.5, 'gilt')),
    text('title', '{titleText}', at('page', 'top', 26, 120), // the \\ in the heading breaks it
      { ...title(68), lineHeight: 0.95, color: col('gilt') }),
    text('subtitle', '{subtitle}', at('page', 'top', 75, 66), { fontFamily: 'Crimson Text',
      italic: true, fontSize: pt(12.5), lineHeight: 1.25, color: col('foam') }),
    text('when', '{attr.when}', at('page', 'top', 91), label(LABEL, 'foam')),
    text('where', '{attr.where}', at('page', 'top', 96), label(LABEL, 'foam')),
  ] } },
};

La cubierta imprime dos valores del frontmatter con {author} y {subtitle}, y el PDF toma de ahí el título, Home from Sea, y el autor, The Harbour Consort, para sus propiedades de documento. La fecha y el lugar son atributos del encabezado de la cubierta. El dibujo de detrás es un solo SVG del ancho de la página, y el PDF lo conserva como trazados vectoriales.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 025 · A real PDF with the same fonts embedded ═══════════
// https://postext.dev/en/cookbook/pdf-with-embedded-fonts
// Code: MIT · Text: notes original (CC BY 4.0), poems in the public domain · Cover: drawn in code
// Fonts: Crimson Text, Fraunces, Tenor Sans (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'pdf-with-embedded-fonts';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region answer: one download per face: the layout measures it, the PDF embeds it
// Hook-up: `await registerFaces()` before the first build; `renderToPdf(doc, { fontProvider })`.
const files = new Map(); // 'crimson-text-latin-600-normal' → its WOFF2 (gotcha: latin-subset)
function fontFile(family, weight, style) {
  const id = family.toLowerCase().replaceAll(' ', '-'), file = `${id}-latin-${weight}-${style}`;
  if (!files.has(file)) {
    files.set(file, fetch(`https://cdn.jsdelivr.net/npm/@fontsource/${id}@5/files/${file}.woff2`)
      .then((res) => {
        if (!res.ok) throw new Error(`Fontsource has no ${family} ${weight} ${style}`);
        return res.arrayBuffer();
      }));
  }
  return files.get(file);
}
const facesOf = (family) => (FONTS[family] ?? []).map((spec) =>
  ({ spec, weight: parseInt(spec, 10), style: spec.endsWith('i') ? 'italic' : 'normal' }));

// The screen: a FontFace per face, from those bytes, before the first build.
const registerFaces = () => Promise.all(Object.keys(FONTS).flatMap((family) =>
  facesOf(family).map(async ({ weight, style }) => {
    const face = new FontFace(family, await fontFile(family, weight, style),
      { weight: `${weight}`, style });
    document.fonts.add(await face.load());
  })));

// The PDF: the same bytes as TrueType. renderToPdf asks for each face the pages paint and no
// other. A face FONTS lacks gets the closest one it has, and is logged as a stand-in: the
// status line should list none.
const embedded = new Set(), standIns = new Set(); // shown once the PDF is ready
async function fontProvider(family, weight, style) {
  if (!FONTS[family]) throw new Error(`${family} is not in FONTS: no page was set in it`);
  const cost = (f) => (f.style === style ? 0 : 1000) + Math.abs(f.weight - weight);
  const best = facesOf(family).reduce((a, b) => (cost(b) < cost(a) ? b : a));
  const asked = `${weight}${style === 'italic' ? 'i' : ''}`;
  embedded.add(`${family} ${best.spec}`);

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

#Prescinde de los marcadores

Una hoja suelta o un cartel no necesitan marcadores, y sin ellos el PDF se abre con la barra lateral cerrada.

-    outlines: true, // the default, spelled out: each heading becomes a bookmark
+    outlines: false,

#Sirve tú las fuentes

Cambia la URL de Fontsource por la de tus copias de los mismos archivos WOFF2 estáticos, uno por peso y estilo, con los nombres que usa Fontsource. La página y el PDF siguen compartiendo cada descarga.

-    files.set(file, fetch(`https://cdn.jsdelivr.net/npm/@fontsource/${id}@5/files/${file}.woff2`)
+    files.set(file, fetch(`/fonts/${file}.woff2`)
       .then((res) => {
-        if (!res.ok) throw new Error(`Fontsource has no ${family} ${weight} ${style}`);
+        if (!res.ok) throw new Error(`No font file ${file}.woff2`);

Errores frecuentes

Error frecuente

La negrita o la cursiva que la familia no trae se simula en pantalla, no en el PDF

Cuando un texto pide un peso o un estilo que su familia no trae (una cabecera de tabla en negrita con una fuente de rótulos de un solo estilo, cursiva en una sans sin cursivas), el navegador lo sintetiza en el canvas y en HTML: engruesa o inclina la redonda con los mismos anchos. Un PDF solo incrusta fuentes reales, así que allí se imprime la fuente más cercana que dé el proveedor, sin engrosar ni inclinar. Pon en tu lista de fuentes solo las que la familia trae y ajusta cada estilo a ellas, por ejemplo con tableStyle.headerBold: false. Fuentes incrustadas en el PDF →

Error frecuente

Los archivos de Fontsource cubren letras, no símbolos

El kit incrusta el archivo latin de Fontsource de cada fuente y, cuando el texto los usa, su archivo latin-ext para č, ł, † y su archivo greek para α, χ (en una familia que lo tenga: Lora y Gelasio no), en pantalla y en el PDF. Símbolos como →, ≈, ✓ y ★ no están en ninguno de esos archivos y faltan en el PDF: dibújalos, escríbelos como matemáticas o elige una fuente cuyos archivos los tengan. Fuentes incrustadas en el PDF →

Error frecuente

Un estilo de título hereda el salto de página de su nivel

Una entrada de headingStyles toma de su nivel de título todo lo que no fija, también breakBefore. Un índice o un colofón con estilo sobre un H1 tras un :::pagebreak hereda la paridad 'odd' y cae detrás de una página en blanco. Dale a ese estilo breakBefore: { enabled: false }. Estilos de título →

Enumera en FONTS todas las fuentes que componen tus páginas, también la negrita y la cursiva del texto. Si olvidas una, en pantalla no lo notarás, porque el kit la carga sin avisar; el PDF, en cambio, imprime la fuente más próxima que tenga el proveedor, y solo lo delatan las sustitutas de la línea de estado.

Usa archivos estáticos, uno por peso y estilo. De un WOFF2 variable solo se incrusta la instancia por defecto, así que una negrita saldría con el peso normal (¿Por qué un proveedor de fuentes?).

Créditos

Texto
  • «The Tide Rises, the Tide Falls», con sus sangrías, tal como se imprimió en The Complete Poetical Works of Henry Wadsworth Longfellow · Henry Wadsworth Longfellow · dominio público
  • «Requiem», con las sangrías y las cursivas de la primera edición de Underwoods (1887) · Robert Louis Stevenson · dominio público
  • «Crossing the Bar», con sus versos cortos sangrados, de la primera edición de Demeter and Other Poems (1889), en la transcripción revisada de Wikisource · Alfred Tennyson · dominio público
  • El programa, las notas sobre la música, los intérpretes y el colofón · Ignacio Ferro · CC BY 4.0
Imágenes
  • Las olas seigaiha de la cubierta, dibujadas en código con la paleta de la página · Ignacio Ferro · CC BY 4.0
Fuentes
Crimson Text (SIL OFL 1.1) · Fraunces (SIL OFL 1.1) · Tenor Sans (SIL OFL 1.1)
SandboxPDF