En pocas palabras
Un librito de poemas japoneses: el diario de viaje de Bashō con sus haikus en líneas propias, y los poemas breves de Takuboku en tres versos cada uno, que nunca corta un cambio de página.
Lo que vas a componer
Ocho páginas de un librito de poesía en una página 四六判 de 127 × 188 mm, encuadernada por la derecha. La primera parte son siete etapas de Sendas de Oku de Bashō, su prosa con sus haikus; la segunda, once tankas de Un puñado de arena de Ishikawa Takuboku, cada uno en los tres versos en que lo escribió. La prosa corre de arriba abajo, 36 caracteres por línea, en Shippori Mincho de 10 pt con un paso holgado de 1,9 em. Cada haiku ocupa una línea propia tres caracteres más abajo, cada tanka dos, y el haiku de Sora va firmado 曾良 cerca del pie de la línea. Ningún tanka se parte entre dos páginas, y un * anaranjado separa los grupos. El libro de poesía europeo es la Nº 015; los poemas Tang en chino vertical, la Nº 083.
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?
- ¿Qué fuentes componen el japonés, con los kanji en sus formas japonesas, en pantalla y en el PDF?
La respuesta corta
// A haiku is a paragraph of one line, so a style sets where it starts: three characters down
// from the head of the line. Takuboku's tanka keep his three lines in a :::verse block, two
// down; 曾良 signs his haiku raised five characters from the foot (地から五字上げ).
const paragraphStyles = [
{ id: 'haiku', indent: em(3), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
// A poem's style gives its indent and the space under the poem: one blank line.
{ id: 'tanka', indent: em(2), marginTop: pt(0), marginBottom: pt(LEAD) },
{ id: 'by', textAlign: 'end', endIndent: em(5), firstLineIndent: em(0) },
// The ornament between groups of poems, in the middle of its line, with a blank line after
// it to match the one the group before it leaves.
{ id: 'ornament', textAlign: 'center', firstLineIndent: em(0), color: col('persimmon'),
marginBottom: pt(LEAD) },
];
// :::paragraphs{style="haiku"} :::paragraphs{style="by"}
// 夏草や兵どもが夢の跡 曾良
// ::: :::
Ingredientes
- Funciones
- Estilos de párrafoVerso línea a líneaTexto verticalTítulos que ocupan líneas del texto (gyōdori)Libros encuadernados por la derechaSangrías, alineación y separación de párrafosFurigana: lecturas en kana sobre los kanjiCorte de líneas japonés (kinsoku)Numerales japoneses y contadores en kanaKana, kanji y rōmajiRetícula de caracteresFuentes chinas, japonesas y coreanasImportar textos de Aozora BunkoEstilos de títuloAperturas diseñadasTextos, filetes y cajas en los diseños de páginaCabeceras y foliosMárgenes simétricosPaleta de color semánticaExportación a PDF
- También usa
- Corte de líneas en chinoAtributos de títuloColor del papelCabeceras según el tipo de páginaFuentes incrustadas en el PDFPreliminares en romanosRuby: lecturas en pinyin y zhuyinCabeceras por sección
- Tipografía
- Shippori Mincho, Noto Sans JP (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Un verso es un párrafo, y su estilo dice dónde empieza
El código es la respuesta corta de arriba. Un haiku es una sola línea, así que es un párrafo propio dentro de un contenedor :::paragraphs, y el estilo del contenedor fija la sangría: indent: em(3) baja un haiku tres caracteres desde la cabeza de la línea (el texto de Aozora los pone a dos; tres les dan más aire), y firstLineIndent: em(0) evita que se le sume la sangría de un carácter del texto. Los 17 sonidos más o menos de un haiku caben en cualquier línea de 36, así que nunca saltan. La firma es otro párrafo: textAlign: 'end' la apoya en el pie de la línea (地付き, jitsuki) y endIndent: em(5) la levanta cinco caracteres desde ahí (地から五字上げ), como hace la edición de la que procede el texto (Estilos de párrafo).
#2 · Mantén cada tanka en una sola página
// The tanka of a group are one :::verse block, each a stanza of three lines with a blank
// line between: a line of verse a line of Markdown, one blank line of the grid between two
// tanka. keepStanzas=3 keeps a stanza of three lines whole, so a tanka is never cut at the
// foot of a page: it moves on to the next.
// :::verse{style="tanka" keepStanzas=3}
// 東海の小島の磯の白砂に
// われ泣きぬれて
// 蟹とたはむる
//
// 頬につたふ
// …
// :::
Los tankas de Takuboku forman un bloque :::verse, cada tanka una estrofa: sus tres versos son tres líneas del Markdown, y la línea en blanco entre dos tankas del texto deja una línea en blanco de la rejilla entre los poemas. El estilo del poema da la sangría de dos caracteres y la línea bajo el grupo, y los versos cuelgan de la cabeza como cualquier columna. keepStanzas=3 mantiene entera cada estrofa de tres versos: en la página 5 el tercer tanka no cabe bajo el título de la parte y los dos primeros, así que abre entero la página 6 en lugar de dejar atrás su primer verso. El adorno entre dos grupos presenta el siguiente, así que pasa con su primer tanka en lugar de quedarse solo al pie de una página (:::verse).
#3 · Espacia los nombres de lugar a un mismo ancho
// The place names over the prose take two lines (2行取り), four characters down, and a
// two-character name is spaced out to three (字取り: 平泉 → 平 泉), so they all end level.
const place = {
level: 2, fontFamily: MINCHO, fontWeight: 700, fontSize: pt(11),
lineSpan: 2, indent: em(4), jidori: 3,
};
Las etapas del viaje son encabezados de segundo nivel de dos líneas del texto (2行取り), para que la prosa y los haikus que siguen queden en la retícula. jidori: 3 espacia un nombre más corto hasta ocupar tres de sus propios caracteres (字取り): 平泉 se imprime 平 泉, con un carácter entero entre ambos, y todos los nombres acaban a la misma altura que 立石寺 y 最上川. Un nombre que ya tiene tres caracteres se queda como está (Configuración por nivel).
#4 · Abre cada parte en su propia página
// A design on a vertical page is laid out in the flow frame: x runs down the column from
// the head of the type area, y across the page leftwards from its right edge.
const at = (down, across) => ({ anchor: { to: 'container', edge: 'top-left' },
offset: { x: pt(down), y: pt(across) } });
const TITLE = 18; // pt
const part = {
level: 1, breakBefore: { enabled: true, parity: 'any' }, // the next page, either side
advancedDesign: { enabled: true, minHeight: lines(5), slot: { elements: [
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: MINCHO, fontWeight: 700,
fontSize: pt(TITLE), lineHeight: 1, letterSpacing: pt(4), color: col('ink'),
placement: at(3 * BODY, 1.5 * LEAD - TITLE / 2) },
{ kind: 'text', id: 'abridged', content: '(抄)', fontFamily: MINCHO, fontSize: pt(9),
color: col('ink'), placement: { anchor: { to: '#title', edge: 'right-of' },
offset: { x: pt(6), y: pt((TITLE - 9) / 2) } } },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6),
color: col('persimmon'), placement: { ...at(3 * BODY, 2.5 * LEAD),
size: { width: pt(4 * TITLE) } } },
{ kind: 'text', id: 'poet', content: '{attr.author}', fontFamily: MINCHO, fontSize: pt(11),
letterSpacing: pt(3), color: col('ink'),
placement: at(CHARS * BODY - 4 * 11 - 3 * 3 - 2 * BODY, 3.5 * LEAD - 11 / 2) },
] } },
};
Cada parte es un encabezado de primer nivel cuyo diseño pone el título, un (抄) pequeño, «selección», justo detrás con anchor.to: '#title', un filete anaranjado corto junto al título y el poeta cerca del pie de la línea. El diseño reserva cinco líneas, y el texto empieza tras ellas en la misma retícula.
#5 · Elige una fuente que tenga las marcas antiguas
const title = markdown.match(/^title: "(.*)"$/m)[1];
const heads = markdown.match(/^#+ [^{\n]*/gm).join('');
await loadFonts(FONTS, markdown); // the Latin files: the colophon
await loadCjkFonts({ [MINCHO]: ['400'] }, markdown, { vertical: true });
await loadCjkFonts({ [MINCHO]: ['700'] }, heads);
await loadCjkFonts({ [GOTHIC]: ['400'] },
`${title}${heads}${markdown.match(/colophon="([^"]*)"/)[1]}一二三四五六七八九十`, { vertical: true });
La prosa de Bashō escribe las palabras repetidas con la vieja marca de iteración 〻 (日〻, 人〻), y los textos antiguos usan también el largo くの字点 〳〵. Zen Old Mincho no tiene ninguna de las dos: el canvas las tomaría de una fuente del sistema y el PDF dibujaría cajas vacías. Shippori Mincho, Noto Serif JP y Shippori Mincho B1 tienen ambas, así que los poemas van en Shippori Mincho (Fuentes chinas, japonesas y coreanas). El texto de Aozora conserva además las notas del editor sobre grafías antiguas, とら{え|(へ)}て, que imprimen el kana esperado junto al que escribió Bashō.
La receta completa
// ═══ Postext Cookbook · Nº 119 · Haiku and tanka set vertically ═══════════════════
// https://postext.dev/en/cookbook/haiku-and-tanka
// Code: MIT · Text: 芭蕉『おくのほそ道』, 啄木『一握の砂』, Aozora Bunko (PD) · Pictures: none
// Fonts: Shippori Mincho, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'es'; // @lang: the language of the colophon; the poems are Japanese in both
const RECIPE = 'haiku-and-tanka';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, one persimmon, a soft poetry stock
const palette = {
ink: '#22201d', // the poems
persimmon: '#b5512c', // 柿: the part titles' rule and the ornaments
muted: '#6a645c', // the hashira, the folios, the colophon
paper: '#fbf8f1',
};
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' } })),
{ id: 'main-color', name: 'defaults', value: { hex: palette.persimmon, model: 'hex' } },
];
// #endregion
// Shippori Mincho: it has the 〻 of 日〻 and 人〻, which Zen Old Mincho lacks.
const [MINCHO, GOTHIC] = ['Shippori Mincho', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [10, 19, 36, 14]; // pt, pt: 36字 × 14行, a 1.9 em pitch
const lines = (n) => pt(n * LEAD);
// #region answer: a haiku on one line three characters down, a tanka in three, 地付き names
// A haiku is a paragraph of one line, so a style sets where it starts: three characters down
// from the head of the line. Takuboku's tanka keep his three lines in a :::verse block, two
// down; 曾良 signs his haiku raised five characters from the foot (地から五字上げ).
const paragraphStyles = [
{ id: 'haiku', indent: em(3), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
// A poem's style gives its indent and the space under the poem: one blank line.
{ id: 'tanka', indent: em(2), marginTop: pt(0), marginBottom: pt(LEAD) },
{ id: 'by', textAlign: 'end', endIndent: em(5), firstLineIndent: em(0) },
// The ornament between groups of poems, in the middle of its line, with a blank line after
// it to match the one the group before it leaves.
{ id: 'ornament', textAlign: 'center', firstLineIndent: em(0), color: col('persimmon'),
marginBottom: pt(LEAD) },
];
// :::paragraphs{style="haiku"} :::paragraphs{style="by"}
// 夏草や兵どもが夢の跡 曾良
// ::: :::
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
#Separa las tres frases del haiku
Algunas antologías escolares ponen un espacio ideográfico entre los 5, 7 y 5 sonidos, para quien aprende la forma; el espacio es un carácter del texto.
-{夏草|なつくさ}や{兵|つはもの}どもが夢の跡
+{夏草|なつくさ}や {兵|つはもの}どもが 夢の跡#Deja que un tanka largo se parta
Sin keepStanzas, un tanka puede empezar al pie de una página y seguir en la siguiente según las reglas de viudas y huérfanas, como haría una antología apretada de mil poemas.
-:::verse{style="tanka" keepStanzas=3}
+:::verse{style="tanka"}Errores frecuentes
Error frecuente
Etiqueta un texto japonés 'ja', nunca zh-Hans ni LANG
Las ediciones de una receta son en y es, pero una muestra japonesa es japonesa en las dos: `locale: LANG` la etiquetaría como inglés o español, y una etiqueta china la compondría con las reglas chinas (puntuación Kaiming, kana pequeño libre de empezar línea, 图 en lugar de 図, formas chinas de los caracteres en el PDF). Desde postext 1.30 la etiqueta es además el idioma en el que se compone el texto (en el que se mide, se pinta y se incrusta), así que cualquier etiqueta que no sea 'ja' da otras formas de glifo que las japonesas (las chinas, con una etiqueta china) y otros cortes de línea. Escribe 'ja': elige la región de Japón (corte y puntuación de la JLReq, puntos de sésamo, reparto de los furigana, etiquetas 図 y 表) y desactiva la separación silábica. El lint falla un texto con kana bajo una etiqueta zh o ko. Corte de líneas japonés (kinsoku) →
Error frecuente
Las fuentes chinas se cargan por fragmentos, con el bloque cjk
Fontsource sirve una familia china, japonesa o coreana en un centenar de archivos por peso, cada uno con un intervalo de caracteres. loadFonts solo descarga el archivo latin, así que en pantalla los caracteres chinos salen de una fuente del sistema y se miden mal, y fontsourceProvider entrega al PDF ese archivo latin, que los imprime como cajas vacías. Añade el bloque cjk del kit, llama a loadCjkFonts(FONTS, markdown) después de loadFonts (una vez por voz, con el texto que compone, si el libro usa varias fuentes chinas) y pasa a renderToPdf fontProvider: cjkPdfProvider: ambos toman los archivos que contienen los caracteres del texto. Fuentes chinas, japonesas y coreanas →
Error frecuente
Un libro encuadernado por la derecha muestra sus pliegos con showBook
En un libro encuadernado por la derecha (texto árabe, hebreo o persa, chino vertical, o page.binding 'right') la página 1 sigue siendo impar, pero queda a la izquierda del lomo, y los pliegos se leen [3 | 2]. showPages compone todos los libros como si se encuadernaran por la izquierda; showBook, del bloque book (el bloque cjk trae la misma función), lee doc.binding y refleja los pliegos. capture.hero sigue nombrando un pliego en orden de lectura, [par, impar]: [2, 3]. Libros encuadernados por la derecha →
Error frecuente
Un intervalo de Fontsource puede nombrar caracteres que su archivo no tiene
Fontsource da a cada archivo un unicode-range, y loadCjkFonts carga los archivos cuyos intervalos cubren la muestra, pero un intervalo puede prometer más de lo que su archivo tiene. El fragmento de Zen Old Mincho para U+3028–303F no tiene 〻 ni las marcas de repetición largas 〳〴〵, y la fuente tampoco tiene las vocales con macrón ō ū ā; el archivo latin-ext de Shippori Mincho B1 trae unos pocos caracteres y ninguno es ō, ū ni ā. Nada falla mientras corre la receta: en pantalla esos caracteres salen de una fuente del sistema y se miden con ella, y el PDF imprime la caja .notdef de la fuente, que solo la comprobación C25 señala después. Busca en la fuente una marca rara o una palabra en rōmaji antes de elegirla (fontTools sobre el archivo de Fontsource) y compón ese texto con una que la tenga: Shippori Mincho B1 y Noto Serif JP tienen 〻 y 〳〴〵; Noto Serif JP y Noto Sans JP, las vocales con macrón. Fuentes chinas, japonesas y coreanas →
Créditos
- Receta
- Ignacio Ferro
- Texto
- 松尾芭蕉『おくのほそ道』 (Sendas de Oku, 1702), siete secciones, sin las notas del editor; ficha 61619 de Aozora Bunko, según 「芭蕉 おくのほそ道」 (Iwanami, 1975), sobre la edición de 杉浦正一郎 en Iwanami Bunko (1957), transcripción de 砂場清隆, corrección de 木下聡, convertida con aozora.py · Matsuo Bashō; Sugiura Shōichirō (editor, 1911–1957); Aozora Bunko volunteers · dominio público
- 石川啄木『一握の砂』 (Un puñado de arena, 1910), once tankas; ficha 816 de Aozora Bunko, convertida con aozora.py · Ishikawa Takuboku; Aozora Bunko volunteers · dominio público
- Fuentes
- Shippori Mincho (SIL OFL 1.1) · Noto Sans JP (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)


