En poques paraules
La carta del 2016 que va anunciar les primeres ones gravitacionals, abreujada i composta de nou en format carta. El senyal dels dos detectors, dibuixat amb les dades públiques, travessa la pàgina 1; les referències van entre claudàtors.
Què compondràs
Cinc pàgines de la carta que va anunciar les primeres ones gravitacionals, Observation of Gravitational Waves from a Binary Black Hole Merger (Abbott et al., 2016), abreujada i composta de nou en format carta a dues columnes. La pàgina 1 obre amb la prova: la deformació registrada a Hanford i a Livingston, redibuixada amb els fitxers de dades obertes del Gravitational Wave Open Science Center, travessa les dues columnes sota el títol. A sota hi ha la signatura de la col·laboració amb la seva nota, el resum a tota pàgina i el text, amb les citacions numerades [1,2] i [25–27] com les imprimeixen les revistes de l'APS. La massa de xiulet és l'equació (1). La Taula I posa els errors asimètrics com a superíndex i subíndex apilats, escrits com a fórmules a les cel·les, i els peus imprimeixen les fórmules de la mateixa carta. Porta el teu BibTeX i els teus fitxers de dades, i el mateix guió compon la teva carta.
Aquesta recepta respon a
- Com componc una carta de física: la signatura d'una col·laboració, el resum a dues columnes i una figura de dades a dalt a tota l'amplada?
- Com decideixo on va una figura: al capdamunt de la pàgina, a l'amplada de les dues columnes, just aquí o al marge?
- Com componc matemàtiques (en línia, destacades, equacions) i les mantinc vectorials al PDF?
- Com torno a compondre amb Postext un article d'accés obert d'arXiv o PubMed Central, amb les seves cites, les seves figures i la seva línia de llicència?
La 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
Ingredients
- Funcions
- Figures just aquíCol·locació de figuresCites en un estil de citaMatemàtiquesTaules a partir de dadesPeus numeratsTipus de recurs propisEstil dels peusLínies de font i crèditNotes a peu de pàginaRequadres a tota l'ampladaRequadresEstils de títolTítols numeratsAtributs de títolObertures dissenyadesCapçaleres i folisBibliografia a partir de les referènciesEstils de paràgrafExportació a PDF
- També fa servir
- Cites que col·loquen les figuresFigura i Taula en la teva llenguaCapçaleres segons el tipus de pàginaFonts incrustades al PDFFigures i taules com a recursosSuperíndexs i subíndexsSalts de línia als títolsCapítols sense númeroEspai vertical explícit
- Tipografia
- Gelasio, Albert Sans (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Citacions numerades de física a partir de l'estil IEEE
El codi és la resposta curta de dalt. postext-citeproc no porta cap estil APS, i el més proper dels inclosos és ieee: ordre de citació, números entre claudàtors, inicials abans del cognom. Quatre substitucions de text sobre STYLES.ieee tanquen la distància. collapse="citation-number" uneix les sèries ([25–27]), un sol parell de claudàtors al layout imprimeix [1,2], et-al-min puja a onze perquè una llista de deu autors surti sencera, i un bloc <bibliography> nou imprimeix la referència com Physical Review, amb la revista, el volum en negreta, la pàgina i l'any: Phys. Rev. Lett. 74, 3515 (1995). Les 43 obres van en un bloc :::references{format=bibtex} propi; un nom entre claus dobles com {{J. Aasi et al.}} s'imprimeix tal qual, que és com la carta cita les llistes d'autors llarguíssimes de la seva pròpia col·laboració. Consulta Citacions i bibliografia.
#2 · La Figura 1 sota el títol, d'amplada a amplada de les dues columnes
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) },
];
Un flotant mai no queda per damunt de la línia que el cita, i el text cita la Figura 1 per primer cop a la secció II, de manera que com a flotant no arribaria a la pàgina 1. La carta l'hi posa directament: ::resource{id="fig1"} va just després del títol, i la seva col·locació, { position: 'here', span: 'page' }, l'estén sobre les dues columnes en aquell punt; les columnes continuen a sota. La signatura i el resum van després en un requadre a tota pàgina, front, amb blocs :::paragraphs que centren la signatura i componen les dates en cos petit. La crida de nota després d'et al. envia el text al peu de la primera columna, on les revistes de l'APS imprimeixen la nota d'autoria, i footnotes.numberFormat: 'lower-alpha' marca les notes amb lletres perquè no es llegeixin mai com a referències. Consulta Inserció en bloc i Notes a peu de pàgina.
#3 · La Taula I, amb fórmules a les cel·les
// 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 }]) } };
Des de postext 1.19 una cel·la compon $…$ igual que el text, així que cada valor s'escriu en TeX, $36^{+5}_{-4}\,M_\odot$, i els seus dos errors s'apilen damunt i davall de la xifra, ajustats a la línia de la cel·la; amb el ^+5^~−4~ de Markdown sortirien l'un darrere l'altre. Els peus i les notes admeten les mateixes fórmules: la Figura 2 escriu $R_S = 2GM/c^2$ i la Figura 4 $5.1\sigma$, amb els glifs de MathJax, que tenen el grec que no porta cap de les dues fonts del text, i el PDF els conserva com a traçats vectorials. Els tipus de recurs imprimeixen FIG. 1 i TABLE I als peus i Fig. 1 i Table I al text: un captionPrefix, i counterFormat: 'upper-roman' per a les taules. Consulta Fórmules matemàtiques.
#4 · Figures dibuixades amb les dades obertes
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' } }));
Les quatre figures es dibuixen en codi amb els fitxers de dades que GWOSC publica amb la carta, amb llicència CC BY 4.0. Cada traça conserva una de cada vuit mostres, 430 punts per als 0,21 s de la Figura 1, i es desa amb un caràcter en base 64 per punt per al seu canvi respecte a l'anterior, de manera que les cinc traces caben en menys de 3 KB dins del guió. La fila del residu és la dada menys la forma d'ona, com a l'original. Hanford va en taronja i Livingston en blau a totes les figures, i el text es queda amb la tinta de la pàgina i un sol blau. Els rètols són traçats de MathJax en la seva lletra de pal sec (\textsf), de manera que un exponent o un símbol en un eix es compon com les fórmules del text, i el PDF conserva cada línia i cada rètol com a vectors.
La recepta 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=", ">/,
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Fes servir l'estil IEEE tal com ve
Sense les substitucions, el text diu [2], [3], [4] i la llista A. Einstein, “títol”, revista….
-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'ieee', link: true,#Volats, com Nature
L'estil de Nature posa números volats i llista els títols; ve inclòs.
-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'nature', link: true,#Compon-la en A4
Canvia el format; la mesura, les columnes i totes les figures se'n deriven.
-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];Errors freqüents
Error freqüent
Les matemàtiques necessiten await initMathEngine() abans de la primera composició
Les fórmules compostes abans que arrenqui el motor de matemàtiques són caixes grises de substitució. Importa initMathEngine des de https://esm.sh/postext amb els altres símbols i espera'l amb await abans de la primera composició; un document amb matemàtiques compost sense ell deixa un únic avís a la consola. Des de postext 1.5 MathJax ve dins del paquet com un mòdul que initMathEngine descarrega, així que la importació normal funciona des d'una CDN i ?bundle no cal (fins a la 1.4 tots els símbols havien de venir de https://esm.sh/postext?bundle). Importa des d'una sola URL: dues URL carreguen dos motors. Matemàtiques →
- Fins a postext 1.18 un recurs
'here'ambspan: 'page'sortia de l'amplada d'una columna en un flux a dues columnes, i un$en un peu o en una cel·la s'imprimia tal qual. Fixa la 1.19 o una de posterior. - Una lletra grega, ⊙ o ≃ teclejada com a caràcter en un peu o en una cel·la cau en una font del sistema a la pantalla i falta al PDF, que incrusta els fitxers llatins de cada font. Escriu-la com a fórmula,
$\sigma$o$M_\odot$, i dibuixa-la a les figures. - Una llista de centenars d'autors no cap en un fitxer BibTeX. Escriu el nom com l'imprimeix la revista, entre claus dobles:
author={{B. Abbott et al.}}. - Conserva la línia de llicència de l'article i la de les dades. Aquí una nota a peu de pàgina i el colofó diuen què s'ha tallat, i la nota de cada peu anomena les dades i el que la figura redibuixada deixa fora.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 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
- Fonts
- Gelasio (SIL OFL 1.1) · Albert Sans (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


