Em poucas palavras
Certificados de um curso de oficina gráfica, uma página por aluno, com uma moldura decorada e um selo. Basta escrever o nome de cada aluno para ter o certificado inteiro.
O que você vai compor
Certificados de conclusão de curso para o Quoin Room, uma oficina fictícia de impressão tipográfica em Providence: uma página Carta americana por aluno. A edição em espanhol os compõe como diplomas A4 para La Cuña, uma oficina de Zaragoza. Uma faixa verde-azulada cheia de lentes de guilhochê cor de creme emoldura a folha, com uma roseta creme em cada canto; faixa e rosetas são desenhadas em código a partir de senoides e hipotrocoides. Sob um título em maiúsculas espacejadas, o nome do aluno vai em Pinyon Script de 48 pt sobre um fio dourado, e o texto do certificado, centrado, em Rosarivo. Um selo vermelho com duas fitas fica entre as linhas de assinatura, com uma linha de imprenta embaixo. Como um único estilo de título desenha a página inteira, cada aluno é um título de Markdown, e o PDF reúne a turma com um marcador por nome.
Esta receita responde a
- Como acrescento uma marca-d'água, um fundo de cor ou uma imagem decorativa em todas as páginas?
- Como componho ilustrações sem numeração: ornamentos, vinhetas, logotipos?
- Como fixo um selo ou um adesivo em uma posição exata da página?
- Como faço para exportar um PDF de verdade no navegador, com as fontes incorporadas?
A 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"}
Ingredientes
- Funcionalidades
- Cabeços por seçãoImagens nos designs de páginaAberturas desenhadasAncoragem de elementos de designTextos, fios e caixas nos designs de páginaEstilos de títuloGeometria por seçãoAtributos de títuloCor do papelPaleta de cores semânticaFiguras e tabelas como recursosMetadados do documentoPáginas em um canvasExportação para PDFFontes incorporadas ao PDFMarcadores do PDF
- Tipografia
- Rosarivo, Pinyon Script, Aboreto (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Deixar um estilo de título desenhar a página
O estilo completo é a resposta curta lá em cima. Um estilo de título governa as páginas da seção (estilos de título): o header e o footer substituem os do documento, que aqui estão vazios, as margins definem a mancha gráfica e o advancedDesign desenha a abertura. A altura de uma abertura é arredondada para cima em linhas inteiras da grade de 17 pt do texto corrido. Um minHeight de 106 mm vira 18 linhas, de modo que o texto começa a 140 mm da borda superior; em A4, y() o transforma em 112,7 mm, ou 19 linhas, e o texto começa a 146 mm. Só o bloco do título faria o texto começar a 128 mm (134 mm em A4). Sem marginBottom: 0, o 0,5 em que fica por padrão sob um título levaria os mesmos 106 mm a 19 linhas.
#2 · Pendurar a moldura na página, pelo cabeçalho
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.' })),
];
Um elemento de imagem desenha um recurso no tamanho da colocação (elementos de imagem): ancorado no canto superior esquerdo da página e com os dois lados em 'fill', o guilhochê cobre a área de refile, e o SVG, declarado com as proporções da página, a preenche sem deformar. O cabeçalho o pinta sobre page.backgroundColor e não reserva espaço, por isso são só as margens que mantêm o texto a pelo menos 32 mm do refile, dentro do fio interno, que está a 26 mm. Uma marca d’água posta no cabeçalho ficaria por cima das palavras, porque o cabeçalho é pintado depois do texto. Num cabeçalho, {attr.serial} lê o atributo do título a cuja seção a página pertence, e assim cada certificado imprime o próprio número.
#3 · Deixar na abertura só o bloco do título
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 linha é ancorada na borda 'top' da página, o que a centra, com um y medido a partir do refile, de modo que o bloco não sai do lugar, sejam quais forem as margens; y() estica essas posições do formato Carta para o A4. O nome é o próprio texto do título, lido com {titleText}, e por isso aparece nos marcadores e nas tags do PDF. Um nome longo passa para uma segunda linha, porque um design de título quebra o texto (overflow: 'wrap'). As linhas espacejadas não pedem correção: o tracking depois da última letra fica fora da medida, por isso o que se centra são as letras.
#4 · Pendurar o selo e as assinaturas da mesma borda
// 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) },
];
Tudo o que vai no rodapé se mede a partir de SIGN, a borda superior do selo, e a margem inferior do estilo fecha a mancha gráfica nessa mesma borda, de modo que um texto comprido demais para a página passa para a seguinte em vez de correr por baixo do selo. Se fossem para a abertura, as linhas e os nomes contariam na altura dela (span e design avançado); como descem abaixo da mancha gráfica, a abertura ficaria com a página inteira e mandaria o texto para a seguinte. LINE pega a largura entre as margens da página, subtrai o disco de 34 mm do selo, divide o resto ao meio e tira 3 mm, de modo que cada linha para a 3 mm do selo nos dois formatos (56 mm de comprimento no Carta, 53 mm no A4). Cada nome e cada função é um elemento de texto da largura da linha, e assim fica centrado sob ela.
#5 · Transformar a lista da turma em títulos
// 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 linha da lista vira um título # que indica o estilo e leva o número de série como atributo (atributos de título), seguido do texto de content.en.md, por isso três linhas dão três páginas. O breakBefore do nível 1, com paridade 'any', começa cada título numa página nova, sem página em branco entre os certificados; o estilo o herda.
#6 · Gerar um único PDF para a turma toda
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' });
A turma é um único documento, por isso renderToPdf grava um só arquivo de três páginas com um marcador por título, cada um com o nome de um aluno. renderToPdf também aceita uma lista de documentos, como os capítulos de um livro, mas um documento por aluno exigiria uma chamada a buildDocument para cada um. Com títulos, a turma inteira é composta de uma vez, e o visualizador mostra os três certificados dessa mesma composição. O PDF incorpora as quatro variantes que as páginas imprimem, e o provedor de fontes do kit as busca na Fontsource (por que um provedor de fontes?).
A receita 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 = 'en'; // @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 },
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Gerar um PDF por aluno
Um botão por aluno compõe aquele certificado como documento à parte, com buildDocumentWithFonts como a composição do próprio pen, e dá ao arquivo o nome do número de série; cada arquivo pesa cerca de 245 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;
+}#Imprimir a moldura e o título em azul-marinho
O desenho SVG e a configuração leem o mesmo objeto palette, de modo que trocar uma única entrada muda a cor da faixa, do desenho das rosetas e das linhas do título.
- teal: '#1f5f5b', // the frame, the title lines
+ teal: '#2b3a67', // the frame, the title linesErros comuns
Erro comum
Uma abertura reserva altura até o seu elemento ancorado mais baixo
Uma abertura com design avançado reserva a altura do seu elemento mais baixo, e os elementos ancorados à página ou à sangria abaixo do título também contam, então um ornamento no pé da página empurra o texto para a página seguinte. Dê a esse elemento reserve: false (desde o postext 1.5): ele é pintado onde está ancorado e não reserva nada. Os elementos que acompanham a própria faixa (ancorados ao pé dela, ou com altura 'fill') nunca definem a altura dela. Aberturas desenhadas →
Erro comum
Os elementos de cabeçalho e rodapé são pintados sobre o texto
Os elementos de cabeçalho e rodapé são pintados por cima da página, e a área de texto não abre espaço para eles. Mantenha esses elementos dentro das margens, que são o que reserva o espaço deles. Cabeços e fólios →
Erro comum
Valores de atributo: sem { ou }; aspas simples se tiver "
Um valor de atributo termina na chave de fechamento, por isso não pode conter { nem }. Um valor que contém aspas duplas vai entre aspas simples; o cifrão não causa problema. Atributos de título →
Erro comum
Sem <marker> nem filtros na arte SVG (vira bitmap)
Uma figura SVG só continua vetorial no PDF sem <marker>, filtros e máscaras; caso contrário, é rasterizada, e filtros muito aninhados podem deixá-la em branco no Chrome. Desenhe as pontas de seta como caminhos (paths). Figuras e tabelas como recursos →
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Rosarivo (SIL OFL 1.1) · Pinyon Script (SIL OFL 1.1) · Aboreto (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


