単語テスト生成 / Word Test Generator

英単語・古文単語の小テスト（問題＋解答、A4印刷対応）を生成する、インストール不要・オフライン動作の静的Webアプリです。index.html をブラウザで開くだけで動きます。

特長

• 単語帳・出題範囲（No.）・問題数・出題形式（英→日 / 日→英）を選んでワンクリック生成
• 問題用紙＋解答用紙をA4最適レイアウトで印刷／PDF保存
• 古文単語は自動で縦書き・A4横向き
• 設定は自動保存され次回復元
• 完全クライアント完結（サーバー・通信なし）

使い方

1. このリポジトリを取得（ZIPダウンロード or clone）
2. index.html をダブルクリックしてブラウザで開く
3. 単語帳・範囲・問題数・形式を選んで「テストを生成」→「印刷する」

最初から サンプル単語帳（サンプル英単語 / サンプル古文単語）が入っているので、すぐ動作を試せます。

自分の単語帳を追加する

著作権の都合により、市販単語帳のデータは同梱していません。手元のExcelから自分で生成してください。

python -m pip install openpyxl
python scripts/convert_excel.py <入力.xlsx> <book_id> "<表示名>" --kind en

• Excel形式：1行目ヘッダ No., 単語, 意味、以降にデータ行
• --kind：en（英単語）/ kobun（古文）/ generic（汎用）
• 生成物 data/<book_id>.js と更新された data/books.js を読み込めば一覧に追加されます

生成した単語帳データ（data/*.js・data/*.json）と元Excel（date_xlsx/）は .gitignore でコミット対象外にしています。各自の手元でのみ利用してください。

⚠️ 著作権について

市販の単語帳（単語の選定・訳語・配列を含む編集著作物）のデータを公開リポジトリに含めることはできません。本リポジトリにはアプリのコードと、動作確認用に作成したオリジナルのサンプルデータのみを収録しています。各自が用意する単語帳データは、私的利用の範囲でご使用ください。

ディレクトリ

index.html              アプリ本体（UI・生成ロジック）
guide.html              使い方ガイド
scripts/convert_excel.py  Excel → 単語データ変換スクリプト
data/books.js           単語帳レジストリ（サンプル）
data/sample-en.js       サンプル英単語
data/sample-kobun.js    サンプル古文単語

ライセンス

MIT License で公開しています。