Em poucas palavras
Um livrinho com quatro poemas sobre a natureza de Gerard Manley Hopkins. Mostra como manter cada verso separado, com os recuos originais do poeta e uma linha em branco entre as estrofes.
O que você vai compor
Um livrinho de poemas de 140 × 216 mm com quatro poemas de Gerard Manley Hopkins sobre a natureza, no texto da primeira edição, de 1918. Depois da falsa folha de rosto, um fotograma de samambaia e sorveira serve de frontispício diante da folha de rosto, composta em Italiana. O sumário lista cada poema pelo numeral e pelo título em itálico, com pontos espaçados até o número da página. Cada poema abre uma página sob um numeral verde-sálvia e o título em itálico. Cada poema é um bloco :::verse, recuado como em 1918: os versos de Pied Beauty entram em degraus conforme a rima, e os versos longos de The Windhover continuam na linha de baixo com 4 em de recuo, o dobro dos recuos. As estrofes ficam a uma linha de distância, e nenhuma palavra é dividida, a não ser onde Hopkins a dividiu. A data vem embaixo de cada poema, alinhada à direita, e um raminho de sorveira vem depois do último. As páginas dos poemas trazem o fólio centralizado no pé.
Esta receita responde a
- Como componho poesia: um verso por linha, espaço entre estrofes, recuo deslocado nos versos que quebram e sem hifenização?
- Como acrescento espaço vertical entre dois blocos, se as linhas em branco não fazem nada?
- Como acrescento um sumário que se atualiza sozinho (pontilhados, números de página, autores, linhas de parte)?
- Como componho uma epígrafe, uma dedicatória, uma assinatura ou um olho com aspas grandes?
- Como componho ilustrações sem numeração: ornamentos, vinhetas, logotipos?
A 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.
Ingredientes
- Funcionalidades
- Verso linha a linhaEstilos de parágrafoSumárioEspaço vertical explícitoRecuos, alinhamento e espaço entre parágrafosEscapes e caracteres literaisTítulos numeradosAberturas desenhadasEstilos de títuloCapítulos sem númeroAtributos de títuloImagens nos designs de páginaCapas, folhas de rosto e colofõesMetadados do documentoCabeços por seçãoCabeços e fóliosTipos de recurso personalizadosFiguras exatamente aquiPaleta de cores semânticaCabeços por tipo de página
- Tipografia
- Sorts Mill Goudy, Italiana, Marcellus SC (SIL OFL 1.1)
- Materiais
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)
Preparo
#1 · Um poema é um bloco :::verse
Um bloco :::verse mantém cada linha do Markdown como um verso, de modo que o poema se escreve como se imprime (:::verse). Os espaços iniciais são os recuos, dois por eme, por isso os versos que rimam entre si começam à mesma distância da margem, como em 1918. Uma linha em branco entre estrofes deixa uma linha da grade de base e é descartada no alto de uma página. Um verso longo demais para a medida se quebra em um espaço entre palavras e pende pelo hangingIndent do estilo do verso, contado a partir do início do próprio verso: 2 em além de um verso sem recuo, 4 em sob um verso recuado 2 em, para que o resto nunca pareça outro verso. align=start alinha cada poema à margem; sem ele, o poema é centralizado pelo verso mais longo. O verso não é hifenizado, e um verso nunca se separa do resto em uma quebra de página.

#2 · As linhas em volta de um poema também têm 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
];
A dedicatória acima de The Windhover e o local e a data embaixo de cada poema não são versos, de modo que cada um é um contêiner :::paragraphs de um só parágrafo, com um estilo próprio. Nenhum dos dois estilos define entrelinha, e as margens medem uma linha (15 pt), por isso os versos continuam na grade do corpo. A data fica uma linha abaixo do poema, alinhada à direita, em Marcellus SC de 8 pt, a fonte dos fólios.
#3 · Cada poema abre uma página sob o 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' } };
Em vez do texto, o título imprime um design na coluna. Nesse design, {number} é a contagem no formato de numberingTemplate: '{1:I}', de I a IV, e {titleText} é o título (span e design avançado). O nível não tem margem inferior, e minHeight faz cada cabeça de poema ocupar seis linhas da grade (31,75 mm). O numeral e um título de uma linha preenchem quatro, e um título que quebra preenche cinco, por isso todos os poemas começam na mesma linha da página. Na página 6, essa linha é a da dedicatória. A paridade 'any' quebra para a página seguinte, par ou ímpar, de modo que não há páginas em branco entre os poemas.
#4 · Os elementos pré-textuais são feitos de 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) },
];
Um estilo de título pode quebrar para uma página nova e desenhar um design nela, por isso a falsa folha de rosto, o frontispício e a folha de rosto são um título cada, com estilo próprio. numbered: false os deixa fora da contagem, e o primeiro poema continua sendo o I. toc: false os deixa fora do sumário, e um rodapé vazio deixa as páginas deles sem fólio (estilos de título). Os estilos ocupam a página inteira porque o pé da mancha de texto corta um design preso à coluna, o que cortaria ali a prancha sangrada e deixaria de fora a legenda. A legenda vem do atributo caption do título; o autor, o título e o subtítulo da folha de rosto vêm do front matter.
#5 · O sumário se preenche sozinho
// 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 lista cada título cujo estilo permite a entrada, com o numeral do mesmo modelo e o rótulo da página em que o título cai. A composição diagrama o livro de novo até que esses rótulos de página parem de mudar (sumário). O título da própria página, Contents, tem um estilo com numbered: false; sem ele, Contents seria o poema I. O preenchimento '. ' põe um espaço depois de cada ponto. Os pontos ficam alinhados à direita, para coincidirem de uma entrada para a outra, e saem na fonte e na cor dos números de página, porque toc.leader não tem configuração de cor.
#6 · Um ornamento é um tipo de recurso sem 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' } };
Uma imagem no texto é um recurso, e todo recurso tem um tipo. O tipo do ornamento tem o prefixo de legenda vazio e o raminho não tem legenda, por isso nenhum rótulo como “Figure 1” sai embaixo dele (tipos de recurso). O defaultPlacement do tipo põe o raminho onde está ::resource{id="sprig"}, centralizado e com um quinto da medida, de modo que o remate sob Inversnaid ocupa uma linha de Markdown. resourceTypes substitui a lista padrão, por isso este livro não tem os tipos Figura e Tabela. Para mantê-los, aplique o spread de defaultResourceTypes() na lista, antes do ornamento.
A receita 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
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Aprofunde o recuo dos versos quebrados
Um recuo deslocado maior afasta da margem o resto de um verso quebrado, para poemas em que os versos quebram com frequência.
- 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#Componha os versos quebrados à direita
Com turnover: 'right' em bodyText.verse, o resto de um verso longo demais para a medida vai para a linha de baixo alinhado à direita, depois de um colchete de abertura, como o compõem muitas edições de poesia.
indentAfterHeading: false, minWordSpacing: 0.8, maxWordSpacing: 1.6,
+ verse: { turnover: 'right' }, // a turnover flush right, behind [
},#Abra cada poema numa página ímpar
Com a paridade 'odd', cada poema abre na próxima página ímpar. O livro passa de oito para onze páginas, e as três páginas pares em branco não levam fólio, porque os fólios são filtrados pela função da 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' } };#Numere os poemas em algarismos arábicos
O estilo do contador no modelo muda ao mesmo tempo o numeral na página do poema e no sumário.
-const poems = { level: 1, numberingTemplate: '{1:I}', advancedDesign: poemHead,
+const poems = { level: 1, numberingTemplate: '{1}', advancedDesign: poemHead,Erros comuns
Erro comum
'1998. ' ou '- ' no início de um parágrafo abre uma lista
Um parágrafo que começa com um número, um ponto e um espaço, ou com um hífen e um espaço, vira item de lista. Coloque um word joiner (U+2060) antes do número e escreva os diálogos com travessão. Escapes e caracteres literais →
Erro comum
Um estilo de título herda a quebra de página do seu nível
Uma entrada de headingStyles recebe do seu nível de título todos os campos que não define, inclusive breakBefore. Um sumário ou um colofão com estilo sobre um H1 depois de um :::pagebreak herda a paridade 'odd' e cai depois de uma página em branco. Dê a esse estilo breakBefore: { enabled: false }. Estilos de título →
Erro comum
::resource{id="…"} só aceita aspas duplas
Uma inserção em bloco só é reconhecida como ::resource{id="…"} com aspas duplas; qualquer outra forma fica no texto como uma linha visível. Figuras exatamente aqui →
- Mantenha juntos os versos de uma estrofe: uma linha em branco dentro de um bloco
:::verseabre outra estrofe, sejam quantas forem as linhas em branco. - Um verso que começa com um sinal de mais e um espaço é um verso escalonado, que começa onde terminou o de cima; escreva
\+para imprimir o sinal de mais. - Sem
align=startcada poema é centralizado pelo verso mais longo, e então cada um fica a uma distância diferente da margem. - Para que duas palavras passem juntas para a linha de baixo, una-as com um espaço não separável (U+00A0), como the soil e bright wings. na página 5.
- Um elemento de rodapé com
pagesdeixado em'all'sai também nas páginas em branco. Aqui o fólio são dois elementos, um para as páginas de abertura e outro para as páginas de texto, por isso uma página par em branco continua em branco.
Créditos
- Receita
- Ignacio Ferro
- Texto
- “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) · domínio público
- The note on the text, the plate’s caption and the colophon · Ignacio Ferro · CC BY 4.0
- Imagens
- 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
- Fontes
- Sorts Mill Goudy (SIL OFL 1.1) · Italiana (SIL OFL 1.1) · Marcellus SC (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


