Saltar al contenido principal
Receta número 143

Recetario · Capítulo 9 · Publicaciones completas

Un boletín semanal: los primeros informes del sida

Dos informes de los CDC de 1981 en un boletín tamaño carta: cabecera, casos con etiquetas en línea, estilos para Reported by y la nota editorial, citas.

  • Muestra en inglés: aún no hay edición en español
  • Formato 215,9 × 279,4 mm
  • 2 columnas, medianil de 6,3 mm
  • IBM Plex Serif 9,5/13
  • IBM Plex Sans Condensed
  • Libre Franklin
  • 6 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 303 ms
  • 180 líneas de código

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

script.js · líneas 84–104en el código completo
// :::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

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

script.js · líneas 38–65en el código completo
// 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

script.js · líneas 439–472en el código completo
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

script.js · líneas 17–21en el código completo
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

Sandbox
// ═══ 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 y scope: '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, o symbols: ['*', '§', '¶'].
  • 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

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)
SandboxPDF