Skip to main content
Recipe number 143

Cookbook · Chapter 9 · Complete publications

A weekly bulletin report: the first AIDS reports

Two 1981 CDC reports re-set as a US Letter bulletin: a masthead, case histories with run-in labels, Reported by and Editorial Note styles, numbered references.

  • Trim 215.9 × 279.4 mm
  • 2 columns, 6.3 mm gutter
  • IBM Plex Serif 9.5/13
  • IBM Plex Sans Condensed
  • Libre Franklin
  • 6 pages
  • Level
  • Postext 1.65.0
  • Laid out in 303 ms
  • 180 lines of code

In short

A public-health bulletin from 1981, set again on letter paper. Each kind of paragraph in a report (the cases, the list of reporting doctors, the editors' comment) gets its own look, and the references are numbered for you.

What you'll build

Six pages of a weekly epidemiology bulletin on US Letter, reprinting the two reports in which the Centers for Disease Control first described what became known as AIDS: five cases of Pneumocystis pneumonia in Los Angeles (June 5, 1981) and the cases of Kaposi's sarcoma that followed (July 3, 1981). The masthead is an original design in the spirit of a government bulletin of the period, a blue band with a condensed wordmark over two columns of Plex Serif. Each voice of a report has its own style: case histories under bold numbered labels, the Reported by line in small italics, the Editorial Note, references in parentheses and a numbered list. The text, the references and the tables are as CDC printed them; the timeline and the case table on page 2 are the editors' own.

This recipe answers

  • How do I set a weekly bulletin report: a masthead, case histories, an editorial note and numbered references?
  • How do I cite works and build the bibliography in APA, IEEE or another citation style?
  • How do I make a table with header rows, merged cells, column widths and per-cell alignment?
  • How do I re-set an open-access paper from arXiv or PubMed Central with Postext, keeping its citations, figures and licence line?

The short answer

script.js · lines 84–104in full code
// :::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' } };

Case histories, "Reported by" and the Editorial Note as paragraph styles

Ingredients

Type
IBM Plex Serif, Libre Franklin, IBM Plex Sans Condensed (SIL OFL 1.1)
Assets
  • Figure 1, timeline of the five cases, drawn in code from the dates in the case reports (Ignacio Ferro, original)

Method

#1 · One paragraph style per voice

The code is the short answer above. A bulletin report is written in several registers: the case histories, the list of the people who reported them, the editors' comment. Wrapping each run in :::paragraphs{style="…"} gives it a look without touching the words, so the Reported by line drops to 7.8 pt condensed italics off the baseline grid while the case histories keep the body texture with their **Patient 1:** labels in the accent. The citations are written [@walzer1974]; american-medical-association with marker: 'parentheses' prints them as (1) and lists the works in citation order, the way the weekly did, numbering: 'chapter' counts each report's citations from 1, and scope: 'chapter' sets its list under it with the same numbers.

#2 · A masthead that opens the first report

script.js · lines 38–65in full code
// 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)] } };

The masthead is the design of the first report's heading style, so it prints once, on page 1, and the running heads skip that page (pages: 'body'). The kicker and the dateline come from attributes of each report's H1, and the title is {titleText}: a text element with inlineMarks: true keeps the italic genus of the heading. The July report opens with the same three elements under a double rule. Its heading style spans the page with spanBreak: false, so the heading opens where the June report ends: the columns above it end level and the text goes on in both columns below, the way the weekly ran one report on after another.

#3 · Three tables from tab-separated text

script.js · lines 439–472in full code
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' } }),
];

Each table is a content slot of tab-separated text, the format a spreadsheet copies, and parseTSV turns it into a model. A column of counts aligns right with its heading centred; four mergeCells calls build the two-row header of the notifiable diseases summary. The table type restarts its counter at every H1 (resetOn: 'h1'), so each report has its own Table 1, as in 1981.

#4 · One blue, linked everywhere

script.js · lines 17–21in full code
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' } }));

The band, the labels, the folios, the table headers and the chart all name the same palette entry, so a reader who swaps accent for a bulletin's own colour retints the six pages at once.

The whole recipe

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: [

The composed script.js runs as it is: paste it into any page’s module script, or open the recipe on CodePen. Recipe folder on GitHub ↗ (opens in a new tab)

Variations

#Superscript reference numbers

Most medical journals raise the numbers instead of setting them in parentheses.

-const citations = { style: 'american-medical-association', marker: 'parentheses',
+const citations = { style: 'american-medical-association', marker: 'superscript',

#Start each report on a new page

A reprint series that files its reports separately opens each one on a fresh page.

-    { id: 'report', span: 'page', spanBreak: false, advancedDesign: opener },
+    { id: 'report', span: 'page', advancedDesign: opener },

#Use the Vancouver list

A medical article in Vancouver style edits the bundled elsevier-vancouver style for the NLM reference form.

Pitfalls

  • Without numbering: 'chapter' the reference numbers run on through the document and scope: 'chapter' only splits the lists: the July report would cite works 4 and 6 to 23 where the weekly printed 1 to 19.
  • The 1981 note Paired specimens not run in parallel is marked with an asterisk: footnotes.numberFormat: 'symbols' sets *, †, ‡ and starts them again on every page. Of these marks only the asterisk is in the latin file of a Fontsource face (the dagger is in latin-ext, the double dagger in neither), so a page with two or three notes needs a face that has them, or symbols: ['*', '§', '¶'].
  • The 1981 wording stays as printed, terminology of the period included, and the colophon says so. A reprint corrects nothing in the text it reproduces; what the editors add (the timeline, the case table, the blue italic line under the first paragraph) is set in its own style and labelled.

Credits

Text
  • "Pneumocystis Pneumonia — Los Angeles", MMWR 1981;30(21):250–252, and "Kaposi's Sarcoma and Pneumocystis Pneumonia Among Homosexual Men — New York City and California", MMWR 1981;30(25):305–308, re-set in full from the printed issues; Table 1 of the first report and Figure 1 added by the editors from the case reports. "All material in the MMWR Series is in the public domain and may be used and reprinted without special permission; citation as to source, however, is appreciated." · Centers for Disease Control (CDC) · public domain
Images
  • Figure 1, timeline of the five cases, drawn in code from the dates in the case reports · Ignacio Ferro · original
Fonts
IBM Plex Serif (SIL OFL 1.1) · Libre Franklin (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
SandboxPDF