Saltar al contingut principal
Recepta número 43

Receptari · Capítol 2 · Text i tipografia

Traducció acarada, estrofa a estrofa

Cada poema és un requadre sense marc amb dues columnes: un tall fix obre l'anglesa al títol i :::space deixa cada estrofa a l'altura de l'original.

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 castellà: encara no hi ha edició en català
  • Format 156 × 234 mm
  • 1 columna
  • Castoro 10,5/14,5
  • Castoro Titling
  • Tenor Sans
  • 5 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 64 ms
  • 164 línies de codi

En poques paraules

Un poemari amb l'original en castellà a un costat i la traducció anglesa a l'altre. Cada estrofa de la traducció comença a la mateixa altura que l'original.

Què compondràs

Un quadern bilingüe de cinc poemes sobre una salina del sud d'Espanya, de 156 × 234 mm, amb el castellà a l'esquerra i la versió anglesa de la mateixa autora a la dreta, vers a vers. Obren el llibre una portada amb un flamenc i una nota de l'autora; els poemes comencen sota una aquarel·la de basses roses, munts de sal i flamencs a trenc d'alba. Cada poema va en un requadre sense marc, sota un número romà granat en Castoro Titling, amb el castellà en una columna i l'anglès en l'altra. L'anglès arrenca sempre a la mateixa línia que el castellà, i cada estrofa, a l'altura del seu original. Quan un vers anglès no cap a la seva columna, continua a la línia de sota sagnat 2 em, i l'estrofa castellana del davant acaba amb una línia en blanc més.

Aquesta recepta respon a

  • Com poso dues columnes dins d'un requadre (una de text al costat d'una altra amb una figura)?
  • 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 aconsegueixo una bona justificació i partició de mots en textos en castellà, francès o alemany?

La resposta curta

script.js · línies 28–52al codi complet
// Each poem is a box titled with its numeral, holding one two-column group. breaks="5"
// opens the second column at the group's 5th block, since the Spanish title and its three
// stanzas come before it. A :::space is not a block, so the gaps leave the count alone:
//   :::callout{type="poem" title="I"}
//   :::columns{count=2 breaks="5"}
//   Spanish title, :::space{lines=0.5}, its stanzas in :::verse blocks
//   English title, :::space{lines=0.5}, its stanzas in :::verse blocks
//   :::
//   :::
// Both columns open on the same line, so matching :::space gaps keep the stanzas level.
// keepTogether: false lets a poem that does not fit go on overleaf. A group with breaks is
// cut stream by stream (flow="parallel"): each language goes on in its own column, level.
const poem = {
  id: 'poem',
  backgroundEnabled: false, // no fill, border or stripe
  padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
  columnGap: mm(GAP),
  titleStyle: { fontFamily: 'Castoro Titling', fontSize: pt(22), fontWeight: 400,
    color: col('madder'), gap: pt(4) },
  // A box starts on the first grid line at least two lines down, under the picture as under
  // a poem (12.3 mm there: its box ends off the grid). The default marginBottom (0.75 em)
  // would add to marginTop and open 17.4 mm between poems.
  marginTop: pt(LEAD * 2), marginBottom: pt(0),
  keepTogether: false, // a long poem goes on overleaf instead of moving whole
};

Ingredients

Tipografia
Castoro, Castoro Titling, Tenor Sans (SIL OFL 1.1)
Recursos
  • flamingo-680.jpg
  • salina-1560.jpg
  • The salt pans at sunrise over the poems, a watercolour (Generated With Diffusion Models, original)
  • The flamingo on the title page, a watercolour (Generated With Diffusion Models, original)

Elaboració

#1 · Un poema és un requadre amb un tall de columna fix

El codi és la resposta curta de més amunt. Cada poema és un requadre amb un grup :::columns a dins; el seu estil treu el fons i el farciment i imprimeix el title de la directiva, el número (:::columns). Sense breaks, el grup talla on les dues columnes queden igualades. En aquests poemes les dues meitats fan el mateix i el tall cau igualment al títol anglès, però si allargues dos versos de The Rake fins que no hi càpiguen, el tall baixa un bloc i THE RAKE es queda al peu de la columna castellana. breaks="5" fixa el bloc que obre la segona columna, així que el títol anglès l'encapçala facin el que facin les dues meitats.

#2 · Un bloc :::verse per columna, una línia en blanc per salt d'estrofa

script.js · línies 56–64al codi complet
// Each half of a poem is a :::verse block, a line of verse a line of Markdown and a blank line
// between stanzas. A line too long for its 55 mm column turns over 2 em in, where it cannot
// pass for the next line; the Spanish half then ends that stanza's block and a
// :::space{lines=2} before the next keeps the stanzas level across the gutter.
const verse = { id: 'verse', hangingIndent: em(2) };
// Castoro Titling draws capitals only. A :::space{lines=0.5} in the Markdown sets each title
// off its poem.
const poemTitle = { id: 'poem-title', fontFamily: 'Castoro Titling', fontSize: pt(9.5),
  color: col('madder'), firstLineIndent: pt(0) };

Cada meitat d'un poema és un bloc :::verse: un vers per línia del Markdown, en bandera i sense partició de mots, i una línia en blanc entre estrofes, que deixa una línia en blanc a la columna (:::verse). Cada estrofa és un bloc, així que breaks compta estrofes, no versos. El vers anglès each one standing on its own reflection. no cap a la seva columna de 55 mm i continua a la línia de sota, sagnat 2 em; la meitat castellana tanca el seu bloc després de l'estrofa del davant i posa un :::space{lines=2} abans de la següent, així que les estrofes següents comencen a la mateixa línia. Un :::space no és un bloc, i breaks no el compta (:::space).

El poema I a la pàgina 3: reflection. passa a la línia següent en l'anglès, i l'estrofa castellana acaba amb dues línies en blanc en lloc d'una.

#3 · La nota fa servir la partició de mots de la seva llengua

script.js · línies 68–82al codi complet
const LOCALE = t({ en: 'en-us', es: 'es' }); // the patterns of the edition's language
const bodyText = {
  fontFamily: 'Castoro', fontSize: pt(10.5), lineHeight: pt(LEAD), color: col('ink'),
  italicColor: col('ink'), firstLineIndent: mm(4.5), indentAfterHeading: false,
  minWordSpacing: 0.8, maxWordSpacing: 1.35, // word spaces from 0.8 to 1.35 of normal
  // No bold on these pages: ink keeps a **bold** or a :ref added later off the default blue
  // (#295AA3). References take boldColor while referenceColor is unset.
  boldColor: col('ink'),
};
// The heading prints its title 36 mm down the text block, and the note starts under it.
const notePage = { id: 'note', advancedDesign: { enabled: true, slot: {
  elements: [{ kind: 'text', id: 'title', content: '{titleText}', align: 'left',
    fontFamily: 'Castoro Titling', fontSize: pt(13), color: col('madder'), overflow: 'wrap',
    placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(36) } } }],
} } };

locale tria els patrons de partició de mots. Amb 'es', la nota castellana talla ori-ginal i Duna-liella; amb els patrons anglesos les dues paraules passen senceres a la línia següent, i només arras-traba es talla amb tots dos (llengües admeses). Els espais entre paraules es poden encongir fins a 0,8 i estirar fins a 1,35 de la seva amplada normal, i cap línia justificada de les dues notes no passa d'aquí. El títol de la nota és un disseny d'un sol element, situat 36 mm per sota de l'inici de la caixa de text, així que la nota comença a 73 mm de la vora superior de la seva pàgina.

#4 · La portada i l'aquarel·la són títols

script.js · línies 86–114al codi complet
const onPage = (y) => ({ anchor: { to: 'page', edge: 'top' }, offset: { y: mm(y) } });
const face = (id, content, font, size, y, extra = {}) => ({ kind: 'text', id, content,
  fontFamily: font, fontSize: pt(size), color: col('ink'), align: 'center', overflow: 'wrap',
  placement: onPage(y), ...extra });
const tracked = { letterSpacing: pt(2), textTransform: 'uppercase' };
const image = (id, placement) => ({ kind: 'image', id, resourceId: id, placement });
const titlePage = {
  id: 'title-page',
  header: { elements: [] }, footer: { elements: [] }, // no running head, no folio
  advancedDesign: { enabled: true, slot: { elements: [
    face('author', '{author}', 'Tenor Sans', 9, 44, { ...tracked, color: col('muted') }),
    face('title', '{titleText}', 'Castoro Titling', 34, 58, { lineHeight: 1 }),
    face('other', '{attr.other}', 'Castoro', 16, 76, { italic: true, color: col('madder') }),
    image('flamingo', { ...onPage(96), size: { width: mm(34) } }),
    face('edition', '{attr.edition}', 'Tenor Sans', 8.5, 170, tracked),
    face('version', '{attr.version}', 'Castoro', 10.5, 176, { italic: true }),
    face('press', '{attr.press}', 'Tenor Sans', 8, 206, { ...tracked, color: col('muted') }),
  ] } },
};
// The picture of the salt pans runs 84 mm down from the top edge of the page, and the heading
// reserves down to its foot. No margin under it: the poem's own marginTop sets the gap.
const poemsOpener = {
  id: 'poems', marginBottom: pt(0),
  advancedDesign: { enabled: true, slot: { elements: [
    image('salina', { anchor: { to: 'page', edge: 'top-left' }, size: { width: 'fill' } }),
    face('title', '{titleText}', 'Castoro Titling', 38, 17, { lineHeight: 1 }),
    face('other', '{attr.other}', 'Castoro', 15, 33, { italic: true, color: col('madder') }),
  ] } },
};

Cadascun és un títol de nivell 1 amb un estil propi (estils d'encapçalament): el disseny de la portada pren {author} del frontmatter, i els dos dissenys prenen {attr.other} dels atributs del títol. L'aquarel·la està ancorada a la vora superior de la pàgina, per sobre de la caixa de text, i el títol reserva fins al seu peu, a 84 mm de la vora. L'estil posa marginBottom: pt(0), així que l'espai sota l'aquarel·la és el marge superior del mateix poema, de dues línies, i el poema I comença a la primera línia de la retícula que queda almenys dues línies per sota de la imatge.

#5 · Les capçaleres anomenen les dues llengües

script.js · línies 118–132al codi complet
const edgeAt = (edge, x, y) => ({ anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(y) } });
const head = (id, content, parity, placement, extra = {}) => ({ kind: 'text', id, content,
  parity, pages: 'body', fontFamily: 'Tenor Sans', fontSize: pt(7.5), color: col('muted'),
  ...tracked, letterSpacing: pt(1.5), placement, ...extra });
const folio = { color: col('ink'), letterSpacing: pt(0) };
const TITLES = ['Sal de agosto', 'August Salt']; // the book's title in its two languages
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', edgeAt('top-left', OUTER, 12), folio),
  head('verso-title', TITLES[0], 'even', edgeAt('top-left', OUTER + 8, 12)),
  head('recto-title', TITLES[1], 'odd', edgeAt('top-right', -(OUTER + 8), 12)),
  head('recto-folio', '{pageNumber}', 'odd', edgeAt('top-right', -OUTER, 12), folio),
] };
// The note and the picture open their pages ('opener'): a folio at the foot instead.
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', edgeAt('bottom', 0, -12),
  { ...folio, pages: 'opener' })] };

La pàgina parella porta el títol castellà i la senar l'anglès, en l'ordre de les columnes. pages: 'body' les treu de les tres pàgines que comencen amb un títol. La nota i l'aquarel·la porten en lloc seu un foli al peu, i l'estil de la portada en deixa buides la capçalera i el peu (elements de text).

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 043 · Facing translation, stanza by stanza ═══════════════════
// https://postext.dev/en/cookbook/bilingual-facing-verse
// Code: MIT · Text: original (CC BY 4.0) · Salt pans and flamingo: diffusion models
// Fonts: Castoro, Castoro Titling, Tenor Sans (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

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

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // every colour in the config links to one of these
  ink: '#1f2430', // the text: a blue-black
  madder: '#9a3c52', // the one accent: numerals, poem titles, the other language's title
  muted: '#6a6770', // running heads, folios, the author's name, the colophon
  paper: '#ffffff',
};
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' } }));
const TRIM_W = 156, TRIM_H = 234; // mm
const TOP = 22, OUTER = 18, INNER = 20; // mm: the text block is 118 mm wide
const LEAD = 14.5; // pt: the leading of the note and of every line of verse
const GAP = 8; // mm between the original and the translation: each column is 55 mm wide

// #region answer: a poem and its translation: a box with two columns and a fixed break
// Each poem is a box titled with its numeral, holding one two-column group. breaks="5"
// opens the second column at the group's 5th block, since the Spanish title and its three
// stanzas come before it. A :::space is not a block, so the gaps leave the count alone:
//   :::callout{type="poem" title="I"}
//   :::columns{count=2 breaks="5"}
//   Spanish title, :::space{lines=0.5}, its stanzas in :::verse blocks
//   English title, :::space{lines=0.5}, its stanzas in :::verse blocks
//   :::
//   :::
// Both columns open on the same line, so matching :::space gaps keep the stanzas level.
// keepTogether: false lets a poem that does not fit go on overleaf. A group with breaks is
// cut stream by stream (flow="parallel"): each language goes on in its own column, level.
const poem = {
  id: 'poem',
  backgroundEnabled: false, // no fill, border or stripe
  padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
  columnGap: mm(GAP),
  titleStyle: { fontFamily: 'Castoro Titling', fontSize: pt(22), fontWeight: 400,
    color: col('madder'), gap: pt(4) },
  // A box starts on the first grid line at least two lines down, under the picture as under
  // a poem (12.3 mm there: its box ends off the grid). The default marginBottom (0.75 em)

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

#Eixampla l'espai entre columnes

Amb 12 mm les columnes es queden en 53 mm, i Los turistas paran y hacen fotos: ja no cap al poema III, així que la seva segona estrofa comença una línia per sota de l'anglesa; tanca el bloc anglès després d'aquesta estrofa i posa un :::space{lines=2} abans de la següent per igualar-les.

-const GAP = 8; // mm between the original and the translation: each column is 55 mm wide
+const GAP = 12; // mm between the original and the translation: each column is 53 mm wide

#Sagna més els versos que no hi caben

Amb 3 em, reflection. comença a la pàgina 3 un em més endins.

-const verse = { id: 'verse', hangingIndent: em(2) };
+const verse = { id: 'verse', hangingIndent: em(3) };

Errors freqüents

  • Un :::space posat abans del títol anglès desapareix: la segona columna s'obre al bloc que indica breaks, i l'espai cau al tall. Posa'l després del títol, com el :::space{lines=0.5} que segueix aquí el títol de cada columna.
  • Compta breaks des del títol castellà: amb un títol i tres estrofes, el títol anglès és el bloc 5. Cada estrofa és un bloc, així que una estrofa castellana més porta el títol anglès al bloc 6, i breaks ha de pujar amb ell; un vers més dins d'una estrofa no mou res.

Crèdits

Text
  • The poem cycle Sal de agosto and its English version, August Salt, with the author’s note, written for this recipe; the poet Adela Membrives is fictional · Postext Cookbook · CC BY 4.0
Imatges
  • The salt pans at sunrise over the poems, a watercolour · Generated With Diffusion Models · original
  • The flamingo on the title page, a watercolour · Generated With Diffusion Models · original
Fonts
Castoro (SIL OFL 1.1) · Castoro Titling (SIL OFL 1.1) · Tenor Sans (SIL OFL 1.1)
Sandbox