En poques paraules
Un butlletí de salut pública de 1981, compost de nou en paper carta. Cada tipus de paràgraf (els casos, la llista de metges que els van comunicar, el comentari de la redacció) té el seu aspecte, i les referències es numeren soles.
Què compondràs
Sis pàgines d'un butlletí epidemiològic setmanal en mida carta US, que reprodueixen els dos informes en què els Centres per al Control de Malalties (CDC) van descriure per primera vegada el que després es va dir sida: cinc casos de pneumònia per Pneumocystis a Los Angeles (5 de juny de 1981) i els casos de sarcoma de Kaposi que van venir després (3 de juliol de 1981). La capçalera és un disseny propi a l'estil d'un butlletí oficial de l'època: una banda blava amb la marca en una sans condensada sobre dues columnes de Plex Serif. Cada veu de l'informe té el seu estil: els casos sota etiquetes numerades en negreta, la línia Reported by en cursiva petita, l'Editorial Note, les cites entre parèntesis i una llista numerada. El text, les referències i les taules són els que van imprimir els CDC; la cronologia i la taula de casos de la pàgina 2 són de l'edició.
Aquesta recepta respon a
- Com componc l'informe d'un butlletí setmanal: la capçalera, els casos clínics, una nota editorial i les referències numerades?
- Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?
- Com faig una taula amb files de capçalera, cel·les combinades, amplades de columna i alineació per cel·la?
- Com torno a compondre amb Postext un article d'accés obert d'arXiv o PubMed Central, amb les seves cites, les seves figures i la seva línia de llicència?
La resposta curta
// :::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' } };
Ingredients
- Funcions
- Estils de paràgrafObertures dissenyadesBibliografia a partir de les referènciesCites en un estil de citaNotes a peu de pàginaEstil de taulesTipus de recurs propisEstil dels peusCol·locació de figuresCapçaleres i folisCapçaleres segons el tipus de pàginaEstils de títolAtributs de títolUna o dues columnesFormat de pàginaPaleta de color semànticaExportació a PDF
- També fa servir
- Cites que col·loquen les figuresFigures just aquíFigura i Taula en la teva llenguaFonts incrustades al PDFFigures i taules com a recursosGeometria per seccióTaules a partir de dadesEstils de taula amb nom
- Tipografia
- IBM Plex Serif, Libre Franklin, IBM Plex Sans Condensed (SIL OFL 1.1)
- Recursos
- Figure 1, timeline of the five cases, drawn in code from the dates in the case reports (Ignacio Ferro, original)
Elaboració
#1 · Un estil de paràgraf per a cada veu
El codi és la resposta curta de dalt. Un informe de butlletí s'escriu en diversos registres: els casos, la llista de qui els va comunicar i el comentari de la redacció. Embolcallar cada tram en :::paragraphs{style="…"} li dona el seu aspecte sense tocar les paraules: la línia Reported by baixa a 7,8 pt en cursiva condensada, fora de la reixeta base, mentre els casos conserven la textura del cos amb les etiquetes **Patient 1:** en el color d'accent. Les cites s'escriuen [@walzer1974]; american-medical-association amb marker: 'parentheses' les imprimeix com (1) i ordena la llista per ordre de cita, com feia el butlletí, numbering: 'chapter' compta les cites de cada informe des de l'1, i scope: 'chapter' posa la seva llista a sota amb els mateixos números.
#2 · Una capçalera que obre 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 capçalera és el disseny de l'estil d'encapçalament del primer informe, així que s'imprimeix una sola vegada, a la pàgina 1, i les capçaleres de pàgina se la salten (pages: 'body'). L'avanttítol i la data surten d'atributs de l'H1 de cada informe, i el títol és {titleText}: un element de text amb inlineMarks: true conserva el gènere en cursiva del títol. L'informe de juliol s'obre amb aquests tres elements sota un filet doble. El seu estil d'encapçalament ocupa tota la pàgina amb spanBreak: false, així que comença on acaba l'informe de juny: les columnes de sobre acaben a la mateixa altura i el text continua a sota a totes dues, com el butlletí encadenava un informe rere l'altre.
#3 · Tres taules a partir de text amb tabuladors
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 taula és una ranura de contingut amb text separat per tabuladors, el format que copia un full de càlcul, i parseTSV la converteix en un model. Una columna de xifres s'alinea a la dreta amb la capçalera centrada; quatre crides a mergeCells formen la capçalera de dues files del resum de malalties de declaració obligatòria. El tipus taula reinicia el comptador a cada H1 (resetOn: 'h1'), de manera que cada informe té la seva Taula 1, com el 1981.
#4 · Un sol blau, enllaçat a tot arreu
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, les etiquetes, els folis, les capçaleres de taula i el gràfic fan referència a la mateixa entrada de la paleta: qui canviï accent pel color del seu butlletí recoloreja les sis pàgines alhora.
La recepta 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: [
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
#Números de referència volats
Gairebé totes les revistes mèdiques pugen els números en lloc de posar-los entre parèntesis.
-const citations = { style: 'american-medical-association', marker: 'parentheses',
+const citations = { style: 'american-medical-association', marker: 'superscript',#Cada informe en pàgina nova
Una sèrie de reimpressions que arxiva els informes per separat obre cadascun en pàgina nova.
- { id: 'report', span: 'page', spanBreak: false, advancedDesign: opener },
+ { id: 'report', span: 'page', advancedDesign: opener },#La llista a la manera de Vancouver
Un article mèdic en estil Vancouver retoca l'estil elsevier-vancouver inclòs per seguir la forma de referència de la NLM.
Errors freqüents
- Sense
numbering: 'chapter'els números de referència continuen per tot el document iscope: 'chapter'només separa les llistes: l'informe de juliol citaria les obres 4 i de 6 a 23, on el butlletí va imprimir de l'1 al 19. - La nota de 1981 Paired specimens not run in parallel es crida amb un asterisc:
footnotes.numberFormat: 'symbols'posa *, †, ‡ i torna a començar a cada pàgina. D'aquestes marques, només l'asterisc és a l'arxiu latin d'una font de Fontsource (la creu és a latin-ext i la doble creu a cap), així que una pàgina amb dues o tres notes necessita una font que les tingui, osymbols: ['*', '§', '¶']. - El text de 1981 queda com es va imprimir, amb la terminologia de l'època, i el colofó ho diu. Una reimpressió no corregeix el text que reprodueix; el que afegeix l'edició (la cronologia, la taula de casos, la línia en cursiva blava sota el primer paràgraf) va en el seu propi estil i retolat.
Crèdits
- Recepta
- Ignacio Ferro
- 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) · domini públic
- Imatges
- 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)
- 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)


