Em poucas palavras
Um artigo famoso de biologia, resumido e diagramado de novo como numa revista. Os Métodos vêm depois do texto principal, em letra menor, e suas referências continuam a contagem de onde o texto principal parou.
O que você vai compor
Cinco páginas de um artigo de revista de ciências da vida em A4: Highly accurate protein structure prediction with AlphaFold, de Jumper e colaboradores, resumido a partir da Nature sob licença CC BY 4.0. Uma faixa azul abre a primeira página sobre o título, os 34 autores em 7,4 pt com os números de afiliação sobrescritos e o resumo em negrito na largura da página. A figura 1 ocupa a largura da página logo abaixo: um gráfico de barras com as precisões do CASP14 que o texto cita e o esqueleto do alvo T1049 traçado a partir do PDB, com o modelo do AlphaFold desenhado dentro dele e colorido pela confiança. O texto cita com os números sobrescritos da Nature. O texto principal fecha com as referências 1–35. Os Métodos vêm em seguida, em 8,2 pt, e uma obra que eles citam pela primeira vez recebe o número seguinte, de modo que a lista deles começa em 36, como na revista.
Esta receita responde a
- Como componho a seção de Métodos de um artigo em corpo menor depois do texto principal, com as citações continuando a numeraçã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?
- Como coloco os números de citação em sobrescrito e transformo os DOIs em links, como fazem as revistas médicas?
- Como acrescento uma figura com legenda numerada e a cito no texto (“ver fig. 3.2”)?
A resposta curta
// [@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) } };
Ingredientes
- Funcionalidades
- Estilos de títuloCitações em um estilo de citaçãoBibliografia a partir das referênciasSobrescritos e subscritosAberturas desenhadasAtributos de títuloBoxesBoxes na largura da páginaCabeços e fóliosCabeços por tipo de páginaFiguras exatamente aquiEstilo de legendaLinhas de fonte e créditoEstilo de tabelaLegendas numeradasEstilos de parágrafoPaleta de cores semânticaExportação para PDFFontes incorporadas ao PDF
- Também usa
- Citações que posicionam as figurasFigura e Tabela no seu idiomaTipos de recurso personalizadosFiguras e tabelas como recursosCapítulos sem número
- Tipografia
- Noto Serif, Noto Sans (SIL OFL 1.1)
- Materiais
- 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)
Preparo
#1 · Duas listas de referências, uma só numeração
O código é a resposta curta logo acima. As citações são numeradas pela ordem da primeira citação, por isso você não precisa fazer nada para continuar a contagem: o jackhmmer, citado pela primeira vez nos Métodos, recebe o 36, enquanto o campo de força Amber, citado antes no texto principal, mantém o 30. As listas saem de :::bibliography{scope=new}, que imprime só as obras que nenhuma lista anterior imprimiu. O pen põe o mesmo bloco depois da Discussão e depois dos Métodos: o primeiro compõe de 1 a 35, o segundo de 36 a 55, e o Amber não é impresso de novo. O título dos Métodos é um título de nível 1 com estilo próprio; seu bodyStyle compõe a seção em 8,2 pt sobre 10,8 pt, breakBefore: { enabled: false } o mantém na coluna e runningChapter: false deixa nos cabeços o título do artigo. Para seu próprio artigo, cole a exportação de seu .bib num bloco :::references{format=bibtex}, cite com [@key] colado à palavra e troque nature pelo estilo de sua revista.
#2 · Um bloco de título para 34 autores
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) }),
] },
};
A lista de autores é um único atributo do título, authors="John Jumper^1,4^, Richard Evans^1,4^, …", composto em Noto Sans de 7,4 pt na medida inteira, onde os 34 nomes ocupam cinco linhas. inlineMarks eleva os números de afiliação. As afiliações e a nota de contribuição igual vão para o fim, em Author information, como a Nature as imprime, e a página de abertura guarda espaço para o resumo e a figura. Nenhum autor é omitido: o cabeço das páginas pares abrevia a lista para Jumper et al.
#3 · O resumo na largura da página e a figura 1 abaixo
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' }) }))) } } },
];
O resumo é um box com span: 'page' e sem moldura, com o texto em Noto Sans seminegrito. A figura 1 vem depois dele como ::resource{id="fig1"}, e o posicionamento, { position: 'here', span: 'page' }, a compõe sobre as duas colunas nesse ponto; as duas colunas de texto começam abaixo da legenda. A legenda abre com uma frase em negrito, como as da Nature; o captionPrefix do tipo e o labelSeparator do estilo de legenda fazem o rótulo dizer Fig. 1 |. A tabela 1 entra onde está, nos Métodos, com position: 'here', e fica na coluna.
#4 · O esqueleto de uma proteína desenhado a partir de coordenadas abertas
// 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>`;
As coordenadas foram lidas uma única vez, quando a receita foi escrita, da entrada 6Y4F do PDB (CC0) e do modelo da mesma proteína na AlphaFold Database (CC BY 4.0), sobrepostas pelos átomos Cα e giradas para os eixos principais do experimento. O pen as guarda em três arrays curtos. Cada traçado é uma cadeia de segmentos de Bézier pelas posições dos Cα, pintados do mais distante ao mais próximo com um halo da cor do papel, o que dá profundidade sem sombreamento. As cores do modelo são as faixas de pLDDT que a AlphaFold Database usa, lidas da coluna de fator B do arquivo.
#5 · Letras gregas e acentos no PDF
O Fontsource divide cada fonte por sistema de escrita. kitFonts(FONTS) lê o texto que recebe e carrega o arquivo latin-ext de cada fonte quando ela compõe Ž ou Š, e o arquivo grego quando compõe α ou χ; fontsourceProvider incorpora esses mesmos arquivos no PDF a partir dos caracteres que cada fonte compõe. Cα, χ, Žídek e Šali não pedem código próprio: a receita passa o markdown, que reúne todos os blocos de conteúdo, e o provedor do kit.
A receita completa
// ═══ 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
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
#Mantenha os Métodos no corpo do texto
Algumas revistas compõem os Métodos com a mesma letra do texto; tire o estilo de corpo da seção e mantenha o título.
- bodyStyle: { fontSize: pt(8.2), lineHeight: pt(SMALL) } };
+};#Numere entre colchetes
Algumas revistas da mesma área imprimem [1] na linha.
- style: 'nature', // raised 1–4, "Nature 577, 706–710 (2020)." entries
+ style: 'nature', marker: 'brackets',#Imprima uma só lista no fim
As revistas que imprimem todas as referências depois dos Métodos, como a Science, ficam só com o segundo bloco.
-const markdown = [/* @content */ '', references, /* @content:methods */ '', references,
+const markdown = [/* @content */ '', /* @content:methods */ '', references,#Use a lista Vancouver
Para uma revista médica, parta do estilo NLM incluído, como faz o artigo médico no estilo Vancouver.
Erros comuns
Erro comum
Os arquivos do Fontsource cobrem letras, não símbolos
O kit incorpora o arquivo latin do Fontsource de cada fonte e, quando o texto usa esses caracteres, o arquivo latin-ext para č, ł, † e o arquivo greek para α, χ (em uma família que o tenha: Lora e Gelasio não têm), na tela e no PDF. Símbolos como →, ≈, ✓ e ★ não estão em nenhum desses arquivos e somem no PDF: desenhe-os, componha-os como matemática ou escolha uma fonte cujos arquivos os tenham. Fontes incorporadas ao PDF →
- A Nature nomeia até cinco autores e corta uma lista mais longa no primeiro, seguido de et al. Onde a lista do próprio artigo faz isso, escreva
and othersna entrada BibTeX ({Senior, Andrew W. and others}) e o estilo imprime Senior, A. W. et al.; em CSL-YAML, termine a lista com"others". - O
bodyStylede um estilo de título muda o corpo e a entrelinha do texto, não a grade de linhas de base: os títulos dos Métodos usamsnapToGrid: false, senão a linha abaixo de cada um pularia para a linha seguinte da grade do texto principal.
Créditos
- Receita
- Ignacio Ferro
- Texto
- “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
- Imagens
- 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
- Fontes
- Noto Serif (SIL OFL 1.1) · Noto 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)


