En pocas palabras
Un librito con cuatro poemas sobre la naturaleza de Gerard Manley Hopkins. Enseña a respetar cada verso por separado, con las sangrías originales del poeta y una línea en blanco entre estrofas.
Lo que vas a componer
Un poemario de 140 × 216 mm con cuatro poemas de Gerard Manley Hopkins sobre la naturaleza, según la primera edición (1918). Tras la anteportada, un fotograma de helecho y serbal hace de frontispicio frente a la portada, compuesta en Italiana. El índice da el número romano y el título en cursiva de cada poema, con puntos espaciados hasta la página. Cada poema abre página bajo su número. Cada poema es un bloque :::verse y conserva las sangrías de 1918: en Pied Beauty se escalonan según la rima, y los largos de The Windhover siguen en la línea de abajo con 4 em de sangría, el doble que sus sangrías. Entre estrofas queda una línea en blanco, y ninguna palabra se parte salvo donde la partió Hopkins. Debajo de cada poema va la fecha, a la derecha, y tras el último, una ramita de serbal. Los poemas llevan el folio centrado abajo.
Esta receta responde a
- ¿Cómo compongo poesía: un verso por línea, espacio entre estrofas, sangría francesa en los versos que no caben y sin separación silábica?
- ¿Cómo añado espacio vertical entre dos bloques, si las líneas en blanco no hacen nada?
- ¿Cómo añado un índice que se actualice solo (líneas de puntos, números de página, autores, filas de parte)?
- ¿Cómo compongo un epígrafe, una dedicatoria, una firma o una cita destacada con una comilla grande?
- ¿Cómo compongo ilustraciones sin numerar: adornos, viñetas, logotipos?
La respuesta corta
// 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.
Ingredientes
- Funciones
- Verso línea a líneaEstilos de párrafoÍndice generalEspacio vertical explícitoSangrías, alineación y separación de párrafosEscapes y caracteres literalesTítulos numeradosAperturas diseñadasEstilos de títuloCapítulos sin númeroAtributos de títuloImágenes en los diseños de páginaCubiertas, portadas y colofonesMetadatos del documentoCabeceras por secciónCabeceras y foliosTipos de recurso propiosFiguras justo aquíPaleta de color semánticaCabeceras según el tipo de página
- Tipografía
- Sorts Mill Goudy, Italiana, Marcellus SC (SIL OFL 1.1)
- Recursos
plate-1120.jpg- El fotograma del frontispicio, con helecho y serbal (Generated With Diffusion Models, original)
- El adorno de serbal, dibujado en código con la paleta de la página (Ignacio Ferro, CC BY 4.0)
Elaboración
#1 · Un poema es un bloque :::verse
Un bloque :::verse conserva cada línea del Markdown como un verso, así que el poema se escribe como se imprime (:::verse). Sus espacios iniciales son las sangrías, dos por eme, de modo que los versos que riman entre sí quedan a la misma distancia del margen, como en 1918. Una línea en blanco entre estrofas deja una línea de la rejilla base y se descarta si cae en lo alto de una página. Un verso que no cabe en la medida se parte en un espacio entre palabras y cuelga según la hangingIndent del estilo del verso, contada desde el inicio del propio verso: 2 em más allá de un verso sin sangría, 4 em bajo uno sangrado 2 em, para que nadie tome el resto por otro verso. align=start alinea cada poema con el margen; sin él, el poema se centra sobre su verso más largo. El verso no se divide con guion, y un verso nunca se separa de su resto en un salto de página.

#2 · Las líneas que rodean un poema también tienen estilo
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 dedicatoria de The Windhover, encima del poema, y el lugar y la fecha, debajo de cada uno, acompañan a los versos sin formar parte de ellos. Cada una de esas líneas es un contenedor :::paragraphs con un solo párrafo, y por eso admite un estilo propio. Ninguno de los dos estilos fija el interlineado y sus márgenes miden una línea (15 pt), de modo que el poema no se sale de la rejilla del texto base. La fecha queda una línea por debajo del último verso, alineada a la derecha, en Marcellus SC de 8 pt, la misma letra de los folios.
#3 · Cada poema abre página bajo su 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 lugar de su texto, el título imprime un diseño en la columna. Ahí, {number} es el contador con el formato de numberingTemplate: '{1:I}', de I a IV, y {titleText} es el título (apertura a toda página y diseño avanzado). El nivel no tiene margen inferior, y minHeight hace que el título de cada poema ocupe seis líneas de la rejilla (31,75 mm). El número y un título de una línea llenan cuatro, y un título que pasa a dos líneas llena cinco; así, todos los poemas empiezan en la misma línea de la página. En la página 6, esa línea es la de la dedicatoria. La paridad 'any' salta a la página siguiente, par o impar, y entre los poemas no queda ninguna página en blanco.
#4 · Los preliminares también son títulos
// 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 estilo de encabezado puede saltar a una página nueva y dibujar en ella un diseño, así que la anteportada, el frontispicio y la portada son un título cada uno, con su estilo. Con numbered: false no entran en la cuenta, y el primer poema sigue siendo el I. toc: false los deja fuera del índice, y como su pie de página está vacío, sus páginas no llevan folio (estilos de encabezado). Los estilos ocupan la página entera porque a un diseño que se queda en la columna lo recorta el pie de la caja de texto: la lámina, que va a sangre, perdería la parte de abajo y se quedaría sin pie. El pie de la lámina sale del atributo caption del título; el autor, el título y el subtítulo de la portada, del frontmatter.
#5 · El índice se rellena solo
// 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 recoge cada título cuyo estilo lo admite en el índice, con el número de la misma plantilla y la etiqueta de la página donde cae. El libro se compone de nuevo hasta que esas etiquetas dejen de cambiar (índice general). El título de la propia página, Contents, tiene un estilo con numbered: false; sin él, Contents sería el poema I. Con '. ' como carácter de relleno, cada punto va seguido de un espacio. Los puntos se alinean a la derecha, para que coincidan de una entrada a otra, y salen con la letra y el color de los números de página, porque toc.leader no tiene ajuste de color.
#6 · Un adorno es un tipo de recurso sin rótulo
// 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 imagen en el texto es un recurso, y todo recurso tiene un tipo. El tipo del adorno tiene vacío el prefijo del pie y la ramita no lleva pie, de modo que debajo no aparece ningún rótulo como «Figure 1» (tipos de recurso). El defaultPlacement del tipo coloca la ramita donde está ::resource{id="sprig"}, centrada y con un quinto de la medida; para el remate bajo Inversnaid basta esa línea del Markdown. resourceTypes sustituye a la lista predeterminada, por lo que este libro no tiene tipos de figura ni de tabla. Si los necesitas, pon ...defaultResourceTypes() en la lista, delante del adorno.
La receta 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
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Sangra más los versos partidos
Con una sangría francesa mayor, el resto de cada verso partido queda más lejos del margen. Sirve para poemas en los que muchos versos no caben en la línea.
- 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#Compón los versos partidos a la derecha
Con turnover: 'right' en bodyText.verse, el resto de un verso que no cabe en la medida pasa a la línea de abajo alineado a la derecha, tras un corchete de apertura, como lo componen muchas ediciones de poesía.
indentAfterHeading: false, minWordSpacing: 0.8, maxWordSpacing: 1.6,
+ verse: { turnover: 'right' }, // a turnover flush right, behind [
},#Abre cada poema en página impar
Con la paridad 'odd', cada poema salta a la siguiente página impar. El libro pasa de ocho páginas a once, y las tres pares que quedan en blanco no llevan folio, porque los folios se filtran por el 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 los poemas con cifras
El estilo del contador en la plantilla cambia a la vez el número de la página del poema y el del índice.
-const poems = { level: 1, numberingTemplate: '{1:I}', advancedDesign: poemHead,
+const poems = { level: 1, numberingTemplate: '{1}', advancedDesign: poemHead,Errores frecuentes
Error frecuente
«1998. » o «- » al principio de un párrafo abren una lista
Un párrafo que empieza por un número, un punto y un espacio, o por un guion y un espacio, se convierte en un elemento de lista. Pon un unidor de palabras (U+2060) antes del número y escribe los diálogos con raya. Escapes y caracteres literales →
Error frecuente
Un estilo de título hereda el salto de página de su nivel
Una entrada de headingStyles toma de su nivel de título todo lo que no fija, también breakBefore. Un índice o un colofón con estilo sobre un H1 tras un :::pagebreak hereda la paridad 'odd' y cae detrás de una página en blanco. Dale a ese estilo breakBefore: { enabled: false }. Estilos de título →
Error frecuente
::resource{id="…"} solo admite comillas dobles
Una inserción de bloque solo se reconoce como ::resource{id="…"} con comillas dobles; cualquier otra forma se queda en el texto como una línea visible. Figuras justo aquí →
- Mantén juntos los versos de una estrofa: una línea en blanco dentro de un bloque
:::verseabre otra estrofa, sean cuantas sean las líneas en blanco. - Un verso que empieza con un signo más y un espacio es un verso escalonado, que empieza donde terminó el de arriba; escribe
\+para imprimir el signo más. - Sin
align=startcada poema se centra sobre su verso más largo, y entonces cada uno queda a una distancia distinta del margen. - Para que dos palabras pasen juntas a la línea de abajo, únelas con un espacio de no separación (U+00A0), como the soil y bright wings. en la página 5.
- Un elemento del pie de página con
pagesen'all'se imprime también en las páginas en blanco. Aquí el folio se compone de dos elementos, uno para las aperturas y otro para las páginas de texto, así que una página par en blanco se queda en blanco.
Créditos
- Receta
- Ignacio Ferro
- Texto
- «God’s Grandeur», «The Windhover», «Pied Beauty» e «Inversnaid», con los lugares y las fechas de las notas del editor, en la primera edición de Poems of Gerard Manley Hopkins (1918); los acentos y las sangrías, cotejados con la transcripción revisada de esa edición en Wikisource · Gerard Manley Hopkins; Robert Bridges (editor) · dominio público
- La nota sobre el texto, el pie de la lámina y el colofón · Ignacio Ferro · CC BY 4.0
- Imágenes
- El fotograma del frontispicio, con helecho y serbal · Generated With Diffusion Models · original
- El adorno de serbal, dibujado en código con la paleta de la página · Ignacio Ferro · CC BY 4.0
- Fuentes
- Sorts Mill Goudy (SIL OFL 1.1) · Italiana (SIL OFL 1.1) · Marcellus SC (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


