Saltar al contingut principal
Recepta número 15

Receptari · Capítol 2 · Text i tipografia

Poemes compostos vers a vers

Cada poema és un bloc :::verse escrit com s'imprimeix: els sagnats de 1918 són espais inicials i els versos partits pengen 2 em del seu vers.

En aquesta pàgina
Gènere
Poesia
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.34.0
Llicència
Actualitzada el 16 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en anglès: encara no hi ha edició en català
  • Format 140 × 216 mm
  • 1 columna
  • Sorts Mill Goudy 11/15
  • Italiana
  • Marcellus SC
  • 8 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 59 ms
  • 159 línies de codi

En poques paraules

Un llibret amb quatre poemes sobre la natura de Gerard Manley Hopkins. Ensenya a respectar cada vers per separat, amb els sagnats originals del poeta i una línia en blanc entre estrofes.

Què compondràs

Un poemari de 140 × 216 mm amb quatre poemes de Gerard Manley Hopkins sobre la natura, segons la primera edició (1918). Després de l'avantportada, un fotograma de falguera i server fa de frontispici davant de la portada, composta en Italiana. L'índex dona el número romà i el títol en cursiva de cada poema, amb punts espaiats fins a la pàgina. Cada poema obre pàgina sota el seu número. Cada poema és un bloc :::verse i conserva els sagnats de 1918: a Pied Beauty s'esglaonen segons la rima, i els llargs de The Windhover continuen a la línia de sota amb 4 em de sagnat, el doble que els seus sagnats. Entre estrofes queda una línia en blanc, i cap paraula no es parteix tret d'on la va partir Hopkins. Sota cada poema va la data, a la dreta, i després de l'últim, una branqueta de server. Els poemes porten el foli centrat a baix.

Aquesta recepta respon a

  • Com componc poesia: un vers per línia, espai entre estrofes, sagnat francès als versos que no hi caben i sense partició de mots?
  • Com afegeixo espai vertical entre dos blocs, si les línies en blanc no fan res?
  • Com afegeixo un índex que s'actualitzi sol (línies de punts, números de pàgina, autors, files de part)?
  • Com componc un epígraf, una dedicatòria, una signatura o una cita destacada amb una cometa gran?
  • Com componc il·lustracions sense numerar: ornaments, vinyetes, logotips?

La resposta curta

script.js · línies 31–46al codi complet
// A poem is one :::verse block written as it is printed: a line of verse a line, a blank line
// between stanzas (one line of the grid), and spaces before an indented line, two to an em:
//   :::verse{style="verse" align=start}
//   The world is charged with the grandeur of God.
//       It will flame out, like shining from shook foil;
//
//   And for all this, nature is never spent;
//   :::
// align=start sets the poem flush with the margin (the default centres it on its longest line).
const verse = {
  id: 'verse',
  hangingIndent: em(2), // a turnover hangs 2 em past its line's start: 4 em under a 2 em indent
  // Verse keeps its words whole, even where bodyText.hyphenation.ragged is switched on.
  hyphenation: false,
};
// Hook-up: paragraphStyles: [verse, …]; the Markdown goes to buildDocument as it is written.

Ingredients

Tipografia
Sorts Mill Goudy, Italiana, Marcellus SC (SIL OFL 1.1)
Recursos
  • plate-1120.jpg
  • The frontispiece photogram of fern and rowan (Generated With Diffusion Models, original)
  • The rowan ornament, drawn in code in the page’s palette (Ignacio Ferro, CC BY 4.0)

Elaboració

#1 · Un poema és un bloc :::verse

Un bloc :::verse conserva cada línia del Markdown com un vers, de manera que el poema s'escriu com s'imprimeix (:::verse). Els espais inicials en són els sagnats, dos per eme, de manera que els versos que rimen entre si queden a la mateixa distància del marge, com el 1918. Una línia en blanc entre estrofes deixa una línia de la retícula base i es descarta si cau al capdamunt d'una pàgina. Un vers que no cap a la mesura es parteix en un espai entre paraules i penja segons la hangingIndent de l'estil del vers, comptada des de l'inici del mateix vers: 2 em més enllà d'un vers sense sagnat, 4 em sota un de sagnat 2 em, perquè ningú no prengui la resta per un altre vers. align=start alinea cada poema amb el marge; sense, el poema es centra sobre el seu vers més llarg. El vers no es parteix amb guionet, i un vers no se separa mai de la seva resta en un salt de pàgina.

The Windhover, pàgina 6: els versos que rimen en -iding entren 2 em, i els quatre que no hi caben continuen a la línia de sota, amb 4 em de sagnat francès.

#2 · Les línies que envolten un poema també tenen estil

script.js · línies 50–54al codi complet
const lineStyles = [
  { id: 'dedication', fontSize: pt(9.5), marginBottom: pt(LEAD) }, // under The Windhover
  { id: 'date', fontFamily: 'Marcellus SC', fontSize: pt(8), color: col('muted'),
    textAlign: 'right', marginTop: pt(LEAD) }, // a line of space above, flush right
];

La dedicatòria de The Windhover, damunt del poema, i el lloc i la data, sota cadascun, acompanyen els versos sense formar-ne part. Cadascuna d'aquestes línies és un contenidor :::paragraphs amb un sol paràgraf, i per això admet un estil propi. Cap dels dos estils no fixa l'interlineat i els seus marges fan una línia (15 pt), de manera que el poema no surt de la retícula del cos. La data queda una línia per sota de l'últim vers, alineada a la dreta, en Marcellus SC de 8 pt, la mateixa lletra dels folis.

#3 · Cada poema obre pàgina sota el seu número

script.js · línies 58–73al codi complet
// '{1:I}' numbers the poems I to IV: {number} prints the numeral here, :::toc in the contents.
// The head is HEAD_LINES grid lines (minHeight, no bottom margin), so each poem starts on the same
// line; numeral and title fill 4, or 5 if the title wraps.
const HEAD_LINES = 6;
const poemHead = { enabled: true, minHeight: pt(LEAD * HEAD_LINES), slot: { elements: [
  { kind: 'text', id: 'numeral', content: '{number}', fontFamily: 'Italiana', fontSize: pt(22),
    color: col('sage'), align: 'left',
    placement: { anchor: { to: 'container', edge: 'top-left' } } },
  { kind: 'text', id: 'title', content: '{titleText}', fontFamily: 'Sorts Mill Goudy',
    italic: true, fontSize: pt(17), color: col('ink'), align: 'left',
    placement: { anchor: { to: '#numeral', edge: 'below' }, offset: { y: mm(2) },
      size: { width: 'fill' } } },
] } };
// Parity 'any': the next page, recto or verso, with no blank page between two poems.
const poems = { level: 1, numberingTemplate: '{1:I}', advancedDesign: poemHead,
  marginBottom: pt(0), breakBefore: { enabled: true, parity: 'any' } };

En lloc del seu text, el títol imprimeix un disseny a la columna. Allà, {number} és el comptador amb el format de numberingTemplate: '{1:I}', de I a IV, i {titleText} és el títol (extensió i disseny avançat). El nivell no té marge inferior, i minHeight fa que el títol de cada poema ocupi sis línies de la retícula (31,75 mm). El número i un títol d'una línia n'omplen quatre, i un títol que passa a dues línies n'omple cinc; així, tots els poemes comencen a la mateixa línia de la pàgina. A la pàgina 6, aquesta línia és la de la dedicatòria. La paritat 'any' salta a la pàgina següent, parella o senar, i entre els poemes no queda cap pàgina en blanc.

#4 · Els preliminars també són títols

script.js · línies 77–106al codi complet
// Headings too, each on a page of its own, with no number, contents entry or folio.
// A style restates the break, or inherits the poems' (gotcha: style-inherits-break).
const leaf = { numbered: false, toc: false, span: 'page', footer: { elements: [] },
  breakBefore: { enabled: true, parity: 'any' } };
const onPage = (y, width) => ({ anchor: { to: 'page', edge: 'top' }, offset: { y: mm(y) },
  ...(width && { size: { width: mm(width) } }) }); // centred, y mm below the trim
const face = (id, content, font, size, y, extra = {}) => ({ kind: 'text', id, content,
  fontFamily: font, fontSize: pt(size), color: col('ink'), align: 'center',
  placement: onPage(y), ...extra });
const image = (id, placement) => ({ kind: 'image', id, resourceId: id, placement });
const design = (...elements) => ({ enabled: true, slot: { elements } });
const front = [
  { id: 'half-title', ...leaf,
    advancedDesign: design(face('title', '{titleText}', 'Italiana', 20, 60)) },
  { id: 'plate', ...leaf, advancedDesign: design( // span 'page': a column's foot would cut it
    image('plate', { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill' } }),
    face('caption', '{attr.caption}', 'Sorts Mill Goudy', 8.5, 203,
      { italic: true, color: col('muted') })) },
  { id: 'title-page', ...leaf, advancedDesign: design(
    face('author', '{author}', 'Marcellus SC', 10, 46, // {author}, {title}: the frontmatter
      { letterSpacing: pt(2.4), textTransform: 'uppercase' }),
    face('title', '{title}', 'Italiana', 54, 56, { lineHeight: 1 }),
    face('subtitle', '{subtitle}', 'Sorts Mill Goudy', 13, 80,
      { italic: true, color: col('sage') }),
    image('sprig', onPage(96, 30)),
    face('press', '{attr.press}', 'Marcellus SC', 8.5, 182,
      { letterSpacing: pt(1.8), color: col('muted') })) },
  { id: 'contents', ...leaf, span: 'column', advancedDesign: { enabled: false },
    fontFamily: 'Italiana', fontSize: pt(24), lineHeight: pt(LEAD * 2), marginBottom: pt(LEAD) },
];

Un estil d'encapçalament pot saltar a una pàgina nova i dibuixar-hi un disseny, així que l'avantportada, el frontispici i la portada són un títol cadascun, amb el seu estil. Amb numbered: false no entren al compte, i el primer poema continua sent el I. toc: false els deixa fora de l'índex, i com que el seu peu de pàgina és buit, les seves pàgines no porten foli (estils d'encapçalament). Els estils ocupen la pàgina sencera perquè un disseny que es queda a la columna el retalla el peu de la caixa de text: la làmina, que va a sang, perdria la part de baix i es quedaria sense peu. El peu de la làmina surt de l'atribut caption del títol; l'autor, el títol i el subtítol de la portada, del frontmatter.

#5 · L'índex s'omple sol

script.js · línies 110–116al codi complet
// The numerals stand on the titles' baseline, in Italiana and sage, at the titles' size.
const contents = {
  levels: [{ level: 1, italic: true, marginBottom: pt(LEAD), numberFontFamily: 'Italiana',
    numberFontWeight: 400, numberColor: col('sage'), numberWidth: mm(6), numberGap: mm(3) }],
  pageNumber: { fontFamily: 'Marcellus SC', fontSize: pt(9), color: col('muted'), width: mm(6) },
  leader: { char: '. ', gap: mm(2) }, // spaced dots, right-aligned so they line up
};

:::toc recull cada títol que el seu estil admet a l'índex, amb el número de la mateixa plantilla i l'etiqueta de la pàgina on cau. El llibre es torna a compondre fins que aquestes etiquetes deixen de canviar (índex general). El títol de la mateixa pàgina, Contents, té un estil amb numbered: false; sense aquest estil, Contents seria el poema I. Amb '. ' com a caràcter de farciment, cada punt va seguit d'un espai. Els punts s'alineen a la dreta, perquè coincideixin d'una entrada a l'altra, i surten amb la lletra i el color dels números de pàgina, perquè toc.leader no té paràmetre de color.

#6 · Un ornament és un tipus de recurs sense rètol

script.js · línies 120–124al codi complet
// No caption prefix and no caption: the sprig prints bare, where ::resource{id="sprig"} puts
// it (double quotes: gotcha resource-double-quotes), a fifth of the measure wide, centred.
const ornament = { id: 'ornament', name: 'Ornament', shortLabel: '', captionPrefix: '',
  numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
  defaultPlacement: { position: 'here', width: 0.2, align: 'center' } };

Una imatge al text és un recurs, i tot recurs té un tipus. El tipus de l'ornament té buit el prefix del peu i la branqueta no porta peu, de manera que a sota no apareix cap rètol com «Figure 1» (tipus de recurs). El defaultPlacement del tipus col·loca la branqueta on és ::resource{id="sprig"}, centrada i amb una cinquena part de la mesura; per al cul-de-llàntia sota Inversnaid n'hi ha prou amb aquesta línia del Markdown. resourceTypes substitueix la llista per defecte, per la qual cosa aquest llibre no té tipus de figura ni de taula. Si els necessites, posa ...defaultResourceTypes() a la llista, davant de l'ornament.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 015 · Poems set line by line ═════════════════════════════
// https://postext.dev/en/cookbook/poetry-collection
// Code: MIT · Text: G. M. Hopkins, Poems, 1918 (PD) · Plate: diffusion models · Sprig: code
// Fonts: Sorts Mill Goudy, Italiana, Marcellus SC (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

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

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // every colour in the config links to one of these
  ink: '#26221f', // the text: a warm near-black
  sage: '#56673f', // the one accent: numerals, the subtitle, the ornament's leaves
  sepia: '#8c5f3a', // used for the rowan berries only
  muted: '#746a60', // dates, folios, leaders and the colophon
  paper: '#fbf8f2', // the page
};
// A colour is its hex and the palette entry it follows.
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 accent, so nothing prints blue.
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.sage, model: 'hex' } },
];
const TRIM_W = 140, TRIM_H = 216; // mm: a poetry trim, tall enough for a sonnet's turnovers
const LEAD = 15; // pt: the body's leading, the grid every line of verse sits on

// #region answer: verse: a :::verse block keeps each line, its indent, the stanza breaks
// A poem is one :::verse block written as it is printed: a line of verse a line, a blank line
// between stanzas (one line of the grid), and spaces before an indented line, two to an em:
//   :::verse{style="verse" align=start}
//   The world is charged with the grandeur of God.
//       It will flame out, like shining from shook foil;
//
//   And for all this, nature is never spent;
//   :::
// align=start sets the poem flush with the margin (the default centres it on its longest line).
const verse = {
  id: 'verse',
  hangingIndent: em(2), // a turnover hangs 2 em past its line's start: 4 em under a 2 em indent
  // Verse keeps its words whole, even where bodyText.hyphenation.ragged is switched on.
  hyphenation: false,
};
// Hook-up: paragraphStyles: [verse, …]; the Markdown goes to buildDocument as it is written.
// #endregion

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

#Sagna més els versos partits

Amb un sagnat francès més gran, la resta de cada vers partit queda més lluny del marge. Serveix per a poemes en què molts versos no caben a la línia.

-  hangingIndent: em(2), // a turnover hangs 2 em past its line's start: 4 em under a 2 em indent
+  hangingIndent: em(4), // a turnover hangs 2 em past its line's start: 4 em under a 2 em indent

#Compon els versos partits a la dreta

Amb turnover: 'right' a bodyText.verse, la resta d'un vers que no cap a la mesura passa a la línia de sota alineada a la dreta, darrere d'un claudàtor d'obertura, com la componen moltes edicions de poesia.

     indentAfterHeading: false, minWordSpacing: 0.8, maxWordSpacing: 1.6,
+    verse: { turnover: 'right' }, // a turnover flush right, behind [
   },

#Obre cada poema en pàgina senar

Amb la paritat 'odd', cada poema salta a la pàgina senar següent. El llibre passa de vuit pàgines a onze, i les tres parelles que queden en blanc no porten foli, perquè els folis es filtren pel rol de la pàgina.

 const poems = { level: 1, numberingTemplate: '{1:I}', advancedDesign: poemHead,
-  marginBottom: pt(0), breakBefore: { enabled: true, parity: 'any' } };
+  marginBottom: pt(0), breakBefore: { enabled: true, parity: 'odd' } };

#Numera els poemes amb xifres

L'estil del comptador a la plantilla canvia alhora el número de la pàgina del poema i el de l'índex.

-const poems = { level: 1, numberingTemplate: '{1:I}', advancedDesign: poemHead,
+const poems = { level: 1, numberingTemplate: '{1}', advancedDesign: poemHead,

Errors freqüents

Error freqüent

«1998. » o «- » al començament d'un paràgraf obren una llista

Un paràgraf que comença per un número, un punt i un espai, o per un guionet i un espai, es converteix en un element de llista. Posa un unidor de paraules (U+2060) davant del número i escriu els diàlegs amb guió llarg. Escapaments i caràcters literals →

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 →

Error freqüent

::resource{id="…"} només admet cometes dobles

Una inserció de bloc només es reconeix com a ::resource{id="…"} amb cometes dobles; qualsevol altra forma es queda al text com una línia visible. Figures just aquí →

  • Mantén junts els versos d'una estrofa: una línia en blanc dins d'un bloc :::verse obre una altra estrofa, siguin quantes siguin les línies en blanc.
  • Un vers que comença amb un signe més i un espai és un vers esglaonat, que comença on va acabar el de dalt; escriu \+ per imprimir el signe més.
  • Sense align=start cada poema es centra sobre el seu vers més llarg, i llavors cadascun queda a una distància diferent del marge.
  • Perquè dues paraules passin juntes a la línia de sota, uneix-les amb un espai de no separació (U+00A0), com the soil i bright wings. a la pàgina 5.
  • Un element del peu de pàgina amb pages a 'all' s'imprimeix també a les pàgines en blanc. Aquí el foli es compon de dos elements, un per a les obertures i un altre per a les pàgines de text, així que una pàgina parella en blanc queda en blanc.

Crèdits

Text
  • “God’s Grandeur”, “The Windhover”, “Pied Beauty” and “Inversnaid”, with the places and dates from the editor’s notes, in the first edition of Poems of Gerard Manley Hopkins (1918); accents and indents checked against the proofread Wikisource transcription of that edition · Gerard Manley Hopkins; Robert Bridges (editor) · domini públic
  • The note on the text, the plate’s caption and the colophon · Ignacio Ferro · CC BY 4.0
Imatges
  • The frontispiece photogram of fern and rowan · Generated With Diffusion Models · original
  • The rowan ornament, drawn in code in the page’s palette · Ignacio Ferro · CC BY 4.0
Fonts
Sorts Mill Goudy (SIL OFL 1.1) · Italiana (SIL OFL 1.1) · Marcellus SC (SIL OFL 1.1)
Sandbox