En pocas palabras
Un artículo breve de investigación médica, compuesto como en una revista. Los autores citan con códigos; Postext imprime números pequeños volados y monta al final la lista numerada de referencias, con cada DOI como enlace.
Lo que vas a componer
Tres páginas de una revista clínica: un artículo original que presenta un ensayo piloto, compuesto en A4 a dos columnas como lo imprimen las revistas que siguen las normas del ICMJE. Una banda verde azulado cruza la cabeza de la primera página sobre el tipo de artículo, un título de cuatro líneas, los autores con sus números de filiación volados y un resumen estructurado sobre un tinte pálido. Los autores citan con claves de BibTeX, y las páginas muestran lo que espera un editor médico: números pequeños volados, obras consecutivas agrupadas como 6–8, dos no consecutivas juntas y sin espacio, 6,9, y una bibliografía numerada en la forma de la NLM, Lancet 2016;387(10022):957-67, que cierra cada entrada con su DOI. En el PDF cada número salta a su referencia y cada DOI abre el artículo. El ensayo es inventado; las once obras que cita son reales.
Esta receta responde a
- ¿Cómo pongo los números de cita en superíndice y hago que los DOI sean enlaces, como en las revistas médicas?
- ¿Cómo cito obras y compongo la bibliografía en APA, IEEE u otro estilo de cita?
La respuesta corta
// [@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
- Funciones
- Citas en un estilo de citaBibliografía a partir de las referenciasSuperíndices y subíndicesEstilos de títuloAtributos de títuloAperturas diseñadasRecuadrosCabeceras y foliosEstilo de tablasEstilos de cifrasEstilo de los piesColocación de figurasPaleta de color semánticaExportación a PDF
- También usa
- Citas que colocan las figurasFigura y Tabla en tu idiomaSalir de la rejilla a propósitoCabeceras según el tipo de páginaFuentes incrustadas en el PDFTipos de recurso propiosFiguras y tablas como recursosPreliminares en romanosTablas a partir de datosCapítulos sin número
- Tipografía
- PT Serif, Fira Sans, Fira Sans Condensed (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Vancouver, volado y enlazado
El código es la respuesta corta de arriba. De los estilos que trae el motor, elsevier-vancouver es el que sigue el Citing Medicine de la NLM (orden de cita, autores como Ettehad D, Emdin CA, seis nombres y luego et al., títulos de revista abreviados), así que es el archivo del que conviene partir. Dos sustituciones de texto acercan su lista a los ejemplos de la NLM: el número se lee 1. y no [1], y el fascículo va tras el volumen. marker: 'superscript' compone las citas como números volados escriba lo que escriba el estilo, y doi: 'link' mantiene cada dirección https://doi.org/ como enlace. En inglés la llamada va tras el punto; en español va delante, como pide la ortografía académica, y basta con escribir [@clave] antes del punto. Dos obras no consecutivas salen juntas, 6,9: un espacio tras la coma se estiraría con la línea justificada. En la lista, labelWidth da a los números una columna propia y labelAlign: 'right' hace que 9. y 10. acaben a la vez, de modo que el texto de cada entrada empieza en la misma vertical, en su primera línea como en las siguientes. El estilo AMA también viene incluido y vuela sus números por sí mismo, pero su lista difiere de la de Vancouver en la puntuación y en los intervalos de páginas.
#2 · Un bloque de título a dos columnas
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ítulo del artículo es el único encabezado de nivel 1, con el estilo article, que ocupa toda la página y lo dibuja con su diseño. El tipo de artículo, los autores, las filiaciones y la nota salen de atributos del encabezado. inlineMarks convierte el ^1^ del atributo en un número de filiación volado, y el \n de las filiaciones abre una línea para cada centro. La banda está anclada al corte, así que llega hasta el borde superior del papel.
#3 · Un resumen estructurado y un recuadro de puntos clave
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') } }),
];
Los dos recuadros comparten un estilo de texto: Fira Sans a 8,3 pt con etiquetas en negrita al comienzo del párrafo, la voz que el lector espera en el material de resumen. El resumen lleva un tinte y las etiquetas en verde azulado; los puntos clave van bajo un filete de 2,5 pt con las etiquetas en tinta. snapToGrid: false respeta el relleno exacto, de modo que el recuadro del resumen se ciñe al texto.
#4 · La Tabla 1 y la Figura 1 a la cabeza de 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 tabla se lee de un texto separado por tabuladores, como lo exporta una hoja de cálculo, y su fila de cabecera va rellena en verde azulado con las etiquetas en blanco y negrita. Los dos recursos flotan a la cabeza de una columna después del párrafo que los cita. Con shortLabel igual al nombre completo del tipo, :ref imprime (Tabla 1), como escriben las revistas, y el numbered: false del título deja la cuenta en 1 y no en 1.1. Sus celdas usan Fira Sans con figureStyle: 'tabular': todas las cifras tienen el mismo ancho, y las medias y los recuentos de los dos grupos quedan alineados.
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 receta 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
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Usa el estilo AMA
El estilo AMA vuela sus números por sí mismo y escribe doi:10.1056/… en la lista; quita las sustituciones y el marcador.
- style: 'custom', customStyle: vancouver,
- marker: 'superscript', collapseRanges: true, // raised 1 and 6–8, not [1] and [6–8]
+ style: 'american-medical-association',#Imprime los DOI sin enlace
Para un PDF que solo se va a imprimir, deja las direcciones como texto negro.
- doi: 'link' }, // https://doi.org/… printed whole and clickable
+ doi: 'text' },#Números entre corchetes
Algunas revistas Vancouver escriben los números en la línea, entre corchetes.
- marker: 'superscript', collapseRanges: true, // raised 1 and 6–8, not [1] and [6–8]
+ marker: 'brackets', collapseRanges: true,Errores frecuentes
Error frecuente
La cabecera de un estilo de título rige toda su sección
header: { elements: [] } en el estilo del título quita las cabeceras hasta el siguiente título con estilo, no solo en la apertura. Para dejar libre solo la primera página, da a los elementos de la cabecera pages: 'body'. Cabeceras y folios →
- La
headerde un estilo de encabezado rige toda la sección que ese título abre, así queheader: { elements: [] }en el título del artículo quitaría las cabeceras de todas las páginas hasta el siguiente título con estilo. Para dejar libre la primera página basta conpages: 'body'en las cabeceras.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- PT Serif (SIL OFL 1.1) · Fira Sans (SIL OFL 1.1) · Fira Sans Condensed (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


