Saltar al contingut principal
Recepta número 32

Receptari · Capítol 6 · Requadres i notes

Clàssic anotat amb glosses al marge

El berenar de bojos d'Alícia en edició anotada: glosses verdes i vermelles al marge exterior, al costat del que expliquen, amb crides del mateix color.

En aquesta pàgina
Sortida
Canvas
Nivell
Avançat
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.28.0
Llicència
Actualitzada el 11 d’oct. del 2026
Codi MIT · Text CC BY 4.0

pp. 82–83 · 2–3 de 3

  • Mostra en anglès: encara no hi ha edició en català
  • Format 156 × 234 mm
  • Columna i mitja, espai entre columnes de 4,5 mm
  • Unna 9,5/14
  • Cormorant SC
  • Rozha One
  • 3 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 68 ms
  • 207 línies de codi

En poques paraules

Unes pàgines d'Alícia al país de les meravelles amb notes de l'editor al marge. Cada nota va al costat de les línies que explica, marcada amb una lletra de color.

Què compondràs

El començament del capítol VII d'Alice’s Adventures in Wonderland, el berenar de bojos, en tres pàgines d'una edició anotada de 156 × 234 mm. El text de Carroll va en una columna justificada d'Unna, d'uns 66 caràcters per línia. Una columna lateral de 33 mm al costat del tall exterior recull les vuit glosses de l'editor, cadascuna al costat del paràgraf que porta la seva crida, a la dreta a les pàgines senars i a l'esquerra a les parelles. Les de paraules i acudits van en verd i les d'història en vermell, igual que les lletres que les criden. El capítol s'obre sota una aquarel·la de la taula del te vista des de dalt, amb el número, el títol en Rozha One i una entradeta en cursiva amb caplletra verda, i al marge, al costat de l'entradeta, va la nota sobre aquesta edició.

Aquesta recepta respon a

  • Com poso notes al marge o glosses al costat del paràgraf que expliquen?
  • Com faig notes a peu de pàgina?
  • Com compono en columna i mitja, amb una columna de text ampla i una de lateral estreta?
  • Com afegeixo a una obertura una línia d'autor, una entradeta o un primer paràgraf amb caplletra?

La resposta curta

script.js · línies 36–61al codi complet
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

Ingredients

Tipografia
Unna, Rozha One, Cormorant SC (SIL OFL 1.1)
Recursos
  • tea-table-1560.jpg
  • The tea-table seen from above, a watercolour (Generated With Diffusion Models, original)

Elaboració

#1 · Deixa el tall exterior per a les glosses

El codi és la resposta curta de dalt. En una disposició en columna i mitja, sideColumnPercent: 26 dona a la columna lateral 33 dels 127 mm que hi ha entre marges, i al text li queden 89,5 mm després de l'espai entre columnes de 4,5 mm. Amb sideColumnRole: 'floats' el text de Carroll no entra a la columna lateral, que només rep el que s'hi col·loca amb span: 'side'. Una nota a peu de pàgina espera al peu de la columna, sota un filet; al marge, cada glossa queda a l'altura de la línia que explica i les glosses no treuen línies a la columna de text. Els dos estils de glossa només es diferencien en el color del filet i del títol, així que el lector distingeix una glossa sobre una paraula d'una altra sobre història abans de llegir-la.

#2 · Reflecteix la pàgina perquè el canal segueixi el tall exterior

script.js · línies 75–86al codi complet
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;

Amb mirror: true els marges s'intercanvien a cada pàgina parella, i sideColumnSide: 'outer' hi porta la columna lateral, així que les glosses baixen per la dreta de les pàgines 81 i 83 i per l'esquerra de la 82. Els marges de 22 mm a dalt i a baix deixen 190 mm, lloc per a 38 línies de 14 pt, i cada glossa comença en una línia d'aquesta mateixa retícula.

#3 · Posa cada glossa abans del paràgraf que explica

script.js · línies 90–104al codi complet
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'] } };

Un requadre amb span="side" a la seva tanca :::callout surt del flux i es col·loca a la columna lateral a l'altura del bloc que segueix la línia de tancament. Per això cada glossa s'obre just abans del paràgraf que porta la seva crida, com a l'exemple de sota. Les glosses a i b acompanyen el primer paràgraf, de manera que els seus requadres queden entre el títol i aquest paràgraf. Un requadre que surt del flux no compta com el bloc que segueix el títol, de manera que indentAfterHeading: false deixa igualment aquest paràgraf sense sagnat. El cos està ajustat a la columna: a 9,5 pt, el paràgraf que comença «“Have some wine,”» cap en una línia de 89,5 mm, i a 10,4 pt totes les mesures entre 77 i 93 mm li deixaven una última línia curta, com «ing tone.» o «tone.». L'espai entre paraules d'Unna és estret, 0,22 em, i amb el minWordSpacing per defecte, 0,6, una línia de la pàgina 83 el reduïa al 0,69 de la seva amplada; amb minWordSpacing: 0.75 aquesta línia ja no és possible. A la pàgina 81 el diccionari partia el nom de la protagonista, «Al-» i «ice»; aquest paràgraf va dins de :::paragraphs{style="whole"}, un estil amb hyphenation: false, i l'únic tall que té és un guionet opcional (U+00AD) escrit a «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 · Dona a cada lletra el color de la seva glossa

script.js · línies 65–71al codi complet
// 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')];

El Markdown no té marcatge per al text en color, però un estil de chip sí que fixa un color de text, així que cada crida és un xip amb un estil que es diu igual que el tipus de la seva glossa. :chip[^c^]{style="context"} imprimeix una c vermella, el mateix vermell del filet i del títol de la glossa c. Sense fons, contorn, farciment ni separació, el xip no afegeix amplada i cada línia es talla on es tallava amb un ^c^ sense res més.

#5 · Obre el capítol sota la taula del te

script.js · línies 108–155al codi complet
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) } } },
] } };

La ranura de disseny del títol ocupa tota la pàgina perquè l'aquarel·la pugui arribar al tall. L'avanttítol, el títol i l'entradeta pengen sota l'aquarel·la, i l'obertura reserva fins al més baix de tots tres, amb l'alçada arrodonida a la retícula; el marge inferior que el títol porta per defecte afegeix una línia en blanc. Amb una entradeta de quatre línies el text comença a la línia 23, i una cinquena el baixaria a la 24. El número, l'entradeta i la nota sobre aquesta edició surten d'atributs del títol, {num="VII" headnote="…" source="…"}. El número es pren d'aquí perquè {chapterNumber} imprimiria 1 en un fragment que és un document a part. La caplletra obre l'entradeta de l'editor, en cursiva i en bandera, i el text de Carroll comença justificat a sota, ja al flux. dropSize() calcula el cos de la caplletra perquè la seva part superior quedi a l'altura de les majúscules de la primera línia de l'entradeta.

#6 · Dona a cada glossa el color del que explica

script.js · línies 16–30al codi complet
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)'),
];

El verd gespa marca les glosses sobre paraules, dites i acudits, i el vermell melmelada les de persones, dates i història del text. N'hi ha prou amb un valor nou a jam, al mateix objecte palette, per tornar a pintar alhora les glosses d'història, les seves crides i l'avanttítol; l'aquarel·la de dalt es va triar per aquest mateix verd gespa i aquest vermell melmelada.

La recepta completa

Sandbox
// ═══ 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

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

#Deixa les glosses a la dreta a totes les pàgines

Per a una edició que es llegeix pàgina a pàgina en pantalla, desactiva els marges simètrics: 'outer' passa a ser la vora dreta de totes les pàgines, i les capçaleres no es mouen, perquè van ancorades a les vores de la pàgina.

-    mirror: true } };
+    mirror: false } };

#Porta les notes llargues al peu de la pàgina

Escriu com a nota a peu de pàgina la que no càpiga al marge, amb [^1] al text i la seva definició [^1]: sota el paràgraf: Postext la compon al peu de la columna de text, a 89,5 mm d'amplada i sota un filet curt, i les glosses conserven la columna lateral. Notes al peu de la columna que les cita mostra com donar estil a aquestes notes.

Errors freqüents

Error freqüent

Un requadre lateral comença a l'altura del bloc que segueix la seva tanca

A postext 1.4.1, un requadre amb span: 'side' es col·loca a la columna lateral a l'altura on ha arribat el text a la seva tanca, a la línia següent de la retícula i sota els requadres que ja hi hagi. Posa la tanca d'una glossa just abans del paràgraf que explica: si va després, la glossa comença al costat del paràgraf següent. Un requadre que passaria del peu de la columna puja fins que el seu peu coincideix amb el de la columna, si el requadre de sobre li deixa lloc; si tot i així no hi cap, espera la columna lateral de la pàgina següent. Notes al marge →

  • Les glosses s'apilen en l'ordre del Markdown, l'una sota l'altra, així que una glossa llarga empeny cap avall la següent. A la pàgina 81 les dues crides cauen a la segona línia del primer paràgraf: la glossa a comença a l'altura del paràgraf i la b a continuació, cinc línies per sota de la seva crida. On les crides quedin a prop, escriu glosses breus.

Crèdits

Text
  • Alice’s Adventures in Wonderland (1865), the opening of chapter VII, “A Mad Tea-Party” · Lewis Carroll · domini públic
  • The headnote, the eight glosses and the note on this edition · Ignacio Ferro · CC BY 4.0
Imatges
  • The tea-table seen from above, a watercolour · Generated With Diffusion Models · original
Fonts
Unna (SIL OFL 1.1) · Rozha One (SIL OFL 1.1) · Cormorant SC (SIL OFL 1.1)
Sandbox