En pocas palabras
Un poemario con el original en español a un lado y la traducción inglesa al lado. Cada estrofa de la traducción empieza a la misma altura que la original.
Lo que vas a componer
Un cuaderno bilingüe de cinco poemas sobre una salina del sur de España, de 156 × 234 mm, con el español a la izquierda y la versión inglesa de la propia autora a la derecha, verso a verso. Abren el libro una portada con un flamenco y una nota de la autora; los poemas empiezan bajo una acuarela de balsas rosas, montones de sal y flamencos al amanecer. Cada poema va en un recuadro sin borde, bajo un número romano granate en Castoro Titling, con el español en una columna y el inglés en la otra. El inglés arranca siempre en la misma línea que el español, y cada estrofa, a la altura de su original. Cuando un verso inglés no cabe en su columna, sigue en la línea de abajo sangrado 2 em, y la estrofa española de enfrente termina con una línea en blanco más.
Esta receta responde a
- ¿Cómo pongo dos columnas dentro de un recuadro (una de texto junto a otra con una figura)?
- ¿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 consigo una buena justificación y separación silábica en textos en español, francés o alemán?
La respuesta corta
// 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
};
Ingredientes
- Funciones
- Verso línea a líneaColumnas en un recuadro o en el textoEspacio vertical explícitoEstilos de párrafoRecuadrosSeparación silábica e idioma del documentoEstilos de títuloAperturas diseñadasAtributos de títuloImágenes en los diseños de páginaCubiertas, portadas y colofonesMetadatos del documentoEquilibrado de columnasCabeceras y foliosCabeceras según el tipo de páginaMárgenes simétricosPaleta de color semánticaFiguras y tablas como recursosCabeceras por secciónPáginas en un canvas
- Tipografía
- Castoro, Castoro Titling, Tenor Sans (SIL OFL 1.1)
- Recursos
flamingo-680.jpgsalina-1560.jpg- Las salinas al amanecer sobre los poemas, una acuarela (Generated With Diffusion Models, original)
- El flamenco de la portada, una acuarela (Generated With Diffusion Models, original)
Elaboración
#1 · Un poema es un recuadro con un corte de columna fijo
El código es la respuesta corta de arriba. Cada poema es un recuadro con un grupo :::columns dentro; su estilo quita el fondo y el relleno e imprime el title de la directiva, el número (:::columns). Sin breaks, el grupo corta donde sus dos columnas quedan igualadas. En estos poemas las dos mitades miden lo mismo y el corte cae de todos modos en el título inglés, pero si alargas dos versos de The Rake hasta que no quepan, el corte baja un bloque y THE RAKE se queda al pie de la columna española. breaks="5" fija el bloque que abre la segunda columna, así que el título inglés la encabeza midan lo que midan las dos mitades.
#2 · Un bloque :::verse por columna, una línea en blanco por salto de estrofa
// 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 mitad de un poema es un bloque :::verse: un verso por línea del Markdown, en bandera y sin separación silábica, y una línea en blanco entre estrofas, que deja una línea en blanco en la columna (:::verse). Cada estrofa es un bloque, así que breaks cuenta estrofas, no versos. El verso inglés each one standing on its own reflection. no cabe en su columna de 55 mm y sigue en la línea de abajo, sangrado 2 em; la mitad española cierra su bloque tras la estrofa de enfrente y pone un :::space{lines=2} antes de la siguiente, así que las estrofas siguientes empiezan en la misma línea. Un :::space no es un bloque, y breaks no lo cuenta (:::space).

#3 · La nota usa la separación silábica de su idioma
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 elige los patrones de separación silábica. Con 'es', la nota española corta ori-ginal y Duna-liella; con los patrones ingleses las dos palabras pasan enteras a la línea siguiente, y solo arras-traba se corta con ambos (idiomas admitidos). Los espacios entre palabras pueden encogerse hasta 0,8 y estirarse hasta 1,35 de su ancho normal, y ninguna línea justificada de las dos notas pasa de ahí. El título de la nota es un diseño de un solo elemento, situado 36 mm por debajo del inicio de la caja de texto, así que la nota empieza a 73 mm del borde superior de su página.
#4 · La portada y la acuarela son títulos
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') }),
] } },
};
Cada uno es un encabezado de nivel 1 con un estilo propio (estilos de encabezado): el diseño de la portada toma {author} del frontmatter, y los dos diseños toman {attr.other} de los atributos del encabezado. La acuarela está anclada al borde superior de la página, por encima de la caja de texto, y el título reserva hasta su pie, a 84 mm del borde. El estilo pone marginBottom: pt(0), así que el hueco bajo la acuarela es el margen superior del propio poema, de dos líneas, y el poema I empieza en la primera línea de la rejilla que queda al menos dos líneas por debajo de la imagen.
#5 · Las cabeceras nombran los dos idiomas
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 par lleva el título español y la impar el inglés, en el orden de las columnas. pages: 'body' las quita de las tres páginas que empiezan con un título. La nota y la acuarela llevan en su lugar un folio al pie, y el estilo de la portada deja vacíos su cabecera y su pie (elementos de texto).
La receta completa
// ═══ 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)
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
#Ensancha el medianil
Con 12 mm las columnas se quedan en 53 mm, y Los turistas paran y hacen fotos: ya no cabe en el poema III, así que su segunda estrofa empieza una línea por debajo de la inglesa; cierra el bloque inglés tras esa estrofa y pon un :::space{lines=2} antes de la siguiente para igualarlas.
-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#Sangra más los versos que no caben
Con 3 em, reflection. empieza en la página 3 un em más adentro.
-const verse = { id: 'verse', hangingIndent: em(2) };
+const verse = { id: 'verse', hangingIndent: em(3) };Errores frecuentes
- Un
:::spacepuesto antes del título inglés desaparece: la segunda columna se abre en el bloque que indicabreaks, y el espacio cae en el corte. Ponlo después del título, como el:::space{lines=0.5}que sigue aquí al título de cada columna. - Cuenta
breaksdesde el título español: con un título y tres estrofas, el título inglés es el bloque 5. Cada estrofa es un bloque, así que una estrofa española más lleva el título inglés al bloque 6, ybreakstiene que subir con él; un verso más dentro de una estrofa no mueve nada.
Créditos
- Receta
- Ignacio Ferro
- Texto
- El ciclo de poemas Sal de agosto y su versión inglesa, August Salt, con la nota de la autora, escritos para esta receta; la poeta Adela Membrives es ficticia · Postext Cookbook · CC BY 4.0
- Imágenes
- Las salinas al amanecer sobre los poemas, una acuarela · Generated With Diffusion Models · original
- El flamenco de la portada, una acuarela · Generated With Diffusion Models · original
- Fuentes
- Castoro (SIL OFL 1.1) · Castoro Titling (SIL OFL 1.1) · Tenor Sans (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)


