En poques paraules
Un llibret de poemes japonesos: el diari de viatge de Bashō amb els seus haikus en línies pròpies, i els poemes breus de Takuboku en tres versos cadascun, que cap canvi de pàgina no talla.
Què compondràs
Vuit pàgines d'un llibret de poesia en una pàgina 四六判 de 127 × 188 mm, enquadernada per la dreta. La primera part són set etapes d'Oku no hosomichi de Bashō, la seva prosa amb els seus haikus; la segona, onze tankes d'Un grapat de sorra d'Ishikawa Takuboku, cadascuna en els tres versos en què la va escriure. La prosa baixa de dalt a baix, 36 caràcters per línia, en Shippori Mincho de 10 pt amb un pas generós d'1,9 em. Cada haiku ocupa una línia pròpia tres caràcters més avall, cada tanka dos, i el haiku de Sora va signat 曾良 a prop del peu de la línia. Cap tanka no es parteix entre dues pàgines, i un * taronja separa els grups. El llibre de poesia europeu és la Núm. 015; els poemes Tang en xinès vertical, la Núm. 083.
Aquesta recepta respon a
- 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?
- Quines fonts componen el japonès, amb els kanji en les seves formes japoneses, a la pantalla i al PDF?
La resposta curta
// 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"}
// 夏草や兵どもが夢の跡 曾良
// ::: :::
Ingredients
- Funcions
- Estils de paràgrafVers línia a líniaText verticalTítols que ocupen línies del text (gyōdori)Llibres enquadernats per la dretaSagnats, alineació i separació de paràgrafsFurigana: lectures en kana sobre els kanjiTall de línies japonès (kinsoku)Numerals japonesos i comptadors en kanaKana, kanji i rōmajiRetícula de caràctersFonts xineses, japoneses i coreanesImportar textos d'Aozora BunkoEstils de títolObertures dissenyadesTextos, filets i caixes als dissenys de pàginaCapçaleres i folisMarges simètricsPaleta de color semànticaExportació a PDF
- També fa servir
- Tall de línies en xinèsAtributs de títolColor del paperCapçaleres segons el tipus de pàginaFonts incrustades al PDFPreliminars en romansRuby: lectures en pinyin i zhuyinCapçaleres per secció
- Tipografia
- Shippori Mincho, Noto Sans JP (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Un vers és un paràgraf, i el seu estil diu on comença
El codi és la resposta curta de més amunt. Un haiku és una sola línia, així que és un paràgraf propi dins d'un contenidor :::paragraphs, i l'estil del contenidor fixa el sagnat: indent: em(3) baixa un haiku tres caràcters des del cap de la línia (el text d'Aozora els posa a dos; tres els donen més aire), i firstLineIndent: em(0) evita que s'hi sumi el sagnat d'un caràcter del text. Els 17 sons, poc o molt, d'un haiku caben en qualsevol línia de 36, així que mai no salten. La signatura és un altre paràgraf: textAlign: 'end' la recolza al peu de la línia (地付き, jitsuki) i endIndent: em(5) l'aixeca cinc caràcters des d'allà (地から五字上げ), com fa l'edició d'on surt el text (Estils de paràgraf).
#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}
// 東海の小島の磯の白砂に
// われ泣きぬれて
// 蟹とたはむる
//
// 頬につたふ
// …
// :::
Les tankes de Takuboku formen un bloc :::verse, cada tanka una estrofa: els seus tres versos són tres línies del Markdown, i la línia en blanc entre dues tankes del text deixa una línia en blanc de la retícula entre els poemes. L'estil del poema dona el sagnat de dos caràcters i la línia sota el grup, i els versos pengen del capdamunt com qualsevol columna. keepStanzas=3 manté sencera cada estrofa de tres versos: a la pàgina 5 la tercera tanka no cap sota el títol de la part i les dues primeres, així que obre sencera la pàgina 6 en lloc de deixar enrere el primer vers. L'ornament entre dos grups presenta el següent, així que passa amb la seva primera tanka en lloc de quedar-se sol al peu d'una pàgina (:::verse).
#3 · Espaia els noms de lloc a una mateixa amplada
// 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,
};
Les etapes del viatge són títols de segon nivell de dues línies del text (2行取り), perquè la prosa i els haikus que segueixen quedin a la retícula. jidori: 3 espaia un nom més curt fins que ocupa tres dels seus propis caràcters (字取り): 平泉 s'imprimeix 平 泉, amb un caràcter sencer entre tots dos, i tots els noms acaben a la mateixa alçada que 立石寺 i 最上川. Un nom que ja té tres caràcters es queda com és (Configuració per nivell).
#4 · Obre cada part a la seva pròpia 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 part és un títol de primer nivell amb un disseny que posa el títol, un (抄) petit, «selecció», just al darrere amb anchor.to: '#title', un filet taronja curt al costat del títol i el poeta a prop del peu de la línia. El disseny reserva cinc línies, i el text comença després d'elles en la mateixa retícula.
#5 · Tria una font que tingui les marques antigues
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ō escriu les paraules repetides amb la vella marca d'iteració 〻 (日〻, 人〻), i els textos antics també fan servir el くの字点 llarg, 〳〵. Zen Old Mincho no té cap de les dues: el canvas les agafaria d'una font del sistema i el PDF dibuixaria caixes buides. Shippori Mincho, Noto Serif JP i Shippori Mincho B1 tenen totes dues, així que els poemes van en Shippori Mincho (Fonts xineses, japoneses i coreanes). El text d'Aozora conserva a més les notes de l'editor sobre grafies antigues, とら{え|(へ)}て, que imprimeixen el kana esperat al costat del que va escriure Bashō.
La recepta 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"}
// 夏草や兵どもが夢の跡 曾良
// ::: :::
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
#Separa les tres frases del haiku
Algunes antologies escolars posen un espai ideogràfic entre els 5, 7 i 5 sons, per a qui aprèn la forma; l'espai és un caràcter del text.
-{夏草|なつくさ}や{兵|つはもの}どもが夢の跡
+{夏草|なつくさ}や {兵|つはもの}どもが 夢の跡#Deixa que una tanka llarga es parteixi
Sense keepStanzas, una tanka pot començar al peu d'una pàgina i continuar a la següent segons les regles de vídues i òrfenes, com faria una antologia atapeïda de mil poemes.
-:::verse{style="tanka" keepStanzas=3}
+:::verse{style="tanka"}Errors freqüents
Error freqüent
Etiqueta un text japonès 'ja', mai zh-Hans ni LANG
Les edicions d'una recepta són en i es, però una mostra japonesa és japonesa en totes dues: `locale: LANG` l'etiquetaria com a anglès o castellà, i una etiqueta xinesa la compondria amb les regles xineses (puntuació Kaiming, kana petit lliure de començar línia, 图 en lloc de 図, formes xineses dels caràcters al PDF). Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que qualsevol etiqueta que no sigui 'ja' dona altres formes de glif que les japoneses (les xineses, amb una etiqueta xinesa) i altres talls de línia. Escriu 'ja': tria la regió del Japó (tall i puntuació de la JLReq, punts de sèsam, repartiment dels furigana, etiquetes 図 i 表) i desactiva la partició de mots. El lint falla un text amb kana sota una etiqueta zh o ko. Tall de línies japonès (kinsoku) →
Error freqüent
Les fonts xineses es carreguen per fragments, amb el bloc cjk
Fontsource serveix una família xinesa, japonesa o coreana en un centenar de fitxers per pes, cadascun amb un interval de caràcters. loadFonts només baixa el fitxer latin, així que a la pantalla els caràcters xinesos surten d'una font del sistema i es mesuren malament, i fontsourceProvider lliura al PDF aquest fitxer latin, que els imprimeix com a caixes buides. Afegeix el bloc cjk del kit, crida loadCjkFonts(FONTS, markdown) després de loadFonts (una vegada per veu, amb el text que compon, si el llibre fa servir diverses fonts xineses) i passa a renderToPdf fontProvider: cjkPdfProvider: tots dos agafen els fitxers que contenen els caràcters del text. Fonts xineses, japoneses i coreanes →
Error freqüent
Un llibre enquadernat per la dreta mostra els seus plecs amb showBook
En un llibre enquadernat per la dreta (text àrab, hebreu o persa, xinès vertical, o page.binding 'right') la pàgina 1 continua sent senar, però queda a l'esquerra del llom, i els plecs es llegeixen [3 | 2]. showPages compon tots els llibres com si s'enquadernessin per l'esquerra; showBook, del bloc book (el bloc cjk porta la mateixa funció), llegeix doc.binding i reflecteix els plecs. capture.hero continua anomenant un plec en ordre de lectura, [parella, senar]: [2, 3]. Llibres enquadernats per la dreta →
Error freqüent
Un interval de Fontsource pot anomenar caràcters que el seu fitxer no té
Fontsource dona a cada fitxer un unicode-range, i loadCjkFonts carrega els fitxers els intervals dels quals cobreixen la mostra, però un interval pot prometre més del que el seu fitxer té. El fragment de Zen Old Mincho per a U+3028–303F no té 〻 ni les marques de repetició llargues 〳〴〵, i la font tampoc no té les vocals amb macró ō ū ā; el fitxer latin-ext de Shippori Mincho B1 porta uns quants caràcters i cap no és ō, ū ni ā. No falla res mentre corre la recepta: a la pantalla aquests caràcters surten d'una font del sistema i es mesuren amb ella, i el PDF imprimeix la caixa .notdef de la font, que només la comprovació C25 assenyala després. Busca a la font una marca rara o una paraula en rōmaji abans de triar-la (fontTools sobre el fitxer de Fontsource) i compon aquest text amb una que la tingui: Shippori Mincho B1 i Noto Serif JP tenen 〻 i 〳〴〵; Noto Serif JP i Noto Sans JP, les vocals amb macró. Fonts xineses, japoneses i coreanes →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 松尾芭蕉『おくのほそ道』 (The Narrow Road to the Deep North, 1702), seven sections, the editor’s notes left out; Aozora Bunko card 61619, from 「芭蕉 おくのほそ道」 (Iwanami, 1975) after 杉浦正一郎’s Iwanami Bunko edition (1957), input 砂場清隆, proofreading 木下聡, converted with aozora.py · Matsuo Bashō; Sugiura Shōichirō (editor, 1911–1957); Aozora Bunko volunteers · domini públic
- 石川啄木『一握の砂』 (A Handful of Sand, 1910), eleven tanka; Aozora Bunko card 816, converted with aozora.py · Ishikawa Takuboku; Aozora Bunko volunteers · domini públic
- Fonts
- Shippori Mincho (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


