Em poucas palavras
Uma notícia de um semanário local, conferida duas vezes em busca de erros. Mostra como marcar cada erro em vermelho na página e ligá-lo à linha do texto que o causou.
O que você vai compor
O número 41 de The Tideline, um semanário regional, abre com a volta da balsa noturna que atravessa o Sawyer, e o pen revisa a notícia duas vezes. A primeira prova é o texto como chegou à redação: a notícia corrigida com sete deslizes devolvidos, entre eles um carimbo escrito como uma diretiva que não existe e um box que nunca se fecha. Esses sete deslizes deixam onze marcas. Como no cartão, cada erro é sublinhado em vermelho na linha em que foi composto (uma linha frouxa recebe um fundo em vez disso), e seu número na margem corresponde à entrada na lista ao lado das páginas. Clicar numa linha ou numa entrada seleciona o Markdown. As páginas abaixo são a segunda prova. As verificações não encontram nada nela, e um carimbo PROOF · 2ND PASS fica preso no canto superior direito.
Esta receita responde a
- Como descubro o que está errado no meu documento (avisos, transbordamento, layout que não converge)?
- Como relaciono um clique na página renderizada com o Markdown de origem, para construir um editor?
- Por que uma linha sai alinhada à esquerda ou esticada demais (URLs, palavras compostas longas, palavras longas em células)?
A resposta curta
const MM = DPI / 25.4; // page px per mm
function proof(md, doc) {
const faults = [];
const add = (kind, from, to, detail, at) => faults.push({ kind, from, to, detail, at });
const { blocks, issues } = parseMarkdownWithIssues(md); // a $, $$ or ::: left open
for (const i of issues) add(i.kind, i.sourceStart, i.sourceEnd);
for (const w of doc.warnings ?? []) { // calloutOverflow: a box no cut could split
add(w.kind, w.sourceStart, w.sourceEnd, Math.round(w.overflowPx / MM), w);
}
if (!doc.converged) add('unsettled', 0, 1, doc.iterationCount); // the layout never settled
// The pen's own readings of the source and the lines, in the same list and shape.
const ids = new Set(resources.map((r) => r.id)); // an unknown id prints '?'
for (const m of md.matchAll(/:ref\{id="([^"]*)"|^::resource\{id="([^"]*)"/gm)) {
if (!ids.has(m[1] ?? m[2])) add('unknownResourceId', m.index, m.index + m[0].length);
}
for (const m of md.matchAll(/^:::?([a-z][\w-]*)/gim)) { // an unknown fence prints as text
const known = KNOWN_CONTAINERS.has(m[1]) || KNOWN_DIRECTIVES.has(m[1]) || m[1] === 'resource';
if (!known) add('unknownDirective', m.index, m.index + m[0].length);
}
for (const b of blocks) { // formulas count as faults only because this story has none
if (b.startNumber > 999) add('yearList', b.sourceStart, b.sourceEnd); // 1971. opens a list
for (const s of b.spans ?? []) if (s.math) add('formula', s.math.sourceStart, s.math.sourceEnd);
}
// The lines as set: spaces past maxWordSpacing, a line set ragged, a hyphen in an address.
const max = doc.config.bodyText.maxWordSpacing;
for (const l of doc.pages.flatMap((p) => p.columns.flatMap((c) => c.blocks))
.flatMap((b) => b.lines ?? [])) {
const ratio = Math.round(lineWordSpacing(l) * 100) / 100; // as the report prints it
if (ratio > max) add('looseLine', l.sourceStart, l.sourceEnd, ratio);
if (l.ragged) add('raggedLine', l.sourceStart, l.sourceEnd); // past 3×: no ratio left
if (l.hyphenated && /[./]\S+-$/.test(l.text)) add('addressHyphen', l.sourceStart, l.sourceEnd);
}
return faults.sort((a, b) => a.from - b.from);
}
Ingredientes
- Funcionalidades
- Avisos e diagnósticoEscapes e caracteres literaisBoxes que se dividem ou ficam inteirosQuebra de linha ótima (Knuth–Plass)Boxes fixos e selosCitações que posicionam as figurasColuna de margem para flutuantesNotas na margemColunas num boxe ou no textoBoxesAberturas desenhadasFaixa de capítulo em largura totalAtributos de títuloCabeços e fóliosCabeços por tipo de páginaPáginas em um canvasFiguras e tabelas como recursosTipos de recurso personalizadosPaleta de cores semânticaCor do papel
- Também usa
- Coluna e meia
- Tipografia
- Charis SIL, Chivo, Fragment Mono (SIL OFL 1.1)
- Materiais
crossing-1590.jpg- The night crossing at the head of page 1 (Generated With Diffusion Models, original)
- The route map, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)
Preparo
#1 · Leia o que o motor informa e confira o resto
O código é a resposta curta logo acima. parseMarkdownWithIssues() devolve um problema para cada $, $$ ou ::: que ficou aberto, e doc.warnings reúne um calloutOverflow para cada box que nenhum corte conseguiu dividir. doc.converged e doc.iterationCount dizem se a diagramação se estabilizou, e esta notícia se estabiliza numa iteração, com ou sem os erros. O motor também registra ids e diretivas desconhecidos em doc.contentWarnings, e findLooseLines devolve as linhas frouxas: são as verificações que o painel Verificações do Sandbox mostra (Painéis laterais). proof() faz essas leituras por conta própria, para que todos os erros fiquem numa lista só, com a mesma forma: um tipo, um trecho do Markdown e um detalhe. Ele compara os ids de :ref e ::resource com os resources da composição, e os nomes dos delimitadores com KNOWN_CONTAINERS e KNOWN_DIRECTIVES. Para esta notícia, também aponta um bloco de lista cujo startNumber é um ano e qualquer fórmula, já que a notícia não tem nenhuma, e lê as linhas compostas em busca de espaços esticados além de maxWordSpacing, linhas em bandeira e hifens acrescentados dentro de um endereço.
#2 · Devolva os erros ao texto corrigido
const FIRST_PASS = [ // [corrected, faulty], replaced wherever it occurs
[':::callout{type="stamp"}\n:::', t({ en: ':::stamp', es: ':::sello' })], // no such directive
[':ref{id="route"}', ':ref{id="route-map"}'], // an id no resource has
['\\$', '$'], // bare dollars (gotcha: dollar-math)
[' https://', ' '], // a web address without its scheme
[':::\n:::\n', ''], // the fact box's two closing fences
['\u20601971.', '1971.'], // the word joiner before 1971 (gotcha: digit-period-list)
[t({ en: 'October 2.\n:::', es: 'octubre.\n:::' }), t({ en: 'October 2.', es: 'octubre.' })],
]; // last: the timeline's closing fence, so its box stays open inside the open fact box
const firstPass = (md) => FIRST_PASS.reduce((out, [fix, fault]) => out.replaceAll(fix, fault), md);
O pen guarda um único arquivo Markdown, a notícia corrigida, e tira dele a primeira prova desfazendo sete correções; assim as duas versões não se desencontram e cada marca tem uma causa conhecida. A versão corrigida é composta por último, e é ela que aparece nas páginas abaixo. \$ escapa o cifrão de um preço, e nenhuma fórmula se abre. Um word joiner (U+2060) antes de cada ano da cronologia da página 2 impede que uma entrada como 1971. The Tern… abra uma lista numerada a partir desse ano; a primeira prova tira só o que vem antes de 1971. Com o esquema https://, um endereço web é composto como endereço, sem hifenizar e quebrando só nas junções, como na página 1 antes de .example. Sem ele, o endereço é uma palavra comum, e a primeira prova o hifeniza como night-ferry. A sétima entrada tira o delimitador que fecha a cronologia, e o passo 3 mostra o que a composição faz com isso.
#3 · Marque cada erro onde ele foi composto
const linesOf = (page) => [...page.columns.flatMap((c) => c.blocks), ...(page.floats ?? [])]
.flatMap((b) => (b.lines ?? []).map((l) => ({ ...l.bbox, from: l.sourceStart, to: l.sourceEnd,
width: l.justifiedSpaceRatio // a bbox is the natural width; a justified line fills the block
? b.bbox.x + b.bbox.width - l.bbox.x : l.bbox.width })));
const REACH = 80; // characters after a fence where its first line may start
function spotOf(page, f) { // where a fault shows on this page: its first line, in page px
if (f.at) { // a box that ran off its column: a bar under the column's foot
const c = page.columns[f.at.columnIndex]?.bbox;
return f.at.pageIndex === page.index ? { ...c, y: c.y + c.height, height: 1.6 * MM } : null;
}
const lines = linesOf(page); // a fence sets no line of its own: then the first line after it
return lines.find((r) => r.from < f.to && r.to > f.from)
?? lines.find((r) => r.from >= f.from && r.from - f.to < REACH);
}
function paintMarks(canvas, page, faults, scale) {
const ctx = canvas.getContext('2d');
ctx.setTransform(scale, 0, 0, scale, 0, 0); // page px from here on
Object.assign(ctx, { font: `${3 * MM}px "${MONO}"`, textAlign: 'center' });
const taken = []; // the numbers set so far: two on one line sit side by side
faults.forEach((f, n) => {
const r = spotOf(page, f);
if (!r) return;
const wash = f.kind === 'looseLine'; // a loose line is washed, any other fault underlined
Object.assign(ctx, { fillStyle: palette.proof, globalAlpha: wash ? 0.2 : 1 });
ctx.fillRect(r.x, wash ? r.y : r.y + r.height, r.width, wash ? r.height : 0.45 * MM);
const [left, y] = [r.x + r.width / 2 < page.width / 2, r.y + r.height / 2]; // nearest margin
const shift = taken.filter((ty) => Math.abs(ty - y) < 4.5 * MM).length * 5.2 * MM;
const [x, edge] = [left ? 6.5 * MM + shift : page.width - 6.5 * MM - shift,
left ? r.x : r.x + r.width]; // the number, and a leader from it to the text
taken.push(y);
ctx.globalAlpha = 1;
ctx.fillRect(Math.min(x, edge), y - 0.12 * MM, Math.abs(x - edge), 0.24 * MM);
ctx.beginPath();
ctx.arc(x, y, 2.4 * MM, 0, 2 * Math.PI);
ctx.fill();
ctx.fillStyle = palette.paper;
ctx.fillText(String(n + 1), x, y + 1.05 * MM);
});
}
Cada linha do VDT leva sourceStart e sourceEnd, e o intervalo de origem de um erro leva à linha que o imprimiu. Um delimitador de contêiner não imprime linha própria, e sua marca vai para a primeira linha que começa nos REACH (80) caracteres seguintes. Um calloutOverflow ganha uma barra sob o pé da coluna que ele indica. Um só deslize pode deixar várias marcas. Os cifrões sem escape transformam $2.50 on foot, $ numa fórmula, que não imprime nada porque este pen nunca carrega o motor de matemática, e o terceiro cifrão abre uma fórmula que nunca se fecha. Sem esse trecho, uma linha do parágrafo das tarifas sai com espaços 1,9 vez maiores que o normal. Os dois delimitadores que faltam ao box de dados o deixam aberto, com seu grupo :::columns, até o fim da notícia, e o que vem depois é composto dentro deles, na segunda coluna do grupo. Um grupo de colunas é cortado entre as colunas como o box que o contém, por isso só com esses dois delimitadores nada transborda. Quem faz transbordar é o delimitador da cronologia. O box dela, aberto dentro do box de dados, fica com os cinco últimos parágrafos e o colofão, e um box dentro de outro nunca é cortado. Ele é composto na página 3 e passa 69 mm do pé da coluna; o que fica abaixo desse pé não é impresso, e a primeira prova tem três páginas em vez de duas. O aviso leva o intervalo de origem do box de dados, que é o box que a composição colocou, por isso a entrada 8 seleciona o box de fora, do delimitador até o fim da notícia. proof() considera uma linha frouxa quando o espaço entre palavras, lineWordSpacing(line), passa de maxWordSpacing (1,6 aqui). Uma linha cujos espaços passariam de 3× não tem proporção para comparar, porque o motor a compõe em bandeira, e por isso proof() confere também ragged.
#4 · Selecione o Markdown por trás de uma linha
function selectSource(from, to) {
const all = source.value; // measure the wrapped height of the text before the selection
source.value = all.slice(0, from);
const top = source.scrollHeight;
source.value = all;
source.focus({ preventScroll: true });
source.setSelectionRange(from, to); // the offsets the parser and the layout give
source.scrollTop = top > source.clientHeight ? top - source.clientHeight / 3 : 0;
}
function onPageClick(canvas, page) {
canvas.onclick = ({ clientX, clientY }) => {
const box = canvas.getBoundingClientRect(); // CSS px to page px
const [x, y] = [(clientX - box.left) * (page.width / box.width),
(clientY - box.top) * (page.height / box.height)];
const hit = linesOf(page).find((r) => x >= r.x && x <= r.x + r.width && y >= r.y
&& y <= r.y + r.height);
if (hit?.from !== undefined) selectSource(hit.from, hit.to);
};
}
Um clique chega em pixels CSS. onPageClick() o converte para pixels de página, encontra a linha cujo bbox o contém e seleciona o intervalo de origem dessa linha no textarea; uma entrada da lista seleciona do mesmo jeito o intervalo do erro. selectSource() dá foco ao textarea sem rolar a página e define o scrollTop pela altura do texto anterior à seleção. O bbox de uma linha justificada mantém a largura natural da linha, não a largura com que ela é pintada, de modo que linesOf() o estende até a borda direita do bloco. Do contrário, o fundo pararia antes da margem, e um clique perto da borda direita não selecionaria nada.
#5 · Deixe o box se dividir e prenda o carimbo
const boxes = [
// keepTogether: false: cut between two blocks at the page foot; a line of white closes it.
{ id: 'facts', keepTogether: false, backgroundEnabled: false, marginBottom: pt(LEAD),
stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('proof') },
padding: { ...NONE, top: mm(2.6) }, titleStyle: { ...caps(8), color: col('proof') },
body: { fontSize: pt(9), lineHeight: pt(LEAD), textAlign: 'left', firstLineIndent: pt(0) },
lists: { bulletChar: '•', color: col('proof') } },
// 'fixed': pinned to the page its fence falls on, out of the flow; 'auto': as wide as its title.
{ id: 'stamp', placement: 'fixed', width: 'auto', backgroundEnabled: false,
title: t({ en: 'Proof · 2nd pass', es: 'Segundas pruebas' }),
fixed: { anchor: { to: 'page', edge: 'top-right' }, offset: { x: mm(-OUTER), y: mm(8) } },
border: { enabled: true, color: col('proof'), width: pt(1.2) }, borderRadius: mm(1),
padding: { top: mm(1.4), right: mm(2.4), bottom: mm(1.2), left: mm(2.4) },
titleStyle: { ...caps(9), color: col('proof'), gap: mm(0) } },
];
keepTogether: false deixa o box de dados começar no pé da página 1 e continuar no verso sob o fio vermelho, sem título. O box não tem fundo nem fio no pé, por isso na página 2 só o branco separa o horário da notícia, e marginBottom é uma linha inteira de entrelinha, 14 pt; com 4 pt, o horário terminaria 1,5 mm acima do parágrafo seguinte. O carimbo é placement: 'fixed', fora do fluxo e preso 8 mm abaixo da borda superior, e width: 'auto' o encolhe até a largura do título, 42 mm em vez dos 110 mm da coluna principal.
A receita completa
// ═══ Postext Cookbook · Nº 055 · A galley proof with every fault marked in red ══════
// https://postext.dev/en/cookbook/proof-sheet-diagnostics
// Code: MIT · Text: original (CC BY 4.0) · Map: code (CC BY 4.0) · Photo: diffusion models
// Fonts: Charis SIL, Chivo, Fragment Mono (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import { buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
parseMarkdownWithIssues, KNOWN_DIRECTIVES, KNOWN_CONTAINERS, lineWordSpacing,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'proof-sheet-diagnostics';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// col() links a colour to its palette entry; the hex is the value the entry holds.
const palette = { // proof: the one accent and the marks; rule: the map's banks; muted: furniture
ink: '#1d1d1b', proof: '#d7263d', paper: '#f6f3ea', rule: '#bdb8aa', muted: '#76726a' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [...Object.entries(palette), ['main-color', palette.proof]] // every default
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })); // on main-color: red
const [TEXT, DISPLAY, MONO] = ['Charis SIL', 'Chivo', 'Fragment Mono'];
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER] = [190, 253, 22, 20, 17, 14]; // mm, mirrored
const MEASURE = TRIM_W - INNER - OUTER; // mm: 159, the text block the opener spans
const [LEAD, ART_H, DPI] = [14, 50, 150]; // pt: leading; mm: the photograph; page px/inch
const NONE = { top: mm(0), right: mm(0), bottom: mm(0), left: mm(0) };
const caps = (size) => ({ fontFamily: MONO, fontSize: pt(size), letterSpacing: pt(size * 0.12),
textTransform: 'uppercase', fontWeight: 400 });
const below = (id, gap, width = MEASURE) => ({ anchor: { to: id, edge: id === 'container'
? 'top-left' : 'below' }, offset: { x: mm(0), y: mm(gap) }, size: { width: mm(width) } });
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 opener = { enabled: true, slot: { elements: [ // the drawing, then the words under it
{ kind: 'image', id: 'art', resourceId: 'crossing', placement: { ...below('container', 0),
size: { width: mm(MEASURE), height: mm(ART_H) } } },
// The words start 6 mm under the drawing, and the opener reserves down to the byline.
text('kicker', '{attr.kicker}', MONO, 8, 'proof', below('container', ART_H + 6), caps(8)),
text('title', '{titleText}', DISPLAY, 50, 'ink', below('#kicker', 1.4),
{ fontWeight: 900, lineHeight: 0.96 }), // a multiple of the size
text('standfirst', '{attr.standfirst}', TEXT, 11.5, 'ink', below('#title', 4, 136),
{ italic: true, lineHeight: 1.3 }),
text('byline', '{attr.byline}', MONO, 7.5, 'muted', below('#standfirst', 3), caps(7.5))] } };
const head = (id, content, parity, edge, x, y = 12) => text(id, content, MONO, 7.5, 'muted',
{ anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(y) } }, { ...caps(7.5), parity,
pages: 'body', align: edge.split('-')[1] ?? 'center' }); // y: mm from the trim
const RUNNING = t({ en: ['The Tideline · issue 41', 'News · the night ferry'],
es: ['La Marea · número 41', 'Noticias · la barcaza nocturna'] });
const header = { elements: [
head('verso', `{pageNumber} ${RUNNING[0]}`, 'even', 'top-left', OUTER),
<section id="proof">
<header>
<p id="slug" data-en="The Tideline 41 · news galley · proof desk" data-es="La Marea 41 · galerada · mesa de pruebas"></p>
<h2 id="verdict"></h2>
<p id="passes"></p>
</header>
<div class="desk">
<div id="galley"></div>
<ol id="report"></ol>
</div>
<div class="source">
<label for="source" data-en="The galley’s Markdown: click a line on a page to select it here" data-es="El Markdown de la galerada: pulsa una línea de una página para seleccionarla aquí"></label>
<textarea id="source" spellcheck="false"></textarea>
<p>
<button id="again" type="button" data-en="Proof again" data-es="Revisar de nuevo"></button>
<button id="fixed" type="button" data-en="Load the second pass" data-es="Cargar las segundas pruebas"></button>
</p>
</div>
<template id="words"><!-- the report's words, in the language of the sample -->
<i data-key="unclosedMath" data-en="Unclosed maths" data-es="Fórmula sin cerrar"></i>
<i data-key="unclosedMathBlock" data-en="Unclosed display maths" data-es="Fórmula en bloque sin cerrar"></i>
<i data-key="formula" data-en="Stray formula" data-es="Fórmula perdida"></i>
<i data-key="unclosedContainer" data-en="Unclosed fence" data-es="Valla sin cerrar"></i>
<i data-key="calloutOverflow" data-en="Box runs {} mm past its column" data-es="El recuadro desborda su columna en {} mm"></i>
<i data-key="unknownResourceId" data-en="Unknown id: prints “?”" data-es="Id desconocido: imprime «?»"></i>
<i data-key="unknownDirective" data-en="Unknown directive: prints as text" data-es="Directiva desconocida: sale como texto"></i>
<i data-key="yearList" data-en="A year opened a numbered list" data-es="Un año abrió una lista numerada"></i>
<i data-key="looseLine" data-en="Loose line, {}×" data-es="Línea floja, {}×"></i>
<i data-key="raggedLine" data-en="Line set ragged: its spaces would pass 3×" data-es="Línea en bandera: sus espacios pasarían de 3×"></i>
<i data-key="addressHyphen" data-en="Hyphen added inside an address" data-es="Guion añadido dentro de una dirección"></i>
<i data-key="unsettled" data-en="Layout did not settle in {} passes" data-es="La composición no se asentó en {} pasadas"></i>
<i data-key="faults" data-en="{} faults" data-es="{} fallos"></i>
<i data-key="fault" data-en="{} fault" data-es="{} fallo"></i>
<i data-key="clean" data-en="Nothing to mark" data-es="Nada que marcar"></i>
<i data-key="first" data-en="on the first pass" data-es="en las primeras pruebas"></i>
<i data-key="second" data-en="on the second pass" data-es="en las segundas pruebas"></i>
<i data-key="edited" data-en="in the edited copy" data-es="en la copia editada"></i>
<i data-key="page" data-en="Proof, page {}" data-es="Prueba, página {}"></i>
<i data-key="title" data-en="The Tideline · galley proof" data-es="La Marea · galerada"></i>
</template>
</section>
<main id="pages"></main>
/* The proof desk: the first pass marked in red beside its report, the Markdown under them.
Colours repeat the palette in script.js: newsprint, ink, the proofreader's red. */
#proof {
background: #e6e0d2; color: #1d1d1b; padding: 36px 32px 40px;
font: 15px/1.45 "Charis SIL", Georgia, serif;
}
#proof > * { max-width: 1216px; margin-inline: auto; }
#proof header { margin-bottom: 24px; }
#slug, #passes {
margin: 0; font: 12px/1.2 "Fragment Mono", monospace; letter-spacing: .14em;
text-transform: uppercase;
}
#slug { color: #b81d31; margin-bottom: 10px; }
#passes { color: #5f5b54; margin-top: 12px; text-transform: none; letter-spacing: .04em; }
#verdict { margin: 0; font: 900 clamp(38px, 6vw, 72px)/.95 Chivo, sans-serif; letter-spacing: -.01em; }
.desk { display: grid; grid-template-columns: auto minmax(0, 1fr); gap: 32px; align-items: start; }
#galley { display: flex; flex-wrap: wrap; gap: 14px; max-width: 854px; } /* two pages a row */
#galley canvas {
display: block; width: 420px; aspect-ratio: 190 / 253; cursor: text; /* DESK_W */
box-shadow: 0 1px 2px rgb(40 30 20 / .25), 0 18px 36px -18px rgb(40 30 20 / .55);
}
#report { list-style: none; margin: 0; padding: 0; border-top: 3px solid #d7263d; }
#report button {
all: unset; box-sizing: border-box; display: grid; grid-template-columns: 30px minmax(0, 1fr);
column-gap: 12px; width: 100%; padding: 9px 0 10px; border-bottom: 1px solid #bdb8aa; cursor: pointer;
}
#report button:hover span, #report button:focus-visible span { color: #b81d31; }
#report b {
grid-row: span 2; width: 26px; height: 26px; border-radius: 50%; background: #d7263d;
color: #f6f3ea; font: 13px/26px "Fragment Mono", monospace; text-align: center;
}
#report span { font: 400 16px/1.25 Chivo, sans-serif; }
#report code {
font: 12px/1.5 "Fragment Mono", monospace; color: #5f5b54;
overflow: hidden; white-space: nowrap; text-overflow: ellipsis;
}
.source { margin-top: 28px; }
.source label {
display: block; margin-bottom: 8px; font: 12px/1.3 "Fragment Mono", monospace; color: #5f5b54;
}
#source {
display: block; width: 100%; height: 280px; box-sizing: border-box; padding: 14px 16px;
font: 13px/1.6 "Fragment Mono", monospace; color: #1d1d1b; background: #f6f3ea;
border: 1px solid #bdb8aa; resize: vertical;
}
#source::selection { background: #d7263d; color: #f6f3ea; }
.source p { margin: 12px 0 0; display: flex; gap: 10px; flex-wrap: wrap; }
.source button {
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
#Mantenha o box inteiro
Com o keepTogether padrão, o box passa inteiro para a página 2; a página 1 termina 33 mm antes e a notícia vai para uma terceira página.
- { id: 'facts', keepTogether: false, backgroundEnabled: false, marginBottom: pt(LEAD),
+ { id: 'facts', backgroundEnabled: false, marginBottom: pt(LEAD),#Interrompa uma composição que ainda tem erros
Num script de build ou num teste, rode proof() sobre a versão final e lance um erro se ele encontrar alguma coisa.
const doc = await build(markdown); // last: the corrected galley, the pages below
+if (proof(markdown, doc).length) throw new Error('The second pass still has faults.');Erros comuns
Erro comum
Um $ solto abre matemática: escreva \$
O cifrão abre matemática em linha, então um preço como $40 inicia uma fórmula. Escreva \$40. Escapes e caracteres literais →
Erro comum
'1998. ' ou '- ' no início de um parágrafo abre uma lista
Um parágrafo que começa com um número, um ponto e um espaço, ou com um hífen e um espaço, vira item de lista. Coloque um word joiner (U+2060) antes do número e escreva os diálogos com travessão. Escapes e caracteres literais →
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 →
Aviso do Markdown · unclosedContainer
Contêiner não fechado
Por quê. Um contêiner ::: nunca é fechado; por isso, vai até o fim do documento.
Correção. Acrescente uma linha só com ::: onde o contêiner termina. Docs →
Aviso de diagramação · calloutOverflow
Boxe ultrapassa a coluna
Por quê. Uma caixa que nenhum corte consegue dividir (uma figura, uma tabela ou um boxe aninhado nela mais alto que a coluna, ou um splitMinLines alto demais) foi colocada transbordando; o motor registra isso em doc.warnings e o Sandbox mostra na lista. Um boxe com span: 'side' mais alto que uma coluna lateral vazia também é colocado transbordando.
Correção. Encurte a caixa, deixe que ela se divida com keepTogether: false, reduza splitMinLines ou dê a ela outro span. Docs →
Verificação do Sandbox · unknownResourceId
Recurso desconhecido
Por quê. Um :ref ou ::resource cita um id que nenhum recurso tem; a referência imprime “?” e nada é colocado.
Correção. Corrija o id (só com aspas duplas) ou acrescente o recurso. Docs →
Aviso de diagramação · unknownDirective
Diretiva desconhecida
Por quê. Uma linha :::nome não é nenhuma das diretivas nem dos contêineres do Postext; por isso, é impressa como texto.
Correção. Compare a grafia com os nomes aceitos (pagebreak, columnbreak, numbering, space, toc, callout, paragraphs, part, columns, paper). Docs →
Verificação do Sandbox · looseLine
Linha frouxa
Por quê. Uma linha justificada estica os espaços além do limite, quase sempre por causa de uma palavra longa, uma URL ou uma medida estreita.
Correção. Ative a hifenização no idioma certo, aumente a medida, reescreva o trecho ou componha essa passagem alinhada à esquerda. Docs →
- Ajuste o texto para que o box encha a página 1 até a última linha. Um box que fecha uma página desce até o pé quando as colunas são equilibradas (
headings.balancing.closingBox,'first'por padrão): corte a última frase do primeiro parágrafo e o fio do box fica 6,4 mm abaixo do parágrafo das tarifas em vez de 2,4 mm.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imagens
- The night crossing at the head of page 1 · Generated With Diffusion Models · original
- The route map, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
- Fontes
- Charis SIL (SIL OFL 1.1) · Chivo (SIL OFL 1.1) · Fragment Mono (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


