Saltar al contenido principal
Receta número 15

Recetario · Capítulo 2 · Texto y tipografía

Poemas compuestos verso a verso

Cada poema es un bloque :::verse escrito como se imprime: las sangrías de 1918 son espacios iniciales y los versos partidos cuelgan 2 em de su verso.

En esta página
Género
Poesía
Salida
Canvas
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.34.0
Licencia
Actualizada el 16 oct 2026
Código MIT · Texto CC BY 4.0

pp. 2–3 de 8

  • Muestra en inglés: aún no hay edición en español
  • Formato 140 × 216 mm
  • 1 columna
  • Sorts Mill Goudy 11/15
  • Italiana
  • Marcellus SC
  • 8 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 59 ms
  • 159 líneas de código

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

script.js · líneas 31–46en el código completo
// 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

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.

The Windhover, página 6: los versos que riman en -iding entran 2 em, y los cuatro que no caben en la página siguen en la línea de abajo, con 4 em de sangría francesa.

#2 · Las líneas que rodean un poema también tienen estilo

script.js · líneas 50–54en el código completo
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

script.js · líneas 58–73en el código completo
// '{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

script.js · líneas 77–106en el código completo
// 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

script.js · líneas 110–116en el código completo
// 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

script.js · líneas 120–124en el código completo
// 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

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

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 :::verse abre 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=start cada 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 pages en '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

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)
Sandbox