japanese-furigana-normalize
v1.0.5
Published
Normalize Japanese readings to furigana
Downloads
38
Readme
Japanese Furigana Normalize
This package provides a utility function to normalize Japanese readings containing furigana. It is particularly useful for creating Yomitan dictionaries and ensuring the readings are properly aligned with the kanji characters.
Purpose
Let's say you have a term such as 喫茶ステラと死神の蝶
and its reading
かふぇすてらとしにがみのちょう
. The term contains the katakana ステラ
, but
the reading is in hiragana. So if you were to put this into a Yomitan
dictionary, you would want to normalize the reading to
かふぇステラとしにがみのちょう
so that there is no unnecessary furigana on top
of the katakana characters. This package handles this as well as other cases to
ensure the readings are properly handled by Yomitan.
| | | | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | | | | Before normalization | After normalization |
Installation
npm install japanese-furigana-normalize
Usage
The primary function provided by this package is
normalizeReading(term: string, reading: string)
, which takes two parameters:
term
: The term or phrase.reading
: The corresponding reading in hiragana.
The function normalizes the reading to match and align with the kanji characters present in the term.
For example:
import { normalizeReading } from 'japanese-furigana-normalize';
const term = '喫茶ステラと死神の蝶'; // Kanji term
const reading = 'かふぇすてらとしにがみのちょう'; // Hiragana reading
const normalizedReading = normalizeReading(term, reading);
console.log(normalizedReading); // Output: かふぇステラとしにがみのちょう
For more examples, you can refer to the
normalizeReading.test.ts
file.