Em poucas palavras
Um estudo publicado sobre um chatbot que propõe exercícios de terapia, encurtado e diagramado de novo. O fluxograma de quem entrou e saiu do ensaio sai dos próprios números, as tabelas alinham os decimais e as referências seguem a APA.
O que você vai compor
Um ensaio clínico randomizado de saúde mental digital, composto de novo a partir do texto em acesso aberto: o ensaio do Woebot publicado na JMIR Mental Health em 2017, um agente conversacional que aplica terapia cognitivo-comportamental, resumido a oito páginas. O estilo da casa é o de um relatório de pesquisa sóbrio em 210 × 280 mm, com Lora para o texto, Nunito Sans para todos os rótulos e números e um único acento de cor, o índigo. As páginas trazem o que um relatório de ensaio precisa: o resumo estruturado na largura das duas colunas, palavras-chave e uma linha de registro, o fluxo de participantes CONSORT redesenhado em código com os números do próprio artigo, duas tabelas de resultados com os decimais alinhados, o conflito de interesses dos autores mantido palavra por palavra e citações autor-data APA 7 geradas a partir de BibTeX.
Esta receita responde a
- Como faço para desenhar um fluxograma CONSORT e compor um resumo estruturado para o relatório de um ensaio clínico?
- Como faço uma tabela com linhas de cabeçalho, células mescladas, larguras de coluna e alinhamento por célula?
- Como cito obras e monto a bibliografia em APA, IEEE ou outro estilo de citação?
- 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
// The abstract is a box whose span is 'page': the columns close above it and open again
// under it. Inside, :::columns sets Background to Results in two columns; the keywords and
// the registration line run across the box under them.
const abstractBox = { id: 'abstract', span: 'page', background: col('tint'),
padding: { top: mm(3.5), right: mm(4.5), bottom: mm(3), left: mm(4.5) },
marginTop: pt(0), marginBottom: pt(LEAD), columnGap: mm(7),
titleStyle: { fontFamily: SANS, fontSize: pt(8.5), fontWeight: 800, letterSpacing: pt(1.6),
textTransform: 'uppercase', color: col('accent'), gap: mm(2) },
body: { fontFamily: SANS, fontSize: pt(8.4), lineHeight: pt(11.4), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: true, boldColor: col('accent'),
boldFontWeight: 800, italicColor: col('ink') } };
// The CONSORT diagram is an SVG drawn in code from the trial's numbers (see #region art),
// declared as a resource and placed by its first :ref, at the head of the next page.
const consort = { id: 'fig-consort', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
placement: { position: 'top', span: 'page' },
svg: { fileId: 'consort.svg', width: 1760, height: CONSORT_H * 10 },
caption: 'Participant flow through the trial (CONSORT diagram).',
note: 'Redrawn from Figure 1 of the original; the Analysis row follows the Statistical '
+ 'Analysis section. The text reports 58 participants with T2 data.',
altText: 'Flow chart: 204 registrations, 115 confirmed, 45 excluded as bot-generated, 70 '
+ 'randomized; 34 to Woebot (3 lost, 31 with T2 data) and 36 to the information-only '
+ 'control (11 lost, 25 with T2 data); 34 and 36 analysed.' };
Ingredientes
- Funcionalidades
- Figuras e tabelas como recursosBoxes na largura da páginaTabelas a partir de dadosCitações que posicionam as figurasPosicionamento de figurasEstilo de legendaLinhas de fonte e créditoColunas num boxe ou no textoBoxes aninhadosEstilo de tabelaCitações em um estilo de citaçãoBibliografia a partir das referênciasEstilos de títuloAberturas desenhadasAtributos de títuloCabeços e fóliosSobrescritos e subscritosEstilos de parágrafoPaleta de cores semânticaExportação para PDF
- Também usa
- BoxesFigura e Tabela no seu idiomaMatemáticaCabeços por tipo de páginaFontes incorporadas ao PDFTipos de recurso personalizadosCapítulos sem númeroEspaço vertical explícito
- Tipografia
- Lora, Nunito Sans (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · O boxe do resumo e o diagrama como recurso
O código é a resposta curta lá em cima. Um estilo de boxe com span: 'page' fecha as duas colunas acima dele e as abre de novo embaixo, de modo que o resumo pode ficar na largura da página em qualquer altura. Dentro dele, :::columns{count=2} compõe de Background a Conclusions em duas colunas, e as palavras-chave e a linha de registro vêm depois, na largura inteira do boxe. O diagrama CONSORT é um recurso SVG como outro qualquer: o número, a legenda e a nota de crédito vêm do recurso, e o primeiro :ref o põe no alto da página seguinte.
#2 · O cabeçalho do artigo a partir dos atributos do título
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 = { fontFamily: SANS, fontWeight: 800, letterSpacing: pt(1.5),
textTransform: 'uppercase' };
const titleBlock = { enabled: true, minHeight: mm(70), slot: { elements: [
{ kind: 'rule', id: 'bar', thickness: pt(2.5), color: col('accent'),
placement: at('container', 'top-left', 0, 0, MEASURE) },
text('kind', '{attr.kind}', SANS, 8, { ...caps, color: col('accent'),
placement: at('#bar', 'below', 0, 3, MEASURE) }),
text('title', '{titleText}', SERIF, 18.5, { fontWeight: 700, lineHeight: 1.17,
placement: at('#kind', 'below', 0, 3.5, MEASURE - 8) }),
text('authors', '{attr.authors}', SANS, 10, { fontWeight: 700, inlineMarks: true,
placement: at('#title', 'below', 0, 4.5, MEASURE) }),
text('affiliations', '{attr.affiliations}', SANS, 7.4, { inlineMarks: true, lineHeight: 1.4,
color: col('muted'), placement: at('#authors', 'below', 0, 1.8, MEASURE) }),
{ kind: 'rule', id: 'hair', thickness: pt(0.5), color: col('rule'),
placement: at('#affiliations', 'below', 0, 2.6, MEASURE) },
text('history', '{attr.history}', SANS, 7.2, { color: col('muted'),
placement: at('#hair', 'below', 0, 1.6, MEASURE) }),
text('source', '{attr.source}', SANS, 7.2, { fontWeight: 700, color: col('accent'),
placement: at('#history', 'below', 0, 0.8, MEASURE) }),
] } };
O título é o único título de nível 1 do documento, com um estilo que ocupa a página e o desenha com elementos. Todo o resto do cabeçalho vem de atributos do título: o tipo de artigo, os autores com marcas de afiliação ^1^ que inlineMarks sobe, as afiliações separadas por \n, as datas de recebimento e aceite e a linha de procedência. Para seu artigo, você troca os atributos e mantém o design. numbered: false no estilo deixa as figuras como Figura 1, 2, 3 em vez de 1.1.
#3 · O fluxo CONSORT, desenhado a partir dos números
const n2 = (v) => +v.toFixed(2);
const esc = (s) => s.replace(/&/g, '&').replace(/</g, '<');
// The labels' family, named on the root element: loadSvg embeds its faces.
const LABELS = `font-family="${SANS}"`;
const label = (x, y, s, size, weight, fill, anchor = 'middle') => `<text x="${n2(x)}" `
+ `y="${n2(y)}" font-size="${size}" font-weight="${weight}" fill="${fill}" `
+ `text-anchor="${anchor}">${esc(s)}</text>`;
// A box of centred lines: the first bold, "n = …" bold in the accent (white on a
// filled box), the rest regular.
function node(cx, y, w, lines, { size = 2.6, fill = palette.tint, stroke = palette.accent } = {}) {
const lh = size * 1.3;
const h = lines.length * lh + 2.2;
const solid = fill === palette.accent;
let svg = `<rect x="${n2(cx - w / 2)}" y="${n2(y)}" width="${w}" height="${n2(h)}" rx="1.2" `
+ `fill="${fill}" stroke="${stroke}" stroke-width="0.3"/>`;
lines.forEach((s, i) => {
const isN = /^n = /.test(s);
svg += label(cx, y + 1.1 + lh * (i + 0.78), s, size, i === 0 || isN ? 800 : 400,
solid ? palette.paper : isN ? palette.accent : palette.ink);
});
return { svg, h, top: y, bottom: y + h, mid: y + h / 2 };
}
// Arrows are a line plus a filled triangle path: no <marker> (gotcha: svg-no-marker-filters).
const line = (pts) => `<path d="M${pts.map(([x, y]) => `${n2(x)} ${n2(y)}`).join('L')}" `
+ `fill="none" stroke="${palette.ink}" stroke-width="0.3"/>`;
function arrow(pts) {
const [[x0, y0], [x1, y1]] = pts.slice(-2);
const a = Math.atan2(y1 - y0, x1 - x0);
const p = (d, s) => `${n2(x1 - Math.cos(a) * d + Math.sin(a) * s)} `
+ `${n2(y1 - Math.sin(a) * d - Math.cos(a) * s)}`;
return line([...pts.slice(0, -1), [x1 - Math.cos(a) * 1.4, y1 - Math.sin(a) * 1.4]])
+ `<path d="M${n2(x1)} ${n2(y1)}L${p(1.8, 0.9)}L${p(1.8, -0.9)}Z" fill="${palette.ink}"/>`;
}
// The four CONSORT stages as pills at the left edge, each centred on a y.
const stage = (y, s) => `<rect x="0" y="${n2(y - 2.2)}" width="${n2(s.length * 1.9 + 5)}" `
+ `height="4.4" rx="2.2" fill="${palette.ink}"/>`
+ label(2.5, y + 0.85, s.toUpperCase(), 2.3, 800, palette.paper, 'start');
function consortSvg(face) { // 176 mm wide, the full measure; one unit is a millimetre
const [W, L, R, MID] = [176, 59, 117, 88];
const side = { size: 2.5, fill: palette.paper, stroke: palette.rule };
const a = node(MID, 0.5, 64, ['Registrations received by email', 'n = 204']);
const b = node(MID, a.bottom + 3, 64, ['Responded to the email confirmation', 'n = 115']);
const x = node(150, b.bottom + 0.5, 52, ['Excluded as ineligible', 'n = 45',
'deemed bot-generated'], side);
const c = node(MID, x.bottom + 2, 64, ['Randomized by computer algorithm', 'n = 70'],
{ fill: palette.accent });
const split = c.bottom + 4; // the line that divides the sample between the arms
const parts = [a.svg, b.svg, x.svg, c.svg, stage(a.mid, 'Enrollment'),
arrow([[MID, a.bottom], [MID, b.top]]), arrow([[MID, b.bottom], [MID, c.top]]),
arrow([[MID, x.mid], [124, x.mid]]), stage(split, 'Allocation'),
line([[MID, c.bottom], [MID, split]]), line([[L, split], [R, split]])];
const arms = [[L, 13, 'Allocated to Woebot', 34, 'up to 20 sessions over 2 weeks', 3, 31],
[R, 163, 'Allocated to information-only control', 36, 'NIMH ebook on depression', 11, 25]];
for (const [cx, sx, title, n, what, gone, kept] of arms) {
const box = node(cx, split + 3.5, 56, [title, `n = ${n}`, what]);
const lost = node(sx, box.bottom + 4.5, 26, ['Lost to follow-up', `n = ${gone}`], side);
const t2 = node(cx, lost.bottom + 2, 56, ['Provided data at T2', `n = ${kept}`]);
const an = node(cx, t2.bottom + 5.5, 56, ['Analysed (intention to treat)', `n = ${n}`,
'missing T2 data imputed'], { fill: palette.accent });
parts.push(box.svg, lost.svg, t2.svg, an.svg, arrow([[cx, split], [cx, box.top]]),
arrow([[cx, box.bottom], [cx, t2.top]]), arrow([[cx, lost.mid], [sx + (sx < MID ? 13
: -13), lost.mid]]), arrow([[cx, t2.bottom], [cx, an.top]]));
if (cx === R) parts.push(stage(lost.top - 3, 'Follow-up'), stage(t2.bottom + 2.75, 'Analysis'));
}
return `<svg xmlns="http://www.w3.org/2000/svg" width="1760" height="${CONSORT_H * 10}" `
+ `viewBox="0 0 ${W} ${CONSORT_H}" ${face}>${parts.join('')}</svg>`;
}
// The thematic maps (Figs 3, 4) as bars.
const THEMES = [
{ id: 'fig-best', file: 'best.svg', themes: [['Process', 31, [['Checking in / accountability', 9],
['Empathy / personality', 7], ['Learning', 12, [['Emotions', 5], ['General insight', 5],
['Cognitions', 2]]], ['Conversation', 3]]], ['Content', 16, [['Videos', 7], ['Games', 3],
['Suggestions', 2], ['Weekly graphs', 1]]]],
caption: 'Best features of the Woebot experience: themes of the answers to “What was the best '
+ 'thing about your experience using Woebot?”',
note: 'Number of participants per theme. Redrawn as bars from the thematic map in Figure 3 of '
+ 'the original; numbers as printed there.',
alt: 'Bars for Process (31): checking in 9, empathy 7, learning 12 (emotions 5, general '
+ 'insight 5, cognitions 2), conversation 3; Content (16): videos 7, games 3, suggestions 2, '
+ 'weekly graphs 1.' },
{ id: 'fig-worst', file: 'worst.svg', themes: [['Process violations', 15,
[['Not being able to converse naturally', 10], ['Repetitive', 2], ['Miscellaneous', 3]]],
['Technical problems', 8, [['Glitches', 4], ['Looping', 4]]], ['Content', 8,
[['Emoticons', 2], ['Interactions too short', 2], ['Videos too long', 2], ['Other', 2]]]],
caption: 'Least favored experiences: themes of the answers to “What was the worst thing about '
+ 'your experience of using Woebot?”',
note: 'Number of participants per theme. Redrawn as bars from the thematic map in Figure 4 of '
+ 'the original; numbers as printed there.',
alt: 'Bars for Process violations (15): not conversing naturally 10, repetitive 2, '
+ 'miscellaneous 3; Technical problems (8): glitches 4, looping 4; Content (8): emoticons, '
+ 'short interactions, long videos and other, 2 each.' },
];
const rows = (themes) => themes.flatMap(([name, n, subs]) => [{ name, n, depth: 0 },
...subs.flatMap(([s, k, deeper = []]) => [{ name: s, n: k, depth: 1 },
...deeper.map(([d, m]) => ({ name: d, n: m, depth: 2 }))])]);
const ROW = 4.4;
function themeHeight(id) { return rows(THEMES.find((f) => f.id === id).themes).length * ROW + 2; }
function themeSvg({ id, themes }, face) { // 84.5 mm wide: one column
const [W, X0, X1] = [84.5, 48, 79];
const H = themeHeight(id);
let svg = '';
rows(themes).forEach(({ name, n, depth }, i) => {
const y = 1 + i * ROW;
if (!depth) {
svg += `<path d="M0 ${n2(y + 0.2)}H${W}" stroke="${palette.rule}" stroke-width="0.25"/>`
+ label(0, y + 3.1, `${name} (${n})`, 2.75, 800, palette.ink, 'start');
return;
}
const w = (n / 12) * (X1 - X0);
svg += label(depth * 3 - 1, y + 3, name, 2.45, 400, palette.ink, 'start')
+ `<rect x="${X0}" y="${n2(y + 0.9)}" width="${n2(w)}" height="2.6" `
+ `fill="${depth === 1 ? palette.accent : palette.soft}"/>`
+ label(X0 + w + 1.2, y + 3, String(n), 2.55, 800, palette.ink, 'start');
});
return `<svg xmlns="http://www.w3.org/2000/svg" width="845" height="${Math.round(H * 10)}" `
+ `viewBox="0 0 ${W} ${n2(H)}" ${face}>${svg}</svg>`;
}
Cada caixa é uma chamada a node() com as linhas; as fases são pílulas na borda esquerda, e as setas são uma linha e um triângulo preenchido, porque <marker> vira imagem no PDF. Os números são os do ensaio: 204 inscrições, 115 confirmações, 45 cadastros gerados por bots excluídos, 34 e 36 alocados, 3 e 11 perdidos, 31 e 25 com dados em T2. Para seu ensaio, troque os textos e as contagens; a diagramação acompanha a altura das caixas. O texto de um SVG desenhado como imagem não enxerga as fontes da página, por isso o desenho leva a Nunito Sans incorporada como URL de dados.
#4 · Números alinhados nas tabelas
// Nunito Sans sets tabular figures, so numbers right-aligned in a column line up on the
// decimal point; the (SD) or (SE) sits in a column of its own, flush left beside it.
// aligns: one letter per column, l or r; header cells over the numbers are centred.
const cell = (content, align, head) => ({ content, ...(head && { isHeader: true }),
align: head && align !== 'left' ? 'center' : align });
function grid(rows, widths, aligns, heads, spans) { // spans: [row, col, lastRow, lastCol]
const a = [...aligns].map((k, c) => (c && k === 'r' ? 'right' : 'left'));
let m = { headerRowCount: heads, columnWidths: widths,
rows: rows.map((row, r) => widths.map((_, c) => cell(row[c] ?? '', a[c], r < heads))) };
for (const [r0, c0, r1, c1] of spans) {
m = mergeCells(m, { start: { row: r0, col: c0 }, end: { row: r1, col: c1 } });
}
return m; // mergeCells marks the covered cells hiddenBy (gotcha: merged-cells-hiddenby)
}
const pair = (s) => s.split(' '); // '13.25 (5.17)' → ['13.25', '(5.17)']
const BASE = [['Depression (PHQ-9)', '13.25 (5.17)', '14.30 (6.65)'],
['Anxiety (GAD-7)', '19.02 (4.27)', '18.05 (5.89)'],
['Positive affect', '26.19 (8.37)', '25.54 (9.58)'],
['Negative affect', '28.74 (8.92)', '24.87 (8.13)'], ['Age, mean (SD)', '21.83 (2.24)',
'22.58 (2.38)'], ['**Gender, n (%)**'], ['Male', '4 (7)', '7 (21)'],
['Female', '20 (55)', '27 (79)'], ['**Ethnicity, n (%)**'], ['Latino/Hispanic', '2 (8)', '2 (6)'],
['Non-Latino/Hispanic', '22 (92)', '32 (94)'], ['Caucasian', '18 (75)', '28 (82)'],
['Non-Caucasian', '6 (25)', '6 (18)']];
const ITT = [['PHQ-9', '13.67 (.81)', '12.07-15.27', '11.14 (0.71)', '9.74-12.32', '6.03',
'.017', '0.44'], ['GAD-7', '16.84 (.67)', '15.52-18.56', '17.35 (0.60)', '16.16-18.13', '0.38',
'.581', '0.14'], ['PANAS positive affect', '26.02 (1.45)', '23.17-28.86', '26.88 (1.29)',
'24.35-29.41', '0.17', '.707', '0.02'], ['PANAS negative affect', '27.53 (1.42)',
'24.73-30.32', '25.98 (1.24)', '23.54-28.42', '0.91', '.912', '0.344']];
const table = (id, model, span, caption, note) => ({ id, typeId: 'table', kind: 'table',
createdAt: 0, updatedAt: 0, placement: { position: 'top', span }, caption, note,
table: { model } });
const baseline = grid([['', 'Information control', '', 'Woebot', ''],
['**Scale, mean (SD)**'], ...BASE.map(([k, a, b]) => (a ? [k, ...pair(a), ...pair(b)] : [k]))],
[26, 13, 10, 13, 10], 'lrlrl', 1, [[0, 1, 0, 2], [0, 3, 0, 4], [1, 0, 1, 4], [7, 0, 7, 4],
[10, 0, 10, 4]]);
const itt = grid([['', 'Information-only control', '', '', 'Woebot', '', '', '*F*', '*P*',
'*d*^c^'], ['', 'T2^a^', '', '95% CI^b^', 'T2^a^', '', '95% CI^b^', '', '', ''],
...ITT.map(([k, a, ca, b, cb, ...s]) => [k, ...pair(a), ca, ...pair(b), cb, ...s])],
[30, 10, 9, 18, 10, 9, 18, 8, 8, 8], 'lrlrrlrrrr', 2, [[0, 0, 1, 0], [0, 1, 0, 3],
[0, 4, 0, 6], [1, 1, 1, 2], [1, 4, 1, 5], [0, 7, 1, 7], [0, 8, 1, 8], [0, 9, 1, 9]]);
const resources = () => [consort,
table('tbl-baseline', baseline, 'column', 'Demographic and clinical variables of '
+ 'participants at baseline.', 'Participants with data at T2 (N=58), as printed in the '
+ 'original Table 1.'),
table('tbl-itt', itt, 'page', 'Results of ITT analysis of entire sample on primary outcomes '
+ 'in the study at T2.', '^a^Baseline=pooled mean (standard error). ^b^95% confidence '
+ 'interval. ^c^Cohen *d* shown for between-subjects effects using means and standard '
+ 'errors at Time 2.'),
...THEMES.map(({ id, file, caption, note, alt }) => ({ id, typeId: 'figure', kind: 'svg',
createdAt: 0, updatedAt: 0, placement: { position: 'auto' }, caption, note, altText: alt,
svg: { fileId: file, width: 845, height: Math.round(themeHeight(id) * 10) } })),
];
A Nunito Sans compõe os algarismos com uma largura só, por isso uma coluna de médias alinhadas à direita fica alinhada no separador decimal. Cada média e o DP ou EP vão em duas colunas, a média alinhada à direita e o parêntese alinhado à esquerda, ao lado dela, e mergeCells monta os cabeçalhos de grupo (“Information-only control” sobre três colunas) e as linhas que atravessam a tabela. A Tabela 2 é um flutuante na largura da página; a Tabela 1 fica numa coluna.
#5 · As palavras do bot em boxes aninhados
const bubbleTitle = { fontFamily: SANS, fontSize: pt(6.6), fontWeight: 800, letterSpacing: pt(1),
textTransform: 'uppercase', color: col('muted'), gap: mm(0.8) };
const calloutStyles = [
abstractBox,
{ id: 'chat', backgroundEnabled: false, marginTop: pt(LEAD), marginBottom: pt(0),
padding: { top: mm(2.5), right: mm(0), bottom: mm(0.5), left: mm(0) },
stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('accent') },
titleStyle: { ...bubbleTitle, fontSize: pt(7.6), color: col('accent'), gap: mm(2) } },
{ id: 'bubble', background: col('tint'), borderRadius: mm(2.4), marginTop: mm(1.6),
marginBottom: mm(0), padding: { top: mm(1.6), right: mm(3), bottom: mm(1.8), left: mm(3) },
titleStyle: bubbleTitle,
body: { fontFamily: SANS, fontSize: pt(8.8), lineHeight: pt(11.4), textAlign: 'left',
firstLineIndent: pt(0), color: col('ink') } },
];
O artigo cita cinco mensagens que o bot enviou. A receita as reúne num boxe com uma faixa índigo no alto, cada uma num boxe aninhado de cantos arredondados, com um rótulo pequeno que nomeia o recurso que ela ilustra. Ali só aparecem as citações do artigo; nada é acrescentado a elas.
A receita completa
// ═══ Postext Cookbook · Nº 142 · A clinical trial report with a CONSORT diagram ══════
// https://postext.dev/en/cookbook/clinical-trial-consort-flow
// Code: MIT · Text: Fitzpatrick, Darcy & Vierhile 2017 (CC BY 4.0), abridged · Figures: code
// Fonts: Lora, Nunito Sans (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerCitationEngine, registerResourceImage,
defaultResourceTypes, mergeCells, initMathEngine, 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 = 'clinical-trial-consort-flow';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a violet-tinted ink and one indigo accent; the control arm in a pale tint
const palette = { ink: '#1f1d2b', accent: '#4a3f8c', soft: '#a39cd0', tint: '#efedf7',
rule: '#c7c2de', muted: '#5b586b', 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 [SERIF, SANS] = ['Lora', 'Nunito Sans'];
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER, GUTTER] = [210, 280, 22, 22, 18, 16, 7];
const MEASURE = TRIM_W - INNER - OUTER; // 176 mm
const LEAD = 13; // pt: 9.4 pt Lora in two columns of 84.5 mm
const CONSORT_H = 107; // mm: the height of the CONSORT drawing (its resource is × 10 px)
// #region answer: a structured abstract across both columns, and a figure drawn from numbers
// The abstract is a box whose span is 'page': the columns close above it and open again
// under it. Inside, :::columns sets Background to Results in two columns; the keywords and
// the registration line run across the box under them.
const abstractBox = { id: 'abstract', span: 'page', background: col('tint'),
padding: { top: mm(3.5), right: mm(4.5), bottom: mm(3), left: mm(4.5) },
marginTop: pt(0), marginBottom: pt(LEAD), columnGap: mm(7),
titleStyle: { fontFamily: SANS, fontSize: pt(8.5), fontWeight: 800, letterSpacing: pt(1.6),
textTransform: 'uppercase', color: col('accent'), gap: mm(2) },
body: { fontFamily: SANS, fontSize: pt(8.4), lineHeight: pt(11.4), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: true, boldColor: col('accent'),
boldFontWeight: 800, italicColor: col('ink') } };
// The CONSORT diagram is an SVG drawn in code from the trial's numbers (see #region art),
// declared as a resource and placed by its first :ref, at the head of the next page.
const consort = { id: 'fig-consort', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
placement: { position: 'top', span: 'page' },
svg: { fileId: 'consort.svg', width: 1760, height: CONSORT_H * 10 },
caption: 'Participant flow through the trial (CONSORT diagram).',
note: 'Redrawn from Figure 1 of the original; the Analysis row follows the Statistical '
+ 'Analysis section. The text reports 58 participants with T2 data.',
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
#Citar no estilo numérico Vancouver
As revistas médicas costumam numerar as citações; o BibTeX e o texto continuam iguais.
- citations: { style: 'apa', link: true,
+ citations: { style: 'elsevier-vancouver', marker: 'superscript', link: true,#Acrescentar um número do ClinicalTrials.gov
Este ensaio foi considerado isento de registro e diz isso. Um ensaio registrado dá o registro e o número na mesma linha do boxe do resumo, por exemplo **Trial registration** ClinicalTrials.gov NCT01234567, com o número de seu próprio registro.
#Um diagrama sem a linha de análise
Quando um relatório não diz quem foi analisado, termine cada braço nas caixas de seguimento: tire o nó an e a seta, e diminua CONSORT_H.
Erros comuns
Erro comum
Sem <marker> nem filtros na arte SVG (vira bitmap)
Uma figura SVG só continua vetorial no PDF sem <marker>, filtros e máscaras; caso contrário, é rasterizada, e filtros muito aninhados podem deixá-la em branco no Chrome. Desenhe as pontas de seta como caminhos (paths). Figuras e tabelas como recursos →
Erro comum
Matemática precisa de await initMathEngine() antes da primeira composição
Fórmulas diagramadas antes de o motor de matemática estar rodando saem como caixas cinza no lugar da fórmula. Importe initMathEngine de https://esm.sh/postext com os outros símbolos e aguarde-o com await antes da primeira composição; um documento com matemática composto sem ele imprime um aviso no console. Desde o postext 1.5, o MathJax vem dentro do pacote postext como um único módulo que initMathEngine baixa, então a importação simples funciona a partir de uma CDN e ?bundle não é necessário (até a 1.4, todos os símbolos tinham de vir de https://esm.sh/postext?bundle). Importe de uma única URL: duas URLs carregam dois motores. Matemática →
Erro comum
Um $ solto abre matemática: escreva \$
O cifrão abre matemática em linha, então um preço como $40 inicia uma fórmula. Escreva \$40. Escapes e caracteres literais →
Erro comum
Um flutuante 'top' vai para a página seguinte à sua citação, a menos que possa encabeçar a página que o cita
Por padrão um flutuante nunca fica acima da própria referência, então um flutuante 'top' na largura da página citado na página N abre a página N+1. Com placement.citingPage: true no recurso ou no defaultPlacement do seu tipo (ou layout.floatsAtCitingPage para o livro todo, desde o postext 1.25) ele encabeça a página N, e o texto acima da referência desce para baixo dele, quando cabe dentro de layout.maxTopFraction e a linha que o cita continua nessa página. Nunca encabeça a primeira página de um capítulo nem uma página depois de uma quebra forçada: ali continua abrindo a página seguinte, e 'auto' ou 'bottom' podem ocupar o pé da página que o cita. Posicionamento de figuras →
- O artigo não tem número NCT: os autores escrevem que o ensaio foi isento de registro. A linha de registro diz isso, citando o motivo dado no artigo, em vez de inventar um número.
- Uma tabela que divide a coluna com uma figura na largura da página para três linhas antes do pé e continua na página seguinte. A Tabela 1 cabe inteira porque as linhas são compostas a 7,5 pt com 0,45 mm de preenchimento e o desenho CONSORT tem 107 mm de altura.
- O artigo escreve χ² nos testes de qui-quadrado, e esta edição também, como matemática em linha:
$\chi^2_1$. Nenhum dos arquivos da Lora na Fontsource tem o χ, nem mesmo o arquivo math, que só traz algumas letras gregas como π e Ω; quem desenha o χ é o MathJax, como traçados no PDF.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Text and data: Fitzpatrick KK, Darcy A, Vierhile M. Delivering Cognitive Behavior Therapy to Young Adults With Symptoms of Depression and Anxiety Using a Fully Automated Conversational Agent (Woebot): A Randomized Controlled Trial. JMIR Mental Health 2017;4(2):e19, doi:10.2196/mental.7785. Originally published in JMIR Mental Health (http://mental.jmir.org), 06.06.2017. Abridged; figures redrawn in code from the article's numbers; citations converted to APA author–date · © Kathleen Kara Fitzpatrick, Alison Darcy, Molly Vierhile · CC BY 4.0
- Fontes
- Lora (SIL OFL 1.1) · Nunito Sans (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)


