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
// [@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
- Funcions
- Cites en un estil de citaBibliografia a partir de les referènciesSuperíndexs i subíndexsEstils de títolAtributs de títolObertures dissenyadesRequadresCapçaleres i folisEstil de taulesEstils de xifresEstil dels peusCol·locació de figuresPaleta de color semànticaExportació a PDF
- També fa servir
- Cites que col·loquen les figuresFigura i Taula en la teva llenguaSortir de la retícula a propòsitCapçaleres segons el tipus de pàginaFonts incrustades al PDFTipus de recurs propisFigures i taules com a recursosPreliminars en romansTaules a partir de dadesCapítols sense número
- 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
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
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
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.
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
// ═══ 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
headerd'un estil d'encapçalament regeix tota la secció que aquest títol obre, així queheader: { 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 ambpages: 'body'a les capçaleres.
Crèdits
- Recepta
- Ignacio Ferro
- 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)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


