En pocas palabras
Un manual de identidad de un metro inventado. Enseña a descargar una sola vez las fuentes propias de una marca y usarlas en la vista previa, en el PDF y en el archivo guardado.
Lo que vas a componer
Cuatro páginas, en inglés, del manual de identidad del Metro de Alba, una red ficticia de cinco líneas. En la cubierta, las cinco líneas salen juntas de la esquina inferior izquierda y se separan hacia la derecha tras cruzar un río gris, bajo el nombre en Big Shoulders Display. Cada sección se abre bajo una franja negra, con un número de dos cifras en el color de una línea. En 01 Colour, la primera columna de la tabla es el propio color; 02 Type reúne líneas de muestra y un rótulo de andén, y 03 Usage cierra con dos planos enmarcados, uno dibujado según las reglas (Do) y otro saltándoselas (Don't). Todo el texto sale de seis archivos de fuente que el código descarga antes de componer. El PDF se dibuja con esos seis archivos y el .postext lleva cinco, porque la fuente de rótulos está marcada como no redistribuible.
Esta receta responde a
- ¿Cómo uso mis fuentes corporativas o con licencia en la composición y las incrusto en el PDF?
- ¿Cómo exporto un PDF de verdad en el navegador, con las fuentes incrustadas?
- ¿Cómo evito que los títulos, las negritas y las viñetas salgan en azul?
- ¿Cómo añado muestras de color como leyenda en el texto, los pies o las notas de tabla?
- ¿Cómo creo un paquete .postext desde el código para pasar un documento al Sandbox o a otro programa?
La respuesta corta
// Your licensed files, one per face in FONTS. Fontsource's copies stand in for them here:
// point FONT_URL at your own server (same origin, or one that lets this page in by CORS).
const slug = (family) => family.toLowerCase().replaceAll(' ', '-');
const FONT_URL = ({ family, weight, style }) => `https://cdn.jsdelivr.net/npm/@fontsource/`
+ `${slug(family)}@5/files/${slug(family)}-latin-${weight}-${style}.woff2`;
const brandFaces = () => Object.entries(FONTS).flatMap(([family, specs]) => specs.map((spec) => {
const weight = parseInt(spec, 10), style = spec.endsWith('i') ? 'italic' : 'normal';
return { family, weight, style, fileId: `${slug(family)}-${weight}-${style}.woff2` };
}));
const fontFiles = new Map(); // fileId → the WOFF2 bytes, fetched once
// 1 · Layout measures with document.fonts: register every face before the first build.
async function loadBrandFonts() {
await Promise.all(brandFaces().map(async ({ family, weight, style, fileId }) => {
const res = await fetch(FONT_URL({ family, weight, style }));
if (!res.ok) throw new Error(`No file for ${family} ${weight} ${style}`);
fontFiles.set(fileId, new Uint8Array(await res.arrayBuffer()));
const face = new FontFace(family, fontFiles.get(fileId), { weight: `${weight}`, style });
document.fonts.add(await face.load());
}));
}
// 2 · The PDF embeds the same bytes as TrueType. renderToPdf asks for the faces the pages
// paint; a weight or slant the brand lacks gets the family's closest file, embedded once.
async function brandFontProvider(family, weight, style) {
const cost = (f) => (f.style === style ? 0 : 1000) + Math.abs(f.weight - weight);
const own = brandFaces().filter((f) => f.family === family);
if (!own.length) throw new Error(`${family} is not one of the brand's fonts`);
return decompressWoff2(fontFiles.get(own.reduce((a, b) => (cost(b) < cost(a) ? b : a)).fileId));
}
// 3 · The bundle: customFonts names each face's file by its fileId; createBundle packs the bytes
// of every family it may hand on. Layout never reads it (gotcha: custom-fonts-declarative).
const customFonts = () => Object.keys(FONTS).map((name) => ({
name, redistributable: name !== DISPLAY, // the display face reaches suppliers another way
variants: brandFaces().filter((f) => f.family === name)
.map(({ weight, style, fileId }) => ({ weight, style, fileId, format: 'woff2' })),
}));
Ingredientes
- Funciones
- Tus propias fuentesPaleta de color semánticaRellenos de celdaMuestras de colorAperturas diseñadasTítulos numeradosBanda de capítulo a todo el anchoEstilos de tabla con nombreEstilos de párrafoTipos de recurso propiosEstilo de los piesColocación de figurasTextos, filetes y cajas en los diseños de páginaTipografía del textoUna o dos columnasFuentes antes de componerExportación a PDFPaquetes .postextPáginas en un canvasFiguras y tablas como recursos
- También usa
- RecuadrosCitas que colocan las figurasAtributos de títuloEstilos de títuloFigura y Tabla en tu idiomaColores por parteFuentes incrustadas en el PDFCabeceras por secciónCapítulos sin número
- Tipografía
- Public Sans, Big Shoulders Display, Spline Sans Mono (SIL OFL 1.1)
- Recursos
- El dibujo de la red en la cubierta y los dos ejemplos de plano, dibujados en código (Ignacio Ferro, CC BY 4.0)
Elaboración
#1 · Registra las fuentes de la marca, compón y dale al PDF los mismos bytes
await loadBrandFonts(); // the answer, step 1
for (const [fileId, markup] of Object.entries(ART)) await loadSvg(fileId, markup);
const doc = buildDocument({ markdown, resources }, config());
showPages(doc, { title: 'Metro de Alba · Identity manual' });
offerPdf(() => renderToPdf(doc, { fontProvider: brandFontProvider, resourceBytes: imageBytes }),
`${RECIPE}.pdf`); // step 2: the provider hands renderToPdf the same files
La composición mide cada palabra con las fuentes de document.fonts, así que loadBrandFonts(), en la respuesta corta, descarga cada archivo una sola vez, guarda los bytes y registra con ellos un FontFace antes de llamar a buildDocument. El kitFonts del kit solo descarga de Fontsource, y una marca sirve sus archivos desde su propio servidor. renderToPdf pide las variantes que pintan las páginas, y brandFontProvider responde a cada petición con los bytes ya descargados; a un peso o una cursiva que la marca no tenga le daría el archivo más cercano de la misma familia (¿Por qué un proveedor de fuentes?). El PDF incrusta los seis archivos que midió el canvas, una vez cada uno.
#2 · El sistema de color es una sola lista
const COLOURS = [ // id, name, screen, print (coated stock)
['line-1', 'Line 1 · Tile red', '#e4572e', '0 75 85 0'],
['line-2', 'Line 2 · Harbour teal', '#17bebb', '75 0 32 0'],
['line-3', 'Line 3 · Broom yellow', '#ffc914', '0 22 95 0'],
['line-4', 'Line 4 · Heather', '#6c4f9e', '65 75 0 0'],
['line-5', 'Line 5 · Pine', '#3f9b4a', '76 12 90 2'],
['signal-red', 'Signal red', '#c0391b', '10 88 100 2'],
['signal-green', 'Signal green', '#2b7d3c', '84 25 95 10'],
['ink', 'Ink', '#1f2124', '72 62 55 78'],
['rule', 'Rule grey', '#d9d9d4', '14 10 14 0'],
];
const palette = { ...Object.fromEntries(COLOURS.map(([id, , hex]) => [id, hex])),
paper: '#ffffff', section: '#e4572e' }; // section: the line colour of the current section
// col(): a colour linked to its palette entry, with the entry's hex beside the link.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [...Object.entries(palette), ['main-color', palette.ink]]
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const rgb = (hex) => [1, 3, 5].map((i) => parseInt(hex.slice(i, i + 2), 16)).join(' ');
const swatchTable = () => COLOURS.reduce( // an empty first cell, filled with the colour itself
(model, [id], i) => setCellBackground(model, { row: i + 1, col: 0 }, col(id)),
{ headerRowCount: 1, columnWidths: [22, 34, 14, 15, 15], rows: [
['COLOUR', 'NAME', 'HEX', 'RGB', 'CMYK'].map((content) => ({ content, isHeader: true })),
...COLOURS.map(([, name, hex, cmyk]) =>
['', name, hex.toUpperCase(), rgb(hex), cmyk].map((content) => ({ content }))),
] });
Como la paleta y la tabla 1.1 se construyen con las mismas nueve filas, la tabla no puede dar un valor que las páginas no usen. setCellBackground rellena la primera celda de cada fila, que va vacía, con el color de esa fila enlazado a la paleta. En el texto, :swatch{color="line-2"} recibe el identificador de una entrada de la paleta y dibuja un cuadrado perfilado con el color del texto. main-color toma el hex de Ink, de modo que los títulos, las negritas y las cursivas, enlazados a él por defecto, salen en Ink y no en el azul del motor. bodyText.referenceColor: col('ink') usa Ink también para las remisiones (Paleta de colores).
#3 · Una apertura, tres colores de línea
// The body starts ten grid lines down, in both columns.
const opener = { enabled: true, minHeight: pt(10 * LEAD), slot: { elements: [
{ kind: 'text', id: 'number', content: '{number}', fontFamily: DISPLAY, fontWeight: 800,
fontSize: pt(130), lineHeight: 1, color: col('section'), align: 'left', overflow: 'wrap',
// Nudged by eye on the capture: the cap tops of number and title on one line.
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { x: mm(-1.5), y: mm(1.3) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontWeight: 800,
fontSize: pt(34), lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { x: mm(COL + GUTTER), y: mm(1) }, size: { width: mm(COL) } } },
{ kind: 'text', id: 'lead', content: '{attr.lead}', fontFamily: TEXT, fontSize: pt(12.5),
lineHeight: 1.36, color: col('ink'), align: 'left', overflow: 'wrap',
placement: { anchor: { to: '#title', edge: 'below' }, offset: { y: mm(3) },
size: { width: mm(COL) } } },
] } };
// Each section sets `section` to its line's colour; the number and the head square use it.
const section = (id) => ({ id, palette: { section: palette[id] } });
numberingTemplate: '{1:01}' escribe el contador con dos cifras, y {number} imprime 01, 02 y 03 en la apertura; el título de la cubierta lleva numbered: false y se queda sin número. Los tres estilos de sección solo se diferencian en la entrada section de la paleta, a la que cada uno da el color de su línea. El número y el cuadrado de la franja están enlazados a section, de modo que un único diseño de apertura sirve para las tres secciones. minHeight reserva para la apertura diez líneas de la rejilla base de 14 pt, y el texto de cada sección empieza en la misma línea de su página.
#4 · Do y Don't son tipos de figura
const example = (id, name, colour) => ({ id, name, shortLabel: name, captionPrefix: name,
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
captionStyle: { labelColor: col(colour) } });
const resourceTypes = [...defaultResourceTypes(LANG),
example('do', 'Do', 'signal-green'), example('dont', 'Don’t', 'signal-red')];
const FOOT = { position: 'bottom' }; // cited in one paragraph: its page's foot, one per column
Un tipo de recurso admite un captionStyle parcial, y estos dos solo cambian el color de la etiqueta: Signal green en Do y Signal red en Don't (Tipos de recurso). Los dos colores de señal llegan a 5,1:1 y 5,5:1 sobre blanco, mientras que las líneas 1, 2, 3 y 5 se quedan por debajo del 4,5:1 que pide el texto pequeño. Los dos dibujos flotan con position: 'bottom' y se citan en el mismo párrafo, el primero de Drawing the map, así que comparten el pie de la página 4, Do en la columna izquierda y Don't en la derecha.
#5 · El paquete lleva las fuentes que puede compartir
const pack = Object.assign(document.createElement('button'), { type: 'button',
textContent: 'Build the .postext' });
pack.addEventListener('click', async () => {
const { bytes, manifest, warnings } = await createBundle({
name: 'Metro de Alba identity manual', locale: LANG, markdown, config: config(), resources,
files: new Map([...Object.entries(ART), ...fontFiles]), // fileId → SVG markup or font bytes
});
const size = `${Math.round(bytes.length / 1024)} KB`;
const packed = `fonts inside: ${manifest.fonts.map((font) => font.name).join(', ')}`;
kitStatus(['.postext', size, packed, ...warnings].join(' · ')); // warnings: what stayed out
pack.replaceWith(Object.assign(document.createElement('a'), { download: `${RECIPE}.postext`,
href: URL.createObjectURL(new Blob([bytes], { type: 'application/zip' })),
textContent: `Download ${RECIPE}.postext · ${size}` }));
});
document.getElementById('pt-actions').append(pack);
createBundle lee config.customFonts, busca en files los bytes de cada variante por su fileId y los guarda en fonts/, con una entrada fonts en el manifiesto. La familia de rótulos lleva redistributable: false, que aquí simula una licencia que no deja repartir los archivos (la de Big Shoulders Display, la OFL, sí lo permite). Su archivo se queda fuera y warnings indica la familia. El archivo de 81 KB contiene el capítulo, la configuración, los tres dibujos y cinco archivos de fuente. La composición nunca lee customFonts, y sin él las páginas salen iguales (Crear un paquete).
La receta completa
// ═══ Postext Cookbook · Nº 040 · Brand fonts in layout, PDF and bundle ════════════
// https://postext.dev/en/cookbook/brand-fonts-identity-manual
// Code: MIT · Text and drawings: original (CC BY 4.0) · Metro de Alba is a fictional network
// Fonts: Public Sans, Big Shoulders Display, Spline Sans Mono (OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocument, renderPageToCanvas, registerResourceImage, defaultResourceTypes, setCellBackground,
createBundle,
} 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 = 'brand-fonts-identity-manual';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region answer: the brand's font files, fetched once for the layout, the PDF and the bundle
// Your licensed files, one per face in FONTS. Fontsource's copies stand in for them here:
// point FONT_URL at your own server (same origin, or one that lets this page in by CORS).
const slug = (family) => family.toLowerCase().replaceAll(' ', '-');
const FONT_URL = ({ family, weight, style }) => `https://cdn.jsdelivr.net/npm/@fontsource/`
+ `${slug(family)}@5/files/${slug(family)}-latin-${weight}-${style}.woff2`;
const brandFaces = () => Object.entries(FONTS).flatMap(([family, specs]) => specs.map((spec) => {
const weight = parseInt(spec, 10), style = spec.endsWith('i') ? 'italic' : 'normal';
return { family, weight, style, fileId: `${slug(family)}-${weight}-${style}.woff2` };
}));
const fontFiles = new Map(); // fileId → the WOFF2 bytes, fetched once
// 1 · Layout measures with document.fonts: register every face before the first build.
async function loadBrandFonts() {
await Promise.all(brandFaces().map(async ({ family, weight, style, fileId }) => {
const res = await fetch(FONT_URL({ family, weight, style }));
if (!res.ok) throw new Error(`No file for ${family} ${weight} ${style}`);
fontFiles.set(fileId, new Uint8Array(await res.arrayBuffer()));
const face = new FontFace(family, fontFiles.get(fileId), { weight: `${weight}`, style });
document.fonts.add(await face.load());
}));
}
// 2 · The PDF embeds the same bytes as TrueType. renderToPdf asks for the faces the pages
// paint; a weight or slant the brand lacks gets the family's closest file, embedded once.
async function brandFontProvider(family, weight, style) {
const cost = (f) => (f.style === style ? 0 : 1000) + Math.abs(f.weight - weight);
const own = brandFaces().filter((f) => f.family === family);
if (!own.length) throw new Error(`${family} is not one of the brand's fonts`);
return decompressWoff2(fontFiles.get(own.reduce((a, b) => (cost(b) < cost(a) ? b : a)).fileId));
}
// 3 · The bundle: customFonts names each face's file by its fileId; createBundle packs the bytes
// of every family it may hand on. Layout never reads it (gotcha: custom-fonts-declarative).
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
#Incluye también la fuente de rótulos
Si la licencia te permite repartir los archivos, quita redistributable y el paquete llevará las tres familias en 96 KB.
- name, redistributable: name !== DISPLAY, // the display face reaches suppliers another way
+ name,#Usa una negrita de verdad
Como la marca no tiene negrita, boldFontWeight: 600 compone en seminegrita las negritas, los encabezados de tabla y las etiquetas de los pies; si tu familia la tiene, añade sus archivos a FONTS, borra el ajuste y cambia la línea de muestra del texto de ejemplo y su «There is no Bold», que dejarían de ser ciertos.
- boldFontWeight: 600, // the brand has no Bold: its SemiBold sets **emphasis**
- 'Public Sans': ['400', '400i', '600', '600i'],
+ 'Public Sans': ['400', '400i', '600', '600i', '700', '700i'],Errores frecuentes
Error frecuente
customFonts no carga ninguna fuente
config.customFonts solo nombra archivos de fuente por su fileId: buildDocument y los renderizadores de canvas, HTML y PDF no lo leen nunca, así que una familia que figura ahí y no se ha registrado se mide y se pinta con una fuente de reserva. Registra tú cada estilo (un FontFace con sus bytes) antes de la primera composición y pasa esos mismos bytes al proveedor de fuentes del PDF. createBundle lee la lista para meter los archivos en un .postext, y el Sandbox, para registrar las fuentes. Tus propias fuentes →
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 →
Pasa a createBundle los bytes de cada fuente con el fileId que les da customFonts. Una variante sin bytes se queda fuera con el aviso «missing file, skipped», y la familia que se queda sin variantes desaparece del manifiesto.
Créditos
- Receta
- Ignacio Ferro
- Texto
- El manual de identidad del Metro de Alba, una red ficticia · Ignacio Ferro · CC BY 4.0
- Imágenes
- El dibujo de la red en la cubierta y los dos ejemplos de plano, dibujados en código · Ignacio Ferro · CC BY 4.0
- Fuentes
- Public Sans (SIL OFL 1.1) · Big Shoulders Display (SIL OFL 1.1) · Spline Sans Mono (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)


