En pocas palabras
La carta de 2016 que anunció las primeras ondas gravitacionales, abreviada y compuesta de nuevo en tamaño carta. La señal de los dos detectores, dibujada con los datos públicos, cruza la página 1; las referencias van entre corchetes.
Lo que vas a componer
Cinco páginas de la carta que anunció las primeras ondas gravitacionales, Observation of Gravitational Waves from a Binary Black Hole Merger (Abbott et al., 2016), abreviada y compuesta de nuevo en tamaño carta a dos columnas. La página 1 abre con la prueba: la deformación registrada en Hanford y en Livingston, redibujada con los archivos de datos abiertos del Gravitational Wave Open Science Center, cruza las dos columnas bajo el título. Debajo van la firma de la colaboración con su nota, el resumen a toda página y el texto, con las citas numeradas [1,2] y [25–27] como las imprimen las revistas de la APS. La masa de chirrido es la ecuación (1). La Tabla I pone sus errores asimétricos como superíndice y subíndice apilados, escritos como fórmulas en las celdas, y los pies imprimen las fórmulas de la propia carta. Trae tu BibTeX y tus archivos de datos, y el mismo guion compone tu carta.
Esta receta responde a
- ¿Cómo compongo una carta de física: la firma de una colaboración, el resumen a dos columnas y una figura de datos arriba a todo el ancho?
- ¿Cómo decido dónde va una figura: en la cabeza de la página, a lo ancho de las dos columnas, justo aquí o al margen?
- ¿Cómo compongo matemáticas (en línea, destacadas, ecuaciones) y las mantengo vectoriales en el PDF?
- ¿Cómo vuelvo a componer con Postext un artículo de acceso abierto de arXiv o PubMed Central, con sus citas, sus figuras y su línea de licencia?
La respuesta corta
// [@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
- Funciones
- Figuras justo aquíColocación de figurasCitas en un estilo de citaMatemáticasTablas a partir de datosPies numeradosTipos de recurso propiosEstilo de los piesLíneas de fuente y créditoNotas al pieRecuadros a todo el anchoRecuadrosEstilos de títuloTítulos numeradosAtributos de títuloAperturas diseñadasCabeceras y foliosBibliografía a partir de las referenciasEstilos de párrafoExportación a PDF
- También usa
- Citas que colocan las figurasFigura y Tabla en tu idiomaCabeceras según el tipo de páginaFuentes incrustadas en el PDFFiguras y tablas como recursosSuperíndices y subíndicesSaltos de línea en los títulosCapítulos sin númeroEspacio vertical explícito
- Tipografía
- Gelasio, Albert Sans (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Citas numeradas de física a partir del estilo IEEE
El código es la respuesta corta de arriba. postext-citeproc no trae un estilo APS, y el más cercano de los incluidos es ieee: orden de cita, números entre corchetes, iniciales antes del apellido. Cuatro sustituciones de texto sobre STYLES.ieee cierran la distancia. collapse="citation-number" une las series ([25–27]), un solo par de corchetes en el layout imprime [1,2], et-al-min sube a once para que una lista de diez autores salga entera, y un bloque <bibliography> nuevo imprime la referencia como Physical Review, con la revista, el volumen en negrita, la página y el año: Phys. Rev. Lett. 74, 3515 (1995). Las 43 obras van en un bloque :::references{format=bibtex} propio; un nombre entre llaves dobles como {{J. Aasi et al.}} se imprime tal cual, que es como la carta cita las listas de autores larguísimas de su propia colaboración. Consulta Citas y bibliografía.
#2 · La Figura 1 bajo el título, a lo ancho de las dos columnas
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 flotante nunca queda por encima de la línea que lo cita, y el texto cita la Figura 1 por primera vez en la sección II, así que como flotante no llegaría a la página 1. La carta la pone ahí directamente: ::resource{id="fig1"} va justo después del título, y su colocación, { position: 'here', span: 'page' }, la extiende sobre las dos columnas en ese punto; las columnas siguen debajo. La firma y el resumen van después en un recuadro a toda página, front, cuyos bloques :::paragraphs centran la firma y componen las fechas en cuerpo pequeño. La llamada de nota tras et al. manda su texto al pie de la primera columna, donde las revistas de la APS imprimen la nota de autoría, y footnotes.numberFormat: 'lower-alpha' marca las notas con letras para que nunca se lean como referencias. Consulta Inserción en bloque y Notas al pie.
#3 · La Tabla I, con fórmulas en las celdas
// 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 }]) } };
Desde postext 1.19 una celda compone $…$ igual que el texto, así que cada valor se escribe en TeX, $36^{+5}_{-4}\,M_\odot$, y sus dos errores se apilan encima y debajo de la cifra, ajustados a la línea de la celda; con el ^+5^~−4~ de Markdown saldrían uno detrás de otro. Los pies y las notas admiten las mismas fórmulas: la Figura 2 escribe $R_S = 2GM/c^2$ y la Figura 4 $5.1\sigma$, con los glifos de MathJax, que tienen el griego que no trae ninguna de las dos fuentes del texto, y el PDF los conserva como trazados vectoriales. Los tipos de recurso imprimen FIG. 1 y TABLE I en los pies y Fig. 1 y Table I en el texto: un captionPrefix, y counterFormat: 'upper-roman' para las tablas. Consulta Fórmulas matemáticas.
#4 · Figuras dibujadas con los datos abiertos
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' } }));
Las cuatro figuras se dibujan en código con los archivos de datos que GWOSC publica junto a la carta, con licencia CC BY 4.0. Cada traza conserva una de cada ocho muestras, 430 puntos para los 0,21 s de la Figura 1, y se guarda con un carácter en base 64 por punto para su cambio respecto al anterior, de modo que las cinco trazas caben en menos de 3 KB dentro del guion. La fila del residuo es el dato menos la forma de onda, como en el original. Hanford va en naranja y Livingston en azul en todas las figuras, y el texto se queda con la tinta de la página y un solo azul. Los rótulos son trazados de MathJax en su letra sin remates (\textsf), de modo que un exponente o un símbolo en un eje se compone como las fórmulas del texto, y el PDF conserva cada línea y cada rótulo como vectores.
La receta 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=", ">/,
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Usa el estilo IEEE tal como viene
Sin las sustituciones, el texto dice [2], [3], [4] y la lista A. Einstein, “título”, revista….
-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'ieee', link: true,#Volados, como Nature
El estilo de Nature pone números volados y lista los títulos; viene incluido.
-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'nature', link: true,#Compónla en A4
Cambia el formato; la medida, las columnas y todas las figuras se derivan de él.
-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];Errores frecuentes
Error frecuente
Las matemáticas necesitan await initMathEngine() antes de componer
Las fórmulas compuestas antes de que arranque el motor de matemáticas son cajas grises de sustitución. Importa initMathEngine desde https://esm.sh/postext con los demás símbolos y espéralo con await antes de la primera composición; un documento con matemáticas compuesto sin él deja un aviso en la consola. Desde postext 1.5 MathJax viene dentro del paquete como un módulo que initMathEngine descarga, así que la importación normal funciona desde una CDN y ?bundle no hace falta (hasta la 1.4 todos los símbolos tenían que venir de https://esm.sh/postext?bundle). Importa desde una sola URL: dos URL cargan dos motores. Matemáticas →
- Hasta postext 1.18 un recurso
'here'conspan: 'page'salía del ancho de una columna en un flujo a dos columnas, y un$en un pie o en una celda se imprimía tal cual. Fija la 1.19 o una posterior. - Una letra griega, ⊙ o ≃ tecleada como carácter en un pie o en una celda cae en una fuente del sistema en pantalla y falta en el PDF, que incrusta los archivos latinos de cada fuente. Escríbela como fórmula,
$\sigma$o$M_\odot$, y dibújala en las figuras. - Una lista de cientos de autores no cabe en un archivo BibTeX. Escribe el nombre como lo imprime la revista, entre llaves dobles:
author={{B. Abbott et al.}}. - Conserva la línea de licencia del artículo y la de los datos. Aquí una nota al pie y el colofón dicen qué se ha cortado, y la nota de cada pie cita los datos y lo que la figura redibujada deja fuera.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto: B. P. Abbott et al. (LIGO Scientific Collaboration y Virgo Collaboration), «Observation of Gravitational Waves from a Binary Black Hole Merger», Phys. Rev. Lett. 116, 061102 (2016), doi:10.1103/PhysRevLett.116.061102. Versión abreviada de la carta publicada (se suprimen las secciones IV y VII, partes de las secciones I, III, V y VI y casi todos los agradecimientos; secciones y referencias renumeradas); figuras redibujadas; pies acortados. Licencia: CC BY 3.0, https://creativecommons.org/licenses/by/3.0/ · LIGO Scientific Collaboration and Virgo Collaboration · CC BY 3.0
- Datos de las figuras 1, 2 y 4: los ficheros de GW150914 publicados por el Gravitational Wave Open Science Center (gwosc.org), un servicio de LIGO Scientific Collaboration, Virgo Collaboration y KAGRA; redibujados en código · LIGO Scientific Collaboration and Virgo Collaboration, GWOSC · CC BY 4.0
- Fuentes
- Gelasio (SIL OFL 1.1) · Albert Sans (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


