En poques paraules
El xinès clàssic tal com l'aprenen els lectors japonesos: unes marques vermelles petites al costat dels caràcters diuen en quin ordre llegir-los i quines terminacions japoneses afegir-hi, i la lectura japonesa sencera segueix cada passatge.
Què compondràs
Tres pàgines d'un llibre escolar japonès de 漢文 (kanbun), el xinès clàssic llegit com a japonès, en una pàgina A5 enquadernada per la dreta: tres dites de les Analectes i la quarteta Albada de primavera de Meng Haoran. Cada passatge va en Zen Old Mincho de 15 pt, en l'ordre xinès, amb els seus 訓点 (kunten) al costat dels caràcters, en vermelló i a la meitat de la seva mida: les marques de retorn (返り点), a baix a l'esquerra d'un caràcter, diuen al lector que continuï i hi torni després, i l'okurigana (送り仮名), a la seva dreta, hi afegeix les terminacions japoneses. Sota cada passatge, el seu 書き下し文 (yomikudashi), el mateix text escrit com a japonès, va en Klee One, una lletra escolar, amb furigana on la lectura és difícil. Els clàssics xinesos amb les seves pròpies ajudes de lectura són la Núm. 080.
Aquesta recepta respon a
- Com imprimeixo kanbun amb les seves marques de retorn i el seu okurigana?
- Com poso furigana damunt dels kanji, una lectura per caràcter o una per a tota la paraula?
La resposta curta
// :kunten[習]{kaeri="レ" okuri="フ"} sets the return mark small at the character's lower
// left and the okurigana at its lower right, down the line; the text keeps its Chinese
// order, which the reader follows by the marks. cjk.kunten sizes and colours them: half
// the character, in vermilion. The Japanese reading under each passage is plain kana and
// kanji with furigana: {君子|くん|し} gives each character its reading (jukugo ruby).
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
};
const paragraphStyles = [
// The text: 15 pt on a pitch of two grid lines, room for the okurigana beside it. A
// quatrain takes two lines, a couplet to the line with a space between its verses.
{ id: 'kanbun', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
firstLineIndent: em(0), textAlign: 'justify' },
{ id: 'shi', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
indent: em(2), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
// The reading (書き下し文), two characters down in a school-book hand.
{ id: 'kudashi', indent: em(2), firstLineIndent: em(0), marginTop: pt(LEAD) },
{ id: 'kudashi-shi', indent: em(4), firstLineIndent: em(0), marginTop: pt(0),
marginBottom: pt(0) },
];
Ingredients
- Funcions
- Marques de lectura del kanbun (kunten)Furigana: lectures en kana sobre els kanjiText verticalLlibres enquadernats per la dretaRuby: lectures en pinyin i zhuyinEstils de paràgrafTítols que ocupen línies del text (gyōdori)Kana, kanji i rōmajiTall de línies japonès (kinsoku)Numerals japonesos i comptadors en kanaRetícula de caràctersFonts xineses, japoneses i coreanesEstils de títolObertures dissenyadesCapçaleres i folisCapçaleres segons el tipus de pàginaMarges simètricsPaleta de color semànticaExportació a PDF
- També fa servir
- Tall de línies en xinèsAtributs de títolColor del paperFonts incrustades al PDFPreliminars en romansCapçaleres per secció
- Tipografia
- Zen Old Mincho, Klee One, Noto Sans JP (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Marca cada caràcter amb :kunten
El codi és la resposta curta de més amunt. :kunten[習]{kaeri="レ" okuri="フ"} dona a 習 la marca de retorn レ i l'okurigana フ; el text conserva el caràcter, així que la cerca, la còpia i el PDF llegeixen el passatge tal com està escrit, i les marques no ocupen cap caràcter del text (Marques, ruby i warichu). Llegeix 学ビテ而時ニ習フレ之ヲ: la レ de 習 fa llegir primer 之 i tornar, 之を習ふ; 而 no porta marca i no es llegeix. En vertical, la marca de retorn va a baix a l'esquerra del seu caràcter i ocupa mig caràcter de la línia, i l'okurigana va a la dreta, començant a mitja alçada del caràcter, tal com els compon JIS X 4051. cjk.kunten en fixa la mida, la meitat del text, i el color, el vermelló amb què les escriu un lector; un passatge va en 15 pt sobre dues línies de la retícula, cosa que deixa 27 pt al costat de cada línia per a l'okurigana.
#2 · Salta amb 一 二 i amb 一レ
Els números porten el lector més enrere. A 不二亦タ説バシカラ一乎 se salta 不, que porta 二, es llegeix 亦た説ばしから i al 一 es torna a 不: 亦た説ばしからずや. A 為政, la marca combinada 一レ de 為 fa totes dues coses: 可二以テ為一レ師ト矣 es llegeix 以て, 師と (レ), 為る i de tornada a 可 (de 一 a 二), 以て師と為るべし. Els punts de codi de kanbun ㆑ ㆒ ㆓ es llegeixen com els caràcters que representen, així que un text copiat d'una altra banda conserva les seves marques.
#3 · Deixa que un okurigana llarg empenyi el caràcter següent
Un okurigana més llarg que el seu caràcter no corre al costat del següent: a 花落ツルコト知ル多少 els quatre kana de ツルコト ocupen dos caràcters de llarg, i 知 baixa per començar després d'ells, tal com ho compon JIS X 4051 (§5.6.4). La línia creix, i el seu tall es mou amb ella.
#4 · Dona a cada passatge una etiqueta de dues línies
const at = (down, across) => ({ anchor: { to: 'container', edge: 'top-left' },
offset: { x: pt(down), y: pt(across) } });
const TITLE = 26; // pt
const part = { level: 1, breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: pt(5 * LEAD), slot: { elements: [
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: MINCHO, fontWeight: 700,
fontSize: pt(TITLE), lineHeight: 1, letterSpacing: pt(TITLE / 2), color: col('ink'),
placement: at(2 * BODY, 2 * LEAD - TITLE / 2) },
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: GOTHIC, fontSize: pt(8.5),
letterSpacing: pt(2), color: col('vermilion'), placement: at(2 * BODY + 3 * TITLE + 18,
2 * LEAD - 8.5 / 2) },
] } } };
// 2行取り, the passage's book and number in gothic, two characters down.
const passage = { level: 2, fontFamily: GOTHIC, fontWeight: 700, fontSize: pt(9.5),
color: col('muted'), lineSpan: 2, indent: em(2) };
Cada llibre de l'antologia obre pàgina amb el seu títol, 論語 o 唐詩, el primer amb una nota petita en vermelló sobre el que conté; cada passatge porta una etiqueta en gòtica de dues línies del text (2行取り), 学而第一 o 春暁 孟浩然, perquè els passatges que segueixen quedin a la retícula. La lectura és un contenidor :::paragraphs{style="kudashi"} dos caràcters més avall, en la lletra i el cos del text, amb furigana jukugo: {君子|くん|し} dona a cada caràcter la seva pròpia lectura, de manera que una línia es podria tallar entre ells.
#5 · Carrega cada veu amb els seus caràcters
const FENCE = /:::paragraphs\{style="([\w-]+)"\}\n([\s\S]*?)\n:::/g;
const fence = (style) => [...markdown.matchAll(FENCE)].filter((m) => m[1] === style)
.map((m) => m[2]).join('');
const kanbun = `${fence('kanbun')}${fence('shi')}`; // the text and its marks' kana
const reading = `${fence('kudashi')}${fence('kudashi-shi')}`;
const heads = markdown.match(/^#+ [^{\n]*/gm).join('');
const colophon = markdown.match(/colophon="([^"]*)"/)[1];
await loadFonts(FONTS, markdown); // the Latin files: the colophon
await loadCjkFonts({ [MINCHO]: ['400'] }, kanbun, { vertical: true });
await loadCjkFonts({ [MINCHO]: ['700'] }, heads);
await loadCjkFonts({ [KYOKASHO]: ['400'] }, reading, { vertical: true });
await loadCjkFonts({ [GOTHIC]: ['400', '700'] },
`${heads}${colophon}${markdown.match(/kicker="([^"]*)"/)[1]}漢文訓読一二三四五六七八九十`,
{ vertical: true });
El text clàssic i la lectura van en lletres diferents, així que cadascuna carrega els fitxers dels seus propis caràcters: Zen Old Mincho per als passatges i les seves marques, amb els kana dins dels atributs de :kunten; Klee One per a les lectures i el seu furigana; Noto Sans JP per a les etiquetes. La quarteta va amb dos versos per línia i un espai ideogràfic entre ells, una manera habitual d'imprimir-la, perquè el poema i la seva lectura càpiguen a la pàgina sota el títol.
La recepta completa
// ═══ Postext Cookbook · Nº 122 · Kanbun with its reading marks, and the Japanese reading ═══
// https://postext.dev/en/cookbook/kanbun-kundoku
// Code: MIT · Text: 論語, 孟浩然「春暁」 (public domain); kunten and readings CC BY 4.0
// Fonts: Zen Old Mincho, Klee One, 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 page is Japanese in both
const RECIPE = 'kanbun-kundoku';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, the vermilion of hand-written kunten, a school-book paper
const palette = {
ink: '#1e1c1a', // the text
vermilion: '#c0392b', // 朱: the reading marks, as a reader adds them by hand
muted: '#6a635c', // the headings' labels, the folios
paper: '#fcfbf7',
};
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.vermilion, model: 'hex' } },
];
// #endregion
const [MINCHO, KYOKASHO, GOTHIC] = ['Zen Old Mincho', 'Klee One', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [10.5, 21, 36, 16]; // pt, pt: 36字 × 16行, a 2 em pitch
const KANBUN = 15; // pt: the classical text, set larger on two lines of the grid
// #region answer: kanbun with 返り点 and 送り仮名, its yomikudashi beside it in furigana
// :kunten[習]{kaeri="レ" okuri="フ"} sets the return mark small at the character's lower
// left and the okurigana at its lower right, down the line; the text keeps its Chinese
// order, which the reader follows by the marks. cjk.kunten sizes and colours them: half
// the character, in vermilion. The Japanese reading under each passage is plain kana and
// kanji with furigana: {君子|くん|し} gives each character its reading (jukugo ruby).
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
};
const paragraphStyles = [
// The text: 15 pt on a pitch of two grid lines, room for the okurigana beside it. A
// quatrain takes two lines, a couplet to the line with a space between its verses.
{ id: 'kanbun', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
firstLineIndent: em(0), textAlign: 'justify' },
{ id: 'shi', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
indent: em(2), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
// The reading (書き下し文), two characters down in a school-book hand.
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
#Imprimeix les marques en negre
Un llibre imprès compon els kunten amb la tinta del text; treu el color.
- kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
+ kunten: { fontSize: em(0.5), placement: 'inline' },#Posa les marques entre les línies
placement: 'interlinear' treu les marques de retorn de la línia i les porta al buit del costat de la meitat inferior del caràcter, de manera que el passatge conserva l'espaiat del text nu (白文). JIS les posa a la línia, el valor per defecte.
- kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
+ kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'interlinear' },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 →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 論語 (the Analects of Confucius), 學而 1 and 3, 爲政 11, and 孟浩然「春曉」 (Spring Dawn), in shinjitai; the kunten (返り点, 送り仮名) and the yomikudashi follow the usual Japanese school reading and were set for this recipe (CC BY 4.0) · Confucius and his disciples; Meng Haoran; Ignacio Ferro (kunten and reading) · domini públic
- Fonts
- Zen Old Mincho (SIL OFL 1.1) · Klee One (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)


