Em poucas palavras
A carta de 2016 que anunciou as primeiras ondas gravitacionais, resumida e composta de novo em papel carta. O sinal dos dois detectores, desenhado com os dados públicos, cruza a página 1; as referências vão numeradas entre colchetes.
O que você vai compor
Cinco páginas da carta que anunciou as primeiras ondas gravitacionais, Observation of Gravitational Waves from a Binary Black Hole Merger (Abbott et al., 2016), resumida e recomposta em papel carta US, em duas colunas. A página 1 abre com a evidência: a deformação registrada em Hanford e Livingston, redesenhada a partir dos arquivos de dados abertos do Gravitational Wave Open Science Center, atravessa as duas colunas sob o título. Abaixo vêm a autoria da colaboração com a nota, o resumo na largura da página e o texto, com as citações numeradas [1,2] e [25–27] como as revistas da APS as imprimem. A massa de chirp é a equação (1). A Tabela I compõe os erros assimétricos como sobrescrito e subscrito empilhados, escritos como fórmulas nas células, e as legendas imprimem as fórmulas da própria carta. Traga seu BibTeX e seus arquivos de dados, e o mesmo script compõe sua carta.
Esta receita responde a
- Como componho um artigo curto de física (letter): a assinatura de uma colaboração, o resumo sobre as duas colunas e uma figura de dados no alto, em toda a largura?
- Como decido onde vai uma figura: no alto da página, sobre as duas colunas, exatamente aqui ou na margem?
- Como componho matemática (em linha, em destaque, equações) e a mantenho vetorial no PDF?
- 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
// [@key] numbers works by first citation. APS journals print [1,2] and [2–4] in one pair of
// brackets and list "A. Einstein, Sitzungsber. K. Preuss. Akad. Wiss. 1, 688 (1916).": no
// title, volume bold. No APS style is bundled: four edits turn the IEEE file into one.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const ARTICLE = '<group delimiter=" "><text variable="container-title"/><text '
+ 'variable="volume" font-weight="bold" suffix=","/><text variable="page"/><date '
+ 'variable="issued" prefix="(" suffix=")"><date-part name="year"/></date></group>';
const BOOK = '<group delimiter=" "><group delimiter=", "><choose><if type="chapter"><text '
+ 'variable="container-title" prefix="in " font-style="italic"/></if><else><text variable='
+ '"title" font-style="italic"/></else></choose><names variable="editor" prefix="edited by ">'
+ '<name and="text" initialize-with=". "/></names><text variable="collection-title"/><text '
+ 'variable="volume" prefix="Vol. "/></group><group prefix="(" suffix=")" delimiter=", ">'
+ '<text variable="publisher"/><text variable="publisher-place"/><date variable="issued">'
+ '<date-part name="year"/></date></group></group><text variable="page" prefix="pp. "/>';
const aps = STYLES.ieee
.replace('<citation>', '<citation collapse="citation-number">') // [2–4], not [2], [3], [4]
.replace(/<layout delimiter=", ">\s*<group prefix="\[" suffix="\]" delimiter=", ">/,
'<layout prefix="[" suffix="]" delimiter=","><group delimiter=", ">') // [1,2]
.replace('et-al-min="7"', 'et-al-min="11"') // ten authors are listed, as in the letter
.replace(/<bibliography[\s\S]*<\/bibliography>/, '<bibliography second-field-align="flush">'
+ '<layout suffix="."><text variable="citation-number" prefix="[" suffix="]"/><text '
+ 'macro="author"/><choose><if type="manuscript"><text variable="note" prefix=" "/></if>'
+ `<else><group prefix=", " delimiter=", "><choose><if type="article-journal">${ARTICLE}`
+ `</if><else-if type="book chapter" match="any">${BOOK}</else-if><else><text variable=`
+ '"URL"/><text variable="note"/></else></choose></group></else></choose></layout>'
+ '</bibliography>');
const citations = { style: 'custom', customStyle: aps, link: true,
bibliography: { fontSize: em(0.84), lineHeight: pt(9.5), entrySpacing: pt(0.4),
labelWidth: mm(6.2) } }; // the [64] column: turnovers line up after the widest label
Ingredientes
- Funcionalidades
- Figuras exatamente aquiPosicionamento de figurasCitações em um estilo de citaçãoMatemáticaTabelas a partir de dadosLegendas numeradasTipos de recurso personalizadosEstilo de legendaLinhas de fonte e créditoNotas de rodapéBoxes na largura da páginaBoxesEstilos de títuloTítulos numeradosAtributos de títuloAberturas desenhadasCabeços e fóliosBibliografia a partir das referênciasEstilos de parágrafoExportação para PDF
- Também usa
- Citações que posicionam as figurasFigura e Tabela no seu idiomaCabeços por tipo de páginaFontes incorporadas ao PDFFiguras e tabelas como recursosSobrescritos e subscritosQuebras de linha nos títulosCapítulos sem númeroEspaço vertical explícito
- Tipografia
- Gelasio, Albert Sans (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Citações numeradas de física a partir do arquivo IEEE
O código é a resposta curta logo acima. O postext-citeproc não traz um estilo APS, e o estilo ieee que o acompanha é o mais próximo: ordem de citação, números entre colchetes, iniciais antes do sobrenome. Quatro substituições de texto em STYLES.ieee cobrem a diferença. collapse="citation-number" junta as sequências ([25–27]), um único par de colchetes no layout imprime [1,2], et-al-min sobe para onze para que uma lista de dez autores saia inteira, e um bloco <bibliography> novo imprime a referência como a Physical Review faz, com a revista, o volume em negrito, a página e o ano: Phys. Rev. Lett. 74, 3515 (1995). As 43 obras vêm num bloco :::references{format=bibtex} próprio; um nome entre chaves duplas como {{J. Aasi et al.}} sai impresso tal como foi escrito, e é assim que a carta cita as longas listas de autores da própria colaboração. Veja Citações e bibliografia.
#2 · A Figura 1 sob o título, na largura das duas colunas
const text = (id, content, family, size, extra) => ({ kind: 'text', id, content, align: 'left',
fontFamily: family, fontSize: pt(size), color: col('ink'), overflow: 'wrap', ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
...(width && { size: { width: mm(width), height: 'auto' } }) });
const caps = (size) => ({ fontWeight: 700, letterSpacing: pt(size * 0.2),
textTransform: 'uppercase', color: col('accent') });
const letter = { id: 'letter', numbered: false, span: 'page', marginBottom: pt(0),
advancedDesign: { enabled: true, minHeight: mm(21), slot: { elements: [
text('kicker', '{attr.kicker}', SANS, 7.5, { ...caps(7.5),
placement: at('container', 'top-left', 0, 2, MEASURE) }),
text('title', '{titleText}', SANS, 23, { fontWeight: 700, lineHeight: 1.08,
placement: at('#kicker', 'below', 0, 2.2, MEASURE) }),
] } } };
const box = { padding: { top: mm(2.6), right: mm(12), bottom: mm(2.4), left: mm(12) },
background: col('tint'), marginTop: pt(0), marginBottom: pt(LEAD), span: 'page',
body: { fontSize: pt(9.3), lineHeight: pt(12.6), firstLineIndent: pt(0) } };
// ::resource{id="fig1"} right under the title, placed { position: 'here', span: 'page' }:
// it spans both columns on page 1, where a float could only follow its citation.
const paragraphStyles = [
{ id: 'byline', fontFamily: SANS, fontSize: pt(10), lineHeight: pt(12.6), fontWeight: 600,
textAlign: 'center', firstLineIndent: pt(0) },
{ id: 'dates', fontFamily: SANS, fontSize: pt(7.6), lineHeight: pt(12.6), textAlign: 'center',
color: col('muted'), firstLineIndent: pt(0) },
{ id: 'colophon', fontFamily: SANS, fontSize: pt(7), lineHeight: pt(9.4), color: col('muted'),
textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD) },
];
Um flutuante nunca fica acima da linha que o cita, e o texto cita a Figura 1 pela primeira vez na seção II, por isso, como flutuante, ela não chegaria à página 1. A carta a põe ali diretamente: ::resource{id="fig1"} vem logo depois do título, e o posicionamento dele, { position: 'here', span: 'page' }, a estende sobre as duas colunas nesse ponto, com as colunas continuando embaixo. A autoria e o resumo vêm em seguida num boxe na largura da página, front, cujos blocos :::paragraphs centralizam a autoria e compõem as datas em corpo pequeno. A chamada de nota depois de et al. manda o texto da nota para o pé da primeira coluna, onde as revistas da APS imprimem a nota sobre os autores, e footnotes.numberFormat: 'lower-alpha' marca as notas com letras, para que nunca sejam lidas como referências. Veja Inserção em bloco e Notas de rodapé.
#3 · A Tabela I, com fórmulas nas células
// A cell sets $…$ in the line, at the table's size: the errors stack over and under the value.
const VALUES = [['Primary black hole mass', '$36^{+5}_{-4}\\,M_\\odot$'],
['Secondary black hole mass', '$29^{+4}_{-4}\\,M_\\odot$'],
['Final black hole mass', '$62^{+4}_{-4}\\,M_\\odot$'],
['Final black hole spin', '$0.67^{+0.05}_{-0.07}$'],
['Luminosity distance', '$410^{+160}_{-180}$ Mpc'],
['Source redshift $z$', '$0.09^{+0.03}_{-0.04}$']];
const table = { model: { columnWidths: [1.3, 1], rows: VALUES.map(([label, value]) =>
[{ content: label, verticalAlign: 'middle' }, { content: value }]) } };
Uma célula de tabela compõe $…$ como o texto (desde o postext 1.19), por isso cada valor é escrito em TeX, $36^{+5}_{-4}\,M_\odot$, e os dois erros se empilham acima e abaixo do número, ajustados à linha da célula; o ^+5^~−4~ do Markdown os imprimiria um depois do outro. Legendas e notas aceitam as mesmas fórmulas: a Figura 2 escreve $R_S = 2GM/c^2$ e a Figura 4, $5.1\sigma$, compostas com os glifos do MathJax, que têm o grego que nenhuma das duas fontes do texto traz, e o PDF os mantém como traçados vetoriais. Os tipos de recurso imprimem FIG. 1 e TABLE I nas legendas e Fig. 1 e Table I no texto: um captionPrefix, e counterFormat: 'upper-roman' para as tabelas. Veja Fórmulas matemáticas.
#4 · Figuras desenhadas a partir dos dados abertos
const palette = { ink: '#171a21', accent: '#25578a', tint: '#eef2f6', rule: '#b7c0ca',
muted: '#5a636e', paper: '#ffffff' };
const data = { hanford: '#cf5f24', livingston: palette.accent, purple: '#74519c' }; // figures
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' } }));
As quatro figuras são desenhadas em código a partir dos arquivos de dados que o GWOSC publica com a carta, sob CC BY 4.0. Cada traço mantém uma de cada oito amostras, 430 pontos para os 0,21 s da Figura 1, guardados com um caractere em base 64 por ponto para a variação em relação ao anterior, o que deixa os cinco traços com menos de 3 KB dentro do script. A linha do resíduo são os dados menos a forma de onda, como no original. Hanford é laranja e Livingston é azul em todas as figuras, e o texto fica com a tinta da página e um único azul. Os rótulos são traçados do MathJax na letra sem serifa (\textsf), de modo que um expoente ou um símbolo num eixo é composto como as fórmulas do texto, e o PDF mantém cada linha e cada rótulo como vetores.
A receita completa
// ═══ Postext Cookbook · Nº 140 · A physics letter with a data figure across the top ═══
// https://postext.dev/en/cookbook/physics-letter-two-columns
// Code: MIT · Text: Abbott et al., PRL 116, 061102 (CC BY 3.0) · Data: GWOSC (CC BY 4.0)
// Fonts: Gelasio, Albert Sans (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, registerCitationEngine,
defaultResourceTypes, initMathEngine, renderMath,
} 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 = 'physics-letter-two-columns';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink and one blue for the text; the detectors' colours for the data
const palette = { ink: '#171a21', accent: '#25578a', tint: '#eef2f6', rule: '#b7c0ca',
muted: '#5a636e', paper: '#ffffff' };
const data = { hanford: '#cf5f24', livingston: palette.accent, purple: '#74519c' }; // figures
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] = ['Gelasio', 'Albert Sans'];
// mm: US Letter, head, foot and side margins, gutter; then the measure and one column
const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 21, 21, 16, 7];
const MEASURE = TRIM_W - 2 * SIDE;
const COLUMN = (MEASURE - GUTTER) / 2;
const [BODY, LEAD] = [9.3, 12.4]; // pt: a letter journal's density, two columns of 88 mm
// #region answer: physics citations [1] and [2–4], from the bundled IEEE style
// [@key] numbers works by first citation. APS journals print [1,2] and [2–4] in one pair of
// brackets and list "A. Einstein, Sitzungsber. K. Preuss. Akad. Wiss. 1, 688 (1916).": no
// title, volume bold. No APS style is bundled: four edits turn the IEEE file into one.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const ARTICLE = '<group delimiter=" "><text variable="container-title"/><text '
+ 'variable="volume" font-weight="bold" suffix=","/><text variable="page"/><date '
+ 'variable="issued" prefix="(" suffix=")"><date-part name="year"/></date></group>';
const BOOK = '<group delimiter=" "><group delimiter=", "><choose><if type="chapter"><text '
+ 'variable="container-title" prefix="in " font-style="italic"/></if><else><text variable='
+ '"title" font-style="italic"/></else></choose><names variable="editor" prefix="edited by ">'
+ '<name and="text" initialize-with=". "/></names><text variable="collection-title"/><text '
+ 'variable="volume" prefix="Vol. "/></group><group prefix="(" suffix=")" delimiter=", ">'
+ '<text variable="publisher"/><text variable="publisher-place"/><date variable="issued">'
+ '<date-part name="year"/></date></group></group><text variable="page" prefix="pp. "/>';
const aps = STYLES.ieee
.replace('<citation>', '<citation collapse="citation-number">') // [2–4], not [2], [3], [4]
.replace(/<layout delimiter=", ">\s*<group prefix="\[" suffix="\]" delimiter=", ">/,
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
#Use o estilo IEEE como ele vem
Sem as substituições, as referências aparecem como [2], [3], [4] no texto e A. Einstein, “title”, journal… na lista.
-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'ieee', link: true,#Suba os números como faz a Nature
O estilo da Nature usa números sobrescritos e lista os títulos; ele vem incluído.
-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'nature', link: true,#Componha em A4
Mude o formato; a medida, as colunas e todas as figuras derivam dele.
-const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 21, 21, 16, 7];
+const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [210, 297, 22, 22, 15, 7];Erros comuns
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 →
- Até o postext 1.18, um recurso
'here'comspan: 'page'saía na largura de uma coluna num fluxo de duas colunas, e um$numa legenda ou numa célula era impresso como digitado. Fixe a versão 1.19 ou posterior. - Uma letra grega, ⊙ ou ≃ digitado como caractere numa legenda ou numa célula cai numa fonte do sistema na tela e some do PDF, que incorpora os arquivos latin de cada fonte. Escreva como fórmula,
$\sigma$ou$M_\odot$, e desenhe nas figuras. - Uma lista de centenas de autores não cabe num arquivo BibTeX. Escreva o nome como a revista o imprime, entre chaves duplas:
author={{B. Abbott et al.}}. - Mantenha a linha de licença do artigo e a dos dados. Aqui, uma nota de rodapé e o colofão dizem o que foi cortado, e a nota de cada legenda identifica os dados e o que a figura redesenhada deixa de fora.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Text: B. P. Abbott et al. (LIGO Scientific Collaboration and Virgo Collaboration), “Observation of Gravitational Waves from a Binary Black Hole Merger”, Phys. Rev. Lett. 116, 061102 (2016), doi:10.1103/PhysRevLett.116.061102. Abridged from the published letter (Sections IV and VII, parts of Sections I, III, V and VI and most of the acknowledgments cut; sections and references renumbered); figures redrawn; figure captions shortened. Licence: CC BY 3.0, https://creativecommons.org/licenses/by/3.0/ · LIGO Scientific Collaboration and Virgo Collaboration · CC BY 3.0
- Data for Figures 1, 2 and 4: the GW150914 data files released by the Gravitational Wave Open Science Center (gwosc.org), a service of the LIGO Scientific Collaboration, the Virgo Collaboration and KAGRA; redrawn in code · LIGO Scientific Collaboration and Virgo Collaboration, GWOSC · CC BY 4.0
- Fontes
- Gelasio (SIL OFL 1.1) · Albert 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)


