iamcheyan/fudoki

Fudokiは、デバイス上で完全に動作する無料のブラウザベースの日本語学習ツールです。日本語のテキストを貼り付けたり入力したりすると、単語ごとに分割し、品詞（名詞、動詞、助詞など）をラベル付けし、読み方（かなとローマ字）を表示し、コンピュータ音声で読み上げることができます。

アカウント不要、クラウド不要。 ドキュメント、設定、単語分析データなど、すべてがブラウザのローカルストレージに保存されます。アプリ全体が読み込み後にオフラインで動作します（PWAとして）。

できること

1. テキスト分析。 日本語を入力または貼り付けて分析ビューに切り替えると、各単語に小さな色付きドットと下線が表示され、品詞（名詞=緑、動詞=青、形容詞=オレンジ、副詞=紫、助詞=赤、感嘆詞=黄）と読み方が表示されます。

2. 音声読み上げ。 単語、行、またはドキュメント全体を再生します。再生速度を0.5倍から2.0倍まで調整し、音声を選択し、一時停止/再開（専用ボタン）が可能です。再生中に速度や音声を変えると、現在の位置付近から自動的に再開されます。設定はセッション間で保持されます。

3. 単語検索。 単語カードをクリックすると辞書エントリ（JMdictベース）が開き、翻訳、読み、Tanaka Corpusからの例文が表示されます。これらはすべてオンデマンドで読み込まれるオフラインデータスライスとして提供されます。

4. 読書モード。 読み上げ中の行をハイライトするクリーンな全画面オーバーレイで、閉じるボタンとアクティブ中もアクセス可能な切り替えボタンを備えています。

5. ドキュメント管理。 検索、お気に入り、フィルタ機能を備えたサイドバー。自動保存機能により執筆内容が保持されます。内蔵のMarkdownエディタ（太字、斜体、見出し、リスト、リンク、プレビュー—全画面のサイドバイサイドプレビューを含む）も使用できます。

6. データのインポート/エクスポート JSONバックアップファイルとして。

名前の由来

fudoki という名前は、日本の古代の地誌である風土記（Fudoki）に敬意を表しています。奈良時代の記録であり、地域の風景、風習、文化を静かに記録したものです。「風土」は場所の感覚を、「記」は記録することを意味します。このアプリはその精神を借りて、日本語テキストを分割、ラベル付け、再音声化することで「言語の風土」を記録します。

使い方

• オンライン: https://fudoki.iamcheyan.com
• またはローカルで（プロジェクトフォルダから）:

  python3 -m http.server 8000
  # then open http://localhost:8000
  

技術的背景

• 単語分割 / 品詞タグ付け: Kuromoji.js (JSに移植された日本語形態素解析器; Apache License 2.0)
• 辞書: JMdict (Creative Commons Attribution-ShareAlike 3.0) および Tanaka Corpus の例文 (CC BY 2.0 FR)
• 音声: ブラウザ内蔵の Web Speech API
• コードベース: 純粋な静的サイト — index.html と static/ 下の JS/CSS、Kuromoji と辞書ファイルは static/libs/dict/ 下に配置。デザイントークン（色、半径、品詞の色合い）は static/styles.css で CSS 変数として定義
• ライセンス: MIT License; サードパーティコンポーネントは上記ライセンスに従う

注意事項

READMEには、20の調査結果をまとめたUI監査レポート (docs/ui-audit-2026-10-08.md) が含まれており、複数の画面サイズ（デスクトップ 1280×800 / 1920×1080、タブレット 768×1024、モバイル 390×844 / 365×800 / 320×720、ダーク/ライトテーマ）でのビフォーアフターのスクリーンショットが掲載されています。貢献ガイドラインは GitHub Issues を参照してください: https://github.com/iamcheyan/fudoki/issues