In short
A famous biology paper, shortened and laid out again as a journal article. The Methods follow the main text in smaller type, and their references keep counting from where the main text stopped.
What you'll build
Five pages of a life-science journal article on A4: Jumper et al.'s Highly accurate protein structure prediction with AlphaFold, abridged from Nature under CC BY 4.0. A blue band opens the first page over the title, all 34 authors in 7.4 pt with raised affiliation numbers, and the summary set bold across the page. Fig. 1 spans the page under it: a bar chart of the CASP14 accuracies the text quotes, and the backbone of target T1049 traced from the PDB with the AlphaFold model drawn inside it, coloured by confidence. The text cites with Nature's raised numbers. The main text closes on references 1–35. The Methods follow in 8.2 pt, and a work they cite for the first time takes the next number, so their own list starts at 36, as in the journal.
This recipe answers
- How do I set a journal article's Methods section in smaller type after the main text, with its citations continuing the numbering?
- How do I re-set an open-access paper from arXiv or PubMed Central with Postext, keeping its citations, figures and licence line?
- How do I set citation numbers as superscripts and make DOIs live links, as medical journals do?
- How do I add a figure with a numbered caption and cite it in the text ("see Fig. 3.2")?
The short answer
// [@key] prints a raised number in order of first citation, so a work the Methods cite for
// the first time takes the next number after the main text's last, and one cited again
// keeps its number. Nature prints two lists, and :::bibliography{scope=new} lists only the
// works no earlier list printed: the same block after the main text and after the Methods
// sets references 1–35, then 36–55.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'nature', // raised 1–4, "Nature 577, 706–710 (2020)." entries
bibliography: { fontSize: em(0.8), lineHeight: pt(9.6), entrySpacing: pt(0.8),
labelWidth: mm(5), labelAlign: 'right' }, // 9. and 10. end together
};
const references = '### References\n\n:::bibliography{title="" scope=new}';
// "# Methods {style=\"methods\"}" opens a section that runs to the end of the article: an H1
// that breaks nothing, names no running chapter and sets its body two sizes down.
const methods = { id: 'methods', numbered: false, runningChapter: false,
breakBefore: { enabled: false }, fontFamily: SANS, fontSize: pt(11.5), lineHeight: pt(LEAD),
fontWeight: 700, color: col('ink'), marginTop: pt(LEAD), marginBottom: pt(LEAD / 2),
bodyStyle: { fontSize: pt(8.2), lineHeight: pt(SMALL) } };
Methods in smaller type, with a second reference list that numbers on
Ingredients
- Features
- Heading stylesCitations in a citation styleBibliography from the referencesSuperscripts and subscriptsDesigned openersHeading attributesCallout boxesBoxes across the pageRunning heads and foliosHeads by page roleFigures exactly hereCaption styleSource and credit linesTable styleNumbered captionsParagraph stylesSemantic colour palettePDF exportFonts embedded in the PDF
- Also uses
- Citations that place figuresFigure and Table in your languageCustom resource typesFigures and tables as resourcesUnnumbered chapters
- Type
- Noto Serif, Noto Sans (SIL OFL 1.1)
- Assets
- Fig. 1b, experimental Cα coordinates of PDB 6Y4F (Jiang et al. 2020), drawn in code (Worldwide Protein Data Bank, CC0 1.0)
- Fig. 1b, AlphaFold DB model AF-B4EUK6-F1 (AlphaFold Monomer v2.0) and its pLDDT, superposed and drawn in code (DeepMind Technologies Limited and EMBL-EBI, AlphaFold Protein Structure Database, CC BY 4.0)
Method
#1 · Two reference lists, one numbering
The code is the short answer above. Citations take their numbers in order of first citation, so you do nothing to continue the count: jackhmmer, first cited in the Methods, gets 36, while the Amber force field, cited earlier in the main text, keeps its 30. The lists come from :::bibliography{scope=new}, which prints only the works no earlier list has printed. The pen puts the same block after the Discussion and after the Methods: the first sets 1–35, the second 36–55, and Amber is not printed again. The Methods heading is a level-1 heading with a style of its own; its bodyStyle sets the section in 8.2 pt on 10.8 pt, breakBefore: { enabled: false } keeps it in the column, and runningChapter: false keeps the running heads on the article's title. For your own paper, paste your .bib export into a :::references{format=bibtex} block, cite with [@key] straight after the word, and change nature to your journal's style.
#2 · A title block for 34 authors
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: 600, letterSpacing: pt(1.4),
textTransform: 'uppercase' };
const titleBlock = { enabled: true,
minHeight: mm(50),
slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('accent') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: mm(14) } } },
text('kicker', '{attr.kicker}', SANS, 8.5, { ...caps, color: col('paper'),
placement: at('page', 'top-left', INNER, 5.6, 120) }),
text('title', '{titleText}', SANS, 23, { fontWeight: 700, lineHeight: 1.12,
placement: at('container', 'top-left', 0, 1, MEASURE - 30) }),
text('authors', '{attr.authors}', SANS, 7.4, { inlineMarks: true, lineHeight: 1.42,
placement: at('#title', 'below', 0, 4, MEASURE) }),
{ kind: 'rule', id: 'rule', thickness: pt(0.5), color: col('rule'),
placement: at('#authors', 'below', 0, 3, MEASURE) },
text('source', '{attr.source}', SANS, 7, { color: col('muted'),
placement: at('#rule', 'below', 0, 1.6, MEASURE) }),
] },
};
The author list is one heading attribute, authors="John Jumper^1,4^, Richard Evans^1,4^, …", set in Noto Sans at 7.4 pt across the full measure, where 34 names take five lines. inlineMarks raises the affiliation numbers. The affiliations and the equal-contribution note go to the end, under Author information, as Nature prints them, so the opening page keeps room for the summary and the figure. No author is dropped: the running head on the versos shortens the list to Jumper et al.
#3 · The summary across the page, Fig. 1 under it
const resources = () => [
{ id: 'fig1', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
placement: { position: 'here', span: 'page' },
svg: { fileId: 'fig1.svg', width: 1780, height: 640 },
caption: '**AlphaFold produces highly accurate structures.** **a**, Median accuracy on the '
+ 'CASP14 domains of AlphaFold and of the next best method, as r.m.s.d.~95~ over Cα atoms '
+ '(backbone) and over all atoms, with 95% confidence intervals; the dashed line is the '
+ 'width of a carbon atom, about 1.4 Å. **b**, CASP14 target T1049 (PDB 6Y4F): the '
+ 'experimental Cα trace (grey) and the AlphaFold model of the same chain, coloured by '
+ 'its per-residue confidence (pLDDT).',
note: 'Redrawn for this edition. a, from the values given in the text (the original plots '
+ 'the top 15 of 146 entries). b, from PDB 6Y4F (CC0) and AlphaFold DB model '
+ 'AF-B4EUK6-F1, AlphaFold Monomer v2.0 (CC BY 4.0), superposed on 134 Cα atoms; the '
+ 'original shows the CASP14 prediction.',
altText: 'Bars: AlphaFold 0.96 and 1.5 Å, next best 2.8 and 3.5 Å. Two backbones that '
+ 'lie almost on top of each other.' },
{ id: 'tbl-timings', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
placement: { position: 'here' },
caption: '**Inference times.** One model on one V100 GPU, by protein length.',
note: 'Compiled for this edition from the timings given in ‘Inference regimen’.',
table: { model: { headerRowCount: 1, columnWidths: [1, 1.3, 1.3], rows: [
['Residues', 'With ensembling (CASP14)', 'Without ensembling'],
['256', '4.8 min', '0.6 min'], ['384', '9.2 min', '1.1 min'],
['2,500', '18 h', '2.1 h'],
].map((row, r) => row.map((content, c) => ({ content, ...(r === 0 && { isHeader: true }),
...(c > 0 && { align: 'right' }) }))) } } },
];
The summary is a box with span: 'page' and no frame, its text in Noto Sans semibold. Fig. 1 follows it as ::resource{id="fig1"}, and its placement, { position: 'here', span: 'page' }, sets it across both columns at that point; the two columns of text start under its caption. The caption begins with a bold sentence, as Nature's legends do; the type's captionPrefix and the caption style's labelSeparator make the label read Fig. 1 |. Table 1 is embedded where it stands in the Methods with position: 'here' and keeps to its column.
#4 · A protein backbone drawn from open coordinates
// PDB 6Y4F chain A, residues 25–158: Cα x, y in tenths of Å, depth z in Å (CC0)
const EXP = [
-56,-91,-6,-36,-77,-3,-4,-98,-2,26,-81,-1,63,-86,-1,95,-73,1,116,-100,2,146,
-79,3,159,-46,2,187,-34,4,209,-6,3,211,10,0,187,17,-3,182,53,-2,185,46,2,
167,14,3,148,-4,6,122,-28,4,109,-58,6,76,-67,4,45,-89,4,11,-79,3,-2,-114,
3,-37,-116,1,-64,-95,0,-87,-117,-2,-124,-110,-2,-135,-80,-5,-161,-95,-7,-158,
-74,-10,-173,-41,-9,-141,-20,-9,-148,15,-8,-128,31,-5,-105,55,-7,-106,82,-4,
-144,80,-3,-156,116,-3,-122,132,-2,-126,155,1,-102,131,3,-88,98,2,-68,72,4,
-58,37,3,-23,33,4,6,10,5,32,28,2,59,21,0,68,31,-4,89,62,-3,96,70,-7,102,
52,-10,65,59,-11,53,41,-8,39,71,-6,38,70,-2,64,79,0,59,86,4,33,60,5,42,
36,8,7,42,9,-29,48,8,-55,21,9,-88,39,8,-105,69,6,-122,57,3,-134,87,1,-170,
78,2,-167,42,1,-180,38,-3,-165,5,-4,-132,-13,-3,-150,-42,-2,-161,-18,1,-125,
-6,1,-114,-43,2,-141,-49,4,-129,-20,6,-92,-30,6,-98,-66,7,-120,-57,10,-94,
-33,11,-62,-52,11,-54,-89,11,-36,-104,8,-8,-109,7,3,-73,8,40,-75,9,67,-51,
10,93,-26,9,92,8,7,119,30,5,128,47,2,151,77,2,149,93,-2,152,82,-5,173,52,
-6,150,22,-6,162,-13,-8,144,-44,-6,119,-43,-9,109,-8,-8,106,-15,-4,72,-24,
-3,53,-20,0,15,-23,0,-19,-8,1,-20,28,-1,-48,53,-1,-38,89,0,-52,122,1,-25,
128,3,-19,107,7,18,115,7,47,129,5,57,121,1,26,112,-1,28,122,-4,-9,117,-5,
-8,83,-3,-9,51,-5,-13,14,-5,-49,3,-4,-61,-14,-8,-50,-50,-8,-19,-46,-6,8,
-72,-7,43,-65,-6,67,-94,-5,43,-121,-6,32,-148,-3,-6,-157,-3,-17,-192,-4,-23,
-216,-1,
];
// AlphaFold DB AF-B4EUK6-F1, the same residues superposed on 6Y4F (CC BY 4.0)
const MODEL = [
-57,-93,-6,-37,-77,-3,-5,-98,-2,25,-82,-1,63,-87,-1,94,-74,1,112,-103,3,144,
-84,3,158,-50,2,189,-34,4,209,-2,3,212,16,0,187,21,-3,181,57,-2,181,48,2,
166,13,2,148,-4,5,122,-29,4,110,-58,6,76,-66,4,46,-88,4,12,-79,3,0,-115,3,
-37,-113,2,-64,-95,0,-87,-118,-2,-125,-110,-2,-136,-81,-4,-162,-95,-7,-155,
-74,-10,-173,-42,-9,-141,-22,-9,-146,14,-8,-126,31,-5,-102,55,-7,-106,83,-4,
-143,81,-4,-156,117,-3,-122,132,-2,-123,157,1,-101,132,3,-86,98,2,-68,72,4,
-58,36,3,-22,32,4,7,8,4,32,26,2,61,20,0,67,31,-4,89,62,-3,95,73,-7,100,
56,-10,64,67,-11,52,44,-8,40,74,-6,38,68,-2,65,77,0,59,84,4,35,56,5,45,
30,8,10,37,9,-25,47,8,-54,21,9,-86,40,8,-105,69,6,-120,56,3,-132,87,1,
-169,78,2,-166,42,0,-177,37,-3,-163,3,-4,-130,-15,-3,-150,-42,-2,-162,-17,1,
-125,-5,1,-114,-42,2,-142,-47,5,-129,-15,7,-93,-28,6,-103,-62,8,-122,-46,11,
-90,-26,12,-62,-52,11,-59,-89,10,-37,-104,7,-8,-110,7,3,-74,8,40,-74,9,66,
-48,10,95,-26,9,95,7,7,124,30,6,127,45,2,147,78,2,145,92,-1,153,87,-5,172,
54,-6,147,26,-7,158,-6,-8,145,-39,-7,117,-42,-10,105,-7,-8,106,-14,-5,72,
-24,-3,54,-21,0,16,-25,0,-18,-8,0,-19,27,-1,-48,52,-1,-37,88,0,-51,122,1,
-26,127,4,-23,104,7,15,108,7,45,124,5,57,120,2,26,111,-1,31,123,-4,-7,116,
-5,-5,83,-3,-8,51,-5,-12,14,-5,-48,2,-5,-62,-14,-8,-53,-52,-8,-20,-47,-6,5,
-74,-7,39,-66,-5,64,-95,-5,99,-89,-7,117,-72,-4,146,-94,-2,178,-75,-3,190,
-46,-1,
];
// The model's per-residue pLDDT, read from its B-factor column
const PLDDT = [
87,89,87,87,83,87,82,84,85,84,82,79,81,86,90,89,93,93,94,95,92,95,87,90,
93,87,89,88,82,75,87,92,97,98,98,98,98,98,98,98,98,99,99,99,99,99,98,96,
94,93,90,84,87,89,95,95,96,97,98,98,98,98,98,98,99,99,99,98,98,98,98,97,
97,98,98,98,98,98,98,97,98,98,96,95,89,96,97,96,96,96,96,94,93,91,88,86,
82,73,67,61,61,69,83,89,96,97,98,99,99,98,98,97,96,97,96,96,95,95,96,97,
97,96,97,94,87,90,84,82,69,65,64,61,55,53,
];
const n2 = (v) => +v.toFixed(2);
// The figure names Noto Sans on its root; loadSvg embeds the faces its labels set
// (inlineSvgFonts), so the canvas and the PDF draw them in the page's own sans.
const label = (x, y, s, size = 2.5, extra = '') => { // ink unless extra sets a fill
const fill = extra.includes('fill') ? '' : `fill="${palette.ink}" `;
return `<text x="${n2(x)}" y="${n2(y)}" font-size="${size}" ${fill}${extra}>${s}</text>`;
};
// a: median r.m.s.d.95 with its 95% interval, as the text gives them
const ACCURACY = [
{ group: 'Backbone', af: [0.96, 0.85, 1.16], next: [2.8, 2.7, 4.0] },
{ group: 'All-atom', af: [1.5, 1.2, 1.6], next: [3.5, 3.1, 4.2] },
];
function bars() {
const [L, B, T, H] = [9, 54, 8, 4.5]; // axis left, baseline, top, Å at the top
const y = (v) => B - (v / H) * (B - T);
let s = label(0, 3.2, 'a', 3.6, 'font-weight="700"');
for (const v of [0, 1, 2, 3, 4]) {
s += `<path d="M${L} ${n2(y(v))}H58" stroke="${palette.rule}" stroke-width="0.15"/>`
+ label(L - 1.5, y(v) + 0.9, v, 2.5, 'text-anchor="end"');
}
s += label(1.6, 31, 'r.m.s.d.<tspan font-size="1.8" dy="0.6">95</tspan><tspan dy="-0.6"> (Å)'
+ '</tspan>', 2.5, 'text-anchor="middle" transform="rotate(-90 1.6 31)"');
ACCURACY.forEach(({ group, af, next }, g) => {
const x0 = L + 4 + g * 24;
[[af, palette.accent], [next, palette.rule]].forEach(([[m, lo, hi], fill], k) => {
const x = x0 + k * 10;
s += `<rect x="${x}" y="${n2(y(m))}" width="8" height="${n2(B - y(m))}" fill="${fill}"/>`
+ `<path d="M${x + 4} ${n2(y(lo))}V${n2(y(hi))}M${x + 2.6} ${n2(y(lo))}h2.8M${x + 2.6} `
+ `${n2(y(hi))}h2.8" stroke="${palette.ink}" stroke-width="0.3" fill="none"/>`
+ label(x + 4, B - 1.4, m.toFixed(m < 1 ? 2 : 1), 2.3, // inside the bar's foot
`text-anchor="middle" fill="${k ? palette.ink : palette.paper}"`);
});
s += label(x0 + 9, B + 4, group, 2.6, 'text-anchor="middle"');
});
let dash = '';
for (let x = L; x < 57; x += 2.4) dash += `M${n2(x)} ${n2(y(1.4))}h1.4`;
s += `<path d="${dash}" stroke="${palette.ink}" stroke-width="0.3"/>`
+ `<path d="M${L} ${B}H58" stroke="${palette.ink}" stroke-width="0.35"/>`
+ `<rect x="${L + 2}" y="59.3" width="2.6" height="2.6" fill="${palette.accent}"/>`
+ label(L + 5.5, 61.6, 'AlphaFold') + `<rect x="${L + 22}" y="59.3" width="2.6" `
+ `height="2.6" fill="${palette.rule}"/>` + label(L + 25.5, 61.6, 'Next best method');
return s;
}
// b: both chains as smooth Cα traces, far segments first
const BANDS = [[90, '#0053d6', 'pLDDT > 90'], [70, '#65cbf3', 'pLDDT 70–90'],
[50, '#ffdb13', 'pLDDT 50–70'], [0, '#ff7d45', 'pLDDT < 50']];
const band = (p) => BANDS.find(([min]) => p > min);
function trace(xyz, cx, cy, k) {
const pt = (i) => [cx + xyz[3 * i] * k, cy - xyz[3 * i + 1] * k, xyz[3 * i + 2]];
const n = xyz.length / 3;
return Array.from({ length: n - 1 }, (_, i) => {
const [p0, p1, p2, p3] = [pt(Math.max(i - 1, 0)), pt(i), pt(i + 1), pt(Math.min(i + 2, n - 1))];
const c1 = [0, 1].map((a) => p1[a] + (p2[a] - p0[a]) / 6);
const c2 = [0, 1].map((a) => p2[a] - (p3[a] - p1[a]) / 6);
return { i, z: (p1[2] + p2[2]) / 2, d: `M${n2(p1[0])} ${n2(p1[1])}C${n2(c1[0])} `
+ `${n2(c1[1])} ${n2(c2[0])} ${n2(c2[1])} ${n2(p2[0])} ${n2(p2[1])}` };
});
}
function backbone() {
const [cx, cy, k] = [103, 32, 0.142]; // mm per tenth of an Å
const exp = trace(EXP, cx, cy, k);
const model = trace(MODEL, cx, cy, k);
const width = (z) => 1 + z / 40;
let s = label(66, 3.2, 'b', 3.6, 'font-weight="700"');
// the experiment as a grey band, then the model on top of it: where they agree, the model's
// colour runs inside the band
for (const [segs, halo, wide, colour] of [[exp, 2.4, 1.6, () => palette.rule],
[model, 1.3, 0.75, (i) => band(Math.min(PLDDT[i], PLDDT[i + 1]))[1]]]) {
for (const { i, z, d } of [...segs].sort((a, b) => a.z - b.z)) {
const w = width(z);
s += `<path d="${d}" stroke="${palette.paper}" stroke-width="${n2(w * halo)}" `
+ `fill="none"/><path d="${d}" stroke="${colour(i)}" ` // a butt halo: no notch at joins
+ `stroke-width="${n2(w * wide)}" fill="none" stroke-linecap="round"/>`;
}
}
const legend = [[palette.rule, 'Experiment (PDB 6Y4F)'], ...BANDS.slice(0, 3)
.map(([, c, t]) => [c, `Model: ${t}`])];
legend.forEach(([c, t], j) => {
s += `<path d="M138 ${44 + j * 4.6}h5" stroke="${c}" stroke-width="${j ? 1 : 1.6}" `
+ 'stroke-linecap="round"/>' + label(145, 44.9 + j * 4.6, t, 2.4);
});
return s + label(138, 39, 'T1049 · residues 25–158', 2.5, 'font-weight="700"');
}
const figure1 = () => '<svg xmlns="http://www.w3.org/2000/svg" width="1780" height="640" '
+ `viewBox="0 0 178 64" font-family="${SANS}">${bars()}${backbone()}</svg>`;
The coordinates were read once, when the recipe was written, from PDB entry 6Y4F (CC0) and from the AlphaFold Database model of the same protein (CC BY 4.0), superposed on their Cα atoms and turned onto the principal axes of the experiment. The pen keeps them as three short arrays. Each trace is a chain of Bézier segments through the Cα positions, painted from the farthest to the nearest with a paper halo, which gives depth without shading. The model's colours are the pLDDT bands the AlphaFold Database uses, read from the B-factor column of its file.
#5 · Greek letters and accents in the PDF
Fontsource splits each face by script. kitFonts(FONTS) reads the text it is given and loads each face's latin-ext file when it sets Ž or Š and its greek file when it sets α or χ; fontsourceProvider embeds the same files in the PDF from the characters each face sets. Cα, χ, Žídek and Šali take no code of their own: the recipe passes the markdown, which holds every content slot, and the kit's provider.
The whole recipe
// ═══ Postext Cookbook · Nº 139 · A protein paper with a Methods section ════════════
// https://postext.dev/en/cookbook/protein-paper-methods-section
// Code: MIT · Text: Jumper et al. 2021, abridged (CC BY 4.0) · Figures: drawn in code
// Fonts: Noto Serif, Noto Sans (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerCitationEngine, registerResourceImage,
defaultResourceTypes, 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 = 'protein-paper-methods-section';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: near-black text and one deep blue, the blue of confident pLDDT
const palette = { ink: '#161b22', accent: '#0b4ea2', tint: '#e9eff8', rule: '#b3bdcb',
muted: '#59636f', 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] = ['Noto Serif', 'Noto Sans'];
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER, GUTTER] = [210, 297, 22, 22, 18, 16, 6];
const MEASURE = TRIM_W - INNER - OUTER;
const LEAD = 12.6; // pt: 9.3 pt type in two columns of 85 mm
const SMALL = 10.8; // pt: the Methods, at 8.2 pt
// #region answer: Methods in smaller type, with a second reference list that numbers on
// [@key] prints a raised number in order of first citation, so a work the Methods cite for
// the first time takes the next number after the main text's last, and one cited again
// keeps its number. Nature prints two lists, and :::bibliography{scope=new} lists only the
// works no earlier list printed: the same block after the main text and after the Methods
// sets references 1–35, then 36–55.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'nature', // raised 1–4, "Nature 577, 706–710 (2020)." entries
bibliography: { fontSize: em(0.8), lineHeight: pt(9.6), entrySpacing: pt(0.8),
labelWidth: mm(5), labelAlign: 'right' }, // 9. and 10. end together
};
const references = '### References\n\n:::bibliography{title="" scope=new}';
// "# Methods {style=\"methods\"}" opens a section that runs to the end of the article: an H1
// that breaks nothing, names no running chapter and sets its body two sizes down.
const methods = { id: 'methods', numbered: false, runningChapter: false,
breakBefore: { enabled: false }, fontFamily: SANS, fontSize: pt(11.5), lineHeight: pt(LEAD),
fontWeight: 700, color: col('ink'), marginTop: pt(LEAD), marginBottom: pt(LEAD / 2),
bodyStyle: { fontSize: pt(8.2), lineHeight: pt(SMALL) } };
// #endregion
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
#Keep the Methods at the text size
Some journals set the Methods in the same type as the text; drop the section's body style and keep the heading.
- bodyStyle: { fontSize: pt(8.2), lineHeight: pt(SMALL) } };
+};#Number in brackets
Some journals in the same field print [1] on the line.
- style: 'nature', // raised 1–4, "Nature 577, 706–710 (2020)." entries
+ style: 'nature', marker: 'brackets',#Print one list at the end
Journals that print every reference after the Methods, as Science does, keep only the second block.
-const markdown = [/* @content */ '', references, /* @content:methods */ '', references,
+const markdown = [/* @content */ '', /* @content:methods */ '', references,#Use the Vancouver list
For a medical journal, start from the bundled NLM style, as the medical article in Vancouver style does.
Pitfalls
Pitfall
Fontsource files cover letters, not symbols
The kit embeds a face's Fontsource latin file, plus its latin-ext file for č, ł, † and its greek file for α, χ (in a family that ships one: Lora and Gelasio do not), when the text sets them, on screen and in the PDF. Symbols such as →, ≈, ✓ and ★ are in none of those files and go missing in the PDF: draw them, set them as maths, or choose a face whose files hold them. Fonts embedded in the PDF →
- Nature names up to five authors and cuts a longer list to the first, followed by et al. Where the paper's own list does that, write
and othersin the BibTeX entry ({Senior, Andrew W. and others}) and the style prints Senior, A. W. et al.; in CSL-YAML, end the list with"others". - A heading style's
bodyStylechanges the text's size and leading, not the baseline grid: the Methods headings usesnapToGrid: false, or the line under each one would jump to the next line of the main text's grid.
Credits
- Recipe
- Ignacio Ferro
- Text
- “Highly accurate protein structure prediction with AlphaFold”, Nature 596, 583–589 (2021), doi:10.1038/s41586-021-03819-2, PMC8371605, abridged (the sections ‘Interpreting the neural network’ and ‘Related work’, the description of Fig. 2, parts of other sections and of the Methods, the Supplementary information and the peer review note cut; pointers to omitted figures removed; references renumbered by first citation); Fig. 1 redrawn in code (panels c–e omitted), Figs. 2–5 omitted; Table 1 compiled from the Methods text · John Jumper, Richard Evans, Alexander Pritzel, Tim Green, Michael Figurnov, Olaf Ronneberger, Kathryn Tunyasuvunakool, Russ Bates, Augustin Žídek, Anna Potapenko, Alex Bridgland, Clemens Meyer, Simon A. A. Kohl, Andrew J. Ballard, Andrew Cowie, Bernardino Romera-Paredes, Stanislav Nikolov, Rishub Jain, Jonas Adler, Trevor Back, Stig Petersen, David Reiman, Ellen Clancy, Michal Zielinski, Martin Steinegger, Michalina Pacholska, Tamas Berghammer, Sebastian Bodenstein, David Silver, Oriol Vinyals, Andrew W. Senior, Koray Kavukcuoglu, Pushmeet Kohli, Demis Hassabis · CC BY 4.0
- Images
- Fig. 1b, experimental Cα coordinates of PDB 6Y4F (Jiang et al. 2020), drawn in code · Worldwide Protein Data Bank · CC0 1.0
- Fig. 1b, AlphaFold DB model AF-B4EUK6-F1 (AlphaFold Monomer v2.0) and its pLDDT, superposed and drawn in code · DeepMind Technologies Limited and EMBL-EBI, AlphaFold Protein Structure Database · CC BY 4.0
- Fonts
- Noto Serif (SIL OFL 1.1) · Noto Sans (SIL OFL 1.1)
Edit this write-up ↗ (opens in a new tab)Recipe folder on GitHub ↗ (opens in a new tab)


