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

Receitas · Capítulo 5 · Estrutura do livro

Um artigo médico no estilo Vancouver

Relato de ensaio clínico em A4 e duas colunas: números de citação sobrescritos, referências numeradas no estilo Vancouver e DOIs que abrem como links no PDF.

Nesta página
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.65.0 · postext-pdf ≥ 1.65.0
Licença
Atualizada em 31 de out. de 2026
Código MIT · Texto CC BY 4.0

p. 181 · 1 de 3

  • Amostra em inglês: ainda sem edição em português
  • Refile 210 × 297 mm
  • 2 colunas, medianiz de 6 mm
  • PT Serif 9,3/12,8
  • Fira Sans
  • Fira Sans Condensed
  • Fira Sans@tnum
  • 3 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 298 ms
  • 180 linhas de código

Em poucas palavras

Um artigo curto de pesquisa médica, diagramado como a página de uma revista. Os autores citam com códigos; o Postext imprime números pequenos e elevados no texto e monta no fim a lista numerada de referências, com cada DOI como link.

O que você vai compor

Três páginas de uma revista clínica: um artigo original que relata um ensaio piloto, composto em A4 e duas colunas como o imprimem as revistas que seguem o ICMJE. Uma faixa verde-azulada atravessa o alto da primeira página, sobre o tipo de artigo, um título de três linhas, os autores com números de afiliação elevados e um resumo estruturado sobre um fundo claro. Os autores citam com chaves de BibTeX, e as páginas mostram o que um editor da área médica espera: números pequenos e elevados depois do ponto, obras consecutivas agrupadas como 6–8, duas não consecutivas juntas e sem espaço, 6,9, e uma lista de referências numerada na forma da NLM, Lancet 2016;387(10022):957–67, que fecha com o DOI de cada obra. No PDF, cada número leva à referência e cada DOI abre o artigo. O ensaio é inventado; as onze obras que ele cita são reais.

Esta receita responde a

  • Como coloco os números de citação em sobrescrito e transformo os DOIs em links, como fazem as revistas médicas?
  • Como cito obras e monto a bibliografia em APA, IEEE ou outro estilo de citação?

A resposta curta

script.js · linhas 29–49no código completo
// [@key] prints a raised number in order of first citation. English journals set it after
// the full stop, "control.[@ncdrisc2021]"; Spanish ones before it, "controlada[@ncdrisc2021].".
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
// elsevier-vancouver is the bundled NLM/Vancouver style (citation-sequence). Two edits bring
// its list to the NLM sample references: "1." instead of "[1]", and the issue after the
// volume, 2015;373(22):2103-16.
const vancouver = STYLES['elsevier-vancouver']
  .replace('<text variable="citation-number" prefix="[" suffix="]"/>',
    '<text variable="citation-number" suffix="."/>')
  .replace('<text variable="volume"/>',
    '<group><text variable="volume"/><text variable="issue" prefix="(" suffix=")"/></group>');
const citations = {
  style: 'custom', customStyle: vancouver,
  marker: 'superscript', collapseRanges: true, // raised 1 and 6–8, not [1] and [6–8]
  link: true, // each number jumps to its reference, in the PDF and on screen
  // 7.8 pt: the eleven societies of reference 5, ACC/AHA/…/PCNA, fit one line whole
  bibliography: { fontSize: em(0.84), lineHeight: pt(10.4), entrySpacing: pt(1.6),
    labelWidth: mm(5.5), labelAlign: 'right', // a column for the numbers: 9. and 10. end
    // together, and every entry's text starts at one x, first line and turnovers alike
    doi: 'link' }, // https://doi.org/… printed whole and clickable
};

Ingredientes

Tipografia
PT Serif, Fira Sans, Fira Sans Condensed (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

O código é a resposta curta acima. Dos estilos que vêm com o Postext, elsevier-vancouver é o que segue o Citing Medicine da NLM (ordem de citação, autores como Ettehad D, Emdin CA, seis nomes e depois et al., títulos de revista abreviados), e por isso é o arquivo de onde partir. Duas substituições de texto aproximam a lista das referências de exemplo da NLM: o número aparece como 1. em vez de [1], e o fascículo vem depois do volume. marker: 'superscript' compõe as citações como números elevados, escreva o estilo o que escrever, e doi: 'link' mantém cada endereço https://doi.org/ como link. Duas obras não consecutivas saem juntas, 6,9: um espaço depois da vírgula se esticaria com a linha justificada. Na lista, labelWidth dá aos números uma coluna própria e labelAlign: 'right' faz 9. e 10. terminarem no mesmo ponto, de modo que o texto de cada entrada começa na mesma vertical, na primeira linha e nas seguintes. O estilo AMA também vem incluído e eleva os números por conta própria, mas a lista dele difere da Vancouver na pontuação e nos intervalos de páginas.

#2 · Um bloco de título sobre as duas colunas

script.js · linhas 53–83no código completo
const text = (id, content, family, size, extra) => ({ kind: 'text', id, content, align: 'left',
  fontFamily: family, fontSize: pt(size), color: col('ink'), overflow: 'wrap', ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
  ...(width && { size: { width: mm(width), height: 'auto' } }) });
const caps = { fontFamily: COND, fontWeight: 600, letterSpacing: pt(1.3),
  textTransform: 'uppercase' };
const JOURNAL = t({ en: 'Almenara Medical Journal', es: 'Revista Médica de Almenara' });
const titleBlock = { enabled: true,
  minHeight: mm(62), // the abstract and the text start under the note, on both columns
  slot: { elements: [
    { kind: 'box', id: 'band', style: { backgroundColor: col('accent') },
      placement: { anchor: { to: 'page', edge: 'top-left' },
        size: { width: 'fill', height: mm(15) } } },
    text('journal', JOURNAL, COND, 9.5, { ...caps, color: col('paper'),
      placement: at('page', 'top-left', INNER, 6) }),
    text('issue', '{attr.issue}', COND, 9.5, { ...caps, color: col('paper'),
      align: 'right', placement: at('page', 'top-right', -OUTER, 6, 60) }),
    text('kind', '{attr.kind}', COND, 9, { ...caps, color: col('accent'),
      placement: at('container', 'top-left', 0, 0, MEASURE) }),
    text('title', '{titleText}', SANS, 19.5, { fontWeight: 600, lineHeight: 1.16,
      placement: at('#kind', 'below', 0, 3, MEASURE - 20) }),
    text('authors', '{attr.authors}', SERIF, 10.5, { inlineMarks: true, // ^1^ → ¹
      placement: at('#title', 'below', 0, 4.5, MEASURE) }),
    text('affiliations', '{attr.affiliations}', SANS, 7.4, { inlineMarks: true,
      lineHeight: 1.35, color: col('muted'), placement: at('#authors', 'below', 0, 2, MEASURE) }),
    { kind: 'rule', id: 'rule', thickness: pt(0.5), color: col('rule'),
      placement: at('#affiliations', 'below', 0, 3, MEASURE) },
    text('note', '{attr.note}', SANS, 7.4, { color: col('muted'),
      placement: at('#rule', 'below', 0, 1.6, MEASURE) }),
  ] },
};

O título do artigo é o único título de nível 1, com o estilo article, que ocupa a largura da página e o desenha com o design. O tipo de artigo, os autores, as afiliações e a nota vêm de atributos do título. inlineMarks transforma o ^1^ do atributo num número de afiliação elevado, e o \n das afiliações abre uma linha para cada instituição. A faixa é ancorada ao refile, e assim chega até a borda superior do papel.

#3 · Um resumo estruturado e um boxe de pontos-chave

script.js · linhas 87–97no código completo
const box = (id, bold, more) => ({ id, border: { enabled: false }, snapToGrid: false,
  marginTop: pt(LEAD), marginBottom: pt(LEAD),
  titleStyle: { ...caps, fontSize: pt(8.5), color: col('accent') }, // run-in labels in bold
  body: { fontFamily: SANS, fontSize: pt(8.3), lineHeight: pt(11.2), textAlign: 'left',
    firstLineIndent: pt(0), paragraphSpacing: true, boldColor: col(bold) }, ...more });
const calloutStyles = [
  box('abstract', 'accent', { background: col('tint'), padding: mm(3.5), marginTop: pt(0) }),
  box('keypoints', 'ink', { backgroundEnabled: false, padding: { top: mm(2.5), right: mm(0),
    bottom: mm(1), left: mm(0) }, stripe: { enabled: true, side: 'top', width: pt(2.5),
    color: col('accent') } }),
];

Os dois boxes compartilham um estilo de texto: Fira Sans em 8,3 pt com rótulos em negrito no começo do parágrafo, a voz que o leitor espera no material de síntese. O resumo tem um fundo de cor e os rótulos em verde-azulado; os pontos-chave ficam sob um fio de 2,5 pt, com os rótulos em preto. snapToGrid: false mantém o preenchimento exato, de modo que o boxe do resumo se ajusta ao texto.

#4 · A Tabela 1 e a Figura 1 no alto de uma coluna

script.js · linhas 300–319no código completo
const resources = () => [
  { id: 'tbl-baseline', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
    placement: { position: 'top' },
    caption: t({ en: 'Characteristics of the patients at baseline.',
      es: 'Características de los pacientes al inicio.' }),
    note: t({ en: 'Values are mean (SD) or number (%). BP, blood pressure, in mm Hg.',
      es: 'Valores en media (DE) o número (%). PA, presión arterial, en mm Hg.' }),
    table: { model: { headerRowCount: 1, columnWidths: [2.2, 1.1, 1.1],
      rows: parseTSV(baseline).rows.map((row, r) => row.map(({ content }, c) => ({ content,
        ...(r === 0 && { isHeader: true }), ...(c > 0 && { align: 'center' }) }))) } } },
  { id: 'fig-home', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
    placement: { position: 'top' }, svg: { fileId: 'home.svg', width: 850, height: 520 },
    caption: t({ en: 'Mean home systolic pressure by week in the telemonitoring group, with its '
      + '95% confidence interval. The dashed line is the home target of 135\u00a0mm\u00a0Hg.',
    es: 'Presión sistólica domiciliaria media por semana en el grupo de telemonitorización, con '
      + 'su intervalo de confianza del 95\u00a0%. La línea discontinua es el objetivo de '
      + '135\u00a0mm\u00a0Hg.' }),
    altText: t({ en: 'A line falling from 158 mm Hg in week 1 to 135 mm Hg in week 12.',
      es: 'Una línea que baja de 158 mm Hg en la semana 1 a 135 mm Hg en la semana 12.' }) },
];

A tabela é lida de um texto separado por tabulações, como uma planilha o exporta, e a linha de cabeçalho é preenchida em verde-azulado, com rótulos brancos em negrito. Os dois recursos flutuam até o alto de uma coluna depois do parágrafo que os cita. Com shortLabel igual ao nome completo do tipo, :ref imprime (Table 1), como as revistas escrevem, e o numbered: false do título deixa a contagem em 1 e não em 1.1. As células usam Fira Sans com figureStyle: 'tabular': todos os algarismos têm a mesma largura, e as médias e as contagens dos dois grupos ficam alinhadas.

script.js · linhas 17–21no código completo
const palette = { ink: '#1a1d21', accent: '#0d5c63', tint: '#e5eff0', rule: '#9fb4b6',
  muted: '#566065', paper: '#ffffff' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 095 · A medical article in Vancouver style ══════════════
// https://postext.dev/en/cookbook/medical-article-vancouver
// Code: MIT · Text: original (CC BY 4.0) · Chart: generated in code (CC BY 4.0)
// Fonts: PT Serif, Fira Sans, Fira Sans Condensed (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerCitationEngine, registerResourceImage,
  defaultResourceTypes, parseTSV, inlineSvgFonts,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'medical-article-vancouver';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black text, one clinical teal for the journal's own marks
const palette = { ink: '#1a1d21', accent: '#0d5c63', tint: '#e5eff0', rule: '#9fb4b6',
  muted: '#566065', paper: '#ffffff' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SERIF, SANS, COND] = ['PT Serif', 'Fira Sans', 'Fira Sans Condensed'];
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER, GUTTER] = [210, 297, 24, 22, 17, 17, 6];
const MEASURE = TRIM_W - INNER - OUTER;
const LEAD = 12.8; // pt: 9.3 pt type, as journals set two columns of A4

// #region answer: Vancouver numbers as superscripts, a "1." list and DOIs that are links
// [@key] prints a raised number in order of first citation. English journals set it after
// the full stop, "control.[@ncdrisc2021]"; Spanish ones before it, "controlada[@ncdrisc2021].".
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
// elsevier-vancouver is the bundled NLM/Vancouver style (citation-sequence). Two edits bring
// its list to the NLM sample references: "1." instead of "[1]", and the issue after the
// volume, 2015;373(22):2103-16.
const vancouver = STYLES['elsevier-vancouver']
  .replace('<text variable="citation-number" prefix="[" suffix="]"/>',
    '<text variable="citation-number" suffix="."/>')
  .replace('<text variable="volume"/>',
    '<group><text variable="volume"/><text variable="issue" prefix="(" suffix=")"/></group>');
const citations = {
  style: 'custom', customStyle: vancouver,
  marker: 'superscript', collapseRanges: true, // raised 1 and 6–8, not [1] and [6–8]
  link: true, // each number jumps to its reference, in the PDF and on screen
  // 7.8 pt: the eleven societies of reference 5, ACC/AHA/…/PCNA, fit one line whole
  bibliography: { fontSize: em(0.84), lineHeight: pt(10.4), entrySpacing: pt(1.6),
    labelWidth: mm(5.5), labelAlign: 'right', // a column for the numbers: 9. and 10. end
    // together, and every entry's text starts at one x, first line and turnovers alike
    doi: 'link' }, // https://doi.org/… printed whole and clickable

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

#Usar o estilo AMA

O estilo AMA eleva os números sozinho e lista as obras com doi:10.1056/…; tire as substituições e o marcador.

-  style: 'custom', customStyle: vancouver,
-  marker: 'superscript', collapseRanges: true, // raised 1 and 6–8, not [1] and [6–8]
+  style: 'american-medical-association',

Para um PDF que só vai para a gráfica, mantenha os endereços como texto preto simples.

-    doi: 'link' }, // https://doi.org/… printed whole and clickable
+    doi: 'text' },

#Números entre colchetes

Algumas revistas que seguem Vancouver escrevem os números na linha, entre colchetes.

-  marker: 'superscript', collapseRanges: true, // raised 1 and 6–8, not [1] and [6–8]
+  marker: 'brackets', collapseRanges: true,

Erros comuns

Erro comum

O cabeçalho de um estilo de título vale para toda a sua seção

header: { elements: [] } no estilo de um título remove os cabeços até o próximo título com estilo, não só na abertura. Para tirá-los apenas da primeira página, dê aos elementos do cabeçalho pages: 'body'. Cabeços e fólios →

  • O header de um estilo de título vale para toda a seção que esse título abre, por isso header: { elements: [] } no título apagaria os cabeços de todas as páginas até o próximo título com estilo. pages: 'body' nos cabeços basta para tirá-los da primeira página.

Créditos

Texto
Texto original, CC BY 4.0
Fontes
PT Serif (SIL OFL 1.1) · Fira Sans (SIL OFL 1.1) · Fira Sans Condensed (SIL OFL 1.1)
SandboxPDF