Saltar al contingut principal
Recepta número 63

Receptari · Capítol 3 · Títols i obertures

Diploma amb orla de guilloché

Diplomes de final de curs dibuixats per un estil d'encapçalament: l'orla de guilloché a la capçalera, el segell i les signatures al peu i el nom a l'obertura.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.34.0 · postext-pdf ≥ 1.34.0
Llicència
Actualitzada el 16 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 297 mm
  • 1 columna
  • Rosarivo 11,5/17
  • Aboreto
  • Pinyon Script
  • 3 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 33 ms
  • 173 línies de codi

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

script.js · línies 38–57al codi complet
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

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

script.js · línies 61–75al codi complet
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

script.js · línies 79–97al codi complet
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

script.js · línies 101–120al codi complet
// 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

script.js · línies 163–178al codi complet
// 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

script.js · línies 276–279al codi complet
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

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 },

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 lines

Errors 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

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