En pocas palabras
Un informe escolar de química de cuatro páginas sobre el análisis de un vinagre. Enseña a escribir fórmulas químicas y unidades con números pequeños arriba y abajo, además de algunas ecuaciones completas.
Lo que vas a componer
En la práctica 4 de Química, tres alumnos de 2.º de Bachillerato valoran un vinagre de manzana con hidróxido de sodio para saber cuánto ácido acético contiene. Son cuatro páginas A4 impresas por una cara. Los números de sección cuelgan en un margen izquierdo de 55 mm, así que títulos y párrafos arrancan en el mismo borde. La bureta y la cabecera de la tabla van en gris pizarra, y el único color es el rosa de la fenolftaleína, pálido en la banda de la apertura y en el intervalo de viraje, intenso en los números de sección y las lecturas del pH-metro. Las fórmulas y unidades del texto van en su misma letra, con subíndices y superíndices; TeX compone la reacción y tres ecuaciones destacadas. La tabla 1 y la curva de la figura 1 salen de un único array de lecturas en el código.
Esta receta responde a
- ¿Cómo escribo superíndices, subíndices y fórmulas químicas sin escribir LaTeX?
- ¿Cómo compongo matemáticas (en línea, destacadas, ecuaciones) y las mantengo vectoriales en el PDF?
- ¿Cómo numero los títulos (1, 1.1, 1.1.1) y doy a cada nivel un estilo distinto?
- ¿Cómo añado una figura con pie numerado y la cito en el texto («véase la fig. 3.2»)?
- ¿Cómo hago una tabla con filas de cabecera, celdas combinadas, anchos de columna y alineación por celda?
- ¿Cómo consigo las etiquetas «Figura» y «Tabla» en el idioma de mi documento?
- ¿Cómo compongo una bibliografía o un glosario (sangría francesa, cuerpo menor)?
La respuesta corta
// In the Markdown, ~…~ lowers a run and ^…^ raises it, in the text's own face at 58 % of
// its size: CH~3~COOH, OH^−^ (the minus is U+2212), 25,0 cm^3^, 0,100 mol·dm^−3^, p*K*~a~.
// The marks also work in captions and table cells, which keep their own face ($…$ there
// brings the maths face): the column heads this file writes, each a quantity over its unit:
const units = { cm3: 'cm^3^', conc: 'mol·dm^−3^' }; // the dot keeps a unit one word
const heads = t({ es: ['Valoración', 'V~inicial~', 'V~final~', 'V~b~ gastado'],
en: ['Titration', 'V~initial~', 'V~final~', 'V~b~ used'] })
.map((head, i) => (i ? `${head} / ${units.cm3}` : head)); // 'V~b~ gastado / cm^3^'
// Between $$ and $$ is TeX, set by MathJax as vector paths: the reaction, with mhchem's
// \ce{…} (it lowers the 3 of CH3COOH by itself), and the equations. initMathEngine() loads
// MathJax; a build that starts before it resolves prints grey boxes (gotcha: math-bundle).
await initMathEngine();
// A formula's x-height is TeX's 0.442 em of the type size and Inria Serif's is 0.495 em, so
// math.fontSizeScale lifts the formulas' lowercase to the height of the text's.
const MATH_SCALE = 0.495 / 0.442; // about 1.12
Ingredientes
- Funciones
- Superíndices y subíndicesMatemáticasAperturas diseñadasTítulos numeradosAnclaje de elementos de diseñoAtributos de títuloCapítulos sin númeroEstilos de títuloCitas que colocan las figurasPies numeradosTablas a partir de datosEstilo de tablasFigura y Tabla en tu idiomaEstilo de los piesFiguras justo aquíBibliografías y glosariosRecuadrosSeparación silábica e idioma del documentoTextos, filetes y cajas en los diseños de páginaExportación a PDF
- También usa
- Cabeceras según el tipo de páginaEstilos de párrafoFuentes incrustadas en el PDFTipos de recurso propiosFiguras y tablas como recursos
- Tipografía
- Inria Serif, Inria Sans, Sometype Mono (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Fórmulas como texto, TeX para las ecuaciones
El código es la respuesta corta de arriba. ~…~ y ^…^ componen un tramo al 58 % del cuerpo en la letra del texto, así que CH~3~COOH, OH^−^ (su signo menos es U+2212) y cm^3^ conservan el peso y el color de la frase que los rodea. Las marcas sirven también en pies y celdas de tabla, en la letra del pie o de la celda; $…$ en línea también se compone ahí, en la letra de las fórmulas. La reacción, escrita con \ce{…} de mhchem, y las ecuaciones van en TeX entre $$. await initMathEngine() arranca el motor de fórmulas antes de componer; se importa del mismo sitio que los demás símbolos. math.fontSizeScale vale 0,495 / 0,442, unos 1,12: la altura de la x de una fórmula es la de TeX, 0,442 em del cuerpo, y la de Inria Serif es de 0,495 em, así que la escala deja las minúsculas de fórmula y texto a la misma altura.
#2 · Números de sección colgados en el margen
const face = (size, extra) => ({ fontFamily: SANS, fontWeight: 700, fontSize: pt(size),
lineHeight: 1.1, align: 'left', overflow: 'wrap', ...extra });
// The title starts on the text edge; the number hangs off its left side ('left-of') in a box
// of fixed width, set right. An auto width is clamped to the room the column leaves on that
// side, which is none: the box shrinks to 0 mm, the number wraps a character to a line and
// the heads grow by one to three lines (gotcha: negative-offsets).
const hang = (id, content, size, color, extra) => ({ kind: 'text', id, content,
...face(size, extra), color: col(color), align: 'right',
placement: { ...at('#title', 'left-of', -GAP), size: { width: mm(HANG) } } });
const hung = (size, color) => ({ enabled: true, slot: { elements: [
{ kind: 'text', id: 'title', content: '{titleText}', ...face(size), color: col('ink'),
placement: at('container', 'top-left') },
hang('number', '{number}', size, color),
] } });
const levels = [
{ level: 1, breakBefore: { enabled: true, parity: 'any' } }, // the next page, either side
// One grid line per head: the design sets the type, the level's size and leading the flow.
{ level: 2, numberingTemplate: '{2}', fontSize: pt(13), lineHeight: pt(LEAD),
marginTop: pt(LEAD), marginBottom: pt(0), advancedDesign: hung(13, 'phenol') }, // 5
{ level: 3, numberingTemplate: '{2}.{3}', fontSize: pt(BODY), lineHeight: pt(LEAD),
marginTop: pt(LEAD), marginBottom: pt(0), advancedDesign: hung(BODY, 'muted') }, // 5.1
];
El diseño de cada nivel de título es una zona de diseño con dos elementos: el título, en el borde del texto, y el {number}, anclado a su izquierda (left-of) a 4 mm, en una caja de 33 mm alineada a la derecha. La caja necesita un ancho fijo. El ancho automático se limita al espacio que la columna deja a su izquierda, y como no deja ninguno, la caja se queda en 0 mm y los títulos crecen de una a tres líneas. El cuerpo y el interlineado del nivel solo cuentan para el flujo, donde cada título ocupa una línea de 15 pt. La letra la pone el diseño: los apartados, numerados {2}, en rosa a 13 pt, y los subapartados, {2}.{3}, en gris y al cuerpo del texto.
#3 · La apertura del informe sale del H1
const BAND = 104; // mm from the top of the page to the band's foot, where the flask stands
// The byline: values from the H1's attributes and the frontmatter, one per line, each
// with its label hung in the margin like a section number.
const byline = [['{attr.authors}', t({ es: 'Autores', en: 'Authors' })],
['{attr.group}', t({ es: 'Grupo', en: 'Class' })],
['{attr.teacher}', t({ es: 'Profesora', en: 'Teacher' })],
['{publishDate}', t({ es: 'Fecha', en: 'Date' })]].flatMap(([content, label], i) => [
{ kind: 'text', id: `value${i}`, content, fontFamily: SERIF, fontSize: pt(10), align: 'left',
color: col('ink'), overflow: 'clip', placement: at('#title', 'below', 0, 7 + 4.6 * i) },
{ kind: 'text', id: `label${i}`, content: label, fontFamily: MONO, fontWeight: 500,
fontSize: pt(7.5), letterSpacing: pt(1.2), textTransform: 'uppercase', color: col('ink'),
align: 'right', overflow: 'clip',
placement: { ...at(`#value${i}`, 'left-of', -GAP, 0.7), size: { width: mm(HANG) } } },
]);
const report = { id: 'report', numbered: false, advancedDesign: { enabled: true,
// The band is a box, and boxes count towards the height a head reserves, so the text
// would start below its foot at 104 mm (where the burette ends too). minHeight sets a floor
// 8 mm lower, which the H1's bottom margin and the 15 pt grid round up to 15 mm.
minHeight: mm(BAND + 8 - TOP), slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('blush') },
placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(BAND) } } },
{ kind: 'image', id: 'burette', resourceId: 'burette', // its stand 12 mm into the margin
placement: { ...at('page', 'top-right', 12 - RIGHT), size: { width: mm(34) } } },
{ kind: 'text', id: 'course', content: '{attr.course}', fontFamily: MONO, fontWeight: 600,
fontSize: pt(7.5), letterSpacing: pt(1.2), textTransform: 'uppercase',
color: col('phenol'), overflow: 'clip', placement: at('container', 'top-left', 0, 2) },
{ kind: 'text', id: 'title', content: '{titleText}', ...face(27, { lineHeight: 1.06 }),
color: col('ink'), placement: { ...at('#course', 'below', 0, 5), size: { width: mm(96) } } },
hang('practice', '{attr.practice}', 27, 'phenol', { lineHeight: 1.06 }), // as a section's
...byline,
] } } };
const back = { id: 'back', numbered: false, advancedDesign: hung(13, 'phenol') }; // no number
El único H1 del informe lleva el estilo de encabezado report, que lo sustituye por una apertura dibujada: una banda rosa en lo alto de la página, la bureta, la línea del curso, el título con el número de la práctica colgado como un número de sección y los datos de autoría. Estos datos salen de los atributos del título y del publishDate del frontmatter. La banda es una caja, y las cajas cuentan para la altura que reserva el título, así que el texto empezaría bajo su pie, a 104 mm del borde superior de la página, aun sin minHeight. minHeight fija una altura mínima que llega 8 mm por debajo de la banda; con el margen inferior del H1 y la rejilla de 15 pt quedan 15 mm de blanco sobre el resumen, en lugar de 4,7 mm.
#4 · Tabla y Figura en el idioma del informe
// The built-in types follow the locale; defaultResourceTypes(LANG) hands them over so one can
// change. Their '{h1}.{n}' prints a plain 1: the H1 is unnumbered, and an empty {h1} drops out
// with its dot.
const resourceTypes = defaultResourceTypes(LANG).map((type) => (type.id === 'table'
? { ...type, captionStyle: { position: 'above' } } : type)); // a table's caption goes on top
const tableStyle = { rules: 'horizontal', borderColor: col('rule'), borderWidth: pt(0.5),
headerBackground: col('slate'), headerColor: col('paper'), headerFontFamily: SANS,
headerFontSize: pt(8.5), bodyFontFamily: MONO, bodyFontSize: pt(8.8), bodyColor: col('ink'),
cellPadding: mm(1.5) }; // figures in a monospace face, so the decimal separators line up
const captionStyle = { fontFamily: SANS, fontSize: pt(8.8), color: col('ink'), gap: mm(2.5),
labelColor: col('phenol'), note: { fontFamily: SANS, fontSize: pt(7.4), color: col('muted') } };
Los tipos incorporados siguen el locale del documento, así que la edición española dice Tabla y Figura sin ajustar nada. defaultResourceTypes(LANG) devuelve esos tipos para que la receta cambie uno. Su plantilla {h1}.{n} imprime aquí un 1 a secas, porque el H1 del informe no lleva número y un {h1} vacío desaparece con su punto. El pie de la tabla va encima, como es costumbre en los informes. El texto cita tabla y figura con :ref{id="lecturas" style="full" case="lower"}, que escribe «tabla 1» en minúscula, con la tinta y el peso del texto.
#5 · Una sola serie de lecturas para la tabla y la curva
const READINGS = [[0.00, 21.30], [0.40, 21.25], [1.10, 22.00], [0.25, 21.10]]; // cm³: synthetic
const titres = READINGS.map(([from, to]) => to - from); // the first is the rough titration
const fair = titres.slice(1);
const mean = fair.reduce((a, b) => a + b) / fair.length; // 20.87 cm³
const sd = Math.sqrt(fair.reduce((s, v) => s + (v - mean) ** 2, 0) / (fair.length - 1)); // 0.03
const num = (x) => x.toFixed(2).replace('.', t({ es: ',', en: '.' })); // the decimal comma
const cell = (content, align = 'right') => ({ content, align }); // figures set right
const label = (es, en) => cell(t({ es, en }), 'left');
// A summary row: its label set right, against its value, and two cells for the merge to cover.
const total = (es, en, x) => [cell(t({ es, en })), cell(''), cell(''), cell(num(x))];
const rows = [heads.map((head, i) => ({ ...cell(head, i ? 'right' : 'left'), isHeader: true })),
...READINGS.map(([from, to], i) => [i ? cell(String(i), 'left') : label('Orientativa', 'Rough'),
cell(num(from)), cell(num(to)), cell(num(titres[i]))]),
total('Media de 1–3', 'Mean of 1–3', mean), total('Desviación típica', 'Standard deviation', sd)];
// The last two labels span the first three columns. The cells a merge covers stay in the
// row, marked hiddenBy, which mergeCells writes (gotcha: merged-cells-hiddenby).
const table = [rows.length - 2, rows.length - 1].reduce((model, row) => mergeCells(model,
{ start: { row, col: 0 }, end: { row, col: 2 } }), { headerRowCount: 1, rows,
columnWidths: [1.8, 1, 1, 1.15] }); // relative: the first column holds the longest labels
Las cuatro parejas de lecturas de la bureta dan todas las celdas de la tabla 1, la media y la desviación típica, y el volumen medio fija el punto de equivalencia del modelo de pH que dibuja la figura 1. La primera fila es la cabecera (headerRowCount: 1), y columnWidths da a la columna de rótulos 1,8 partes del ancho. Cada celda lleva su propio align, y mergeCells extiende los rótulos de la media y la desviación sobre las tres primeras columnas, alineados a la derecha junto a su valor. Las cifras van en Sometype Mono, así que las comas decimales quedan en columna. Las cabeceras son magnitudes sobre unidades, como V~b~ gastado / cm^3^, con las mismas marcas que el texto.
#6 · Referencias con sangría francesa
const paragraphStyles = [
{ id: 'references', fontSize: pt(9), lineHeight: pt(12.5), textAlign: 'left',
hangingIndent: mm(6), spaceBetween: pt(4) }, // ragged, so never hyphenated
{ id: 'colophon', fontFamily: SANS, fontSize: pt(7.4), lineHeight: pt(10), color: col('muted'),
textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD) },
];
Un contenedor :::paragraphs{style="references"} aplica el estilo de párrafo a cada referencia: 9 pt sobre 12,5 pt, en bandera, con 6 mm de sangría francesa y 4 pt entre entradas. El texto en bandera no lleva separación silábica salvo que bodyText.hyphenation.ragged la pida, así que un título largo como Fundamentos de química analítica solo se corta entre palabras. El colofón lleva un estilo propio, Inria Sans a 7,4 pt, con una línea de 15 pt de blanco encima.
La receta completa
// ═══ Postext Cookbook · Nº 028 · Lab report: formulas, subscripts and a titration curve ═══
// https://postext.dev/en/cookbook/lab-report-formulas
// Code: MIT · Text: original (CC BY 4.0) · Figures: drawn in code (CC BY 4.0)
// Fonts: Inria Serif, Inria Sans, Sometype Mono (SIL OFL 1.1) · Needs postext ≥ 1.57.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, defaultResourceTypes,
initMathEngine, renderMath, mergeCells,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'es'; // @lang: the language of the sample document ('es' | 'en')
const RECIPE = 'lab-report-formulas';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // white paper and phenolphthalein: pale at the end point, deep past it
ink: '#1d2126', // text: a blue-black
phenol: '#ad2c5f', // the accent: numbers, kickers, stripes, the flask's liquid (6.4:1)
blush: '#f6d5e2', // the end-point pink: the head's band, the indicator's range on the curve
slate: '#5b6b7a', // the burette's steel, the table head
rule: '#cfd4da', // hairlines
muted: '#626a73', // running heads, notes (5.5:1)
paper: '#ffffff',
};
// col() links a colour to its palette entry; the hex is the value the entry holds.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// 'main-color' as well: the engine's defaults are linked to it, so any left over turn pink.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.phenol })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [SERIF, SANS, MONO] = ['Inria Serif', 'Inria Sans', 'Sometype Mono'];
const [BODY, LEAD] = [10.5, 15]; // pt: text size and leading
// mm: A4, printed on one side, so not mirrored; the wide left margin holds the numbers
const [TRIM_W, TRIM_H, TOP, BOTTOM, LEFT, RIGHT] = [210, 297, 24, 22, 55, 31];
const MEASURE = TRIM_W - LEFT - RIGHT; // mm: 124, about 74 characters of Inria Serif
const GAP = 4; // mm between a hanging number and the text edge
const HANG = LEFT - GAP - 18; // mm: the number column, 18 mm clear of the trim
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
// #region answer: formulas and units in the text face; TeX for the reaction and equations
// In the Markdown, ~…~ lowers a run and ^…^ raises it, in the text's own face at 58 % of
// its size: CH~3~COOH, OH^−^ (the minus is U+2212), 25,0 cm^3^, 0,100 mol·dm^−3^, p*K*~a~.
// The marks also work in captions and table cells, which keep their own face ($…$ there
// brings the maths face): the column heads this file writes, each a quantity over its unit:
const units = { cm3: 'cm^3^', conc: 'mol·dm^−3^' }; // the dot keeps a unit one word
const heads = t({ es: ['Valoración', 'V~inicial~', 'V~final~', 'V~b~ gastado'],
en: ['Titration', 'V~initial~', 'V~final~', 'V~b~ used'] })
.map((head, i) => (i ? `${head} / ${units.cm3}` : head)); // 'V~b~ gastado / cm^3^'
// Between $$ and $$ is TeX, set by MathJax as vector paths: the reaction, with mhchem's
// \ce{…} (it lowers the 3 of CH3COOH by itself), and the equations. initMathEngine() loads
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
#Tiñe la nota de seguridad en vez de enmarcarla
Un fondo con el rosa del viraje sustituye al borde, y el recuadro sigue con un solo recurso gráfico.
box('safety', t({ es: 'Seguridad', en: 'Safety' }), {
- border: { enabled: true, color: col('phenol'), width: pt(0.75) },
+ backgroundEnabled: true, background: col('blush'),#Numera tablas y figuras por apartado
Los resultados pasan a ser la tabla 5.1 y la figura 5.1, con la cuenta reiniciada en cada apartado.
-const resourceTypes = defaultResourceTypes(LANG).map((type) => (type.id === 'table'
- ? { ...type, captionStyle: { position: 'above' } } : type)); // a table's caption goes on top
+const resourceTypes = defaultResourceTypes(LANG).map((type) => ({ ...type,
+ numberingTemplate: '{h2}.{n}', resetOn: 'h2',
+ ...(type.id === 'table' && { captionStyle: { position: 'above' } }) }));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 desplazamientos negativos relativos al contenedor no pintan nada
El texto de diseño de ancho automático se limita a su contenedor, así que un desplazamiento negativo respecto al contenedor lo saca fuera y no se pinta nada. Ancla esos elementos a la página o a la sangre con desplazamientos explícitos en mm, o dales un ancho fijo. Anclaje de elementos de diseño →
Comprobación del Sandbox · invalidMath
LaTeX no válido
Por qué. MathJax no pudo interpretar una fórmula, así que en su lugar se imprime un marcador rojo.
Solución. Corrige el TeX, o escribe \$ donde el signo de dólar no abre una fórmula. Documentación →
Aviso del Markdown · unclosedMath
Delimitador matemático sin cerrar
Por qué. Un $ abre una fórmula en línea que nunca se cierra; suele ser el de un precio.
Solución. Escribe \$ para un dólar literal, o cierra la fórmula en la misma línea. Documentación →
- Por defecto, una ecuación destacada no queda unida a la frase que la presenta, y una frase que acaba en «así que» puede cerrar una página con la ecuación ya en la siguiente;
math.keepWithLeadIn: truepasa esa línea a la página siguiente junto con la ecuación. La receta lo activa, de modo que la ecuación de [OH⁻] no se separa de su frase aunque cambie el texto. - Los glifos de TeX son los de MathJax, no los de Inria Serif, y una ecuación pesa algo menos que el texto que la rodea. Deja las fórmulas que van dentro de una frase como marcas
~y^, y reserva TeX para las líneas que lo necesitan. - Las cifras de los ejes y sus rótulos en la curva son contornos de MathJax, con los mismos glifos que las ecuaciones y vectoriales en el PDF:
tex()pide arenderMathlos trazados de cada rótulo y los coloca en el SVG. Solo pueden dibujarse cuandoinitMathEngine()ha terminado.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Inria Serif (SIL OFL 1.1) · Inria Sans (SIL OFL 1.1) · Sometype Mono (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)


