Pular para o conteúdo principal
Receita número 63

Receitas · Capítulo 3 · Títulos e aberturas

Certificado com moldura de guilhochê

Certificados de conclusão de curso desenhados por um estilo de título: o guilhochê no cabeçalho, o selo e as assinaturas no rodapé, o nome na abertura.

Nesta página
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.34.0 · postext-pdf ≥ 1.34.0
Licença
Atualizada em 16 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 215,9 × 279,4 mm
  • 1 coluna
  • Rosarivo 11,5/17
  • Aboreto
  • Pinyon Script
  • 3 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 33 ms
  • 173 linhas de código

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

script.js · linhas 38–57no 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

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

script.js · linhas 61–75no 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.' })),
];

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

script.js · linhas 79–97no 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 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

script.js · linhas 101–120no 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) },
];

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

script.js · linhas 163–178no 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 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

script.js · linhas 276–279no 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' });

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

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 = '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 lines

Erros 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

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