Saltar al contenido principal
Receta número 63

Recetario · Capítulo 3 · Títulos y aperturas

Diploma con orla de guilloché

Diplomas de fin de curso dibujados por un estilo de encabezado: la orla de guilloché en su cabecera, el sello y las firmas en su pie y el nombre en su apertura.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.34.0 · postext-pdf ≥ 1.34.0
Licencia
Actualizada el 16 oct 2026
Código MIT · Texto CC BY 4.0
  • Formato 210 × 297 mm
  • 1 columna
  • Rosarivo 11,5/17
  • Aboreto
  • Pinyon Script
  • 3 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 33 ms
  • 173 líneas de código

En pocas palabras

Diplomas de fin de curso de un taller de imprenta, una página por alumno, con una orla decorada y un sello. Basta escribir el nombre de cada alumno para obtener su diploma completo.

Lo que vas a componer

Diplomas de fin de curso para La Cuña, un taller de tipografía ficticio de Zaragoza: un A4 por alumno. La edición inglesa los compone en tamaño carta para el Quoin Room, un taller de Providence. Una banda verde azulado llena de lentes de guilloché color crema enmarca la hoja, con una roseta crema en cada esquina; banda y rosetas se dibujan en código con senoides e hipotrocoides. Bajo un título en versales espaciadas, el nombre del alumno va en Pinyon Script de 48 pt sobre un filete dorado, y el texto del diploma, centrado, en Rosarivo. Entre las dos líneas de firma hay un sello rojo con dos cintas, y debajo, un pie de imprenta de una línea. Como la página entera la dibuja un estilo de encabezado, cada alumno es un encabezado de Markdown, y el PDF recoge la clase completa con un marcador por nombre.

Esta receta responde a

  • ¿Cómo añado una marca de agua, un fondo de color o una imagen decorativa en todas las páginas?
  • ¿Cómo compongo ilustraciones sin numerar: adornos, viñetas, logotipos?
  • ¿Cómo fijo una insignia o una pegatina en una posición concreta de la página?
  • ¿Cómo exporto un PDF de verdad en el navegador, con las fuentes incrustadas?

La respuesta corta

script.js · líneas 38–57en el código completo
const certificate = () => ({ // a function: it uses the elements defined below
  id: 'certificate',
  // Section geometry, for this style's pages only: a narrower measure, and a text area that
  // ends at the seal, so a citation too long for the page moves on instead of running under it.
  margins: { left: mm(SIDE), right: mm(SIDE), bottom: mm(H - SIGN) },
  // Header and footer elements paint over the page and reserve nothing (gotcha:
  // header-paints-over-text), so the frame, the seal and the signatures go there. In the
  // opener the signature lines would count towards its height (gotcha:
  // opener-reserves-anchored), and a design that reaches below the text area takes the page.
  header: { elements: [frame, serial] },
  footer: { elements: signatures },
  // The citation starts 18 lines of the 17 pt grid under the top margin, 140 mm down (19
  // lines, 146 mm, on A4): an opener's height rounds up to whole lines, and without
  // marginBottom: 0 the level's 0.5 em under a heading would add a line. minHeight is a
  // floor: the title block alone would start the citation at 128 mm (134 mm on A4).
  advancedDesign: { enabled: true, minHeight: mm(y(106)), slot: { elements: title } },
  marginBottom: mm(0),
});
// Hook-up: headingStyles: [certificate()], and in the Markdown one heading per student:
// # Imogen Achterberg {style="certificate" serial="26-031"}

Ingredientes

Tipografía
Rosarivo, Pinyon Script, Aboreto (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Deja que un estilo de título dibuje la página

El estilo completo está en la respuesta corta de arriba. Un estilo de encabezado (véase la documentación) gobierna las páginas de su sección: su header y su footer sustituyen a los del documento, que aquí están vacíos, sus margins fijan la caja de texto y su advancedDesign dibuja la apertura. La altura de una apertura se redondea hacia arriba a líneas enteras de la rejilla base de 17 pt. En A4, y(106) da un minHeight de 112,7 mm, que se convierte en 19 líneas, así que el texto empieza a 146 mm del borde superior (a 140 mm en la edición en tamaño carta); si solo contara el bloque del título, empezaría a 134 mm. Sin marginBottom: 0, el medio cuadratín que se deja por defecto bajo un título llevaría esa misma altura a 20 líneas.

#2 · Cuelga la orla de la página, en la cabecera

script.js · líneas 61–75en el código completo
const frame = { kind: 'image', id: 'frame', resourceId: 'guilloche',
  placement: { anchor: { to: 'page', edge: 'top-left' }, // the trim box
    size: { width: 'fill', height: 'fill' } } }; // the SVG has the page's proportions
const serial = { kind: 'text', id: 'serial', ...caps, fontSize: pt(8.5), letterSpacing: pt(1.6),
  content: t({ en: 'No. {attr.serial}', es: 'N.º {attr.serial}' }), // from the heading line
  color: col('seal'), align: 'right', placement: at('top-right', -MARGIN, 29) };
const PX = 10; // declared pixels per mm: an SVG resource only needs the right proportions
const svg = (id, w, h, altText) => ({ id, typeId: 'figure', kind: 'svg', createdAt: 0,
  updatedAt: 0, altText, svg: { fileId: `${id}.svg`, width: w * PX, height: h * PX } });
const resources = [
  svg('guilloche', W, H, t({ en: 'A teal guilloche border with cream rosettes at the corners.',
    es: 'Una orla de guilloché verde azulado con rosetas color crema en las esquinas.' })),
  svg('seal', SEAL.w, SEAL.h, t({ en: 'A red seal with a serrated edge and two ribbon tails.',
    es: 'Un sello rojo de borde dentado con dos cintas.' })),
];

Un elemento de imagen dibuja un recurso al tamaño que le da su colocación (elementos de imagen): anclado a la esquina superior izquierda de la página y con los dos lados en 'fill', el guilloché cubre la caja de corte, y el SVG, declarado con las proporciones de la página, la llena sin deformarse. La cabecera lo pinta sobre page.backgroundColor en cada diploma sin quitarle sitio al texto, así que son los márgenes los que mantienen el texto a 32 mm del corte como mínimo, dentro del filete interior, que está a 26 mm. Una marca de agua puesta en la cabecera quedaría encima de las palabras, porque la cabecera se pinta después del texto. En una cabecera, {attr.serial} lee el atributo del encabezado a cuya sección pertenece la página, y así cada diploma lleva su número.

#3 · Deja en la apertura solo el bloque del título

script.js · líneas 79–97en el código completo
const centred = (top) => at('top', 0, y(top)); // tracked or not, the letters are centred
const title = [
  { kind: 'text', id: 'kicker', ...caps, fontSize: pt(9.5), letterSpacing: pt(2.4),
    content: '{attr.workshop}', placement: centred(39) }, // the wording: see merge
  { kind: 'text', id: 'title', content: t({ en: 'Certificate', es: 'Diploma' }), ...caps,
    fontSize: pt(46), lineHeight: 1, letterSpacing: pt(3), placement: centred(48) },
  { kind: 'text', id: 'of', content: t({ en: 'of completion', es: 'de aprovechamiento' }),
    ...caps, fontSize: pt(11), letterSpacing: pt(4), placement: centred(68) },
  { kind: 'text', id: 'lead', content: '{attr.lead}',
    fontFamily: 'Rosarivo', italic: true, fontSize: pt(13), color: col('muted'),
    placement: centred(90) },
  { kind: 'text', id: 'name', content: '{titleText}', fontFamily: 'Pinyon Script',
    fontSize: pt(48), lineHeight: 1.25, // 60 pt from line to line of a long name
    color: col('ink'), align: 'center', overflow: 'wrap', // a long name takes a second line
    placement: { ...centred(97), size: { width: mm(W - 2 * MARGIN) } } },
  { kind: 'rule', id: 'underline', direction: 'horizontal', thickness: pt(0.75),
    color: col('gold'), placement: { anchor: { to: '#name', edge: 'below' },
      offset: { x: mm(18), y: mm(5) }, size: { width: mm(W - 2 * MARGIN - 36) } } },
];

Cada línea se ancla al borde 'top' de la página, que la centra, con una y medida desde el corte, de modo que el bloque no se mueve aunque cambien los márgenes; y() estira esas posiciones del tamaño carta al A4. El nombre es el propio texto del título, que entra con {titleText}, así que aparece en los marcadores y en las etiquetas del PDF. Un nombre largo pasa a una segunda línea, porque un diseño de encabezado parte su texto (overflow: 'wrap'). Las líneas espaciadas no piden corrección: el espaciado que sigue a la última letra queda fuera de la medida, así que lo que se centra son las letras.

#4 · Cuelga el sello y las firmas de un mismo borde

script.js · líneas 101–120en el código completo
// mm: each signature line stops 3 mm short of the seal (56 on Letter, 53 on A4)
const LINE = (W - 2 * MARGIN - 2 * SEAL.r) / 2 - 3;
const under = (id, gap, x = 0) => ({ anchor: { to: `#${id}`, edge: 'below' },
  offset: { x: mm(x), y: mm(gap) }, size: { width: mm(LINE) } });
const signatures = [
  { kind: 'image', id: 'seal', resourceId: 'seal',
    placement: { ...at('top', 0, SIGN), size: { width: mm(SEAL.w) } } },
  ...[1, 2].flatMap((n, i) => [ // signer1 and role1, signer2 and role2: the wording again
    { kind: 'rule', id: `line${i}`, direction: 'horizontal', thickness: pt(0.6), color: col('rule'),
      placement: { ...at('top-left', i ? W - MARGIN - LINE : MARGIN, SIGN + 23),
        size: { width: mm(LINE) } } },
    { kind: 'text', id: `who${i}`, content: `{attr.signer${n}}`, fontFamily: 'Rosarivo',
      fontSize: pt(10.5), color: col('ink'), align: 'center', placement: under(`line${i}`, 1.6) },
    { kind: 'text', id: `role${i}`, content: `{attr.role${n}}`, ...caps, fontSize: pt(7.5),
      letterSpacing: pt(1.4), color: col('muted'), align: 'center',
      placement: under(`who${i}`, 0.6) },
  ]),
  { kind: 'text', id: 'imprint', fontFamily: 'Rosarivo', italic: true, fontSize: pt(7),
    content: '{attr.imprint}', color: col('muted'), placement: at('top', 0, SIGN + 50) },
];

Todo lo que va en el pie se mide desde SIGN, el borde superior del sello, y el margen inferior del estilo cierra la caja de texto en ese mismo borde, así que un texto demasiado largo para la página pasa a la siguiente en vez de meterse bajo el sello. Si estuvieran en la apertura, las líneas y los nombres contarían para su altura (apertura a toda página y diseño avanzado), y como llegan por debajo de la caja de texto, la apertura se quedaría con la página entera y mandaría el texto a la siguiente. LINE toma el ancho que queda entre los márgenes de la página, le resta el disco del sello (34 mm), lo reparte entre las dos firmas y quita 3 mm a cada mitad, así que cada línea se detiene a 3 mm del sello en los dos formatos (53 mm de largo en A4 y 56 mm en tamaño carta). Cada nombre y cada cargo es un texto tan ancho como su línea, y así queda centrado bajo ella.

#5 · Convierte la lista de clase en títulos

script.js · líneas 163–178en el código completo
// Name and serial: {titleText} and {attr.serial} in the designs (gotcha: attr-values). The
// lines every certificate shares are the front matter of content.<lang>.md, written onto each
// heading as attributes too: {attr.workshop}, {attr.lead}, the signers and the imprint.
const { metadata: wording, content: citation } = extractFrontmatter(markdown);
const shared = Object.entries(wording).map(([key, value]) => `${key}="${value}"`).join(' ');
const heading = (name, serial) => `# ${name} {style="certificate" serial="${serial}" ${shared}}`;
const CLASS = t({
  en: [['Imogen Achterberg', '26-031'], ['Tomás Okafor', '26-032'], ['Ruth Adair', '26-033']],
  es: [['Lucía Beltrán Ochoa', '26-017'], ['Íñigo Sarasola', '26-018'], ['Ana Rius', '26-019']],
});
const merged = CLASS.map(([name, serial]) => `${heading(name, serial)}\n\n${citation}`)
  .join('\n\n');
const metadata = { // the PDF's title and author
  title: t({ en: 'Certificates of completion, fall 2026',
    es: 'Diplomas del curso de otoño de 2026' }),
  author: t({ en: 'The Quoin Room', es: 'La Cuña' }) };

Cada fila se convierte en un encabezado # que indica el estilo y lleva el número de serie como atributo (atributos de encabezado), seguido del texto de content.es.md, así que tres filas dan tres páginas. El breakBefore del nivel 1, con paridad 'any', empieza cada título en una página nueva sin páginas en blanco entre diplomas; el estilo lo hereda.

#6 · Genera un solo PDF para toda la clase

script.js · líneas 276–279en el código completo
offerPdf(() => renderToPdf(doc, { fontProvider: fontsourceProvider, resourceBytes: imageBytes }),
  `${RECIPE}.pdf`); // bookmarks: one per heading, so one per student
document.querySelector('[data-postext-pdf]').textContent = t({ en: 'Class list → one PDF',
  es: 'Toda la clase en un PDF' });

La clase es un único documento, así que renderToPdf escribe un solo archivo de tres páginas, con un marcador por título que lleva el nombre del alumno. renderToPdf también acepta una lista de documentos, como los capítulos de un libro, pero con un documento por alumno habría que llamar a buildDocument para cada uno. Con títulos, la clase entera se compone de una vez, y el visor muestra los tres diplomas de esa misma composición. El PDF incrusta las cuatro variantes que imprimen las páginas, y el proveedor de fuentes del kit las trae de Fontsource (¿por qué un proveedor de fuentes?).

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 063 · Certificate with a guilloche border ═══════════════
// https://postext.dev/en/cookbook/certificate-single-page
// Code: MIT · Text: original (CC BY 4.0) · Guilloche and seal: generated in code (CC BY 4.0)
// Fonts: Rosarivo, Pinyon Script, Aboreto (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// End-of-course certificates, one page per student, drawn by one heading style, in one PDF.
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, extractFrontmatter,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'certificate-single-page';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
  ink: '#1f2a2e', // text and the student's name
  teal: '#1f5f5b', // the frame, the title lines
  gold: '#b08d57', // hairlines and the rule under the name; never text (2.9:1 on paper)
  seal: '#8d2c2c', // the seal and the serial number
  rule: '#8f8878', // signature lines
  muted: '#6d6a60', // the lead-in, the signatories' roles, the imprint
  paper: '#fbf8ef', // the sheet
};
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' } }));
const [W, H] = t({ en: [215.9, 279.4], es: [210, 297] }); // US Letter; A4 for the Spanish diploma
const MARGIN = 32; // mm on every side, inside the frame's inner rule (26 mm in)
const SIDE = 50; // mm: the certificate's side margins, a 116 mm measure (110 on A4)
// Positions are drawn on US Letter and stretched to A4: y(90) is 90 mm down on Letter.
const y = (mm) => (mm * H) / 279.4;
const SIGN = y(194); // mm from the top: the seal's top edge, where the text area ends
const SEAL = { w: 40, h: 45, r: 17 }; // mm: the seal with its ribbon tails, and its disc's radius
const at = (edge, x, top) => ({ anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(top) } });
const caps = { fontFamily: 'Aboreto', textTransform: 'uppercase', color: col('teal') };

// #region answer: one heading style draws the whole certificate
const certificate = () => ({ // a function: it uses the elements defined below
  id: 'certificate',
  // Section geometry, for this style's pages only: a narrower measure, and a text area that
  // ends at the seal, so a citation too long for the page moves on instead of running under it.
  margins: { left: mm(SIDE), right: mm(SIDE), bottom: mm(H - SIGN) },
  // Header and footer elements paint over the page and reserve nothing (gotcha:
  // header-paints-over-text), so the frame, the seal and the signatures go there. In the
  // opener the signature lines would count towards its height (gotcha:
  // opener-reserves-anchored), and a design that reaches below the text area takes the page.
  header: { elements: [frame, serial] },
  footer: { elements: signatures },

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

#Genera un PDF por alumno

Un botón por alumno compone su diploma como documento aparte, con buildDocumentWithFonts como la composición del propio pen, y usa el número de serie como nombre del archivo; cada uno pesa unos 236 KB.

-offerPdf(() => renderToPdf(doc, { fontProvider: fontsourceProvider, resourceBytes: imageBytes }),
-  `${RECIPE}.pdf`); // bookmarks: one per heading, so one per student
-document.querySelector('[data-postext-pdf]').textContent = t({ en: 'Class list → one PDF',
-  es: 'Toda la clase en un PDF' });
+for (const [name, serial] of CLASS) {
+  const one = `${heading(name, serial)}\n\n${citation}`;
+  offerPdf(async () => renderToPdf(await buildDocumentWithFonts({ markdown: one, metadata,
+    resources }, config(), kitFonts(FONTS)), { fontProvider: fontsourceProvider,
+    resourceBytes: imageBytes }), `${serial}.pdf`);
+  document.querySelector(`[data-postext-pdf="${serial}.pdf"]`).textContent = name;
+}

#Imprime la orla y el título en azul marino

El dibujo SVG y la configuración leen el mismo objeto palette, así que al cambiar una sola entrada cambian de color la banda, el trazado de las rosetas y las líneas del título.

-  teal: '#1f5f5b', // the frame, the title lines
+  teal: '#2b3a67', // the frame, the title lines

Errores frecuentes

Error frecuente

Una apertura reserva altura hasta su elemento anclado más bajo

Una apertura de diseño avanzado reserva la altura de su elemento más bajo, y cuentan también los anclados a la página o a la sangre que quedan por debajo del título, así que un adorno al pie de la página empuja el texto a la siguiente. Dale a ese elemento reserve: false (desde postext 1.5): se pinta donde está anclado y no reserva nada. Los elementos que siguen a la propia banda (anclados a su pie, o de altura 'fill') nunca fijan su altura. Aperturas diseñadas →

Error frecuente

Los elementos de cabecera y pie se pintan encima del texto

Los elementos de cabecera y pie se pintan sobre la página y el área de texto no les deja sitio. Mantenlos dentro de los márgenes, que son los que les reservan el espacio. Cabeceras y folios →

Error frecuente

Valores de atributo: sin { ni }; comillas simples si llevan "

Un valor de atributo termina en la llave de cierre, así que no puede contener { ni }. Un valor que lleve comillas dobles va entre comillas simples; el signo de dólar no da problemas. Atributos de título →

Error frecuente

Sin <marker> ni filtros en los SVG, o pasan a mapa de bits

Una figura SVG solo sigue siendo vectorial en el PDF sin <marker>, filtros ni máscaras; si no, pasa a mapa de bits, y los filtros muy anidados pueden dejarla en blanco en Chrome. Dibuja las puntas de flecha como trazados. Figuras y tablas como recursos →

Créditos

Texto
Texto original, CC BY 4.0
Fuentes
Rosarivo (SIL OFL 1.1) · Pinyon Script (SIL OFL 1.1) · Aboreto (SIL OFL 1.1)
SandboxPDF