Saltar al contenido principal
Receta número 141

Recetario · Capítulo 8 · Tablas

Un ensayo de metaciencia en inglés y en español

El ensayo de Ioannidis de 2005 recompuesto con un solo script en dos ediciones, con fórmulas en el texto y en las celdas y la figura 1 calculada.

pp. 2–3 de 7

  • Formato 210 × 280 mm
  • 2 columnas, medianil de 6 mm
  • Gelasio 9,4/13
  • Sofia Sans Semi Condensed
  • 7 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 454 ms
  • 232 líneas de código

En pocas palabras

Un ensayo famoso sobre por qué muchos resultados de investigación no se sostienen, compuesto en siete páginas. Un solo script hace la edición inglesa y una traducción al español, cada una con su separación silábica y su coma decimal.

Lo que vas a componer

Una separata de siete páginas del ensayo de John Ioannidis Why Most Published Research Findings Are False (PLoS Medicine, 2005), abreviado y compuesto en una página de 210 × 280 mm a dos columnas. Una banda azul marino abre la primera página, con las curvas de la propia fórmula del ensayo dibujadas tenues detrás del título. Las tres fórmulas van destacadas y numeradas; las tablas de 2×2 llevan una fórmula en cada celda, con α y β de verdad; la figura 1 se calcula con la ecuación (2), y la última columna de la tabla 4, con la misma ecuación. El mismo script compone una traducción al español con separación silábica española, coma decimal en tablas y figuras, comillas « » y rótulos en español. Cierran treinta y tres referencias al estilo Vancouver, rehechas en BibTeX a partir de la lista del artículo.

Esta receta responde a

  • ¿Cómo publico un mismo artículo en dos idiomas desde un solo script, con la tipografía de cada idioma?
  • ¿Cómo hago una tabla con filas de cabecera, celdas combinadas, anchos de columna y alineación por celda?
  • ¿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

script.js · líneas 32–54en el código completo
// The Cookbook composes the pen once per edition: content.<LANG>.md and each named slot
// replace the @content markers. What else follows the language is set here.
const edition = {
  // Hyphenation patterns and the words the engine writes (Tabla, Continúa) follow the locale.
  locale: t({ en: 'en-us', es: 'es' }),
  // Table 1 / Tabla 1, Figure 1 / Figura 1, counted through the essay; tables caption above.
  resourceTypes: defaultResourceTypes(LANG).map((type) => ({ ...type, shortLabel: type.name,
    numberingTemplate: '{n}', resetOn: 'never',
    ...(type.id === 'table' && { captionStyle: { position: 'above' } }) })),
  // Vancouver numbers in brackets, [2–4]; the CSL locale writes the list's words (2nd ed.,
  // 2.ª ed.). The titles of the works stay in English in both editions.
  citations: { style: 'elsevier-vancouver', locale: t({ en: 'en-US', es: 'es-ES' }),
    marker: 'brackets', collapseRanges: true,
    bibliography: { fontSize: em(0.78), lineHeight: pt(9.4), entrySpacing: pt(0.8),
      labelWidth: mm(6.4), doi: 'hide' } },
};
// The numbers the script writes (Table 4's PPV, the figure axes) take the edition's decimal
// sign, 0.85 or 0,85. Formulas keep their symbols; content.es.md writes 0{,}05 inside $…$
// so that TeX sets no space after the comma.
const number = (x, digits = 2) => x.toLocaleString(t({ en: 'en-US', es: 'es-ES' }),
  { minimumFractionDigits: digits, maximumFractionDigits: digits });
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
await initMathEngine(); // before the tables are built (gotcha: math-bundle)

Ingredientes

Tipografía
Gelasio, Sofia Sans Semi Condensed (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Un script, dos ediciones

El código es la respuesta corta de arriba. El Recetario compone el script una vez por idioma y pone content.en.md o content.es.md donde está la marca @content; cada ranura con nombre (content.corollaries.es.md, content.resources.es.md) sigue la misma regla, y una ranura sin archivo en español toma el inglés, que es como las dos ediciones comparten un único archivo BibTeX. Todo lo demás que cambia con el idioma pasa por LANG: locale elige los patrones de separación silábica ('es' es el código que separa el español), defaultResourceTypes(LANG) escribe Tabla y Figura, la configuración regional de CSL escribe las palabras de la bibliografía y toLocaleString da a los números que calcula el script su coma decimal. La traducción sigue la ortotipografía española: comillas « », 0,05 en el texto y 0{,}05 dentro de una fórmula, para que TeX no trate la coma como signo de puntuación y deje un espacio detrás. Para publicar tu propio artículo en dos idiomas, guarda un archivo por idioma para el texto y los pies, y reúne cualquier otra diferencia en un objeto como edition.

#2 · Fórmulas dentro de las celdas

script.js · líneas 413–438en el código completo
// A cell, a caption or a note sets $…$ as the text does (postext ≥ 1.19): MathJax paths at
// the cell's 8 pt, on the baseline of its line and aligned with the cell, vector in the PDF.
// The faces' latin files have no α or β (gotcha: latin-subset); the formulas need none.
const [CELL_PT, PAD] = [8, 1]; // cell type (pt), cell padding (mm)
function tableModel(tsv, widths, headerRows, merges = [], right = []) {
  let model = { ...parseTSV(tsv, { headerRows }), columnWidths: widths };
  model.rows.forEach((_, row) => right.forEach((c) => {
    model = setAlignment(model, { row, col: c }, 'right'); // the numbers, the PPV and their heads
  }));
  for (const range of merges) model = mergeCells(model, range); // gotcha: merged-cells-hiddenby
  return model;
}
// "Research finding" over both header rows, "True relationship" over Yes, No and Total.
const twoByTwo = (tsv) => tableModel(tsv, [1.1, 1.6, 1.6, 2.5], 2, [
  { start: { row: 0, col: 0 }, end: { row: 1, col: 0 } },
  { start: { row: 0, col: 1 }, end: { row: 0, col: 3 } }]);
// Table 4's last column is computed from Eq. (2), α = 0.05: two significant figures, as in 2005.
const ppv = (power, R, u, alpha = 0.05) => (power * R + u * (1 - power) * R)
  / (R + alpha - (1 - power) * R + u - u * alpha + u * (1 - power) * R);
const read = (s) => Number(s.replace(',', '.'));
const odds = (s) => s.split(':').map((x) => Number(x.replace(/\D/g, ''))).reduce((a, b) => a / b);
const ppvRows = (tsv) => tsv.split('\n').map((line, r) => {
  const [power, R, u, example, head] = line.split('\t');
  const p = ppv(read(power), odds(R), read(u)); // 0.0010: as many decimals as 2 figures need
  return [power, R, u, example, r ? number(p, 1 - Math.floor(Math.log10(p))) : head].join('\t');
}).join('\n');

Desde postext 1.19, una celda compone $…$ como el texto, así que una celda que en el TSV dice $c(1-\beta)R/(R+1)$ es una fórmula: trazados de MathJax al cuerpo de 8 pt de las celdas, sobre la línea de base de la línea de la celda, de modo que Sí, No y las fórmulas quedan en una misma línea, y contornos vectoriales en el PDF. Los archivos latin de Fontsource no traen letras griegas, y las fórmulas no las necesitan. Los pies y las notas también admiten matemáticas: el pie de la tabla 4 escribe la potencia como 1 − β y su nota supone α = 0,05, como en el artículo de 2005. setAlignment alinea a la derecha los números de la tabla 4, y mergeCells une Resultado de la investigación sobre las dos filas de cabecera y Relación verdadera sobre tres columnas, y escribe las celdas ocultas que necesita una celda combinada.

#3 · Pies y tablas desde la ranura, números desde la fórmula

script.js · líneas 442–470en el código completo
const parsed = blocks.trim().split(/\n\s*\n/).map((block) => {
  const fields = {};
  const tsv = block.split('\n').filter((line) => {
    const m = /^(id|caption|note|alt): (.*)$/.exec(line);
    if (m) fields[m[1]] = m[2];
    return !m;
  }).join('\n');
  return { ...fields, tsv };
});
const tables = parsed.filter((b) => b.tsv).map(({ id, caption, note, tsv }) => {
  const model = id === 'tbl-ppv'
    ? tableModel(ppvRows(tsv), [0.8, 0.95, 0.75, 3.8, 1.05], 1, [], [0, 1, 2, 4])
    : twoByTwo(tsv);
  return { id, typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0, caption, note,
    table: { model }, placement: { position: 'auto', ...(id !== 'tbl-ppv' && { span: 'page' }) } };
});
const figures = parsed.filter((b) => !b.tsv).map(({ id, caption, note, alt }) => ({ id,
  typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0, caption, note, altText: alt,
  placement: { position: 'auto', span: 'page' },
  svg: { fileId: `${id}.svg`, width: FIG_W * 10, height: FIG_H * 10 } }));
const resources = [...tables, ...figures,
  { id: 'band-art', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
    svg: { fileId: 'band-art.svg', width: 1400, height: BAND * 10 } }];
const tableStyle = { rules: 'horizontal', borderColor: col('rule'), borderWidth: pt(0.5),
  headerBackground: col('navy'), headerColor: col('paper'), headerBold: true,
  headerFontFamily: SANS, headerFontSize: pt(CELL_PT), bodyFontFamily: SANS,
  bodyFontSize: pt(CELL_PT), bodyColor: col('ink'), cellPadding: mm(PAD) };
const captionStyle = { fontFamily: SANS, fontSize: pt(8.2), color: col('ink'), labelBold: true,
  labelColor: col('accent'), gap: mm(2), note: { fontSize: pt(7), color: col('muted') } };

Las tablas, los pies, las notas y los textos alternativos están en content.resources.<lang>.md, un bloque por recurso, así que quien traduce solo toca archivos de texto y cada edición lleva solo su idioma. La columna de VPP de la tabla 4 no se teclea: ppv() la calcula con la potencia, R y u de cada fila, y los nueve valores coinciden con los impresos en 2005 en dos cifras significativas. Las tablas flotan con position: 'auto', así que la tabla 1 puede ocupar el pie de la página que la cita en lugar de amontonarse con los demás flotantes en la siguiente.

#4 · La figura 1, dibujada con la ecuación (2)

script.js · líneas 474–523en el código completo
const R2 = (x) => Math.round(x * 100) / 100;
// Each label names the label face: loadSvg embeds it for the canvas (inlineSvgFonts), and the
// PDF asks the provider for it.
const mix = (f) => `#${[1, 3, 5].map((i) => Math.round(parseInt(palette.navy.slice(i, i + 2), 16)
  * (1 - f) + parseInt(palette.accent.slice(i, i + 2), 16) * f).toString(16).padStart(2, '0'))
  .join('')}`; // navy for the first curve, vermilion for the last
const label = (x, y, s, size, extra = '', fill = palette.muted) => `<text x="${R2(x)}" `
  + `y="${R2(y)}" font-size="${size}" font-family="${SANS}" fill="${fill}" ${extra}>${s}</text>`;
const line = (points, stroke, width, extra = '') => `<path d="M${points.map(([x, y]) =>
  `${R2(x)} ${R2(y)}`).join('L')}" fill="none" stroke="${stroke}" stroke-width="${width}" `
  + `${extra}/>`;
// Three panels, power 0.80, 0.50 and 0.20; PPV in % against R from 0 to 1, one curve per value.
function panels(curve, values, name, digits, dashed) {
  const [pw, top, plotH, left] = [52, 12, 34, 8]; // panel width, plot top and height, y labels
  let out = '';
  [0.8, 0.5, 0.2].forEach((power, p) => {
    const x0 = p * (pw + (FIG_W - 3 * pw) / 2) + left;
    const X = (R) => x0 + R * (pw - left - 2);
    const Y = (v) => top + plotH * (1 - v);
    const trace = (f) => Array.from({ length: 101 }, (_, k) => [X(k / 100), Y(f(k / 100))]);
    out += label(x0 - left, 4, `${'ABC'[p]}  <tspan font-weight="400">${t({ en: 'Power',
      es: 'Potencia' })} ${number(power)}</tspan>`, 3.4, '', palette.navy);
    if (!p) out += label(x0 - left, top - 4, t({ en: 'PPV (%)', es: 'VPP (%)' }), 2.8);
    for (const v of [0, 0.2, 0.4, 0.6, 0.8, 1]) {
      out += line([[X(0), Y(v)], [X(1), Y(v)]], palette.rule, v ? 0.15 : 0.3)
        + label(X(0) - 1.4, Y(v) + 1, v * 100, 2.6, 'text-anchor="end"')
        + label(X(v), Y(0) + 3.6, number(v, v % 1 ? 1 : 0), 2.6, 'text-anchor="middle"');
    }
    if (dashed) out += line(trace((R) => dashed(power, R)), palette.muted, 0.35,
      'stroke-dasharray="1 0.8"');
    values.forEach((value, i) => {
      out += line(trace((R) => curve(power, R, value)), mix(i / (values.length - 1)), 0.6);
    });
    out += label(X(0.5), Y(0) + 8, `${t({ en: 'Pre-study odds', es: 'Razón previa' })}, `
      + '<tspan font-style="italic">R</tspan>', 2.9, 'text-anchor="middle"');
  });
  const key = values.map((value, i) => line([[48 + i * 24, 57.8], [54 + i * 24, 57.8]],
    mix(i / (values.length - 1)), 0.8) + label(56 + i * 24, 58.8, `<tspan font-style="italic">`
    + `${name}</tspan> = ${number(value, digits)}`, 2.9)).join('');
  return `<svg xmlns="http://www.w3.org/2000/svg" width="${FIG_W * 10}" height="${FIG_H * 10}" `
    + `viewBox="0 0 ${FIG_W} ${FIG_H}">${out}${key}</svg>`;
}
// Eq. (3): n independent studies of equal power, no bias.
const teams = (power, R, n, alpha = 0.05) => (R * (1 - (1 - power) ** n))
  / (R + 1 - (1 - alpha) ** n - R * (1 - power) ** n);
const bandArt = () => `<svg xmlns="http://www.w3.org/2000/svg" width="1400" height="${BAND * 10}" `
  + `viewBox="0 0 140 ${BAND}">${Array.from({ length: 10 }, (_, i) => line(Array.from(
    { length: 81 },
    (_, k) => [10 + k * 1.6, 92 - 76 * ppv(0.8, k / 80, i / 10)]), palette.mist, 0.5,
  `stroke-opacity="${R2(0.5 - i * 0.04)}"`)).join('')}</svg>`;

Cada panel recorre R de 0 a 1 con la misma ppv() que rellena la tabla 4. Dibujar las curvas con la fórmula revela algo que la figura de 2005 esconde: sus curvas corresponden a u = 0; 0,05; 0,20 y 0,80, mientras que su leyenda dice 0,05; 0,20; 0,50 y 0,80. Esta versión dibuja los valores de la leyenda, añade en trazo discontinuo la curva sin sesgo y lo explica en la nota del pie. Los rótulos son texto que indica su propia letra: loadSvg pasa el dibujo por inlineSvgFonts, que incrusta esa fuente para el canvas, y el PDF los compone con la fuente que entrega el proveedor.

#5 · Una primera página y un recuadro para un ensayo

script.js · líneas 58–81en el código completo
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
  content, fontFamily: family, fontSize: pt(size), color: col(color), align: 'left',
  overflow: 'wrap', placement, ...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) => ({ fontWeight, letterSpacing: pt(size * 0.18),
  textTransform: 'uppercase' });
const BAND = 100; // mm from the top of the trim to the foot of the band
const titleBlock = { enabled: true, minHeight: mm(BAND + 12 - TOP), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('navy') },
    placement: { anchor: { to: 'bleed', edge: 'top-left' },
      size: { width: 'fill', height: mm(BAND + 3) } } }, // + the 3 mm bleed
  { kind: 'image', id: 'curves', resourceId: 'band-art', // Eq. (2), faint, for u = 0 to 0.9
    placement: at('page', 'top-left', 128, 46, 76) }, // under the title, clear of the text
  text('kicker', '{attr.kicker}', SANS, 8, 'mist', at('page', 'top-left', INNER, 20, 120),
    caps(8)),
  text('title', '{titleText}', SANS, 36, 'paper', at('#kicker', 'below', 0, 6, 150),
    { fontWeight: 800, lineHeight: 1.02 }),
  text('author', '{attr.author}', SERIF, 13, 'paper', at('#title', 'below', 0, 8, 150)),
  text('affiliation', '{attr.affiliation}', SANS, 8, 'mist', at('#author', 'below', 0, 1.6, 150),
    { lineHeight: 1.35 }),
  text('source', '{attr.source}', SANS, 7.4, 'muted', at('page', 'top-left', INNER, BAND + 4,
    MEASURE), { lineHeight: 1.35 }),
] } };

El título es el único de nivel 1; su estilo essay ocupa toda la página y dibuja la banda, el antetítulo, el autor, las filiaciones y la línea de la fuente a partir de los atributos del encabezado, así que la edición española solo cambia palabras. El resumen es un recuadro a toda la página sobre un tinte. El recuadro 1, el ejemplo resuelto, flota al pie de una página a lo ancho de las dos columnas y compone su texto a dos columnas dentro del recuadro. Los corolarios conservan la forma del artículo, con el enunciado en negrita al comienzo del párrafo: :chip[Corolario 1]{style="corollary"} pone delante un rótulo pequeño en bermellón.

script.js · líneas 130–159en el código completo
const calloutStyles = [
  { id: 'summary', span: 'page', background: col('tint'), marginTop: pt(0),
    marginBottom: pt(LEAD), padding: { top: mm(4), right: mm(6), bottom: mm(4), left: mm(6) },
    titleStyle: { fontFamily: SANS, fontSize: pt(8), ...caps(8), color: col('accent'),
      gap: mm(1.5) },
    body: { fontSize: pt(9.4), lineHeight: pt(13), firstLineIndent: pt(0) } },
  { id: 'box', span: 'page', placement: 'bottom', columnGap: mm(GUTTER),
    backgroundEnabled: false, border: { enabled: false },
    stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('navy') },
    padding: { top: mm(2.5), right: mm(0), bottom: mm(1), left: mm(0) },
    marginTop: pt(LEAD), marginBottom: pt(LEAD),
    titleStyle: { fontFamily: SANS, fontSize: pt(9), fontWeight: 700, color: col('navy'),
      gap: mm(1.2) },
    body: { fontFamily: SANS, fontSize: pt(8.4), lineHeight: pt(11.2), firstLineIndent: mm(3) } },
  // The journal's first-page note (competing interests, abbreviation) floated to the foot of
  // the first column under a hairline, as PLoS Medicine sets it.
  { id: 'note', placement: 'bottom', backgroundEnabled: false, border: { enabled: false },
    stripe: { enabled: true, side: 'top', width: pt(0.5), color: col('rule') },
    padding: { top: mm(1.6), right: mm(0), bottom: mm(0), left: mm(0) },
    marginTop: pt(LEAD), marginBottom: pt(0),
    body: { fontFamily: SANS, fontSize: pt(7.6), lineHeight: pt(10.4), color: col('muted'),
      boldColor: col('ink'), textAlign: 'left', firstLineIndent: pt(0) } },
];
// :chip[Corollary 1]{style="corollary"}: a label in the sans and the accent, no frame.
const chipStyles = [{ id: 'corollary', fontFamily: SANS, fontSize: em(0.86), bold: true,
  color: col('accent'), backgroundEnabled: false, borderWidth: pt(0), paddingX: em(0),
  gap: em(0.35) }];
const paragraphStyles = [{ id: 'colophon', fontFamily: SANS, fontSize: pt(7.6),
  lineHeight: pt(10.4), color: col('muted'), boldColor: col('ink'), textAlign: 'left',
  firstLineIndent: pt(0), spaceBetween: pt(3) }];

La nota de la primera página de la revista, con el conflicto de intereses y la abreviatura, es un recuadro de estilo note con placement: 'bottom': flota al pie de la primera columna que tiene sitio para ella, bajo un filete fino, y en la página 1 de la edición inglesa las dos columnas terminan a la misma altura. headings.balancing.fillShortColumns deja que un párrafo ocupe una línea más, y así las dos columnas de referencias de la última página acaban igualadas.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 141 · A metascience essay in English and Spanish ═══════
// https://postext.dev/en/cookbook/bilingual-metascience-essay
// Code: MIT · Text: J. P. A. Ioannidis, PLoS Med 2005 (CC BY) · Figures: drawn in code (CC BY 4.0)
// Fonts: Gelasio, Sofia Sans Semi Condensed (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
  buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
  registerCitationEngine, defaultResourceTypes, initMathEngine, parseTSV, mergeCells, setAlignment,
  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 = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'bilingual-metascience-essay';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a navy for the furniture, one vermilion accent, every colour linked
const palette = { ink: '#1c1d24', navy: '#22305a', accent: '#b8442a', tint: '#eceff5',
  rule: '#b4bccb', muted: '#5a6070', mist: '#c3cde6', paper: '#ffffff' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.navy })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SERIF, SANS] = ['Gelasio', 'Sofia Sans Semi Condensed'];
// mm: the 210 × 280 trim, head, foot, inner and outer margins, and the gutter
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER, GUTTER] = [210, 280, 22, 22, 19, 17, 6];
const MEASURE = TRIM_W - INNER - OUTER; // 174 mm across both columns
const [BODY, LEAD] = [9.4, 13]; // pt
const [FIG_W, FIG_H] = [MEASURE, 60]; // mm: Figures 1 and 2, across both columns

// #region answer: one script, two editions: LANG picks the text, the language and the numbers
// The Cookbook composes the pen once per edition: content.<LANG>.md and each named slot
// replace the @content markers. What else follows the language is set here.
const edition = {
  // Hyphenation patterns and the words the engine writes (Tabla, Continúa) follow the locale.
  locale: t({ en: 'en-us', es: 'es' }),
  // Table 1 / Tabla 1, Figure 1 / Figura 1, counted through the essay; tables caption above.
  resourceTypes: defaultResourceTypes(LANG).map((type) => ({ ...type, shortLabel: type.name,
    numberingTemplate: '{n}', resetOn: 'never',
    ...(type.id === 'table' && { captionStyle: { position: 'above' } }) })),
  // Vancouver numbers in brackets, [2–4]; the CSL locale writes the list's words (2nd ed.,
  // 2.ª ed.). The titles of the works stay in English in both editions.
  citations: { style: 'elsevier-vancouver', locale: t({ en: 'en-US', es: 'es-ES' }),
    marker: 'brackets', collapseRanges: true,
    bibliography: { fontSize: em(0.78), lineHeight: pt(9.4), entrySpacing: pt(0.8),
      labelWidth: mm(6.4), doi: 'hide' } },
};
// The numbers the script writes (Table 4's PPV, the figure axes) take the edition's decimal

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

#Vuela los números de cita

Las revistas médicas suelen poner los números de Vancouver volados.

-    marker: 'brackets', collapseRanges: true,
+    marker: 'superscript', collapseRanges: true,

#Imprime los DOI

El BibTeX de esta receta no guarda los DOI, para no pasar del tamaño del script. Consérvalos en tu archivo e imprímelos como enlaces.

-      labelWidth: mm(6.4), doi: 'hide' } },
+      labelWidth: mm(6.4), doi: 'link' } },

#Compón las tablas en una columna

Una tabla de 2×2 con fórmulas más cortas cabe en una columna: quítale el span: 'page', que la tabla 4 no lleva. En Artículo a dos columnas con ecuaciones numeradas hay una tabla a una columna.

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 →

Error frecuente

Los archivos de Fontsource cubren letras, no símbolos

El kit incrusta el archivo latin de Fontsource de cada fuente y, cuando el texto los usa, su archivo latin-ext para č, ł, † y su archivo greek para α, χ (en una familia que lo tenga: Lora y Gelasio no), en pantalla y en el PDF. Símbolos como →, ≈, ✓ y ★ no están en ninguno de esos archivos y faltan en el PDF: dibújalos, escríbelos como matemáticas o elige una fuente cuyos archivos los tengan. Fuentes incrustadas en el PDF →

Error frecuente

Las celdas combinadas necesitan hiddenBy: usa mergeCells

Las celdas se colocan según su posición en la fila, así que una celda combinada necesita celdas de relleno marcadas con hiddenBy donde se extiende; omitirlas, como en HTML, desplaza todas las columnas siguientes. Combina celdas con mergeCells. Desde postext 1.5 una tabla con una rejilla irregular se anota en doc.contentWarnings como raggedTableGrid, y parseTSV(texto, { headerRows }) marca las filas de cabecera. Tablas a partir de datos →

Error frecuente

Un $ suelto abre matemáticas: escribe \$

El signo de dólar abre matemáticas en línea, así que un precio como $40 empieza una fórmula. Escribe \$40. Escapes y caracteres literales →

  • Donde la lista de 2005 se queda en cinco autores y et al., el BibTeX termina la lista en and others, y elsevier-vancouver escribe et al. en su lugar (desde postext 1.19; las versiones anteriores imprimían un coautor llamado others).
  • Las páginas no coinciden entre ediciones: el texto español es más largo y la tabla 4 cae una página después. La captura publica las páginas 1, 2, 3, 5, 6 y 7 de las dos, para que las imágenes no pasen del límite de peso y la tabla 4 se vea en ambas.

Créditos

Texto
  • «Why Most Published Research Findings Are False», PLoS Medicine 2(8): e124 (2005), doi:10.1371/journal.pmed.0020124, en acceso abierto con la licencia Creative Commons Attribution; abreviado, con las tablas y las figuras redibujadas; traducción al español hecha para el Recetario · John P. A. Ioannidis · CC BY
Fuentes
Gelasio (SIL OFL 1.1) · Sofia Sans Semi Condensed (SIL OFL 1.1)
SandboxPDF