Saltar al contingut principal
Recepta número 30

Receptari · Capítol 5 · Estructura del llibre

Antologia amb signatures d'autor

Tres assaigs sobre caminar amb títols que porten autor, any i revista: l'obertura imprimeix les tres dades; les capçaleres parelles i l'índex, només l'autor.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en anglès: encara no hi ha edició en català
  • Format 135 × 180 mm
  • 1 columna
  • Spectral 10/14
  • Gloock
  • Hanken Grotesk
  • 9 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 64 ms
  • 175 línies de codi

En poques paraules

Un llibret de tres assaigs sobre caminar. L'autor i l'any de cada assaig s'escriuen una vegada i després apareixen on el llibre els necessita, com a l'índex.

Què compondràs

Nou pàgines d'Afoot, una antologia de butxaca amb tres assaigs sobre caminar, de Hazlitt (1822), Thoreau (1862) i Stevenson (1876), en l'anglès original. Una pintura d'un bruguerar al capvespre, un JPEG generat amb models de difusió, ocupa la coberta. L'índex dona a cada assaig un numeral en vermell òxid, el títol en Gloock, una línia de punts espaiats fins a la seva pàgina i, a sota, el nom de l'autor en cursiva morada. Cada assaig s'obre amb el numeral i el títol, una signatura en majúscules espaiades i la revista i l'any en què es va publicar per primera vegada. Les pàgines parelles porten l'autor a la capçalera; les senars, el títol de l'assaig. El títol de cada assaig porta com a atributs l'autor, l'any i la revista, i l'obertura, les capçaleres i l'índex els prenen d'aquí, de manera que per afegir un quart assaig no cal tocar la configuració.

Aquesta recepta respon a

  • Com afegeixo un índex que s'actualitzi sol (línies de punts, números de pàgina, autors, files de part)?
  • Com afegeixo a una obertura una línia d'autor, una entradeta o un primer paràgraf amb caplletra?
  • Com poso capçaleres: el títol del llibre a la pàgina esquerra, el del capítol a la dreta i el foli per fora?

La resposta curta

script.js · línies 44–64al codi complet
// Each essay's heading carries its credits, and every {attr.…} below reads them:
//   # Walking {author="Henry David Thoreau" year="1862" source="The Atlantic Monthly"}
// (a value cannot hold { or }, and one with " goes in single quotes; gotcha: attr-values)
// 1 · The opener: inside a heading's design, {attr.author} is that heading's attribute.
const byline = [
  text('byline', '{attr.author}', { ...label, fontSize: pt(8), letterSpacing: pt(1.6),
    color: col('heather') }, below('title', 5)),
  text('dateline', '{attr.source}, {attr.year}', { fontFamily: 'Spectral', italic: true,
    fontSize: pt(9.5), color: col('muted'), align: 'left' }, below('byline', 1.2)),
];
// 2 · The verso running head (head() is in the running-heads region): in the page header,
//     {attr.author} is the attribute of the essay the page belongs to.
const versoAuthor = head('verso-author', '{attr.author}', 'even',
  at('page', 'top-left', MARGIN.outer + HEAD.gap, HEAD.y));
// 3 · The contents: toc.subtitle prints the attribute it names as a line under each title.
//     'author' and italic are the defaults; attr is written out so it can become 'source'.
const authorLine = { enabled: true, attr: 'author', fontFamily: 'Spectral', fontSize: pt(10),
  color: col('heather') };
// Hooked up below: byline → the opener, versoAuthor → header, authorLine → toc.subtitle.
// A heading without author="…" gets an empty byline and running head and no line in the
// contents, and the build gives no warning: check every heading.

Ingredients

Tipografia
Spectral, Gloock, Hanken Grotesk (SIL OFL 1.1)
Recursos
  • cover-1200.jpg
  • The cover: a heath and hills at dusk, a painting (Generated With Diffusion Models, original)

Elaboració

#1 · Numerar els assaigs i baixar-ne el text

script.js · línies 68–85al codi complet
const opener = { enabled: true,
  // The hairline ends 7 mm above the foot of this reserve, so the text starts on the same grid
  // line under every opener whose title fits on one line (SINK = 14 holds a two-line title).
  minHeight: pt(SINK * LEAD),
  slot: { elements: [
    // {number} prints the essay's number as numberingTemplate '{1:I}' writes it: I, II, III.
    text('number', '{number}', { ...gloock, fontSize: pt(34), lineHeight: 1, color: col('rust') },
      at('container', 'top-left', 0, 8)),
    text('title', '{titleText}', { ...gloock, fontSize: pt(26), lineHeight: 1.08,
      color: col('ink') }, below('number', 3, { width: 'fill' })),
    ...byline,
    { kind: 'rule', id: 'rule', thickness: pt(0.5), color: col('rule'),
      placement: below('dateline', 6) }, // a horizontal rule runs to the column's edge
  ] } };
const essays = { level: 1, numberingTemplate: '{1:I}', advancedDesign: opener,
  marginBottom: pt(0), // the heading's default margin would add to minHeight
  // The cover and contents styles inherit this break (gotcha: style-inherits-break).
  breakBefore: { enabled: true, parity: 'any' } }; // 'any': each piece opens on the next page

El numberingTemplate: '{1:I}' del nivell numera els assaigs I, II i III, i {number} imprimeix el numeral damunt del títol (extensió i disseny avançat). minHeight reserva 12 línies de 14 pt i el filet fi acaba 7 mm per sobre d'aquest límit, així que, amb un títol d'una línia, el text comença a 79 mm de la vora superior en totes les obertures. Una segona línia de títol, a 26 pt, hi afegeix 9,9 mm i baixa el text una línia de la retícula; amb SINK = 14, el text comença a la mateixa alçada sota títols d'una i de dues línies. El marginBottom: pt(0) del nivell impedeix que el marge per defecte del títol se sumi a aquesta reserva.

#2 · Un índex que s'omple sol

script.js · línies 89–99al codi complet
const ENTRY = 15; // pt: the essay titles in the contents
const contents = { // passed to the config as `toc`
  // An entry's numeral takes the title's face and size and stands on its baseline.
  levels: [{ level: 1, fontFamily: 'Gloock', fontSize: pt(ENTRY), color: col('ink'),
    numberFontWeight: 400, // Gloock has one weight
    numberColor: col('rust'), numberWidth: mm(8), numberGap: mm(3), marginBottom: pt(LEAD) }],
  pageNumber: { fontFamily: 'Hanken Grotesk', fontSize: pt(8.5), fontWeight: 600,
    color: col('muted'), width: mm(6) }, // the leader dots take this face and colour too
  leader: { char: '. ', gap: mm(2) }, // spaced dots, right-aligned so they line up
  subtitle: authorLine,
};

:::toc al Markdown imprimeix una entrada per cada títol inclòs, amb el número, el text del títol, la línia de punts, l'etiqueta de la pàgina i, gràcies a subtitle, l'autor. buildDocument torna a compondre el llibre fins que les etiquetes de pàgina deixen de canviar, de manera que, si un assaig canvia de títol o d'extensió, l'índex s'actualitza (índex general). El numeral de cada entrada pren la font i el cos del títol, tret que numberFontFamily o numberFontSize diguin una altra cosa, i s'assenta a la línia de base de la primera línia del títol amb qualsevol cos. Un llibre amb parts hi afegeix, a més, una fila per cada :::part, amb el disseny de toc.parts.design, com a Parts en color.

#3 · L'autor a la pàgina parella, l'assaig a la senar

script.js · línies 103–119al codi complet
// Each head: the label face, the pages of its parity, never an opener (pages: 'body'), where
// the byline names the author. A function declaration, so the answer above can call it.
function head(id, content, parity, placement, look = {}) {
  return { ...text(id, content, { ...label, fontSize: pt(7.5), letterSpacing: pt(1.3),
    color: col('muted'), ...look }, placement), parity, pages: 'body' };
}
const folio = { color: col('ink') };
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', at('page', 'top-left', MARGIN.outer, HEAD.y), folio),
  versoAuthor,
  head('recto-title', '{chapterTitle}', 'odd',
    at('page', 'top-right', -(MARGIN.outer + HEAD.gap), HEAD.y), { align: 'right' }),
  head('recto-folio', '{pageNumber}', 'odd', at('page', 'top-right', -MARGIN.outer, HEAD.y),
    { ...folio, align: 'right' }),
] };
const footer = { elements: [{ ...head('drop-folio', '{pageNumber}', 'all', // an opener's folio
  at('container', 'top', 0, 9), { ...folio, align: 'center' }), pages: 'opener' }] };

Cada capçalera s'ancora a la pàgina, a 11 mm de la vora superior, i parity tria el costat: el foli s'alinea amb la vora exterior del text, i el nom o el títol queda 7 mm més endins. El pages: 'body' de head() deixa les capçaleres fora de les obertures, on la signatura ja anomena l'autor, i l'element del peu amb pages: 'opener' hi imprimeix el foli, centrat sota el text (elements de text). {chapterTitle} imprimeix el títol de l'assaig sense el numeral.

#4 · La coberta i l'índex no compten

script.js · línies 123–146al codi complet
// Unnumbered, so the first essay is I; unlisted; and with no running heads or folio. They
// inherit the level's page break, 'any' (gotcha: style-inherits-break).
const bare = { numbered: false, toc: false, header: { elements: [] }, footer: { elements: [] } };
const cover = { enabled: true, slot: { elements: [
  { kind: 'image', id: 'art', resourceId: 'cover',
    placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: 'fill' } } },
  text('title', '{titleText}', { ...gloock, fontSize: pt(80), lineHeight: 1, color: col('ink') },
    at('page', 'top-left', MARGIN.inner, 22)), // page 1 is a recto: the inner margin is left
  text('subtitle', '{subtitle}', { fontFamily: 'Spectral', italic: true, fontSize: pt(14),
    color: col('ink'), align: 'left' }, below('title', 1)),
  text('authors', '{attr.authors}', { ...label, fontSize: pt(8.5), letterSpacing: pt(2),
    color: col('heather') }, below('subtitle', 5)),
  text('imprint', '{attr.imprint}', { ...label, fontSize: pt(7.5), letterSpacing: pt(1.8),
    color: col('paper') }, at('page', 'bottom-left', MARGIN.inner, -12)),
] } };
// span: 'page' in a one-column book: a design kept in its column is cut at the column's foot,
// which would leave a band of paper under the dusk.
const coverStyle = { id: 'cover', ...bare, span: 'page', advancedDesign: cover };
const contentsOpener = { enabled: true, slot: { elements: [ // {title}, {subtitle}: frontmatter
  text('kicker', '{title} · {subtitle}', { ...label, fontSize: pt(8), letterSpacing: pt(1.6),
    color: col('heather') }, at('container', 'top-left', 0, 8)),
  text('title', '{titleText}', { ...gloock, fontSize: pt(26), color: col('ink') },
    below('kicker', 2.5)),
] } };

Amb numbered: false, la coberta i l'índex no fan avançar el comptador, així que Hazlitt és el I, i toc: false els deixa fora de la llista (estils d'encapçalament). Els dos estils hereten el breakBefore del nivell, amb paritat 'any', i per això l'índex segueix la coberta a la pàgina 2 sense cap :::pagebreak. L'estil de la coberta ocupa tota la pàgina encara que el llibre tingui una sola columna, perquè un disseny que es queda a la columna es talla al peu d'aquesta i deixaria 22 mm de paper per sota del paisatge.

#5 · Cada color escrit amb el seu enllaç a la paleta

script.js · línies 14–28al codi complet
const palette = {
  ink: '#241f26', // text: a plum-tinted near-black
  paper: '#f7f2e8', // the page
  heather: '#6b4468', // the bylines and the authors in the contents
  rust: '#a4502a', // the essay numbers
  rule: '#d5cabd', // hairlines
  muted: '#6d6570', // running heads, datelines, page numbers in the contents
};
// 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 });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  // The engine's defaults link to 'main-color': point it at the ink, so nothing prints blue.
  { id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];

col() escriu el valor hexadecimal de cada color al costat del seu paletteId, i el motor segueix aquest enllaç: les signatures, les capçaleres i la coberta prenen el que colorPalette desi sota aquell identificador, així que una altra paleta amb els mateixos identificadors canvia el color de tot el llibre. Amb main-color en el color de la tinta, els valors per defecte que la configuració no redefineix surten en aquest color i no en el blau del motor, #295AA3.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 030 · Anthology with bylines ═══════════════════════════════
// https://postext.dev/en/cookbook/anthology-with-bylines
// Code: MIT · Text: Hazlitt, Thoreau, Stevenson (public domain) · Cover: diffusion models
// Fonts: Spectral, Gloock, Hanken Grotesk (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'anthology-with-bylines';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: heather for the credits, rust for the numbers, plum ink on warm paper
const palette = {
  ink: '#241f26', // text: a plum-tinted near-black
  paper: '#f7f2e8', // the page
  heather: '#6b4468', // the bylines and the authors in the contents
  rust: '#a4502a', // the essay numbers
  rule: '#d5cabd', // hairlines
  muted: '#6d6570', // running heads, datelines, page numbers in the contents
};
// 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 });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  // The engine's defaults link to 'main-color': point it at the ink, so nothing prints blue.
  { id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
// #endregion
const TRIM = { width: 135, height: 180 }; // a pocket book, 3 : 4
const MARGIN = { top: 20, bottom: 22, inner: 19, outer: 15 }; // mirrored
const LEAD = 14; // body leading in pt: the baseline grid
const SINK = 12; // grid lines an essay opener reserves above its first line of text
const HEAD = { y: 11, gap: 7 }; // running heads: mm from the top edge, folio to words
const label = { fontFamily: 'Hanken Grotesk', fontWeight: 600, textTransform: 'uppercase',
  align: 'left' }; // design text is centred by default
// One weight, no italic; 'wrap' breaks a long title onto a second line.
const gloock = { fontFamily: 'Gloock', overflow: 'wrap', align: 'left' };
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const below = (id, y, size) => ({ ...at(`#${id}`, 'below', 0, y), ...(size && { size }) });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, ...look, placement });

// #region answer: one set of heading attributes, read in three places
// Each essay's heading carries its credits, and every {attr.…} below reads them:
//   # Walking {author="Henry David Thoreau" year="1862" source="The Atlantic Monthly"}
// (a value cannot hold { or }, and one with " goes in single quotes; gotcha: attr-values)
// 1 · The opener: inside a heading's design, {attr.author} is that heading's attribute.
const byline = [

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

#Indicar on es va publicar cada assaig

toc.subtitle imprimeix qualsevol atribut del títol, així que el mateix Markdown pot posar sota cada títol la revista on es va publicar per primera vegada.

-const authorLine = { enabled: true, attr: 'author', fontFamily: 'Spectral', fontSize: pt(10),
+const authorLine = { enabled: true, attr: 'source', fontFamily: 'Spectral', fontSize: pt(10),

#Posar el títol del llibre a la pàgina parella

Molts llibres posen el seu propi títol a les pàgines parelles i el del capítol a les senars; {title} el pren del frontmatter del Markdown i imprimeix AFOOT.

-const versoAuthor = head('verso-author', '{attr.author}', 'even',
+const versoAuthor = head('verso-author', '{title}', 'even',

#Obrir cada assaig en pàgina senar

Amb la paritat 'odd', Stevenson passa a la pàgina 9, després d'una pàgina 8 en blanc. Els dos estils dels preliminars necessiten llavors el seu propi 'any'; si no, l'índex hereta 'odd' i s'obre a la pàgina 3, després d'una pàgina parella en blanc.

-  breakBefore: { enabled: true, parity: 'any' } }; // 'any': each piece opens on the next page
+  breakBefore: { enabled: true, parity: 'odd' } };
-const bare = { numbered: false, toc: false, header: { elements: [] }, footer: { elements: [] } };
+const bare = { numbered: false, toc: false, breakBefore: { enabled: true, parity: 'any' },
+  header: { elements: [] }, footer: { elements: [] } };

Errors freqüents

Error freqüent

Valors d'atribut: sense { ni }; cometes simples si porten "

Un valor d'atribut acaba a la clau de tancament, així que no pot contenir { ni }. Un valor que porti cometes dobles va entre cometes simples; el signe de dòlar no dona problemes. Atributs de títol →

Error freqüent

Un estil de títol hereta el salt de pàgina del seu nivell

Una entrada de headingStyles pren del seu nivell de títol tot allò que no fixa, també breakBefore. Un índex o un colofó amb estil sobre un H1 després d'un :::pagebreak hereta la paritat 'odd' i cau darrere d'una pàgina en blanc. Dona a aquest estil breakBefore: { enabled: false }. Estils de títol →

  • Hazlitt cita versos enmig de les frases. Els versos van en un bloc :::verse{style="verse" align=start}, una línia de Markdown per vers, entrats 8 mm, i la frase que continua després va en un estil runon, sense sagnat. Una cita en bloc de Markdown no serveix aquí: les seves línies s'uneixen com les d'un paràgraf i els versos sortirien seguits, com prosa.
  • Un atribut que falta en un títol no imprimeix res ni avisa. Sense author="…", la signatura i la capçalera parella d'aquell assaig surten buides i la seva línia sota el títol desapareix de l'índex.

Crèdits

Text
Imatges
  • The cover: a heath and hills at dusk, a painting · Generated With Diffusion Models · original
Fonts
Spectral (SIL OFL 1.1) · Gloock (SIL OFL 1.1) · Hanken Grotesk (SIL OFL 1.1)
Sandbox