باختصار
دراسة منشورة عن روبوت محادثة يقدّم تمارين علاجية، اختُصرت وأُعيد إخراجها. يُرسم مخطط من دخل التجربة ومن خرج منها من أرقامها، وتصطف الكسور العشرية في الجداول، وتتبع المراجع أسلوب APA.
ما الذي ستنضده
تجربة معشّاة محكومة في الصحة النفسية الرقمية، يُعاد إخراجها من نصها المتاح بالوصول المفتوح: تجربة Woebot المنشورة في JMIR Mental Health عام 2017، وهو وكيل محادثة يقدّم العلاج المعرفي السلوكي، مختصرةً إلى ثماني صفحات. الطراز تقرير بحثي هادئ بمقاس 210 × 280 مم، بخط Lora للنص وNunito Sans لكل اللافتات والأرقام، ولون إبراز واحد هو النيلي. في الصفحات ما يحتاجه تقرير تجربة: الملخص المنظَّم بعرض العمودين، والكلمات المفتاحية وسطر التسجيل، وتدفق المشاركين وفق CONSORT مُعادًا رسمه بالشيفرة من أرقام المقال نفسه، وجدولي نتائج تصطف كسورهما العشرية، وتضارب المصالح لدى المؤلفين كما كُتب حرفيًا، واستشهادات APA 7 بنظام المؤلف والسنة مبنية من BibTeX. يبقى النص بالإنجليزية كما نُشر.
تجيب هذه الوصفة عن
- كيف أرسم مخطط CONSORT الانسيابي وأنضّد ملخصًا مهيكلًا لتقرير تجربة سريرية؟
- كيف أصنع جدولًا فيه صفوف رأس، وخلايا مدمجة، وعروض أعمدة، ومحاذاة لكل خلية؟
- كيف أستشهد بالأعمال وأبني قائمة المراجع بأسلوب APA أو IEEE أو أسلوب استشهاد آخر؟
- كيف أعيد تنضيد ورقة بحثية مفتوحة الوصول من arXiv أو PubMed Central بـPostext، مع استشهاداتها وأشكالها وسطر ترخيصها؟
الجواب المختصر
// 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.' };
المكونات
- الميزات
- الأشكال والجداول بوصفها مواردإطارات بعرض الصفحةجداول من البياناتاستشهادات تضع الأشكالموضع الأشكالنمط التعليقسطور المصدر والحقوقأعمدة داخل الإطار أو النصإطارات متداخلةنمط الجدولالاستشهادات بأسلوب توثيققائمة المراجع من البيانات المرجعيةأنماط العناوينصفحات افتتاح مصمَّمةسمات العنوانالترويسات وأرقام الصفحاتالنص المرتفع والمنخفضأنماط الفقراتلوحة ألوان دلاليةالتصدير إلى PDF
- تستخدم أيضًا
- إطارات التنبيه«شكل» و«جدول» بلغتكالرياضياتالترويسات بحسب دور الصفحةالخطوط المضمَّنة في PDFأنواع موارد مخصّصةفصول بلا أرقاممسافة عمودية صريحة
- الخطوط
- Lora, Nunito Sans (SIL OFL 1.1)
- الأصول
- لا شيء: كل صورة مرسومة بالشيفرة
طريقة التحضير
#1 · إطار الملخص والمخطط بوصفه موردًا
الشيفرة هي الجواب المختصر أعلاه. نمط الإطار ذو span: 'page' يغلق العمودين فوقه ويفتحهما من جديد تحته، فيمكن أن يمتد الملخص بعرض الصفحة على أي ارتفاع منها. وفي داخله يوزّع :::columns{count=2} الأقسام من Background إلى Conclusions على عمودين، ثم تمتد الكلمات المفتاحية وسطر التسجيل بعرض الإطار كله. ومخطط CONSORT مورد SVG مثل أي مورد آخر: رقمه وتعليقه وملاحظة مصدره تأتي من المورد، وأول :ref له يضعه في رأس الصفحة التالية.
#2 · رأس المقال من سمات العنوان
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) }),
] } };
العنوان هو عنوان المستوى الأول الوحيد في المستند، بنمط يمتد على الصفحة ويُرسم من عناصر. وكل ما سواه يأتي من سمات العنوان: نوع المقال، والمؤلفون بعلامات انتساب ^1^ يرفعها inlineMarks، والانتسابات مفصولة بـ\n، وتاريخا الاستلام والقبول، وسطر المصدر. في مقالك تغيّر السمات وتُبقي التصميم. ويجعل numbered: false في النمط ترقيم الأشكال 1 و2 و3 بدل 1.1.
#3 · تدفق CONSORT مرسومًا من الأرقام
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>`;
}
كل صندوق استدعاء لـnode() بأسطره؛ والمراحل لافتات على الحافة اليسرى، والأسهم خط ومثلث مملوء، لأن <marker> يتحوّل إلى صورة في ملف PDF. والأرقام هي أرقام التجربة: 204 تسجيلات، و115 تأكيدًا، و45 تسجيلًا من توليد روبوتات مستبعدة، و34 و36 موزّعين، و3 و11 مفقودين، و31 و25 لديهم بيانات في T2. في تجربتك تستبدل النصوص والأعداد، ويتبع التخطيط ارتفاع الصناديق. ولا يرى نص SVG المرسوم صورةً خطوطَ الصفحة، لذا يتضمّن الرسم خط Nunito Sans مضمّنًا بعنوان بيانات (data URL).
#4 · أرقام متراصفة في الجداول
// 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) } })),
];
أرقام Nunito Sans متساوية العرض، فيصطف عمود المتوسطات المحاذاة يمينًا على الفاصلة العشرية. يوضع كل متوسط وانحرافه المعياري أو خطؤه المعياري في عمودين، المتوسط إلى اليمين والقوس إلى اليسار بجانبه، ويبني mergeCells ترويسات المجموعات («Information-only control» فوق ثلاثة أعمدة) والصفوف الممتدة عبر الجدول. الجدول 2 عنصر عائم بعرض الصفحة، ويبقى الجدول 1 في عمود.
#5 · كلمات الروبوت في إطارات متداخلة
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') } },
];
يقتبس المقال خمس رسائل أرسلها الروبوت. تجمعها الوصفة في إطار بشريط نيلي في أعلاه، وكل رسالة إطار متداخل مستدير الزوايا مع لافتة صغيرة تذكر السمة التي توضحها. لا يظهر هناك إلا ما اقتبسه المقال، دون إضافة.
الوصفة كاملة
// ═══ 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.',
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#استشهد بأرقام بأسلوب فانكوفر
كثيرًا ما ترقّم المجلات الطبية استشهاداتها؛ ولا يتغير BibTeX ولا النص.
- citations: { style: 'apa', link: true,
+ citations: { style: 'elsevier-vancouver', marker: 'superscript', link: true,#أضف رقم ClinicalTrials.gov
اعتُبرت هذه التجربة معفاة من التسجيل، ويذكر المقال ذلك. أما التجربة المسجلة فتذكر سجلها ورقمها في السطر نفسه من الإطار، مثل **Trial registration** ClinicalTrials.gov NCT01234567، برقم تسجيلك أنت.
#مخطط بلا صف التحليل
إذا لم يذكر التقرير من حُلّلت بياناتهم، فأنهِ كل فرع عند صناديق المتابعة: احذف العقدة an وسهمها، واخفض CONSORT_H.
أخطاء شائعة
خطأ شائع
لا <marker> ولا مرشِّحات في رسوم SVG (وإلا البديل النقطي)
لا يبقى شكل SVG متّجهيًا في PDF إلا إذا خلا من <marker> والمرشِّحات والأقنعة؛ وإلا عاد إلى صورة نقطية، والمرشِّحات المتداخلة بعمق قد تجعله فارغًا في Chrome. ارسم رؤوس الأسهم مسارات. الأشكال والجداول بوصفها موارد →
خطأ شائع
الرياضيات تحتاج إلى await initMathEngine() قبل البناء الأول
الصيغ التي تُنضَّد قبل أن يعمل محرّك الرياضيات مربعات رمادية نائبة. استورد initMathEngine من https://esm.sh/postext مع سائر الرموز وانتظرها بـ await قبل البناء الأول؛ والمستند الذي فيه رياضيات ويُبنى من دونها يطبع تحذيرًا واحدًا في وحدة التحكم. ومنذ postext 1.5 يأتي MathJax داخل حزمة postext وحدةً واحدة تجلبها initMathEngine، فالاستيراد العادي يعمل من CDN ولا حاجة إلى ?bundle (حتى 1.4 كان يجب أن يأتي كل رمز من https://esm.sh/postext?bundle). استورد من عنوان URL واحد فقط: عنوانان يحمّلان محرّكين. الرياضيات →
خطأ شائع
علامة $ المجرّدة تفتح الرياضيات: اكتب \$
علامة الدولار تفتح رياضيات داخل السطر، فسعرٌ مثل $40 يبدأ صيغة. اكتب \$40. الهروب والمحارف الحرفية →
خطأ شائع
العنصر العائم 'top' يذهب إلى الصفحة التالية لإحالته ما لم يُسمح له بتصدر صفحة الإحالة
افتراضيًا لا يصعد العنصر العائم أبدًا فوق الإحالة إليه، فالعنصر العائم 'top' الممتد بعرض الصفحة والمُحال إليه في الصفحة N يفتتح الصفحة N+1. اضبط placement.citingPage: true على المورد أو على defaultPlacement لنوعه (أو layout.floatsAtCitingPage للكتاب كله، منذ postext 1.25) فيتصدر الصفحة N بدلًا من ذلك، وينزل النص الذي فوق الإحالة تحته، إذا اتسع له المكان في حدود layout.maxTopFraction وبقي سطر الإحالة في تلك الصفحة. ولا يتصدر أبدًا الصفحة الأولى من فصل ولا صفحة بعد فاصل قسري: فهناك يظل يفتتح الصفحة التالية، ويمكن للموضع 'auto' أو 'bottom' أن يشغل أسفل صفحة الإحالة. موضع الأشكال →
- ليس في المقال رقم NCT: يكتب المؤلفون أن التجربة أُعفيت من التسجيل. ويذكر سطر التسجيل ذلك، مع السبب الذي يذكره المقال، بدل اختلاق رقم.
- الجدول الذي يشارك عمودًا مع شكل بعرض الصفحة يتوقف قبل أسفل العمود بثلاثة أسطر ويكمل في الصفحة التالية. يتسع الجدول 1 كاملًا لأن صفوفه بحجم 7.5 نقطة وحشوة 0.45 مم، ولأن ارتفاع رسم CONSORT هو 107 مم.
- يكتب المقال χ² لاختبارات مربع كاي، وكذلك هذه الطبعة، صيغةً رياضية مضمَّنة:
$\chi^2_1$. لا يضم أي ملف من ملفات Lora في Fontsource الحرف χ، ولا حتى ملف math الذي لا يحوي إلا حروفًا يونانية قليلة مثل π وΩ؛ فترسمه MathJax بدلًا من ذلك، مسارات في ملف PDF.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- 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
- الخطوط
- Lora (SIL OFL 1.1) · Nunito Sans (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


