Saltar al contingut principal
Recepta número 95

Receptari · Capítol 5 · Estructura del llibre

Un article mèdic en estil Vancouver

Un assaig clínic en A4 a dues columnes: números de cita volats, una bibliografia numerada a la manera de Vancouver i DOI que s'obren com a enllaços al PDF.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.65.0 · postext-pdf ≥ 1.65.0
Llicència
Actualitzada el 31 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
  • 2 columnes, espai entre columnes de 6 mm
  • PT Serif 9,3/12,8
  • Fira Sans
  • Fira Sans Condensed
  • Fira Sans@tnum
  • 3 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 143 ms
  • 180 línies de codi

En poques paraules

Un article breu de recerca mèdica, compost com en una revista. Els autors citen amb codis; Postext imprimeix números petits volats i munta al final la llista numerada de referències, amb cada DOI com a enllaç.

Què compondràs

Tres pàgines d'una revista clínica: un article original que presenta un assaig pilot, compost en A4 a dues columnes tal com l'imprimeixen les revistes que segueixen les normes de l'ICMJE. Una banda verd blavós travessa el capdamunt de la primera pàgina sobre el tipus d'article, un títol de quatre línies, els autors amb els seus números de filiació volats i un resum estructurat sobre un tint pàl·lid. Els autors citen amb claus de BibTeX, i les pàgines mostren el que espera un editor mèdic: números petits volats, obres consecutives agrupades com a 6–8, dues no consecutives juntes i sense espai, 6,9, i una bibliografia numerada en la forma de la NLM, Lancet 2016;387(10022):957-67, que tanca cada entrada amb el seu DOI. Al PDF cada número salta a la seva referència i cada DOI obre l'article. L'assaig és inventat; les onze obres que cita són reals.

Aquesta recepta respon a

  • Com poso els números de cita en superíndex i faig que els DOI siguin enllaços, com a les revistes mèdiques?
  • Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?

La resposta curta

script.js · línies 29–49al codi complet
// [@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
};

Ingredients

Tipografia
PT Serif, Fira Sans, Fira Sans Condensed (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Vancouver, volat i enllaçat

El codi és la resposta curta de més amunt. Dels estils que porta el motor, elsevier-vancouver és el que segueix el Citing Medicine de la NLM (ordre de cita, autors com Ettehad D, Emdin CA, sis noms i després et al., títols de revista abreujats), així que és el fitxer del qual convé partir. Dues substitucions de text acosten la seva llista als exemples de la NLM: el número es llegeix 1. i no [1], i el fascicle va després del volum. marker: 'superscript' compon les cites com a números volats escrigui el que escrigui l'estil, i doi: 'link' manté cada adreça https://doi.org/ com a enllaç. En anglès la crida va després del punt; en castellà va al davant, com demana l'ortografia acadèmica, i n'hi ha prou d'escriure [@clave] abans del punt. Dues obres no consecutives surten juntes, 6,9: un espai després de la coma s'estiraria amb la línia justificada. A la llista, labelWidth dona als números una columna pròpia i labelAlign: 'right' fa que 9. i 10. acabin alhora, de manera que el text de cada entrada comença a la mateixa vertical, tant a la primera línia com a les següents. L'estil AMA també ve inclòs i vola els seus números tot sol, però la seva llista difereix de la de Vancouver en la puntuació i en els intervals de pàgines.

#2 · Un bloc de títol a dues columnes

script.js · línies 53–83al codi complet
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) }),
  ] },
};

El títol de l'article és l'únic títol de nivell 1, amb l'estil article, que ocupa tota la pàgina i el dibuixa amb el seu disseny. El tipus d'article, els autors, les filiacions i la nota surten d'atributs del títol. inlineMarks converteix el ^1^ de l'atribut en un número de filiació volat, i el \n de les filiacions obre una línia per a cada centre. La banda està ancorada al tall, així que arriba fins a la vora superior del paper.

#3 · Un resum estructurat i un requadre de punts clau

script.js · línies 87–97al codi complet
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') } }),
];

Els dos requadres comparteixen un estil de text: Fira Sans a 8,3 pt amb etiquetes en negreta al començament del paràgraf, la veu que el lector espera en el material de resum. El resum porta un tint i les etiquetes en verd blavós; els punts clau van sota un filet de 2,5 pt amb les etiquetes en tinta. snapToGrid: false respecta el farciment exacte, de manera que el requadre del resum s'ajusta al text.

#4 · La Taula 1 i la Figura 1 al capdamunt d'una columna

script.js · línies 300–319al codi complet
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.' }) },
];

La taula es llegeix d'un text separat per tabuladors, tal com l'exporta un full de càlcul, i la seva fila de capçalera va emplenada en verd blavós amb les etiquetes en blanc i negreta. Els dos recursos floten al capdamunt d'una columna després del paràgraf que els cita. Amb shortLabel igual al nom complet del tipus, :ref imprimeix (Taula 1), com escriuen les revistes, i el numbered: false del títol deixa el compte en 1 i no en 1.1. Les cel·les usen Fira Sans amb figureStyle: 'tabular': totes les xifres tenen la mateixa amplada, i les mitjanes i els recomptes dels dos grups queden alineats.

script.js · línies 17–21al codi complet
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' } }));

La recepta 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 = 'es'; // @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

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

#Fes servir l'estil AMA

L'estil AMA vola els seus números tot sol i escriu doi:10.1056/… a la llista; treu les substitucions i el marcador.

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

#Imprimeix els DOI sense enllaç

Per a un PDF que només s'imprimirà, deixa les adreces com a text negre.

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

#Números entre claudàtors

Algunes revistes Vancouver escriuen els números a la línia, entre claudàtors.

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

Errors freqüents

Error freqüent

La capçalera d'un estil de títol regeix tota la seva secció

header: { elements: [] } a l'estil del títol treu les capçaleres fins al títol següent amb estil, no només a l'obertura. Per deixar lliure només la primera pàgina, dona als elements de la capçalera pages: 'body'. Capçaleres i folis →

  • La header d'un estil d'encapçalament regeix tota la secció que aquest títol obre, així que header: { elements: [] } al títol de l'article trauria les capçaleres de totes les pàgines fins al títol amb estil següent. Per deixar lliure la primera pàgina n'hi ha prou amb pages: 'body' a les capçaleres.

Crèdits

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