Saltar al contingut principal
Recepta número 141

Receptari · Capítol 8 · Taules

Un assaig de metaciència en anglès i en castellà

L'assaig d'Ioannidis del 2005 recompost amb un sol script en dues edicions, amb fórmules al text i a les cel·les i la figura 1 calculada.

En aquesta pàgina
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 280 mm
  • 2 columnes, espai entre columnes de 6 mm
  • Gelasio 9,4/13
  • Sofia Sans Semi Condensed
  • 7 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 454 ms
  • 232 línies de codi

En poques paraules

Un assaig famós sobre per què molts resultats de recerca no s'aguanten, compost en set pàgines. Un sol script fa l'edició anglesa i una traducció al castellà, cadascuna amb la seva partició de mots i la seva coma decimal.

Què compondràs

Una separata de set pàgines de l'assaig de John Ioannidis Why Most Published Research Findings Are False (PLoS Medicine, 2005), abreujat i compost en una pàgina de 210 × 280 mm a dues columnes. Una banda blau marí obre la primera pàgina, amb les corbes de la mateixa fórmula de l'assaig dibuixades tènues darrere el títol. Les tres fórmules van destacades i numerades; les taules de 2×2 porten una fórmula a cada cel·la, amb α i β de debò; la figura 1 es calcula amb l'equació (2), i l'última columna de la taula 4, amb la mateixa equació. El mateix script compon una traducció al castellà amb partició de mots castellana, coma decimal a taules i figures, cometes « » i rètols en castellà. Tanquen trenta-tres referències a l'estil Vancouver, refetes en BibTeX a partir de la llista de l'article.

Aquesta recepta respon a

  • Com publico un mateix article en dues llengües des d'un sol script, amb la tipografia de cada llengua?
  • Com faig una taula amb files de capçalera, cel·les combinades, amplades de columna i alineació per cel·la?
  • 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

script.js · línies 32–54al codi complet
// 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)

Ingredients

Tipografia
Gelasio, Sofia Sans Semi Condensed (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Un script, dues edicions

El codi és la resposta curta de dalt. El Receptari compon l'script una vegada per llengua i posa content.en.md o content.es.md on hi ha la marca @content; cada ranura amb nom (content.corollaries.es.md, content.resources.es.md) segueix la mateixa regla, i una ranura sense fitxer en castellà pren l'anglès, que és com les dues edicions comparteixen un únic fitxer BibTeX. Tota la resta que canvia amb la llengua passa per LANG: locale tria els patrons de partició de mots ('es' és el codi que parteix el castellà), defaultResourceTypes(LANG) escriu Tabla i Figura, la configuració regional de CSL escriu les paraules de la bibliografia i toLocaleString dona als nombres que calcula l'script la seva coma decimal. La traducció segueix l'ortotipografia castellana: cometes « », 0,05 al text i 0{,}05 dins una fórmula, perquè TeX no tracti la coma com un signe de puntuació i hi deixi un espai al darrere. Per publicar el teu article en dues llengües, guarda un fitxer per llengua per al text i els peus, i reuneix qualsevol altra diferència en un objecte com edition.

#2 · Fórmules dins les cel·les

script.js · línies 413–438al codi complet
// 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');

Des de postext 1.19, una cel·la compon $…$ com el text, de manera que una cel·la que al TSV diu $c(1-\beta)R/(R+1)$ és una fórmula: traçats de MathJax al cos de 8 pt de les cel·les, sobre la línia de base de la línia de la cel·la, de manera que Sí, No i les fórmules queden en una mateixa línia, i contorns vectorials al PDF. Els fitxers latin de Fontsource no porten lletres gregues, i les fórmules no les necessiten. Els peus i les notes també admeten matemàtiques: el peu de la taula 4 anomena la potència 1 − β i la nota suposa α = 0,05, com a l'article de 2005. setAlignment alinea a la dreta els nombres de la taula 4, i mergeCells uneix el rètol de la primera columna sobre les dues files de capçalera i el de la relació veritable sobre tres columnes, i escriu les cel·les ocultes que necessita una cel·la combinada.

#3 · Peus i taules des de la ranura, nombres des de la fórmula

script.js · línies 442–470al codi complet
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') } };

Les taules, els peus, les notes i els textos alternatius són a content.resources.<lang>.md, un bloc per recurs, així que qui tradueix només toca fitxers de text i cada edició porta només la seva llengua. La columna de VPP de la taula 4 no es tecleja: ppv() la calcula amb la potència, R i u de cada fila, i els nou valors coincideixen amb els impresos el 2005 en dues xifres significatives. Les taules suren amb position: 'auto', així que la taula 1 pot ocupar el peu de la pàgina que la cita en lloc d'amuntegar-se amb els altres flotants a la següent.

#4 · La figura 1, dibuixada amb l'equació (2)

script.js · línies 474–523al codi complet
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 panell recorre R de 0 a 1 amb la mateixa ppv() que omple la taula 4. Dibuixar les corbes amb la fórmula fa veure una cosa que la figura del 2005 amaga: les seves corbes corresponen a u = 0; 0,05; 0,20 i 0,80, mentre que la llegenda diu 0,05; 0,20; 0,50 i 0,80. Aquesta versió dibuixa els valors de la llegenda, hi afegeix en traç discontinu la corba sense biaix i ho explica a la nota del peu. Els rètols són text que indica la seva lletra: loadSvg passa el dibuix per inlineSvgFonts, que hi incrusta aquesta font per al canvas, i el PDF els compon amb la font que lliura el proveïdor.

#5 · Una primera pàgina i un requadre per a un assaig

script.js · línies 58–81al codi complet
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ítol és l'únic de nivell 1; el seu estil essay ocupa tota la pàgina i dibuixa la banda, l'avantítol, l'autor, les filiacions i la línia de la font a partir dels atributs del títol, així que l'edició castellana només canvia paraules. El resum és un requadre a tota la pàgina sobre un tint. El requadre 1, l'exemple resolt, sura al peu d'una pàgina a l'amplada de les dues columnes i compon el text a dues columnes dins el requadre. Els corol·laris conserven la forma de l'article, amb l'enunciat en negreta al començament del paràgraf: :chip[Corolario 1]{style="corollary"} hi posa al davant un rètol petit en vermelló.

script.js · línies 130–159al codi complet
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, amb el conflicte d'interessos i l'abreviatura, és un requadre d'estil note amb placement: 'bottom': sura al peu de la primera columna que té lloc per a ella, sota un filet prim, i a la pàgina 1 de l'edició anglesa les dues columnes acaben a la mateixa altura. headings.balancing.fillShortColumns deixa que un paràgraf ocupi una línia més, i així les dues columnes de referències de l'última pàgina acaben igualades.

La recepta 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

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

#Enlaira els números de cita

Les revistes mèdiques solen posar els números de Vancouver volats.

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

#Imprimeix els DOI

El BibTeX d'aquesta recepta no guarda els DOI, per no passar de la mida de l'script. Conserva'ls al teu fitxer i imprimeix-los com a enllaços.

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

#Compon les taules en una columna

Una taula de 2×2 amb fórmules més curtes cap en una columna: treu-li el span: 'page', que la taula 4 no porta. A Article a dues columnes amb equacions numerades hi ha una taula a una columna.

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 →

Error freqüent

Els fitxers de Fontsource cobreixen lletres, no símbols

El kit incrusta el fitxer latin de Fontsource de cada font i, quan el text els fa servir, el seu fitxer latin-ext per a č, ł, † i el seu fitxer greek per a α, χ (en una família que en tingui: Lora i Gelasio no), a la pantalla i al PDF. Símbols com →, ≈, ✓ i ★ no són a cap d'aquests fitxers i falten al PDF: dibuixa'ls, escriu-los com a matemàtiques o tria una font els fitxers de la qual els tinguin. Fonts incrustades al PDF →

Error freqüent

Les cel·les combinades necessiten hiddenBy: fes servir mergeCells

Les cel·les es col·loquen segons la seva posició a la fila, així que una cel·la combinada necessita cel·les de farciment marcades amb hiddenBy on s'estén; ometre-les, com en HTML, desplaça totes les columnes següents. Combina cel·les amb mergeCells. Des de postext 1.5 una taula amb una graella irregular s'anota a doc.contentWarnings com a raggedTableGrid, i parseTSV(text, { headerRows }) marca les files de capçalera. Taules a partir de dades →

Error freqüent

Un $ sol obre matemàtiques: escriu \$

El signe de dòlar obre matemàtiques en línia, de manera que un preu com $40 comença una fórmula. Escriu \$40. Escapaments i caràcters literals →

  • On la llista de 2005 es queda en cinc autors i et al., el BibTeX acaba la llista en and others, i elsevier-vancouver escriu et al. al seu lloc (des de postext 1.19; les versions anteriors imprimien un coautor anomenat others).
  • Les pàgines no coincideixen entre edicions: el text castellà és més llarg i la taula 4 cau una pàgina després. La captura publica les pàgines 1, 2, 3, 5, 6 i 7 de les dues, perquè les imatges no passin del límit de pes i la taula 4 es vegi en totes dues.

Crèdits

Text
  • “Why Most Published Research Findings Are False”, PLoS Medicine 2(8): e124 (2005), doi:10.1371/journal.pmed.0020124, open access under the Creative Commons Attribution License; abridged, tables and figures redrawn; Spanish translation made for the Cookbook · John P. A. Ioannidis · CC BY
Fonts
Gelasio (SIL OFL 1.1) · Sofia Sans Semi Condensed (SIL OFL 1.1)
SandboxPDF