En poques paraules
Un informe escolar de química de quatre pàgines sobre l'anàlisi d'un vinagre. Ensenya a escriure fórmules químiques i unitats amb números petits a dalt i a baix, a més d'algunes equacions completes.
Què compondràs
A la pràctica 4 de Química, tres alumnes de 2n de Batxillerat valoren un vinagre de poma amb hidròxid de sodi per saber quant àcid acètic conté. Són quatre pàgines A4 impreses per una cara. Els números de secció pengen en un marge esquerre de 55 mm, de manera que títols i paràgrafs comencen al mateix límit. La bureta i la capçalera de la taula van en gris pissarra, i l'únic color és el rosa de la fenolftaleïna, pàl·lid a la banda de l'obertura i a l'interval de viratge, intens als números de secció i a les lectures del pH-metre. Les fórmules i unitats del text van en la mateixa lletra, amb subíndexs i superíndexs; TeX compon la reacció i tres equacions destacades. La taula 1 i la corba de la figura 1 surten d'un únic array de lectures al codi.
Aquesta recepta respon a
- Com escric superíndexs, subíndexs i fórmules químiques sense escriure LaTeX?
- Com componc matemàtiques (en línia, destacades, equacions) i les mantinc vectorials al PDF?
- Com numero els títols (1, 1.1, 1.1.1) i dono a cada nivell un estil diferent?
- Com afegeixo una figura amb peu numerat i la cito en el text («vegeu la fig. 3.2»)?
- Com faig una taula amb files de capçalera, cel·les combinades, amplades de columna i alineació per cel·la?
- Com aconsegueixo les etiquetes «Figura» i «Taula» en la llengua del meu document?
- Com componc una bibliografia o un glossari (sagnat francès, cos més petit)?
La resposta curta
// 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
Ingredients
- Funcions
- Superíndexs i subíndexsMatemàtiquesObertures dissenyadesTítols numeratsAncoratge d'elements de dissenyAtributs de títolCapítols sense númeroEstils de títolCites que col·loquen les figuresPeus numeratsTaules a partir de dadesEstil de taulesFigura i Taula en la teva llenguaEstil dels peusFigures just aquíBibliografies i glossarisRequadresPartició de mots i llengua del documentTextos, filets i caixes als dissenys de pàginaExportació a PDF
- També fa servir
- Capçaleres segons el tipus de pàginaEstils de paràgrafFonts incrustades al PDFTipus de recurs propisFigures i taules com a recursos
- Tipografia
- Inria Serif, Inria Sans, Sometype Mono (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Fórmules com a text, TeX per a les equacions
El codi és la resposta curta de més amunt. ~…~ i ^…^ componen un tram al 58 % del cos en la lletra del text, de manera que CH~3~COOH, OH^−^ (el seu signe menys és U+2212) i cm^3^ conserven el gruix i el color de la frase que els envolta. Les marques serveixen també als peus i a les cel·les de taula, en la lletra del peu o de la cel·la; $…$ en línia també s'hi compon, en la lletra de les fórmules. La reacció, escrita amb \ce{…} de mhchem, i les equacions van en TeX entre $$. await initMathEngine() arrenca el motor de fórmules abans de compondre; s'importa del mateix lloc que la resta de símbols. math.fontSizeScale val 0,495 / 0,442, uns 1,12: l'alçada de la x d'una fórmula és la de TeX, 0,442 em del cos, i la d'Inria Serif és de 0,495 em, de manera que l'escala deixa les minúscules de fórmula i text a la mateixa alçada.
#2 · Números de secció penjats al marge
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 disseny de cada nivell de títol és una zona de disseny amb dos elements: el títol, al límit del text, i el {number}, ancorat a la seva esquerra (left-of) a 4 mm, en una caixa de 33 mm alineada a la dreta. La caixa necessita una amplada fixa. L'amplada automàtica es limita a l'espai que la columna deixa a la seva esquerra, i com que no en deixa gens, la caixa es queda en 0 mm i els títols creixen d'una a tres línies. El cos i l'interlineat del nivell només compten per al flux, on cada títol ocupa una línia de 15 pt. La lletra la posa el disseny: els apartats, numerats {2}, en rosa a 13 pt, i els subapartats, {2}.{3}, en gris i al cos del text.
#3 · L'obertura de l'informe surt de l'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
L'únic H1 de l'informe porta l'estil d'encapçalament report, que el substitueix per una obertura dibuixada: una banda rosa a dalt de la pàgina, la bureta, la línia del curs, el títol amb el número de la pràctica penjat com un número de secció i les dades d'autoria. Aquestes dades surten dels atributs del títol i del publishDate del frontmatter. La banda és una caixa, i les caixes compten per a l'alçada que reserva el títol, així que el text començaria sota el seu peu, a 104 mm del límit superior de la pàgina, fins i tot sense minHeight. minHeight fixa una alçada mínima que arriba 8 mm per sota de la banda; amb el marge inferior de l'H1 i la retícula de 15 pt queden 15 mm de blanc sobre el resum, en lloc de 4,7 mm.
#4 · Taula i Figura en la llengua de l'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') } };
Els tipus incorporats segueixen el locale del document, així que l'edició espanyola diu Tabla i Figura sense ajustar res. defaultResourceTypes(LANG) retorna aquests tipus perquè la recepta en canviï un. La plantilla {h1}.{n} imprimeix aquí un 1 a seques, perquè l'H1 de l'informe no porta número i un {h1} buit desapareix amb el seu punt. El peu de la taula va a sobre, com és costum als informes. El text cita taula i figura amb :ref{id="lecturas" style="full" case="lower"}, que escriu «tabla 1» en minúscula, amb la tinta i el gruix del text.
#5 · Una sola sèrie de lectures per a la taula i la corba
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
Les quatre parelles de lectures de la bureta donen totes les cel·les de la taula 1, la mitjana i la desviació típica, i el volum mitjà fixa el punt d'equivalència del model de pH que dibuixa la figura 1. La primera fila és la capçalera (headerRowCount: 1), i columnWidths dona a la columna de rètols 1,8 parts de l'amplada. Cada cel·la porta el seu propi align, i mergeCells estén els rètols de la mitjana i la desviació sobre les tres primeres columnes, alineats a la dreta al costat del seu valor. Les xifres van en Sometype Mono, de manera que les comes decimals queden en columna. Les capçaleres són magnituds sobre unitats, com V~b~ gastado / cm^3^, amb les mateixes marques que el text.
#6 · Referències amb sagnat francès
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 contenidor :::paragraphs{style="references"} aplica l'estil de paràgraf a cada referència: 9 pt sobre 12,5 pt, en bandera, amb 6 mm de sagnat francès i 4 pt entre entrades. El text en bandera no porta partició de mots tret que bodyText.hyphenation.ragged la demani, així que un títol llarg com Fundamentos de química analítica només es talla entre paraules. El colofó porta un estil propi, Inria Sans a 7,4 pt, amb una línia de 15 pt de blanc a sobre.
La recepta 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
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
#Acoloreix la nota de seguretat en lloc d'emmarcar-la
Un fons amb el rosa del viratge substitueix el marc, i el requadre continua amb un sol recurs gràfic.
box('safety', t({ es: 'Seguridad', en: 'Safety' }), {
- border: { enabled: true, color: col('phenol'), width: pt(0.75) },
+ backgroundEnabled: true, background: col('blush'),#Numera taules i figures per apartat
Els resultats passen a ser la taula 5.1 i la figura 5.1, amb el compte reiniciat a cada apartat.
-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' } }) }));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 desplaçaments negatius relatius al contenidor no pinten res
El text de disseny d'amplada automàtica es limita al seu contenidor, de manera que un desplaçament negatiu respecte al contenidor el treu fora i no es pinta res. Ancora aquests elements a la pàgina o a la sang amb desplaçaments explícits en mm, o dona'ls una amplada fixa. Ancoratge d'elements de disseny →
Comprovació del Sandbox · invalidMath
LaTeX no vàlid
Per què. MathJax no ha pogut interpretar una fórmula, de manera que en el seu lloc s'imprimeix un marcador vermell.
Solució. Corregeix el TeX, o escriu \$ on el signe de dòlar no obre una fórmula. Documentació →
Avís del Markdown · unclosedMath
Delimitador matemàtic sense tancar
Per què. Un $ obre una fórmula en línia que no es tanca mai; sol ser el d'un preu.
Solució. Escriu \$ per a un dòlar literal, o tanca la fórmula a la mateixa línia. Documentació →
- Per defecte, una equació destacada no queda unida a la frase que la presenta, i una frase que acaba en «así que» pot tancar una pàgina amb l'equació ja a la següent;
math.keepWithLeadIn: truepassa aquesta línia a la pàgina següent amb l'equació. La recepta l'activa, de manera que l'equació de [OH⁻] no se separa de la seva frase encara que canviï el text. - Els glifs de TeX són els de MathJax, no els d'Inria Serif, i una equació pesa una mica menys que el text que l'envolta. Deixa les fórmules que van dins d'una frase com a marques
~i^, i reserva TeX per a les línies que el necessiten. - Les xifres dels eixos i els seus rètols a la corba són contorns de MathJax, amb els mateixos glifs que les equacions i vectorials al PDF:
tex()demana arenderMathels traçats de cada rètol i els col·loca a l'SVG. Només es poden dibuixar quaninitMathEngine()ha acabat.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Inria Serif (SIL OFL 1.1) · Inria Sans (SIL OFL 1.1) · Sometype Mono (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)


