En poques paraules
Diplomes de final de curs d'un taller d'impremta, una pàgina per alumne, amb una orla decorada i un segell. N'hi ha prou d'escriure el nom de cada alumne per obtenir-ne el diploma complet.
Què compondràs
Diplomes de final de curs per a La Cuña, un taller de tipografia fictici de Saragossa: un A4 per alumne. L'edició anglesa els compon en mida carta per al Quoin Room, un taller de Providence. Una banda verd blavós plena de lents de guilloché de color crema emmarca el full, amb una roseta crema a cada cantonada; la banda i les rosetes es dibuixen en codi amb sinusoides i hipotrocoides. Sota un títol en versals espaiades, el nom de l'alumne va en Pinyon Script de 48 pt sobre un filet daurat, i el text del diploma, centrat, en Rosarivo. Entre les dues línies de signatura hi ha un segell vermell amb dues cintes i, a sota, un peu d'impremta d'una línia. Com que tota la pàgina la dibuixa un estil d'encapçalament, cada alumne és un títol de Markdown, i el PDF recull la classe completa amb un marcador per nom.
Aquesta recepta respon a
- Com afegeixo una marca d'aigua, un fons de color o una imatge decorativa a totes les pàgines?
- Com componc il·lustracions sense numerar: ornaments, vinyetes, logotips?
- Com fixo una insígnia o un adhesiu en una posició concreta de la pàgina?
- Com exporto un PDF de debò al navegador, amb les fonts incrustades?
La resposta curta
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"}
Ingredients
- Funcions
- Capçaleres per seccióImatges als dissenys de pàginaObertures dissenyadesAncoratge d'elements de dissenyTextos, filets i caixes als dissenys de pàginaEstils de títolGeometria per seccióAtributs de títolColor del paperPaleta de color semànticaFigures i taules com a recursosMetadades del documentPàgines en un canvasExportació a PDFFonts incrustades al PDFMarcadors del PDF
- Tipografia
- Rosarivo, Pinyon Script, Aboreto (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Deixa que un estil d'encapçalament dibuixi la pàgina
L'estil complet és a la resposta curta de més amunt. Un estil d'encapçalament (vegeu la documentació) governa les pàgines de la seva secció: el seu header i el seu footer substitueixen els del document, que aquí són buits, els seus margins fixen la caixa de text i el seu advancedDesign dibuixa l'obertura. L'alçada d'una obertura s'arrodoneix cap amunt a línies senceres de la retícula de base de 17 pt. En A4, y(106) dona un minHeight de 112,7 mm, que es converteix en 19 línies, de manera que el text comença a 146 mm de la vora superior (a 140 mm a l'edició en mida carta); si només comptés el bloc del títol, començaria a 134 mm. Sense marginBottom: 0, el mig quadratí que es deixa per defecte sota un títol duria aquesta mateixa alçada a 20 línies.
#2 · Penja l'orla de la pàgina, a la capçalera
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 element d'imatge dibuixa un recurs a la mida que li dona la seva col·locació (elements d'imatge): ancorat a la cantonada superior esquerra de la pàgina i amb els dos costats en 'fill', el guilloché cobreix la caixa de tall, i l'SVG, declarat amb les proporcions de la pàgina, l'omple sense deformar-se. La capçalera el pinta sobre page.backgroundColor a cada diploma sense treure lloc al text, de manera que són els marges els que mantenen el text a 32 mm del tall com a mínim, dins del filet interior, que és a 26 mm. Una marca d'aigua posada a la capçalera quedaria damunt de les paraules, perquè la capçalera es pinta després del text. En una capçalera, {attr.serial} llegeix l'atribut del títol que obre la secció de la pàgina, i així cada diploma porta el seu número.
#3 · Deixa a l'obertura només el bloc del títol
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ínia s'ancora a la vora 'top' de la pàgina, que la centra, amb una y mesurada des del tall, de manera que el bloc no es mou encara que canviïn els marges; y() estira aquestes posicions de la mida carta a l'A4. El nom és el mateix text del títol, que entra amb {titleText}, així que apareix als marcadors i a les etiquetes del PDF. Un nom llarg passa a una segona línia, perquè un disseny de títol parteix el seu text (overflow: 'wrap'). Les línies espaiades no demanen cap correcció: l'espaiat que segueix l'última lletra queda fora de la mesura, així que el que se centra són les lletres.
#4 · Penja el segell i les signatures d'una mateixa vora
// 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) },
];
Tot el que va al peu es mesura des de SIGN, la vora superior del segell, i el marge inferior de l'estil tanca la caixa de text en aquesta mateixa vora, de manera que un text massa llarg per a la pàgina passa a la següent en lloc de ficar-se sota el segell. Si fossin a l'obertura, les línies i els noms comptarien per a la seva alçada (extensió i disseny avançat), i com que arriben per sota de la caixa de text, l'obertura es quedaria la pàgina sencera i enviaria el text a la següent. LINE pren l'amplada que queda entre els marges de la pàgina, li resta el disc del segell (34 mm), la reparteix entre les dues signatures i treu 3 mm a cada meitat, de manera que cada línia s'atura a 3 mm del segell en els dos formats (53 mm de llarg en A4 i 56 mm en mida carta). Cada nom i cada càrrec és un text tan ample com la seva línia, i així queda centrat a sota.
#5 · Converteix la llista de classe en títols
// 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 es converteix en un títol # que indica l'estil i porta el número de sèrie com a atribut (atributs d'encapçalament), seguit del text de content.es.md, de manera que tres files donen tres pàgines. El breakBefore del nivell 1, amb paritat 'any', comença cada títol en una pàgina nova sense pàgines en blanc entre diplomes; l'estil l'hereta.
#6 · Genera un sol PDF per a tota la classe
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 classe és un únic document, així que renderToPdf escriu un sol fitxer de tres pàgines, amb un marcador per títol que porta el nom de l'alumne. renderToPdf també accepta una llista de documents, com els capítols d'un llibre, però amb un document per alumne caldria cridar buildDocument per a cadascun. Amb títols, tota la classe es compon d'una vegada, i el visor mostra els tres diplomes d'aquesta mateixa composició. El PDF incrusta les quatre variants que imprimeixen les pàgines, i el proveïdor de fonts del kit les porta de Fontsource (per què un proveïdor de fonts?).
La recepta completa
// ═══ 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 },
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Genera un PDF per alumne
Un botó per alumne compon el seu diploma com a document a part, amb buildDocumentWithFonts com la composició del mateix pen, i fa servir el número de sèrie com a nom del fitxer; cadascun pesa uns 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;
+}#Imprimeix l'orla i el títol en blau marí
El dibuix SVG i la configuració llegeixen el mateix objecte palette, de manera que, en canviar una sola entrada, canvien de color la banda, el traçat de les rosetes i les línies del títol.
- teal: '#1f5f5b', // the frame, the title lines
+ teal: '#2b3a67', // the frame, the title linesErrors freqüents
Error freqüent
Una obertura reserva alçada fins al seu element ancorat més baix
Una obertura de disseny avançat reserva l'alçada del seu element més baix, i també hi compten els ancorats a la pàgina o a la sang que queden per sota del títol, així que un ornament al peu de la pàgina empeny el text a la següent. Dona a aquest element reserve: false (des de postext 1.5): es pinta on està ancorat i no reserva res. Els elements que segueixen la mateixa banda (ancorats al seu peu, o d'alçada 'fill') no en fixen mai l'alçada. Obertures dissenyades →
Error freqüent
Els elements de capçalera i peu es pinten damunt del text
Els elements de capçalera i peu es pinten sobre la pàgina i l'àrea de text no els deixa lloc. Mantén-los dins dels marges, que són els que els reserven l'espai. Capçaleres i folis →
Error freqüent
Valors d'atribut: sense { ni }; cometes simples si porten "
Un valor d'atribut acaba a la clau de tancament, així que no pot contenir { ni }. Un valor que porti cometes dobles va entre cometes simples; el signe de dòlar no dona problemes. Atributs de títol →
Error freqüent
Sense <marker> ni filtres als SVG, o passen a mapa de bits
Una figura SVG només continua sent vectorial al PDF sense <marker>, filtres ni màscares; si no, passa a mapa de bits, i els filtres molt imbricats la poden deixar en blanc a Chrome. Dibuixa les puntes de fletxa com a traçats. Figures i taules com a recursos →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Rosarivo (SIL OFL 1.1) · Pinyon Script (SIL OFL 1.1) · Aboreto (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


