Saltar al contingut principal
Recepta número 130

Receptari · Capítol 2 · Text i tipografia

Japonès en lletres llatines: el diari en rōmaji de Takuboku

Un text en rōmaji etiquetat ja-Latn: regles japoneses per als kana, sense partició de mots en el llatí i els macrons d'una font llatina portats al PDF.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 148 × 210 mm
  • 1 columna
  • Source Serif 4 10,5/15
  • Noto Serif JP
  • Source Sans 3
  • 4 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 123 ms
  • 131 línies de codi

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

script.js · línies 35–50al codi complet
// 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

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).

Pàgina 2: el dia, l'adreça, els dos primers paràgrafs en rōmaji i les seves lectures en kana, més petites i sagnades.

#2 · Porta els macrons al PDF

script.js · línies 201–203al codi complet
// 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

script.js · línies 54–86al codi complet
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

script.js · línies 90–99al codi complet
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

Sandbox
// ═══ 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, Su­na-ho­ko­ri 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

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)
SandboxPDF