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
// [@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
- Funcionalidades
- Citações em um estilo de citaçãoBibliografia a partir das referênciasSobrescritos e subscritosEstilos de títuloAtributos de títuloAberturas desenhadasBoxesCabeços e fóliosEstilo de tabelaEstilos de algarismosEstilo de legendaPosicionamento de figurasPaleta de cores semânticaExportação para PDF
- Também usa
- Citações que posicionam as figurasFigura e Tabela no seu idiomaSair da grade de propósitoCabeços por tipo de páginaFontes incorporadas ao PDFTipos de recurso personalizadosFiguras e tabelas como recursosElementos pré-textuais em romanosTabelas a partir de dadosCapítulos sem número
- Tipografia
- PT Serif, Fira Sans, Fira Sans Condensed (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Vancouver, sobrescrito e com links
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
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
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
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.
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
// ═══ 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',#Imprimir os DOIs sem link
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
headerde um estilo de título vale para toda a seção que esse título abre, por issoheader: { 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
- Receita
- Ignacio Ferro
- 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)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


