Em poucas palavras
Um boletim de saúde pública de 1981, composto de novo em papel carta. Cada tipo de parágrafo (os casos, a lista dos médicos que os comunicaram, o comentário da redação) tem sua aparência, e as referências são numeradas sozinhas.
O que você vai compor
Seis páginas de um boletim epidemiológico semanal em papel carta US, que reproduzem os dois relatórios em que os Centros de Controle de Doenças (CDC) descreveram pela primeira vez o que depois ficou conhecido como aids: cinco casos de pneumonia por Pneumocystis em Los Angeles (5 de junho de 1981) e os casos de sarcoma de Kaposi que vieram em seguida (3 de julho de 1981). O cabeçalho é um desenho original no espírito de um boletim oficial da época, uma faixa azul com a marca numa sem serifa condensada sobre duas colunas de Plex Serif. Cada voz do relatório tem seu estilo: os casos sob rótulos numerados em negrito, a linha Reported by em itálico pequeno, a Editorial Note, as citações entre parênteses e uma lista numerada. O texto, as referências e as tabelas são os que o CDC imprimiu; a linha do tempo e a tabela de casos da página 2 são da edição.
Esta receita responde a
- Como faço para compor o relatório de um boletim semanal, com cabeçalho, relatos de caso, nota editorial e referências numeradas?
- Como cito obras e monto a bibliografia em APA, IEEE ou outro estilo de citação?
- Como faço uma tabela com linhas de cabeçalho, células mescladas, larguras de coluna e alinhamento por célula?
- Como recomponho com o Postext um artigo de acesso aberto do arXiv ou do PubMed Central, mantendo citações, figuras e linha de licença?
A 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' } };
Ingredientes
- Funcionalidades
- Estilos de parágrafoAberturas desenhadasBibliografia a partir das referênciasCitações em um estilo de citaçãoNotas de rodapéEstilo de tabelaTipos de recurso personalizadosEstilo de legendaPosicionamento de figurasCabeços e fóliosCabeços por tipo de páginaEstilos de títuloAtributos de títuloUma ou duas colunasFormato da páginaPaleta de cores semânticaExportação para PDF
- Também usa
- Citações que posicionam as figurasFiguras exatamente aquiFigura e Tabela no seu idiomaFontes incorporadas ao PDFFiguras e tabelas como recursosGeometria por seçãoTabelas a partir de dadosEstilos de tabela com nome
- Tipografia
- IBM Plex Serif, Libre Franklin, IBM Plex Sans Condensed (SIL OFL 1.1)
- Materiais
- Figure 1, timeline of the five cases, drawn in code from the dates in the case reports (Ignacio Ferro, original)
Preparo
#1 · Um estilo de parágrafo para cada voz
O código é a resposta curta logo acima. Um relatório de boletim é escrito em vários registros: os casos, a lista de quem os comunicou e o comentário da redação. Envolver cada trecho em :::paragraphs{style="…"} dá a ele uma aparência sem mexer nas palavras: a linha Reported by desce para 7,8 pt em itálico condensado, fora da grade de linhas de base, enquanto os casos mantêm a textura do corpo com seus rótulos **Patient 1:** na cor de destaque. As citações são escritas [@walzer1974]; american-medical-association com marker: 'parentheses' as imprime como (1) e ordena a lista pela ordem de citação, como fazia o boletim, numbering: 'chapter' conta as citações de cada relatório a partir de 1, e scope: 'chapter' põe a lista dele logo abaixo, com os mesmos números.
#2 · Um cabeçalho que abre o primeiro relatório
// 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)] } };
O cabeçalho é o design do estilo de título do primeiro relatório, por isso ele sai uma vez só, na página 1, e os cabeços pulam essa página (pages: 'body'). O antetítulo e a data vêm de atributos do H1 de cada relatório, e o título é {titleText}: um elemento de texto com inlineMarks: true mantém em itálico o gênero que aparece no título. O relatório de julho abre com os mesmos três elementos sob um fio duplo. Seu estilo de título ocupa a largura da página com spanBreak: false, de modo que ele começa onde termina o relatório de junho: as colunas de cima terminam na mesma altura e o texto continua nas duas colunas de baixo, do jeito que o boletim emendava um relatório no outro.
#3 · Três tabelas a partir de texto separado por tabulações
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 tabela é um espaço de conteúdo com texto separado por tabulações, o formato que uma planilha copia, e parseTSV o transforma em modelo. Uma coluna de números se alinha à direita com o cabeçalho centralizado; quatro chamadas a mergeCells montam o cabeçalho de duas linhas do resumo das doenças de notificação compulsória. O tipo tabela reinicia o contador a cada H1 (resetOn: 'h1'), de modo que cada relatório tem a Tabela 1, como em 1981.
#4 · Um só azul, vinculado em todo lugar
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' } }));
A faixa, os rótulos, os fólios, os cabeçalhos das tabelas e o gráfico apontam para a mesma entrada da paleta, por isso quem trocar accent pela cor de seu próprio boletim recolore as seis páginas de uma vez.
A receita 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: [
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Números de referência sobrescritos
A maioria das revistas médicas sobe os números em vez de colocá-los entre parênteses.
-const citations = { style: 'american-medical-association', marker: 'parentheses',
+const citations = { style: 'american-medical-association', marker: 'superscript',#Cada relatório em página nova
Uma série de reimpressões que arquiva os relatórios separadamente abre cada um numa página nova.
- { id: 'report', span: 'page', spanBreak: false, advancedDesign: opener },
+ { id: 'report', span: 'page', advancedDesign: opener },#Use a lista Vancouver
Um artigo médico no estilo Vancouver ajusta o estilo elsevier-vancouver que acompanha o motor para seguir a forma de referência da NLM.
Erros comuns
- Sem
numbering: 'chapter', os números das referências continuam pelo documento inteiro escope: 'chapter'só separa as listas: o relatório de julho citaria as obras 4 e de 6 a 23, onde o boletim imprimiu de 1 a 19. - A nota de 1981 Paired specimens not run in parallel é chamada por um asterisco:
footnotes.numberFormat: 'symbols'usa *, †, ‡ e recomeça a cada página. Dessas marcas, só o asterisco está no arquivo latin de uma fonte do Fontsource (a adaga está no latin-ext e a adaga dupla em nenhum dos dois), por isso uma página com duas ou três notas precisa de uma fonte que as tenha, ou desymbols: ['*', '§', '¶']. - O texto de 1981 fica como foi impresso, com a terminologia da época, e o colofão avisa isso. Uma reimpressão não corrige o texto que reproduz; o que a edição acrescenta (a linha do tempo, a tabela de casos, a linha em itálico azul sob o primeiro parágrafo) vai num estilo próprio e identificado.
Créditos
- Receita
- Ignacio Ferro
- Texto
- "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) · domínio público
- Imagens
- Figure 1, timeline of the five cases, drawn in code from the dates in the case reports · Ignacio Ferro · original
- Fontes
- 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 o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


