summaryrefslogtreecommitdiff
path: root/website/src/ja/docs/features/japanese-conversion.md
diff options
context:
space:
mode:
authorSho Sakuma <me@m1sk9.dev>2026-06-12 15:42:51 +0900
committerSho Sakuma <me@m1sk9.dev>2026-06-12 15:42:51 +0900
commit8326b6a7619fd9e4fb6a640d01c4bf0c6194dc81 (patch)
tree5a11035b136b216f2033d78a1e4d6b6138c18772 /website/src/ja/docs/features/japanese-conversion.md
parent043e202b1cbedad69d5521a83e791c106b49b10f (diff)
downloadLunaticChat-8326b6a7619fd9e4fb6a640d01c4bf0c6194dc81.tar.gz
LunaticChat-8326b6a7619fd9e4fb6a640d01c4bf0c6194dc81.tar.bz2
LunaticChat-8326b6a7619fd9e4fb6a640d01c4bf0c6194dc81.zip
docs(website): make English the default locale
Swap the website default locale from Japanese to English. English now lives at the site root (/), and Japanese moves under /ja/. Update locale config, nav/sidebar links, internal doc links, and asset relative paths accordingly. Co-Authored-By: Claude <noreply@anthropic.com>
Diffstat (limited to 'website/src/ja/docs/features/japanese-conversion.md')
-rw-r--r--website/src/ja/docs/features/japanese-conversion.md62
1 files changed, 62 insertions, 0 deletions
diff --git a/website/src/ja/docs/features/japanese-conversion.md b/website/src/ja/docs/features/japanese-conversion.md
new file mode 100644
index 0000000..e5e751b
--- /dev/null
+++ b/website/src/ja/docs/features/japanese-conversion.md
@@ -0,0 +1,62 @@
+---
+layout: doc
+---
+
+# ローマ字変換
+
+ローマ字で入力したチャットメッセージを自動的に日本語に変換します.この機能を利用するには `config.yml` で `features.japaneseConversion.enabled` を `true` に設定してください.
+
+## 変換の仕組み
+
+変換は2段階で行われます.
+
+1. **ローマ字 → ひらがな**: プラグイン内蔵の Trie ベースの変換エンジンでローマ字をひらがなに変換します
+2. **ひらがな → 漢字/カナ**: Google IME API を使用してひらがなを自然な日本語に変換します
+
+### 変換例
+
+```
+入力: konnichiha sekai
+変換1: こんにちは せかい
+変換2: こんにちは 世界
+```
+
+## 変換対象
+
+- 通常チャット
+- ダイレクトメッセージ (`/tell`, `/reply`)
+- チャンネルチャット
+
+入力が有効なローマ字でない場合 (英単語などが含まれる場合),変換は行われずそのまま送信されます.
+
+## プレイヤー設定
+
+プレイヤーは個別に変換のオン/オフを切り替えられます.
+
+```
+/lc settings japanese on # 変換を有効化
+/lc settings japanese off # 変換を無効化
+```
+
+## キャッシュ
+
+変換結果は単語単位でキャッシュされ,同じ単語の再変換時には API を呼び出さずにキャッシュから取得します.キャッシュは JSON ファイルとしてディスクに定期保存されます.
+
+| 設定キー | デフォルト | 説明 |
+|----------|-----------|------|
+| `cache.maxEntries` | `500` | キャッシュの最大エントリ数 |
+| `cache.saveIntervalSeconds` | `300` | ディスク保存の間隔 (秒) |
+| `cache.filePath` | `"conversion_cache.json"` | キャッシュファイルのパス |
+
+キャッシュが上限に達すると,古いエントリの10%が自動的に削除されます.
+
+## API 設定
+
+Google IME API への接続に関する設定です.
+
+| 設定キー | デフォルト | 説明 |
+|----------|-----------|------|
+| `api.timeout` | `3000` | リクエストタイムアウト (ミリ秒) |
+| `api.retryAttempts` | `2` | 失敗時のリトライ回数 |
+
+API がタイムアウトまたは失敗した場合,ひらがなのまま送信されます.