Em poucas palavras
Algumas páginas de Alice no País das Maravilhas com notas do editor na margem lateral. Cada nota fica ao lado das linhas que explica, marcada por uma letra colorida.
O que você vai compor
O começo do capítulo VII de Alice’s Adventures in Wonderland, o chá maluco, composto em três páginas de uma edição anotada num formato de 156 × 234 mm. O texto de Carroll corre numa coluna justificada de Unna, com uns 66 caracteres por linha. Um canal de 33 mm junto à borda externa recebe as oito glosas do editor, cada uma ao lado do parágrafo que traz a letra, de modo que elas descem pela direita numa página ímpar e pela esquerda numa página par. As glosas sobre palavras e piadas são verdes, as de história são vermelhas, e cada letra no texto leva a cor da glosa. O capítulo abre sob uma aquarela da mesa do chá vista de cima, seguida do numeral, do título em Rozha One e de um olho em itálico com capitular verde; a nota sobre esta edição fica na margem, ao lado do olho.
Esta receita responde a
- Como coloco notas de margem ou glosas ao lado do parágrafo que elas explicam?
- Como faço notas de rodapé?
- Como monto uma diagramação em coluna e meia, com uma coluna de texto larga e uma coluna lateral estreita?
- Como acrescento a uma abertura uma linha de autor, uma linha fina ou um primeiro parágrafo com capitular?
A resposta curta
const layout = {
layoutType: 'oneAndHalf', // one text column and a narrower side column
sideColumnPercent: 26, // of the 127 mm between the margins: a 33 mm channel
sideColumnRole: 'floats', // no text runs in it: it holds side boxes and figures
sideColumnSide: 'outer', // at the fore-edge, which mirrored margins move page by page
gutterWidth: mm(4.5), // the text column keeps 127 − 33 − 4.5 = 89.5 mm
};
// A gloss is :::callout{type="note" span="side" title="a · …"} in the Markdown.
// span="side" moves it out of the flow into the channel, level with the block after
// the fence, so the fence goes just before the paragraph that carries its letter.
// Glosses never float. One that meets the gloss above stacks under it. One that would
// run past the column's foot slides up, as far as the gloss above allows, until its
// foot sits on the foot; if it still does not fit, it waits for the next page
// (gotcha: side-box-starts-at-fence).
const gloss = (id, hue) => ({ id,
backgroundEnabled: false, // one device: a hairline over the gloss, in its colour
stripe: { enabled: true, side: 'top', width: pt(0.5), color: col(hue) },
padding: { top: mm(1.5), right: pt(0), bottom: pt(0), left: pt(0) },
// Cormorant SC draws lower case as small capitals: the title needs no textTransform.
titleStyle: { fontFamily: LABEL, fontWeight: 600, fontSize: pt(8.5),
letterSpacing: pt(0.3), color: col(hue), gap: mm(0.8) },
// Face and colours come from bodyText. A box body also inherits its 4 mm first-line
// indent, which a gloss sets back to 0.
body: { fontSize: pt(7.8), lineHeight: pt(10), textAlign: 'left',
firstLineIndent: pt(0) } });
const calloutStyles = [gloss('note', 'lawn'), gloss('context', 'jam')]; // words, history
Ingredientes
- Funcionalidades
- Notas na margemColuna de margem para flutuantesColuna e meiaMargens espelhadasBoxesSobrescritos e subscritosAberturas desenhadasFaixa de capítulo em largura totalTextos, fios e caixas nos designs de páginaImagens nos designs de páginaAncoragem de elementos de designCapitulares nas aberturasAtributos de títuloCabeços e fóliosCabeços por tipo de páginaFiguras e tabelas como recursosPaleta de cores semânticaQuebra de linha ótima (Knuth–Plass)Chips no texto
- Também usa
- Notas de rodapéCor do papel
- Tipografia
- Unna, Rozha One, Cormorant SC (SIL OFL 1.1)
- Materiais
tea-table-1560.jpg- The tea-table seen from above, a watercolour (Generated With Diffusion Models, original)
Preparo
#1 · Dê a borda externa às glosas
O código é a resposta curta logo acima. Num layout de coluna e meia, sideColumnPercent: 26 dá à coluna lateral 33 dos 127 mm entre as margens, e o texto fica com 89,5 mm depois da medianiz de 4,5 mm. sideColumnRole: 'floats' mantém Carroll fora da coluna lateral, que só recebe o que é colocado ali com span: 'side'. Uma nota de rodapé espera no pé da coluna, sob um fio; na margem, cada glosa fica na altura da linha que explica, e as glosas não tiram linhas da coluna de texto. Os dois estilos de glosa só diferem na cor do fio fino e do título, de modo que o leitor distingue uma glosa sobre uma palavra de uma glosa sobre história antes de lê-la.
#2 · Espelhe a página para o canal acompanhar a borda externa
const PT = 25.4 / 72; // mm in a point
const [TRIM_W, TRIM_H] = [156, 234]; // mm
const [TOP, BOTTOM, INNER, OUTER] = [22, 22, 15, 14]; // mm: 38 lines of text
const page = { width: mm(TRIM_W), height: mm(TRIM_H), dpi: 150,
backgroundColor: col('paper'),
// left is a recto's inner margin; mirror swaps the sides on a verso, and 'outer' moves
// the channel with them: right on a recto, left on a verso.
margins: { top: mm(TOP), bottom: mm(BOTTOM), left: mm(INNER), right: mm(OUTER),
mirror: true } };
const CONTENT_W = TRIM_W - INNER - OUTER; // 127 mm
const SIDE_W = CONTENT_W * layout.sideColumnPercent / 100; // 33 mm: the glosses' measure
const TEXT_W = CONTENT_W - SIDE_W - layout.gutterWidth.value;
Com mirror: true as margens se invertem em cada página par, e sideColumnSide: 'outer' leva o canal junto, de modo que as glosas descem pela direita da página 81 e da página 83 e pela esquerda da página 82. Margens superior e inferior de 22 mm deixam 190 mm, espaço para 38 linhas de 14 pt, e cada glosa começa numa linha da mesma grade.
#3 · Ponha cada glosa antes do parágrafo que ela explica
const bodyText = { // justified and hyphenated (en-us) by default
// Copy-fitted to the 89.5 mm column: at 9.5 pt '“Have some wine,” the March Hare said in
// an encouraging tone.' fits one line. At 10.4 pt every measure from 77 to 93 mm left
// it a short last line: 'couraging tone.', 'aging tone.', 'ing tone.' or 'tone.'.
fontFamily: TEXT, fontSize: pt(9.5), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), firstLineIndent: mm(4),
// The chapter's first paragraph is set flush, though the fences of glosses a and b stand
// between the heading and it: a box that leaves the flow is not the block after a heading.
indentAfterHeading: false,
// Unna's space is narrow, 0.22 em. At the default 0.6 the line breaker set 'Alice felt
// dreadfully puzzled. The Hatter’s remark seemed to have' with its spaces at 0.69.
minWordSpacing: 0.75,
// The dictionary divides the heroine's name, 'said Al-' | 'ice indignantly' on page 81.
// The list keeps it whole wherever it stands; every other word is divided as before.
hyphenation: { exceptions: ['Alice'] } };
Um boxe com span="side" no delimitador :::callout sai do fluxo e fica no canal na altura do bloco que vem depois do delimitador, por isso cada glosa é delimitada logo antes do parágrafo que traz a letra, como no exemplo abaixo. As glosas a e b pertencem ao lado do primeiro parágrafo, o que põe os delimitadores entre o título e esse parágrafo. Um boxe que sai do fluxo não conta como o bloco depois do título, por isso indentAfterHeading: false deixa esse parágrafo sem recuo do mesmo jeito. O texto corrido foi ajustado à coluna: em 9,5 pt, o parágrafo que começa com “Have some wine,” cabe numa linha de 89,5 mm, enquanto em 10,4 pt todas as medidas de 77 a 93 mm lhe deixavam uma última linha curta, como “ing tone.” ou “tone.”. O espaço entre palavras da Unna é estreito, 0,22 em, e com o minWordSpacing padrão de 0,6 uma linha da página 83 tinha os espaços apertados a 0,69 dessa largura; minWordSpacing: 0.75 descarta essa linha. Na página 81 o dicionário dividia o nome da protagonista, “Al-” e “ice”; esse parágrafo fica dentro de :::paragraphs{style="whole"}, um estilo com hyphenation: false, e a única quebra é um hífen opcional (U+00AD) digitado em “together”.
:::callout{type="context" span="side" title="c · Hair"}
Tenniel drew Alice with long, loose hair. …
:::
“Your hair wants cutting,”:chip[^c^]{style="context"} said the Hatter. …#4 · Imprima cada letra na cor da sua glosa
// A letter in the text is a chip named after its gloss's type, :chip[^a^]{style="note"}:
// the Markdown has no mark for coloured text, and a chip style sets a colour. With no
// fill, outline, padding or gap the chip adds no width, so the lines break as they would
// with a plain ^a^.
const letter = (id, hue) => ({ id, backgroundEnabled: false, borderWidth: pt(0),
paddingX: pt(0), gap: pt(0), color: col(hue), bold: true });
const chipStyles = [letter('note', 'lawn'), letter('context', 'jam')];
O Markdown não tem marcação para texto colorido, mas um estilo de chip define uma cor de texto, de modo que cada letra é um chip cujo estilo tem o mesmo nome do tipo da glosa. :chip[^c^]{style="context"} imprime um c vermelho, o mesmo vermelho do fio e do título da glosa c. Sem preenchimento, contorno, espaçamento interno nem separação, o chip não acrescenta largura, e cada linha quebra onde quebrava com um ^c^ simples.
#5 · Abra o capítulo sob a mesa do chá
const HEADPIECE = 72; // mm: the depth of the painting at the head of the page
const HEADNOTE = { size: 9.8, lead: LEAD }; // pt: the headnote keeps the body's leading
const CAPS = { text: 0.597, initial: 0.56 }; // cap heights, em: Unna and Rozha One
// The initial's size: its capital runs from the first line's cap height down to the
// last baseline it spans. At the default size it stops short of the first line's capitals.
const dropSize = (lines) => pt(((lines - 1) * HEADNOTE.lead + CAPS.text * HEADNOTE.size)
/ CAPS.initial);
const below = (id, y, width) => ({ anchor: { to: `#${id}`, edge: 'below' },
offset: { y: mm(y) }, size: { width } });
// The opener reserves the height of its lowest element, rounded up to the grid, and the
// heading's default bottom margin adds one blank line: with a four-line headnote the
// text starts on line 23. The kicker, the title and the headnote hang below the painting.
const opener = { enabled: true, slot: { elements: [
// An image element draws a resource without number or caption. It hangs from the
// trim's corner, over the top margin and both side margins.
{ kind: 'image', id: 'headpiece', resourceId: 'tea-table',
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: mm(TRIM_W) } } },
// The numeral comes from the heading line,
// # A Mad Tea-Party {num="VII" headnote="…" …}: the excerpt stands alone, so
// {chapterNumber} would count its one heading and print 1.
{ kind: 'text', id: 'kicker', content: 'Chapter {attr.num}', fontFamily: LABEL,
fontWeight: 600, fontSize: pt(9), letterSpacing: pt(2), textTransform: 'uppercase',
color: col('jam'), align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { y: mm(HEADPIECE - TOP + 8) } } }, // 8 mm under the painting's foot
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY,
fontSize: pt(40), lineHeight: 1.05, color: col('ink'), align: 'left', // wraps when longer
placement: below('kicker', 2, 'fill') },
// The drop cap opens the headnote, the editor's voice, italic and ragged; Carroll's
// text opens in the flow, justified.
{ kind: 'text', id: 'headnote', content: '{attr.headnote}', fontFamily: TEXT,
italic: true, fontSize: pt(HEADNOTE.size),
lineHeight: pt(HEADNOTE.lead), color: col('ink'),
align: 'left',
dropCap: { lines: 2, fontFamily: DISPLAY, fontSize: dropSize(2), color: col('lawn'),
gap: mm(1.5) },
placement: below('title', 5, mm(TEXT_W)) },
// The note on this edition stands in the channel, level with the headnote's top.
{ kind: 'text', id: 'edition-label', content: 'This edition', fontFamily: LABEL,
fontWeight: 600, fontSize: pt(8.5), letterSpacing: pt(0.3), color: col('muted'),
align: 'left', placement: { anchor: { to: '#headnote', edge: 'right-of' },
offset: { x: layout.gutterWidth }, size: { width: mm(SIDE_W) } } },
{ kind: 'text', id: 'edition', content: '{attr.source}', fontFamily: TEXT,
fontSize: pt(7.5), lineHeight: pt(10), color: col('muted'), align: 'left',
placement: { anchor: { to: '#edition-label', edge: 'below' }, offset: { y: mm(0.8) },
size: { width: mm(SIDE_W) } } },
] } };
O encaixe de design do título ocupa a página inteira para que a pintura possa chegar ao refile. O antetítulo, o título e o olho ficam pendurados abaixo da pintura, e a abertura reserva até o mais baixo deles, com a altura arredondada para a grade; a margem inferior padrão do título acrescenta uma linha em branco. Com um olho de quatro linhas, o texto começa na linha 23, e uma quinta linha o levaria para a linha 24. O numeral, o olho e a nota sobre esta edição vêm de atributos de título, {num="VII" headnote="…" source="…"}. O numeral vem dali porque {chapterNumber} imprimiria 1 num trecho que é um documento à parte. A capitular abre o olho do editor, composto em bandeira e em itálico, e o texto de Carroll começa justificado no fluxo, logo abaixo. dropSize() dimensiona a inicial para que o topo se alinhe com as maiúsculas da primeira linha do olho.
#6 · Dê a cada glosa a cor do que ela explica
const palette = {
ink: '#1f1b1a', // text: a warm near-black
lawn: '#1e6f6b', // glosses on words and jokes, the drop cap
jam: '#b23a48', // glosses on history, the kicker
muted: '#6e645b', // running heads, the note on this edition
paper: '#f8f3e6', // the page, and the tablecloth
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const entry = (id, hex, name = id) => ({ id, name, value: { hex, model: 'hex' } });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => entry(id, hex)),
// The engine's defaults link to 'main-color': aimed at the green, nothing prints blue.
entry('main-color', palette.lawn, 'lawn (defaults)'),
];
O verde-grama marca as glosas sobre palavras, ditos e piadas, e o vermelho-geleia marca pessoas, datas e a história do texto. Um novo valor para jam, no mesmo objeto palette, recolore numa só edição as glosas de história, as letras e o antetítulo; a aquarela acima delas foi escolhida pelo mesmo verde-grama e pelo mesmo vermelho-geleia.
A receita completa
// ═══ Postext Cookbook · Nº 032 · Annotated classic with margin glosses ════════════
// https://postext.dev/en/cookbook/annotated-classic-glosses
// Code: MIT · Text: Lewis Carroll (PD), glosses (CC BY 4.0) · Headpiece: diffusion models
// Fonts: Unna, Rozha One, Cormorant SC (SIL OFL 1.1) · Needs postext ≥ 1.28.0
// The mad tea-party as an annotated edition: the text keeps to one column, and its glosses stand
// in the outer margin beside the lines they explain, changing sides with the spread.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en')
const RECIPE = 'annotated-classic-glosses';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a lawn green and a jam red on cream paper
const palette = {
ink: '#1f1b1a', // text: a warm near-black
lawn: '#1e6f6b', // glosses on words and jokes, the drop cap
jam: '#b23a48', // glosses on history, the kicker
muted: '#6e645b', // running heads, the note on this edition
paper: '#f8f3e6', // the page, and the tablecloth
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const entry = (id, hex, name = id) => ({ id, name, value: { hex, model: 'hex' } });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => entry(id, hex)),
// The engine's defaults link to 'main-color': aimed at the green, nothing prints blue.
entry('main-color', palette.lawn, 'lawn (defaults)'),
];
// #endregion
const [TEXT, DISPLAY, LABEL] = ['Unna', 'Rozha One', 'Cormorant SC'];
const LEAD = 14; // body leading in pt: the grid of every page
// #region answer: a float-only channel at the fore-edge, and two gloss styles for it
const layout = {
layoutType: 'oneAndHalf', // one text column and a narrower side column
sideColumnPercent: 26, // of the 127 mm between the margins: a 33 mm channel
sideColumnRole: 'floats', // no text runs in it: it holds side boxes and figures
sideColumnSide: 'outer', // at the fore-edge, which mirrored margins move page by page
gutterWidth: mm(4.5), // the text column keeps 127 − 33 − 4.5 = 89.5 mm
};
// A gloss is :::callout{type="note" span="side" title="a · …"} in the Markdown.
// span="side" moves it out of the flow into the channel, level with the block after
// the fence, so the fence goes just before the paragraph that carries its letter.
// Glosses never float. One that meets the gloss above stacks under it. One that would
// run past the column's foot slides up, as far as the gloss above allows, until its
// foot sits on the foot; if it still does not fit, it waits for the next page
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 as glosas à direita em todas as páginas
Para uma edição lida uma página por vez na tela, desative o espelhamento: 'outer' passa a significar a borda direita de todas as páginas, e os cabeços continuam no lugar, já que são ancorados ao refile.
- mirror: true } };
+ mirror: false } };#Mande as notas longas para o pé da página
Escreva uma nota longa demais para a margem como nota de rodapé, [^1] no texto e a definição [^1]: abaixo do parágrafo: o Postext a compõe no pé da coluna de texto, com 89,5 mm de largura sob um fio curto, e as glosas continuam com o canal. Notas de rodapé no pé da coluna que as cita mostra como estilizar essas notas.
Erros comuns
Erro comum
Um boxe lateral começa na altura do bloco que vem depois do seu delimitador
No postext 1.4.1, um boxe com span: 'side' fica na coluna lateral na altura a que o texto chegou no seu delimitador, na linha seguinte da grade e abaixo dos boxes que já estiverem ali. Abra o delimitador de uma glosa logo antes do parágrafo que ela explica: se vier depois, a glosa começa ao lado do parágrafo seguinte. Um boxe que passaria do pé da coluna sobe até seu pé coincidir com o da coluna, se o boxe de cima permitir; se mesmo assim não couber, espera pela coluna lateral da página seguinte. Notas na margem →
- As glosas se empilham na ordem do Markdown, uma embaixo da outra, por isso uma glosa longa empurra a seguinte para baixo. Na página 81, as duas letras caem na segunda linha do primeiro parágrafo: a glosa a começa na altura do parágrafo e a glosa b abaixo dela, cinco linhas abaixo da letra. Onde as letras ficam próximas, escreva glosas curtas.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Alice’s Adventures in Wonderland (1865), the opening of chapter VII, “A Mad Tea-Party” · Lewis Carroll · domínio público
- The headnote, the eight glosses and the note on this edition · Ignacio Ferro · CC BY 4.0
- Imagens
- The tea-table seen from above, a watercolour · Generated With Diffusion Models · original
- Fontes
- Unna (SIL OFL 1.1) · Rozha One (SIL OFL 1.1) · Cormorant SC (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)


