En pocas palabras
Un boletín de salud pública de 1981, compuesto de nuevo en papel carta. Cada tipo de párrafo (los casos, la lista de médicos que los comunicaron, el comentario de la redacción) tiene su aspecto, y las referencias se numeran solas.
Lo que vas a componer
Seis páginas de un boletín epidemiológico semanal en tamaño carta US, que reproducen los dos informes en los que los Centros para el Control de Enfermedades (CDC) describieron por primera vez lo que después se llamó sida: cinco casos de neumonía por Pneumocystis en Los Ángeles (5 de junio de 1981) y los casos de sarcoma de Kaposi que vinieron después (3 de julio de 1981). La cabecera es un diseño propio al estilo de un boletín oficial de la época: una banda azul con la marca en una sans condensada sobre dos columnas de Plex Serif. Cada voz del informe tiene su estilo: los casos bajo etiquetas numeradas en negrita, la línea Reported by en cursiva pequeña, la Editorial Note, las citas entre paréntesis y una lista numerada. El texto, las referencias y las tablas son los que imprimieron los CDC; la cronología y la tabla de casos de la página 2 son de la edición.
Esta receta responde a
- ¿Cómo compongo el informe de un boletín semanal: la cabecera, los casos clínicos, una nota editorial y las referencias numeradas?
- ¿Cómo cito obras y compongo la bibliografía en APA, IEEE u otro estilo de cita?
- ¿Cómo hago una tabla con filas de cabecera, celdas combinadas, anchos de columna y alineación por celda?
- ¿Cómo vuelvo a componer con Postext un artículo de acceso abierto de arXiv o PubMed Central, con sus citas, sus figuras y su línea de licencia?
La respuesta corta
// :::paragraphs{style="…"} wraps the blocks of each voice; **Patient 1:** is a run-in label.
const voice = (id, family, size, lead, extra) => ({ id, fontFamily: family, fontSize: pt(size),
lineHeight: pt(lead), color: col('ink'), boldColor: col('ink'), ...extra });
const aside = { textAlign: 'left', firstLineIndent: pt(0), snapToGrid: false };
const paragraphStyles = [
// Case histories and the Editorial Note: the body texture, bold labels in the accent.
voice('case', TEXT, 9.5, LEAD, { boldColor: col('accent'), boldFontWeight: 600 }),
voice('editorial', TEXT, 9.5, LEAD, { boldColor: col('accent'), boldFontWeight: 600 }),
// "Reported by …": the authors' line, italic small type in the condensed sans, off the grid.
voice('reported', LABEL, 7.8, 10.2, { ...aside, italic: true, color: col('muted'),
hyphenation: false, marginTop: pt(4), marginBottom: pt(6) }),
// A line the reprint adds, in the label face and the accent: never taken for 1981 text.
voice('editor', LABEL, 8, 10.6, { ...aside, italic: true, color: col('accent'),
marginTop: pt(3), marginBottom: pt(5) }),
voice('colophon', LABEL, 7.4, 9.6, { ...aside, color: col('muted'), marginTop: pt(LEAD) }),
];
// MMWR cited (1) in citation order, and each report (its H1 is a chapter) counted from 1.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = { style: 'american-medical-association', marker: 'parentheses',
numbering: 'chapter', bibliography: { scope: 'chapter', fontSize: em(0.86),
lineHeight: pt(10.6), entrySpacing: pt(1.5), labelAlign: 'right' } };
Ingredientes
- Funciones
- Estilos de párrafoAperturas diseñadasBibliografía a partir de las referenciasCitas en un estilo de citaNotas al pieEstilo de tablasTipos de recurso propiosEstilo de los piesColocación de figurasCabeceras y foliosCabeceras según el tipo de páginaEstilos de títuloAtributos de títuloUna o dos columnasFormato de páginaPaleta de color semánticaExportación a PDF
- También usa
- Citas que colocan las figurasFiguras justo aquíFigura y Tabla en tu idiomaFuentes incrustadas en el PDFFiguras y tablas como recursosGeometría por secciónTablas a partir de datosEstilos de tabla con nombre
- Tipografía
- IBM Plex Serif, Libre Franklin, IBM Plex Sans Condensed (SIL OFL 1.1)
- Recursos
- Figura 1, cronología de los cinco casos, dibujada en código con las fechas de los informes (Ignacio Ferro, original)
Elaboración
#1 · Un estilo de párrafo para cada voz
El código es la respuesta corta de arriba. Un informe de boletín se escribe en varios registros: los casos, la lista de quienes los comunicaron y el comentario de la redacción. Envolver cada tramo en :::paragraphs{style="…"} le da su aspecto sin tocar las palabras: la línea Reported by baja a 7,8 pt en cursiva condensada, fuera de la rejilla base, mientras los casos conservan la textura del texto base con sus etiquetas **Patient 1:** en el color de acento. Las citas se escriben [@walzer1974]; american-medical-association con marker: 'parentheses' las imprime como (1) y ordena la lista por orden de cita, como hacía el boletín, numbering: 'chapter' cuenta las citas de cada informe desde 1, y scope: 'chapter' pone su lista debajo con esos mismos números.
#2 · Una cabecera que abre el primer informe
// Kicker and dateline are attributes of each report's H1; {titleText} read with inlineMarks
// keeps the italic genus. The July report opens where June ends, under a double rule.
const reportHead = (y, size) => [
text('kicker', '{attr.kicker}', LABEL, 8.5, { ...caps(8.5), color: col('accent'),
placement: at('container', 'top-left', 0, y, MEASURE) }),
text('title', '{titleText}', DISPLAY, size, { fontWeight: 800, lineHeight: 1.08,
inlineMarks: true, placement: at('#kicker', 'below', 0, 2.2, MEASURE) }),
text('dateline', '{attr.dateline}', LABEL, 9, { color: col('muted'),
placement: at('#title', 'below', 0, 2, MEASURE) }),
];
const masthead = { enabled: true, minHeight: mm(72), slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('accent') }, placement: {
anchor: { to: 'page', edge: 'top-left' }, size: { width: 'fill', height: mm(49) } } },
// The series line, the reprint's number, its description and contents are the first H1's.
text('series', '{attr.series}', LABEL, 8,
{ ...caps(8), color: col('paper'), placement: at('page', 'top-left', SIDE, 11, 120) }),
text('number', '{attr.reprint}', LABEL, 8, { ...caps(8), color: col('paper'), align: 'right',
placement: at('page', 'top-right', -SIDE, 11, 50) }),
text('wordmark', 'Surveillance Notes', DISPLAY, 50, { fontWeight: 800, color: col('paper'),
letterSpacing: pt(-1), lineHeight: 1, placement: at('page', 'top-left', SIDE - 1, 18) }),
text('issue', '{attr.issue}', TEXT, 9.5,
{ lineHeight: 1.3, placement: at('container', 'top-left', 0, 29, 92) }),
text('contents', '{attr.contents}', LABEL, 8, { inlineMarks: true, lineHeight: 1.3,
placement: at('container', 'top-right', 0, 29, 76), align: 'left' }),
rule('rule-a', 46.5, 2), rule('rule-b', 48, 0.5), ...reportHead(52, 23),
] } };
const opener = { enabled: true, minHeight: mm(26), slot: { elements: [rule('rule-a', 0, 2),
rule('rule-b', 1.5, 0.5), ...reportHead(5, 18)] } };
La cabecera es el diseño del estilo de encabezado del primer informe, así que se imprime una sola vez, en la página 1, y las cabeceras de página se la saltan (pages: 'body'). El antetítulo y la fecha salen de atributos del H1 de cada informe, y el título es {titleText}: un elemento de texto con inlineMarks: true conserva el género en cursiva del título. El informe de julio se abre con esos tres elementos bajo un filete doble. Su estilo de encabezado ocupa toda la página con spanBreak: false, así que empieza donde acaba el informe de junio: las columnas de encima terminan a la misma altura y el texto sigue debajo en las dos, como el boletín encadenaba un informe tras otro.
#3 · Tres tablas a partir de texto con tabuladores
const NUMBER = /^[\d,.()% –]*$/; // a column of counts aligns right, its heading centred
const table = (tsv, headerRows, columnWidths) => {
const model = parseTSV(tsv, { headerRows });
const numeric = model.rows[0].map((_, c) => model.rows.slice(headerRows)
.every((row) => NUMBER.test(row[c].content)));
return { ...model, columnWidths, rows: model.rows.map((cells, r) => cells.map((cell, c) =>
(numeric[c] ? { ...cell, align: r < headerRows ? 'center' : 'right' } : cell))) };
};
// Two header rows, as the weekly printed them: "25th week ending" spans two columns.
const notifiable = [[0, 0, 1, 0], [0, 1, 0, 2], [0, 3, 1, 3], [0, 4, 0, 6]]
.reduce((m, [r1, c1, r2, c2]) => mergeCells(m, { start: { row: r1, col: c1 },
end: { row: r2, col: c2 } }), table(NOTIFIABLE, 2, [3.6, 1, 1, 1, 1.1, 1.1, 1.1]));
const added = 'Compiled for this reprint from the case reports; not part of the 1981 report.';
const res = (id, typeId, kind, placement, more) => ({ id, typeId, kind, placement,
createdAt: 0, updatedAt: 0, ...more });
const resources = [
res('fig-timeline', 'figure', 'svg', { position: 'bottom', span: 'page' }, {
svg: { fileId: 'timeline.svg', width: 1780, height: 490 },
caption: 'The five patients, September 1980 to May 1981, by month. The illness before '
+ 'the pneumonia is counted back from the month of diagnosis, as each report gives it.',
note: `Drawn by the editors. ${added}`,
altText: 'A timeline of five rows, one per patient: Pneumocystis pneumonia diagnosed '
+ 'between February and April 1981, two deaths in March and May.' }),
res('tbl-cases', 'table', 'table', { position: 'top', span: 'page' }, {
caption: 'The five case reports at a glance.', note: added,
table: { model: table(CASES, 1, [0.7, 0.45, 1, 2.2, 2.4, 1.5]) } }),
res('tbl-complaints', 'table', 'table', { position: 'bottom' }, {
caption: 'Presenting complaints in 20 patients with Kaposi’s sarcoma',
table: { model: table(COMPLAINTS, 1, [2, 1.15]) } }),
res('tbl-notifiable', 'table', 'table', { position: 'here' }, {
caption: 'Summary — cases of specified notifiable diseases, United States',
note: 'Cumulative totals include revised and delayed reports through previous weeks.',
table: { model: notifiable, styleId: 'weekly' } }),
];
Cada tabla es una ranura de contenido con texto separado por tabuladores, el formato que copia una hoja de cálculo, y parseTSV la convierte en un modelo. Una columna de cifras se alinea a la derecha con su cabecera centrada; cuatro llamadas a mergeCells forman la cabecera de dos filas del resumen de enfermedades de declaración obligatoria. El tipo tabla reinicia su contador en cada H1 (resetOn: 'h1'), de modo que cada informe tiene su Tabla 1, como en 1981.
#4 · Un solo azul, enlazado en todas partes
const palette = { ink: '#1c1f24', accent: '#1f3f74', tint: '#e6eaf1', rule: '#a7b1c2',
muted: '#566070', 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 banda, las etiquetas, los folios, las cabeceras de tabla y el gráfico remiten a la misma entrada de la paleta: quien cambie accent por el color de su boletín recolorea las seis páginas de una vez.
La receta completa
// ═══ Postext Cookbook · Nº 143 · A weekly bulletin report: the first AIDS reports ═══
// https://postext.dev/en/cookbook/outbreak-report-bulletin
// Code: MIT · Text: CDC, MMWR 1981;30:250–252 and 305–308 (public domain) · Chart: original
// Fonts: IBM Plex Serif, Libre Franklin, Plex Sans Condensed (OFL) · Needs postext ≥ 1.34.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerCitationEngine, registerResourceImage,
defaultResourceTypes, parseTSV, mergeCells, 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 = 'outbreak-report-bulletin';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a federal blue on office white, every colour linked by id
const palette = { ink: '#1c1f24', accent: '#1f3f74', tint: '#e6eaf1', rule: '#a7b1c2',
muted: '#566070', 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 [TEXT, DISPLAY, LABEL] = ['IBM Plex Serif', 'Libre Franklin', 'IBM Plex Sans Condensed'];
const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 22, 20, 19, 6.35];
const MEASURE = TRIM_W - 2 * SIDE; // US Letter, two columns of 86 mm
const LEAD = 13; // pt: 9.5 pt Plex Serif, as a bulletin sets two columns of Letter
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 = (size, extra) => ({ fontFamily: LABEL, fontSize: pt(size), fontWeight: 600,
letterSpacing: pt(size * 0.18), textTransform: 'uppercase', ...extra });
const rule = (id, y, thickness) => ({ kind: 'rule', id, color: col('accent'),
thickness: pt(thickness), placement: at('container', 'top-left', 0, y, MEASURE) });
// #region masthead: the bulletin's band, issue strip and contents over the first report
// Kicker and dateline are attributes of each report's H1; {titleText} read with inlineMarks
// keeps the italic genus. The July report opens where June ends, under a double rule.
const reportHead = (y, size) => [
text('kicker', '{attr.kicker}', LABEL, 8.5, { ...caps(8.5), color: col('accent'),
placement: at('container', 'top-left', 0, y, MEASURE) }),
text('title', '{titleText}', DISPLAY, size, { fontWeight: 800, lineHeight: 1.08,
inlineMarks: true, placement: at('#kicker', 'below', 0, 2.2, MEASURE) }),
text('dateline', '{attr.dateline}', LABEL, 9, { color: col('muted'),
placement: at('#title', 'below', 0, 2, MEASURE) }),
];
const masthead = { enabled: true, minHeight: mm(72), slot: { elements: [
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
#Números de referencia volados
Casi todas las revistas médicas suben los números en vez de ponerlos entre paréntesis.
-const citations = { style: 'american-medical-association', marker: 'parentheses',
+const citations = { style: 'american-medical-association', marker: 'superscript',#Cada informe en página nueva
Una serie de reimpresiones que archiva los informes por separado abre cada uno en página nueva.
- { id: 'report', span: 'page', spanBreak: false, advancedDesign: opener },
+ { id: 'report', span: 'page', advancedDesign: opener },#La lista al modo Vancouver
Un artículo médico en estilo Vancouver retoca el estilo elsevier-vancouver incluido para seguir la forma de referencia de la NLM.
Errores frecuentes
- Sin
numbering: 'chapter'los números de referencia siguen en todo el documento yscope: 'chapter'solo separa las listas: el informe de julio citaría las obras 4 y de 6 a 23, donde el boletín imprimió de 1 a 19. - La nota de 1981 Paired specimens not run in parallel se llama con un asterisco:
footnotes.numberFormat: 'symbols'pone *, †, ‡ y vuelve a empezar en cada página. De esas marcas, solo el asterisco está en el archivo latin de una fuente de Fontsource (la cruz está en latin-ext y la doble cruz en ninguno), así que una página con dos o tres notas necesita una fuente que las tenga, osymbols: ['*', '§', '¶']. - El texto de 1981 queda como se imprimió, con la terminología de la época, y el colofón lo dice. Una reimpresión no corrige el texto que reproduce; lo que añade la edición (la cronología, la tabla de casos, la línea en cursiva azul bajo el primer párrafo) va en su propio estilo y rotulado.
Créditos
- Receta
- Ignacio Ferro
- Texto
- «Pneumocystis Pneumonia — Los Angeles», MMWR 1981;30(21):250-252, y «Kaposi's Sarcoma and Pneumocystis Pneumonia Among Homosexual Men — New York City and California», MMWR 1981;30(25):305-308, recompuestos completos a partir de los números impresos; la Tabla 1 del primer informe y la Figura 1 las añade la edición a partir de los casos. Todo el material de la serie MMWR es de dominio público y puede reproducirse sin permiso; se agradece la cita de la fuente. · Centers for Disease Control (CDC) · dominio público
- Imágenes
- Figura 1, cronología de los cinco casos, dibujada en código con las fechas de los informes · Ignacio Ferro · original
- Fuentes
- IBM Plex Serif (SIL OFL 1.1) · Libre Franklin (SIL OFL 1.1) · IBM Plex 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)


