Saltar al contenido principal
Receta número 130

Recetario · Capítulo 2 · Texto y tipografía

Japonés en letras latinas: el diario en rōmaji de Takuboku

Un texto en rōmaji etiquetado ja-Latn: reglas japonesas para sus kana, sin separación silábica en su latín y los macrones de una fuente latina llevados al PDF.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licencia
Actualizada el 10 oct 2026
Código MIT · Texto CC BY 4.0
  • Formato 148 × 210 mm
  • 1 columna
  • Source Serif 4 10,5/15
  • Noto Serif JP
  • Source Sans 3
  • 4 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 123 ms
  • 131 líneas de código

En pocas palabras

La primera entrada de un diario de 1909 que el poeta Takuboku escribió en japonés con letras latinas, con su lectura en escritura japonesa bajo cada párrafo.

Lo que vas a componer

Cuatro páginas del Rōmaji nikki, el diario que Ishikawa Takuboku llevó en Tokio en la primavera de 1909 en letras latinas para que su mujer no pudiera leerlo: las líneas que encabezan su cuaderno y la primera entrada, la del 7 de abril, hasta Kanasii koto da! El diario se compone como una edición de estudio en una página A5: el rōmaji en Source Serif 4, justificado y sin separar nunca una palabra, y bajo cada párrafo su lectura en kana y kanji en Noto Serif JP, más pequeña, más clara y sangrada. Takuboku escribe en el sistema Nippon-shiki, si, tu, hu, con circunflejo en las vocales largas, Tôkyô; las líneas del editor usan Hepburn con macrones, Rōmaji, y las dos llegan al PDF.

Esta receta responde a

  • ¿Cómo compongo japonés en rōmaji: qué etiqueta de idioma, qué separación silábica, macrones en el PDF?
  • ¿Qué fuentes componen el japonés, con los kanji en sus formas japonesas, en pantalla y en el PDF?

La respuesta corta

script.js · líneas 35–50en el código completo
// 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) };

Ingredientes

Tipografía
Source Serif 4, Source Sans 3, Noto Serif JP (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Etiqueta el texto como ja-Latn

El código está en la respuesta corta. ja-Latn es la etiqueta BCP 47 del japonés escrito en alfabeto latino. Su idioma es ja, así que la lectura bajo cada párrafo sigue las reglas japonesas: kinsoku, el espaciado de 、。 y el cuadratín que el motor añade tras ! dentro de una frase, como en 「ええ! ええ!」. El japonés no tiene patrones de separación silábica, así que el rōmaji nunca se parte; con en, los patrones ingleses dividirían palabras como tatinobotta o Surigarasu por sílabas inglesas, no por las moras que oye un lector japonés. Sin guiones, los espacios absorben la holgura, por eso la medida ronda los 70 caracteres y maxWordSpacing vale 1,8 (separación silábica).

Página 2: el día, la dirección, los dos primeros párrafos en rōmaji y sus lecturas en kana, más pequeñas y sangradas.

#2 · Lleva los macrones al PDF

script.js · líneas 201–203en el código completo
// 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 archivo latin-ext aparte. La pantalla lo carga (loadFonts ve la ō de la muestra), y el cjkPdfProvider del kit hace lo mismo con el PDF. Sirve Noto Serif JP desde sus fragmentos japoneses y, cuando una fuente latina compone una letra que solo está en latin-ext, responde con dos archivos, latin y después latin-ext; postext-pdf toma cada glifo del primer archivo que lo tiene. El fontsourceProvider simple del kit solo entrega al PDF el archivo latin: con él, el PDF no tendría glifo para la ō.

#3 · Abre con las líneas del propio diario

script.js · líneas 54–86en el código completo
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 cuaderno empieza NIKKI. I. MEIDI 42 NEN. 1909. APRIL. TOKYO., una cosa por línea. El título las toma de un atributo, cada \n una línea nueva, y las compone en versales espaciadas sobre un campo índigo, la tela de la tapa de un cuaderno. Su página es una apertura, así que las cabeceras no aparecen en ella.

#4 · Cabeceras según la paridad

script.js · líneas 90–99en el código completo
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 par lleva el nombre del diario y la impar el lugar y el mes, con los folios en las esquinas exteriores, en Source Sans 3 de 7,5 pt.

La receta 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),

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

#Escribe el rōmaji en Hepburn

Una edición moderna puede reescribir el diario en Hepburn con macrones, Tōkyō por Tôkyô. El PDF ya lleva la ō, así que solo cambia el texto; añade una nota que diga que la grafía es del editor.

#Separa entre moras

Si una columna estrecha necesita guiones, pon guiones blandos (U+00AD) entre las moras del rōmaji, Su­na-ho­ko­ri en el código o un U+00AD escrito en el texto: un documento ja-Latn nunca separa por sí solo, pero corta en un guion blando cuando una palabra no cabe.

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

Compón el japonés con una fuente japonesa

Noto Serif SC y TC tienen kana, pero dibujan los kanji con formas chinas (直, 骨 y 角 cambian) y el kana con un diseño chino. Compón el texto en Noto Serif JP o Shippori Mincho B1 y los títulos en Noto Sans JP, cargadas con loadCjkFonts. Los archivos japoneses de Fontsource no tienen hentaigana ni otros kana históricos (U+1B000–1B16F): loadCjkFonts falla con ellos y el PDF imprime cajas, así que escribe el kana moderno o lleva en los recursos de la receta una fuente que los tenga. Shippori Mincho tampoco tiene las vocales con macrón ō y ū: compón el rōmaji con una fuente latina. Kana, kanji y rōmaji →

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 →

  • Shippori Mincho no tiene ō ni ū; Noto Serif JP y Source Serif 4 las tienen en sus archivos latin-ext. Comprueba la fuente antes de elegirla para un texto en Hepburn.
  • El chino en letras latinas es el pinyin, que va como ruby sobre los caracteres en Una cartilla con pinyin sobre cada carácter; el rōmaji de Takuboku es el propio texto, así que se compone como texto latino con su propio espaciado, no como anotación.

Créditos

Texto
  • Ishikawa Takuboku, ROMAZI NIKKI (el Diario en rōmaji), la entrada del 7 de abril de 1909 hasta «Kanasii koto da!», en letras latinas como la escribió, según la edición de Iwanami Bunko (ed. Kuwabara Takeo, 1977) transcrita en el blog 啄木の息 · Ishikawa Takuboku (1886–1912) · dominio público
  • La transcripción en kana y kanji bajo cada párrafo y la nota sobre el texto, escritas para esta receta · Postext Cookbook · CC BY 4.0
Fuentes
Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1) · Noto Serif JP (SIL OFL 1.1)
SandboxPDF