Skip to Content

Working with Japanese

This guide covers Japanese-specific features and patterns in GLOST.

Japanese Language Characteristics

Japanese has unique characteristics that GLOST handles:

  • Multiple scripts - Kanji, hiragana, katakana, romaji
  • No word spaces - Like Thai, words run together
  • Furigana - Reading aids above kanji
  • Pitch accent - Regional pitch patterns

Creating Japanese Words

Basic Japanese Word

import { createJapaneseWord } from '@glotblocks/glost-ja'; const word = createJapaneseWord({ text: "今日", romaji: "kyou", partOfSpeech: "noun", furigana: "きょう" }); // Minimal - just text const minimalWord = createJapaneseWord({ text: "今日" });

With Full Transcription Data

import { createGLOSTWordNode } from '@glotblocks/glost'; const word = createGLOSTWordNode({ value: "今日", transcription: { romaji: { text: "kyou" }, furigana: { text: "きょう" }, ipa: { text: "kʲoː" } }, metadata: { partOfSpeech: "noun", usage: "Used for 'today'" }, lang: "ja", script: "kanji" });

Script Types

Kanji

Chinese characters with Japanese readings:

import { createJapaneseWord } from '@glotblocks/glost-ja'; const word = createJapaneseWord({ text: "日本", romaji: "nihon", partOfSpeech: "noun", furigana: "にほん" });

Hiragana

Native Japanese syllabary:

import { createGLOSTWordNode } from '@glotblocks/glost'; const word = createGLOSTWordNode({ value: "これ", transcription: { romaji: { text: "kore" } }, metadata: { partOfSpeech: "pronoun" }, lang: "ja", script: "hiragana" });

Katakana

Used for foreign words:

import { createGLOSTWordNode } from '@glotblocks/glost'; const word = createGLOSTWordNode({ value: "コンピューター", transcription: { romaji: { text: "konpyuutaa" } }, metadata: { partOfSpeech: "noun", etymology: "English: computer" }, lang: "ja", script: "katakana" });

Furigana (Reading Aids)

Furigana shows the reading of kanji.

Simple Furigana

import { createJapaneseWord } from '@glotblocks/glost-ja'; const word = createJapaneseWord({ text: "食べる", romaji: "taberu", partOfSpeech: "verb", furigana: "たべる" });

Ruby-Style Furigana

For complex kanji-furigana alignment:

import { createGLOSTWordNode } from '@glotblocks/glost'; const word = createGLOSTWordNode({ value: "東京", transcription: { furigana: { text: "とうきょう", ruby: [ { base: "東", reading: "とう" }, { base: "京", reading: "きょう" } ] }, romaji: { text: "toukyou" } }, metadata: { partOfSpeech: "proper noun" }, lang: "ja", script: "kanji" });

Word Segmentation

Japanese has no spaces between words.

Manual Segmentation

import { createJapaneseWord } from '@glotblocks/glost-ja'; import { createSentenceFromWords } from '@glotblocks/glost'; const words = [ createJapaneseWord({ text: "私", romaji: "watashi", partOfSpeech: "pronoun", furigana: "わたし" }), createJapaneseWord({ text: "は", romaji: "wa", partOfSpeech: "particle" }), createJapaneseWord({ text: "学生", romaji: "gakusei", partOfSpeech: "noun", furigana: "がくせい" }), createJapaneseWord({ text: "です", romaji: "desu", partOfSpeech: "copula" }) ]; const sentence = createSentenceFromWords( words, "ja", "japanese", "私は学生です" );

Particles

Japanese particles are crucial for grammar:

import { createJapaneseWord } from '@glotblocks/glost-ja'; // Topic marker const wa = createJapaneseWord({ text: "は", romaji: "wa", partOfSpeech: "particle" }); // Object marker const wo = createJapaneseWord({ text: "を", romaji: "wo", partOfSpeech: "particle" }); // Subject marker const ga = createJapaneseWord({ text: "が", romaji: "ga", partOfSpeech: "particle" }); // Direction marker const ni = createJapaneseWord({ text: "に", romaji: "ni", partOfSpeech: "particle" });

Politeness Levels

Japanese has multiple politeness registers:

Plain Form

import { createJapaneseWord } from '@glotblocks/glost-ja'; const eat = createJapaneseWord({ text: "食べる", romaji: "taberu", partOfSpeech: "verb", furigana: "たべる" });

Polite Form (ます)

import { createJapaneseWord } from '@glotblocks/glost-ja'; const eatPolite = createJapaneseWord({ text: "食べます", romaji: "tabemasu", partOfSpeech: "verb", furigana: "たべます" });

Marking Formality

import { createGLOSTWordNode } from '@glotblocks/glost'; const word = createGLOSTWordNode({ value: "食べます", transcription: { romaji: { text: "tabemasu" } }, metadata: { partOfSpeech: "verb", formality: "formal" }, lang: "ja", script: "hiragana" });

Kanji Readings

Kanji can have multiple readings:

On’yomi (Chinese Reading)

import { createGLOSTWordNode } from '@glotblocks/glost'; const word = createGLOSTWordNode({ value: "山", transcription: { furigana: { text: "さん" }, romaji: { text: "san" } }, metadata: { partOfSpeech: "noun", usage: "On reading, used in compounds" }, lang: "ja", script: "kanji" });

Kun’yomi (Japanese Reading)

import { createGLOSTWordNode } from '@glotblocks/glost'; const word = createGLOSTWordNode({ value: "山", transcription: { furigana: { text: "やま" }, romaji: { text: "yama" } }, metadata: { partOfSpeech: "noun", usage: "Kun reading, standalone" }, lang: "ja", script: "kanji" });

Sentence Structure

Basic Sentence

import { createJapaneseWord } from '@glotblocks/glost-ja'; import { createSentenceFromWords } from '@glotblocks/glost'; const words = [ createJapaneseWord({ text: "私", romaji: "watashi", partOfSpeech: "pronoun", furigana: "わたし" }), createJapaneseWord({ text: "は", romaji: "wa", partOfSpeech: "particle" }), createJapaneseWord({ text: "本", romaji: "hon", partOfSpeech: "noun", furigana: "ほん" }), createJapaneseWord({ text: "を", romaji: "wo", partOfSpeech: "particle" }), createJapaneseWord({ text: "読みます", romaji: "yomimasu", partOfSpeech: "verb", furigana: "よみます" }) ]; const sentence = createSentenceFromWords( words, "ja", "japanese", "私は本を読みます" );

With Translation

import { createGLOSTSentenceNode } from '@glotblocks/glost'; const sentence = createGLOSTSentenceNode({ originalText: "私は本を読みます", lang: "ja", script: "japanese", children: words, extras: { translations: { en: "I read a book.", th: "ฉันอ่านหนังสือ" } } });

JLPT Levels

Map difficulty to JLPT:

import { createGLOSTWordNode } from '@glotblocks/glost'; const word = createGLOSTWordNode({ value: "食べる", transcription: { romaji: { text: "taberu" } }, metadata: { partOfSpeech: "verb" }, lang: "ja", script: "hiragana", extras: { metadata: { difficulty: "beginner", jlptLevel: "N5" } } });

Document Example

import { createJapaneseWord } from '@glotblocks/glost-ja'; import { createSentenceFromWords, createParagraphFromSentences, createDocumentFromParagraphs } from '@glotblocks/glost'; // Create a Japanese lesson document const greeting1 = [ createJapaneseWord({ text: "こんにちは", romaji: "konnichiwa", partOfSpeech: "interjection" }) ]; const greeting2 = [ createJapaneseWord({ text: "私", romaji: "watashi", partOfSpeech: "pronoun", furigana: "わたし" }), createJapaneseWord({ text: "は", romaji: "wa", partOfSpeech: "particle" }), createJapaneseWord({ text: "田中", romaji: "tanaka", partOfSpeech: "proper noun", furigana: "たなか" }), createJapaneseWord({ text: "です", romaji: "desu", partOfSpeech: "copula" }) ]; const sentences = [ createSentenceFromWords(greeting1, "ja", "japanese", "こんにちは"), createSentenceFromWords(greeting2, "ja", "japanese", "私は田中です") ]; const paragraph = createParagraphFromSentences(sentences); const document = createDocumentFromParagraphs( [paragraph], "ja", "japanese", { title: "Japanese Self-Introduction" } );

Processing Japanese Documents

import { processGLOSTWithExtensionsAsync } from '@glotblocks/glost-plugins'; const result = await processGLOSTWithExtensionsAsync(document, [ furiganaExtension, freqGen, freqEnh, diffGen, diffEnh ]); // Access processed document const processedDoc = result;
Last updated on