Pular para o conteúdo principal
Receita número 28

Receitas · Capítulo 2 · Tipo e texto

Relatório de laboratório: fórmulas, índices e curva de pH

Um relatório de química de quatro páginas A4 que marca com ~ e ^ as fórmulas e unidades do texto e deixa o TeX para a reação e as equações.

Nesta página
Saída
Canvas · PDF
Nível
Avançado
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.57.0 · postext-pdf ≥ 1.57.0
Licença
Atualizada em 22 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 210 × 297 mm
  • 1 coluna
  • Inria Serif 10,5/15
  • Inria Sans
  • Sometype Mono
  • 4 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 139 ms
  • 237 linhas de código

Em poucas palavras

Um relatório escolar de química de quatro páginas sobre a análise de um vinagre. Mostra como escrever fórmulas químicas e unidades com números pequenos acima e abaixo da linha, além de algumas equações completas.

O que você vai compor

Três alunos do terceiro ano do ensino médio titulam um vinagre de maçã com hidróxido de sódio para saber quanto ácido acético ele contém, e registram o trabalho como a Prática 4 da disciplina de química. O relatório tem quatro páginas A4 impressas de um lado só. A margem esquerda de 55 mm guarda os números das seções, e assim cada título e cada parágrafo começam na mesma borda. A bureta e o cabeçalho da tabela são cinza-ardósia, e a única cor é o rosa da fenolftaleína, claro na faixa do cabeçalho do relatório e na faixa de viragem do indicador na curva, forte nos números das seções e nas leituras de pH. Fórmulas e unidades no texto corrido são compostas na fonte do texto, com subscritos e sobrescritos; o TeX compõe a reação e três equações em destaque. A tabela 1 e a curva da figura 1 são calculadas a partir de uma mesma lista de leituras da bureta no pen.

Esta receita responde a

  • Como escrevo sobrescritos, subscritos e fórmulas químicas sem recorrer à notação matemática completa?
  • Como componho matemática (em linha, em destaque, equações) e a mantenho vetorial no PDF?
  • Como numero os títulos (1, 1.1, 1.1.1) e dou a cada nível um estilo diferente?
  • Como acrescento uma figura com legenda numerada e a cito no texto (“ver fig. 3.2”)?
  • Como faço uma tabela com linhas de cabeçalho, células mescladas, larguras de coluna e alinhamento por célula?
  • Como faço os rótulos “Figura” e “Tabela” saírem no idioma do meu documento?
  • Como componho uma bibliografia ou um glossário (recuo deslocado, corpo menor)?

A resposta curta

script.js · linhas 39–53no código completo
// 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

Tipografia
Inria Serif, Inria Sans, Sometype Mono (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Escreva as fórmulas como texto e deixe o TeX para as equações

O código é a resposta curta logo acima. ~…~ e ^…^ compõem um trecho a 58 % do corpo na própria fonte do texto, de modo que CH~3~COOH, OH^−^ (o sinal de menos é U+2212) e cm^3^ mantêm o peso e a cor da frase em volta. As marcas também funcionam em legendas e células de tabela, na fonte da legenda ou da célula; $…$ em linha também é composto ali, na fonte das fórmulas. A reação, escrita com o \ce{…} do mhchem, e as equações são TeX entre $$. await initMathEngine() inicia o motor de matemática antes da composição; ele vem do mesmo import que os outros símbolos. math.fontSizeScale vale 0,495 / 0,442, cerca de 1,12: a altura de x de uma fórmula é a do TeX, 0,442 em do corpo, e a da Inria Serif é 0,495 em, por isso a escala deixa as minúsculas da fórmula e do texto na mesma altura.

#2 · Pendure os números das seções na margem

script.js · linhas 57–78no código completo
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
];

O design de cada nível de título é um espaço de design com dois elementos: o título, na borda do texto, e o {number}, ancorado à esquerda dele (left-of) a 4 mm, numa caixa de 33 mm alinhada à direita. A caixa precisa de largura fixa. Uma largura automática fica limitada ao espaço que a coluna deixa à esquerda, e ela não deixa nenhum, por isso a caixa encolhe para 0 mm e os títulos crescem de uma para três linhas. O fontSize e o lineHeight do nível só definem o espaço que um título ocupa no fluxo, uma linha de 15 pt. A tipografia vem do design: as seções numeradas {2} em rosa de 13 pt e as subseções {2}.{3} em cinza, no corpo do texto corrido.

#3 · Desenhe o cabeçalho do relatório a partir do H1

script.js · linhas 82–113no código completo
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

O único H1 do relatório usa o estilo de título report, que o troca por um título desenhado: uma faixa rosa no alto da página, a bureta, a linha da disciplina, o título com o número da prática pendurado como um número de seção e os dados de autoria. Os valores da autoria vêm dos atributos do título e do publishDate do front matter. A faixa é uma caixa, e as caixas contam para a altura que um título reserva, de modo que mesmo sem minHeight o texto começaria sob o pé da faixa, a 104 mm do alto da página. minHeight fixa um piso 8 mm abaixo da faixa; com a margem inferior do H1 e a grade de 15 pt, isso deixa 15 mm de branco acima do resumo, em vez de 4,7 mm.

#4 · Dê nome à tabela e à figura no idioma do relatório

script.js · linhas 134–144no código completo
// 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') } };

Os tipos padrão seguem o locale do documento, por isso a edição em espanhol diz Tabla e Figura sem nenhum ajuste. defaultResourceTypes(LANG) devolve esses tipos para que a receita mude um deles. O modelo {h1}.{n} deles imprime aqui só um 1, porque o H1 do relatório não tem número e um {h1} vazio cai junto com o ponto. A legenda da tabela vai acima dela, onde os relatórios a põem. O texto cita a tabela e a figura com :ref{id="lecturas" style="full"}, na tinta e no peso das palavras em volta.

#5 · Calcule a tabela e a curva a partir das mesmas leituras

script.js · linhas 293–311no código completo
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

Os quatro pares de leituras da bureta dão todas as células da tabela 1, a média e o desvio padrão, e o volume médio define o ponto de equivalência do modelo de pH que a figura 1 desenha. A primeira linha é o cabeçalho (headerRowCount: 1), e columnWidths dá à coluna de rótulos 1,8 partes da largura. Cada célula traz o próprio align, e mergeCells estende os rótulos da média e do desvio pelas três primeiras colunas, alinhados à direita junto aos valores. Os números estão em Sometype Mono, e por isso os separadores decimais ficam alinhados. Os cabeçalhos das colunas são grandezas sobre unidades, como V~b~ used / cm^3^, marcados como o texto.

#6 · Feche com referências com recuo deslocado

script.js · linhas 162–167no código completo
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) },
];

Um bloco :::paragraphs{style="references"} aplica o estilo de parágrafo a cada referência: 9 pt sobre 12,5 pt, alinhado à esquerda, com recuo deslocado de 6 mm e 4 pt entre as entradas. Parágrafos alinhados à esquerda não são hifenizados, a menos que bodyText.hyphenation.ragged peça, por isso um título longo como Fundamentals of Analytical Chemistry só quebra entre palavras. O colofão tem um estilo próprio, Inria Sans em 7,4 pt, com uma linha de 15 pt de espaço acima.

A receita completa

Sandbox
// ═══ 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 = 'en'; // @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

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Pinte o fundo da nota de segurança em vez de emoldurá-la

Um fundo no rosa do ponto de viragem substitui a moldura, e o boxe continua com um único 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'),

#Numere tabelas e figuras por seção

Os resultados passam a ser a tabela 5.1 e a figura 5.1, com a contagem reiniciada em cada seção.

-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' } }) }));

Erros comuns

Erro comum

Matemática precisa de await initMathEngine() antes da primeira composição

Fórmulas diagramadas antes de o motor de matemática estar rodando saem como caixas cinza no lugar da fórmula. Importe initMathEngine de https://esm.sh/postext com os outros símbolos e aguarde-o com await antes da primeira composição; um documento com matemática composto sem ele imprime um aviso no console. Desde o postext 1.5, o MathJax vem dentro do pacote postext como um único módulo que initMathEngine baixa, então a importação simples funciona a partir de uma CDN e ?bundle não é necessário (até a 1.4, todos os símbolos tinham de vir de https://esm.sh/postext?bundle). Importe de uma única URL: duas URLs carregam dois motores. Matemática →

Erro comum

Deslocamentos negativos relativos ao contêiner não pintam nada

O texto de design com largura automática fica limitado ao seu contêiner, então um deslocamento negativo em relação ao contêiner o empurra para fora e nada é pintado. Ancore esses elementos na página ou na sangria com deslocamentos explícitos em mm, ou dê a eles uma largura fixa. Ancoragem de elementos de design →

Erro comum

Células mescladas precisam de hiddenBy: use mergeCells

As células são posicionadas pela posição no array da linha, então uma célula mesclada precisa de células de preenchimento marcadas com hiddenBy onde ela se estende; omiti-las, como no HTML, desloca todas as colunas seguintes. Crie as mesclagens com mergeCells. Desde o postext 1.5, uma tabela com grade irregular é informada em doc.contentWarnings como raggedTableGrid, e parseTSV(text, { headerRows }) marca as linhas de cabeçalho. Tabelas a partir de dados →

Verificação do Sandbox · invalidMath

LaTeX inválido

Por quê. O MathJax não conseguiu interpretar uma fórmula; por isso, um marcador vermelho é impresso no lugar dela.

Correção. Corrija o TeX ou escreva \$ onde o cifrão não abre uma fórmula. Docs →

Aviso do Markdown · unclosedMath

Delimitador de fórmula não fechado

Por quê. Um $ abre uma fórmula em linha que nunca é fechada; em geral é o cifrão de um preço.

Correção. Escreva \$ para um cifrão literal ou feche a fórmula na mesma linha. Docs →

  • Por padrão, uma fórmula em destaque não fica presa à linha que a apresenta, de modo que uma frase que termina em “so” pode fechar uma página com a equação já na seguinte; math.keepWithLeadIn: true leva essa linha para a página seguinte junto com a fórmula. A receita o ativa, então a equação de [OH⁻] fica com a sua frase qualquer que seja o tamanho do texto.
  • Os glifos do TeX são os do MathJax, não os da Inria Serif, e uma equação fica um pouco mais leve que o texto em volta. Mantenha as fórmulas dentro das frases como marcas ~ e ^, e reserve o TeX para as linhas que precisam dele.
  • Os rótulos das marcas e os títulos dos eixos da curva são contornos do MathJax, com os mesmos glifos das equações e vetoriais no PDF: tex() pede a renderMath os traçados de cada rótulo e os põe no SVG. Só podem ser desenhados depois que initMathEngine() termina.

Créditos

Texto
Texto original, CC BY 4.0
Fontes
Inria Serif (SIL OFL 1.1) · Inria Sans (SIL OFL 1.1) · Sometype Mono (SIL OFL 1.1)
SandboxPDF