En poques paraules
La primera entrada d'un diari de 1909 que el poeta Takuboku va escriure en japonès amb lletres llatines, amb la lectura en escriptura japonesa sota cada paràgraf.
Què compondràs
Quatre pàgines del Rōmaji nikki, el diari que Ishikawa Takuboku va dur a Tòquio la primavera de 1909 en lletres llatines perquè la seva dona no el pogués llegir: les línies que encapçalen el quadern i la primera entrada, la del 7 d'abril, fins a Kanasii koto da! El diari es compon com una edició d'estudi en una pàgina A5: el rōmaji en Source Serif 4, justificat i sense partir mai cap mot, i sota cada paràgraf la seva lectura en kana i kanji en Noto Serif JP, més petita, més clara i sagnada. Takuboku escriu en el sistema Nippon-shiki, si, tu, hu, amb circumflex a les vocals llargues, Tôkyô; les línies de l'editor fan servir Hepburn amb macrons, Rōmaji, i totes dues arriben al PDF.
Aquesta recepta respon a
- Com componc japonès en rōmaji: quina etiqueta d'idioma, quina partició de mots, macrons al PDF?
- Quines fonts componen el japonès, amb els kanji en les seves formes japoneses, a la pantalla i al PDF?
La resposta curta
// ja-Latn is Japanese written in Latin script (BCP 47). Its language is ja, so the kana
// under each paragraph get the Japanese rules (kinsoku, 、。 spacing, the space after !)
// and the built-in strings are Japanese; and Japanese has no hyphenation patterns, so the
// rōmaji is never divided at a line end. English patterns would divide tatinobotta or
// Surigarasu by English syllables, not by the morae a Japanese reader hears.
const language = { locale: 'ja-Latn' }; // spread into the config
const bodyText = {
fontFamily: SERIF, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', firstLineIndent: em(1.2), indentAfterHeading: false,
optimalLineBreaking: true, maxWordSpacing: 1.8, // no hyphens: the spaces take the slack
};
// The reading in kana, under its paragraph: smaller, a shade lighter, indented.
const kana = { id: 'kana', fontFamily: MINCHO, fontSize: pt(8.6), lineHeight: pt(LEAD),
color: col('kana'), textAlign: 'justify', indent: em(1.5), firstLineIndent: em(1),
marginTop: pt(LEAD / 4), marginBottom: pt(LEAD * 0.75) };
Ingredients
- Funcions
- Kana, kanji i rōmajiPartició de mots i llengua del documentFonts xineses, japoneses i coreanesEspaiat de la puntuació japonesa (yakumono)Tall de línies japonès (kinsoku)Tipografia del textObertures dissenyadesEstils de títolAtributs de títolEstils de paràgrafCapçaleres i folisCapçaleres segons el tipus de pàginaMarges simètricsColor del paperPaleta de color semànticaExportació a PDFFonts incrustades al PDF
- També fa servir
- Tall de línies en xinèsCapítols sense número
- Tipografia
- Source Serif 4, Source Sans 3, Noto Serif JP (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Etiqueta el text com a ja-Latn
El codi és la resposta curta de més amunt. ja-Latn és l'etiqueta BCP 47 del japonès escrit en alfabet llatí. El seu idioma és ja, així que la lectura sota cada paràgraf segueix les regles japoneses: kinsoku, l'espaiat de 、。 i el quadratí que el motor afegeix després de ! dins d'una frase, com a 「ええ! ええ!」. El japonès no té patrons de partició de mots, així que el rōmaji no es parteix mai; amb en, els patrons anglesos partirien mots com tatinobotta o Surigarasu per síl·labes angleses, no per les mores que sent un lector japonès. Sense guions, els espais absorbeixen la folgança, per això la mesura ronda els 70 caràcters i maxWordSpacing val 1,8 (partició de mots).

#2 · Porta els macrons al PDF
// Fontsource keeps ō ū ā in a latin-ext file. cjkPdfProvider serves Noto Serif JP from its
// slices, and adds that file after the latin one for a Latin face whose text needs it.
offerPdf(() => renderToPdf(doc, { fontProvider: cjkPdfProvider }), `${RECIPE}.pdf`);
Fontsource guarda ō ū ā en un fitxer latin-ext a part. La pantalla el carrega (loadFonts veu la ō de la mostra), i el cjkPdfProvider del kit fa el mateix amb el PDF. Serveix Noto Serif JP des dels seus fragments japonesos i, quan una font llatina compon una lletra que només és a latin-ext, respon amb dos fitxers, latin i després latin-ext; postext-pdf pren cada glif del primer fitxer que el té. El fontsourceProvider simple del kit només lliura al PDF el fitxer latin: amb ell, el PDF no tindria glif per a la ō.
#3 · Obre amb les línies del mateix diari
const onField = { color: col('paper'), align: 'center', overflow: 'wrap' };
const title = {
id: 'title', numbered: false, toc: false, span: 'page', runningChapter: false,
breakBefore: { enabled: true, parity: 'any' }, // its page is an opener: no running heads
advancedDesign: { enabled: true, minHeight: mm(166), slot: { elements: [
{ kind: 'box', id: 'field', style: { backgroundColor: col('indigo') },
placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill',
height: 'fill' } } },
{ kind: 'text', id: 'lines', content: '{attr.lines}', ...onField, fontFamily: SERIF,
fontWeight: 600, fontSize: pt(20), lineHeight: 1.9, letterSpacing: pt(5),
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(18) } } },
{ kind: 'rule', id: 'rule', thickness: pt(0.5), color: col('paper'),
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(122) },
size: { width: mm(24) } } },
{ kind: 'text', id: 'note', content: '{attr.note}', inlineMarks: true, ...onField,
fontFamily: SANS, fontSize: pt(8.5), lineHeight: 1.5, placement: { anchor: { to:
'container', edge: 'top' }, offset: { y: mm(130) }, size: { width: mm(84) } } },
] } },
};
// The entry: its day as a heading, the address under it from an attribute.
const entry = {
level: 2, fontFamily: SANS, fontWeight: 600, fontSize: pt(10), letterSpacing: pt(2.5),
color: col('indigo'), marginTop: pt(LEAD), marginBottom: pt(LEAD), advancedDesign: {
enabled: true, minHeight: pt(2 * LEAD), slot: { elements: [
{ kind: 'text', id: 'day', content: '{titleText}', fontFamily: SANS, fontWeight: 600,
fontSize: pt(10), letterSpacing: pt(2.5), color: col('indigo'),
placement: { anchor: { to: 'container', edge: 'top-left' } } },
{ kind: 'text', id: 'place', content: '{attr.place}', fontFamily: SANS, fontSize: pt(7.5),
letterSpacing: pt(1), color: col('muted'), overflow: 'wrap', align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: pt(LEAD) },
size: { width: 'fill' } } },
] } },
};
El quadern comença NIKKI. I. MEIDI 42 NEN. 1909. APRIL. TOKYO., una cosa per línia. El títol les pren d'un atribut, cada \n una línia nova, i les compon en versals espaiades sobre un camp índigo, la tela de la tapa d'un quadern. La seva pàgina és una obertura, així que les capçaleres no hi apareixen.
#4 · Capçaleres segons la paritat
const head = (id, content, parity, edge) => ({ kind: 'text', id, content, parity,
pages: 'body', fontFamily: SANS, fontSize: pt(7.5), letterSpacing: pt(1.5), color: col('muted'),
placement: { anchor: { to: 'page', edge }, offset: { y: mm(13), // 'top' centres on the page
x: mm(edge.endsWith('left') ? 16 : edge.endsWith('right') ? -16 : 0) } } });
const header = { elements: [
head('folio-even', '{pageNumber}', 'even', 'top-left'),
head('book', 'ROMAZI NIKKI · 1909', 'even', 'top'),
head('place', 'TOKYO · APRIL', 'odd', 'top'),
head('folio-odd', '{pageNumber}', 'odd', 'top-right'),
] };
La pàgina parella porta el nom del diari i la senar el lloc i el mes, amb els folis a les cantonades exteriors, en Source Sans 3 de 7,5 pt.
La recepta completa
// ═══ Postext Cookbook · Nº 130 · Japanese in Latin letters: Takuboku's Rōmaji Diary ════
// https://postext.dev/en/cookbook/romaji-nikki
// Code: MIT · Text: Ishikawa Takuboku, 1909 (public domain); transcription (CC BY 4.0)
// Fonts: Source Serif 4, Source Sans 3, Noto Serif JP (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A diary written in Japanese with Latin letters, and its reading in kana under each paragraph.
import { buildDocument, withLoadedFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'es'; // @lang: the language of the note; the diary is Japanese in both editions
const RECIPE = 'romaji-nikki';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: diary ink, a faded indigo, the cream of a notebook
const palette = {
ink: '#22201d', // the rōmaji
indigo: '#34497a', // the date and the title (8.4:1 on the paper)
kana: '#5a554e', // the transcription, a step lighter than the text (7:1)
rule: '#c9c1b2',
muted: '#6f6a62', // running heads, folios, the note
paper: '#fcfaf4',
};
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: 'indigo (defaults)', value: { hex: palette.indigo, model: 'hex' } },
];
// #endregion
const SERIF = 'Source Serif 4'; // the rōmaji: ô û â ê in latin, ō ū in latin-ext
const SANS = 'Source Sans 3'; // labels, running heads, folios, the note
const MINCHO = 'Noto Serif JP'; // the kana: Noto Serif JP's Latin is Source Serif's
const [BODY, LEAD] = [10.5, 15]; // pt
// #region answer: a Japanese text in Latin letters is tagged ja-Latn
// ja-Latn is Japanese written in Latin script (BCP 47). Its language is ja, so the kana
// under each paragraph get the Japanese rules (kinsoku, 、。 spacing, the space after !)
// and the built-in strings are Japanese; and Japanese has no hyphenation patterns, so the
// rōmaji is never divided at a line end. English patterns would divide tatinobotta or
// Surigarasu by English syllables, not by the morae a Japanese reader hears.
const language = { locale: 'ja-Latn' }; // spread into the config
const bodyText = {
fontFamily: SERIF, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', firstLineIndent: em(1.2), indentAfterHeading: false,
optimalLineBreaking: true, maxWordSpacing: 1.8, // no hyphens: the spaces take the slack
};
// The reading in kana, under its paragraph: smaller, a shade lighter, indented.
const kana = { id: 'kana', fontFamily: MINCHO, fontSize: pt(8.6), lineHeight: pt(LEAD),
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
#Escriu el rōmaji en Hepburn
Una edició moderna pot reescriure el diari en Hepburn amb macrons, Tōkyō per Tôkyô. El PDF ja porta la ō, així que només canvia el text; afegeix una nota que digui que la grafia és de l'editor.
#Parteix entre mores
Si una columna estreta necessita guions, posa guions tous (U+00AD) entre les mores del rōmaji, Suna-hokori al codi o un U+00AD escrit al text: un document ja-Latn no parteix mai per si sol, però talla en un guionet tou quan un mot no hi cap.
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
Compon el japonès amb una font japonesa
Noto Serif SC i TC tenen kana, però dibuixen els kanji amb formes xineses (直, 骨 i 角 canvien) i el kana amb un disseny xinès. Compon el text en Noto Serif JP o Shippori Mincho B1 i els títols en Noto Sans JP, carregades amb loadCjkFonts. Els fitxers japonesos de Fontsource no tenen hentaigana ni altres kana històrics (U+1B000–1B16F): loadCjkFonts hi falla i el PDF imprimeix caixes, així que escriu el kana modern o porta als recursos de la recepta una font que els tingui. Shippori Mincho tampoc no té les vocals amb macró ō i ū: compon el rōmaji amb una font llatina. Kana, kanji i rōmaji →
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 →
- Shippori Mincho no té ō ni ū; Noto Serif JP i Source Serif 4 les tenen als fitxers
latin-ext. Comprova la font abans de triar-la per a un text en Hepburn. - El xinès en lletres llatines és el pinyin, que va com a ruby sobre els caràcters a Una cartilla amb pinyin sobre cada caràcter; el rōmaji de Takuboku és el text mateix, així que es compon com a text llatí amb el seu espaiat, no com a anotació.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Ishikawa Takuboku, ROMAZI NIKKI (the Rōmaji Diary), the entry of 7 April 1909 to “Kanasii koto da!”, in Latin letters as he wrote it, after the Iwanami Bunko edition (ed. Kuwabara Takeo, 1977) as transcribed on the blog 啄木の息 · Ishikawa Takuboku (1886–1912) · domini públic
- The transcription into kana and kanji under each paragraph and the note on the text, written for this recipe · Postext Cookbook · CC BY 4.0
- Fonts
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1) · Noto Serif 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)


