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
// 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
- Funcions
- Vers línia a líniaEstils de paràgrafÍndex generalEspai vertical explícitSagnats, alineació i separació de paràgrafsEscapaments i caràcters literalsTítols numeratsObertures dissenyadesEstils de títolCapítols sense númeroAtributs de títolImatges als dissenys de pàginaCobertes, portades i colofonsMetadades del documentCapçaleres per seccióCapçaleres i folisTipus de recurs propisFigures just aquíPaleta de color semànticaCapçaleres segons el tipus de pàgina
- 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.

#2 · Les línies que envolten un poema també tenen estil
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
// '{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
// 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
// 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
// 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
// ═══ 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
:::verseobre 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=startcada 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
pagesa'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
- Recepta
- Ignacio Ferro
- 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)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


