AozoraEpub3-JDK21

Java 21〜26対応 / Gradle対応版

[!NOTE] Read this in other languages: English (Auto-translated by your browser)

青空文庫の注記入りテキストファイルを EPUB 3 ファイルに変換するツールです。

[!IMPORTANT] 正規配布について: このプロジェクトの正規配布物は GitHub Releases のみです。 各リリースには SHA-256 チェックサム・GitHub artifact attestation を添付しています。 検証方法は VERIFY.md を参照してください。 非公式フォークや再配布物は、同名であっても正規版とは限りません。

このプロジェクトについて

このプロジェクトは hmdev/AozoraEpub3 を元に、Java 21対応および narou.rb での利用を目的として改変したものです。

• 元プロジェクト: hmdev/AozoraEpub3
• ライセンス: GPL v3（元作者に帰属）
• 目的: narou.rb との連携、Java 21 への対応

---

ライセンス

• AozoraEpub3 の再配布・改変には GPL v3 が適用されます（元作者に帰属）。

特徴

• 青空文庫テキスト（txt/zip）を EPUB 3.3 準拠（EPUB 3.2後方互換）で変換
• Web小説サイトのHTMLから青空文庫形式テキストを取得して変換
• 画像zip/rarを EPUB 3 に変換
• 縦書き・横書きに対応
• 日本の主要電子書籍リーダー（Kobo, Kindle, Reader等）に対応
• Java 21 ベースで開発（Java 25 LTS まで動作確認済み、JDK 26 でも CI ビルド/テスト PASS）
• iPhone版Kindle縦書き対応（※表題ページのレイアウトが画面比率により崩れることがあります）
• 高速変換: 大容量アーカイブの処理を最適化（アーカイブスキャンを4回→1回に削減）
• EPUB プレビュー: 変換した EPUB を実機へ移す前にブラウザで確認（本棚から複数の EPUB を選んで表示）

---

画面

ファイルまたは URL をドラッグ＆ドロップすると EPUB に変換します。

変換した EPUB は、リーダーアプリに移す前にブラウザでそのままプレビューできます。
縦書き・ルビ・段組・目次を実機に近い形で確認できます。

画面例は青空文庫の『銀河鉄道の夜』（宮沢賢治、著作権保護期間満了）を変換したものです。 画像は配布パッケージからも参照できるよう GitHub 上の絶対 URL で読み込んでいます。

---

動作環境

Java 21以降 が必要です（Java 25 LTS まで動作確認済み）。

• 実行: JRE 21以降で動作します（JDK不要）。Adoptium Temurin などのランタイム配布を推奨。配布物は Java 21 ターゲットでビルドされている（class file version 65）ため、JDK 21 LTS から JDK 25 LTS までいずれの環境でも動作します（JDK 26 ランタイムも CI で起動確認済）。
• ビルド/開発: JDK 21 が必要です（Gradle の launcher は JDK 21 で動かします。Gradle 9.6.1 では JDK 26 で起動できませんでした）。./gradlew -PjavaToolchainVersion=26 jar で JDK 26 toolchain によるビルドも可能です。
• 推奨: Java 25 LTS を推奨します（Java 21 LTS でも動作します）。Temurin による JDK 26 のバイナリ配布が出揃い次第、推奨を更新する予定です。

Java をお持ちでない場合は、Adoptium から Java 25 LTS をダウンロードしてください。

対応OS

• Windows 10 以降
• macOS
• Ubuntu

---

インストール

方法 1: リリース版をダウンロード（推奨）

最新版は GitHub Releases から取得できます。

配布パッケージには以下が含まれます：

• FAT JAR（依存関係込みの単一JAR）
• 起動スクリプト（.exe / .sh）
• テンプレートファイル（template/）
• プリセット設定（presets/）
• 外字定義（gaiji/）
• ドキュメント

Windows（ZIP）:

AozoraEpub3-1.8.2-jdk21.zip

Linux/macOS（TAR.GZ）:

AozoraEpub3-1.8.2-jdk21.tar.gz

インストール手順

1. 上記リンクからお使いのOS向けファイルをダウンロード
2. Windows のみ・展開前に推奨: ダウンロードした ZIP を右クリック →「プロパティ」→ 下部の「許可する」にチェック → OK（Unblock-File .\AozoraEpub3-*.zip でも同じ）。これをしてから展開すると、.exe 起動時の SmartScreen 警告を回避できます（理由と詳細）
3. ファイルを任意のフォルダに解凍
4. GUI起動方法（以下のいずれか）：
   • Windows: AozoraEpub3.exe をダブルクリック（推奨）
   • Unix/Linux/macOS: AozoraEpub3.sh を実行
   • 直接実行: java -jar AozoraEpub3.jar

注意: Windows 11では .jar ファイルのダブルクリックが動作しないことがあります。その場合は .exe ファイルをご利用ください。

方法 2: ソースからビルド

開発版の場合は以下の手順でビルドしてください：

git clone https://github.com/AozoraEpub3-JDK21/AozoraEpub3-JDK21.git
cd AozoraEpub3-JDK21
./gradlew dist
# build/distributions/ に配布パッケージ（zip / tar.gz）が生成されます

重要: distZip タスクは無効化されています。配布パッケージの生成には必ず dist を使用してください。

ビルドタスク詳細:

• ./gradlew jar: FAT JAR を生成（build/libs/AozoraEpub3.jar、依存関係込みの単一JAR）
• ./gradlew dist: 配布パッケージを生成（ZIP / TAR.GZ、JAR + スクリプト + ドキュメント + テンプレート）【推奨】
• ./gradlew test: テスト実行
• ./gradlew dependencyUpdates: 依存ライブラリの更新候補をレポート

依存ライブラリ更新（開発者向け）:

• 依存ライブラリは定期的に最新の安定版へ更新しています（alpha/beta/RCは除外）
• CLI の非推奨APIを最新版に移行し、警告を解消
• 更新候補確認: ./gradlew dependencyUpdates
• 詳細は RELEASE_NOTES.md を参照

---

既知の問題

• iOS版Kindle: 表題ページ（title.xhtml）のレイアウトが画面比率によって上下位置ずれ・改ページすることがあります。端末依存の制限のため、必要に応じて「表題ページ出力を無効にする」または「カスタム表紙のみ出力する」設定をご検討ください。
• Windows 11: .jar ファイルのダブルクリックが無反応になる場合があります。配布パッケージに同梱の AozoraEpub3.exe の使用を推奨します。
• GUI フォント: OSが英語設定の場合、日本語字形が環境依存フォントにマップされることがあります。本GUIは OS 別に日本語フォント候補（Windows: Yu Gothic UI/Meiryo）を優先適用することで違和感を軽減しています。

---

最近の変更

v1.8.2-jdk21 (2026-11-08)

• Markdown の入力・画像・Kindle 向けの直し: .md のファイルを Markdown として読めるようにしました。BMP の画像を PNG にして入れるようにしました。壊れた画像で EPUB の検査に通らない本ができていた問題と、色数の少ない画像や透過のある画像を縮小・回転すると色が変わっていた問題を直しました。コマンドラインの -device kindle の画像だけの本と目次、-hor の目次、章の中扉も直しました。

v1.8.1-jdk21 (2026-11-03)

• 表題ページ: スマホで文字を大きくすると題名と著者が重なる問題を修正しました。また、配布物に FlatLaf のライセンス文が含まれていなかった問題を修正しました。

v1.8.0-jdk21 (2026-11-02)

• EPUB 3.3 対応の見直し: 表紙の meta と toc.ncx を既定で出さないようにしました。目次タブで出す設定に戻せます。Kobo・.mobi は今までどおりです。目次の階層、画像だけの本の表示、カクヨムで最初の話が 2 回入る問題などを修正しました。

v1.7.6-jdk21 (2026-10-20)

• 本棚（裏機能）: なろう・ノクターンで、作者名にマイページへのリンクがない作品を作り直すと、タイトルと著者が正しく設定されない問題を修正

v1.7.5-jdk21 (2026-10-20)

• 本棚（裏機能）: 本のカードに右クリックメニューを追加（保存フォルダを開く・ゴミ箱へ移す、GUI・CLI から開いた本棚では Web から取った本の作り直し・全話の取り直しも）。更新時に本文のないページが返っても、取得済みの話のキャッシュを残すように修正

v1.7.4-jdk21 (2026-10-15)

• 本棚（裏機能）: 新しい版があれば本棚の上に知らせる（1 日 1 回、止められる）。前の版を残せなかったときの控えが溜まる問題を修正

v1.7.3-jdk21 (2026-10-14)

• カクヨム: 作品によって章扉・目次の章題に次の章の最初の話の題が出ていたのを修正。章に入らないプロローグが最後の章に入っていたのも修正

v1.7.2-jdk21 (2026-10-14)

• 本棚（裏機能）: ダウンロードのキュー（予約）機能を追加。ダウンロード中にも別の作品を予約でき、順番に自動でダウンロードされる。リネーム中の再描画で入力が反映されなくなる問題を修正

v1.7.1-jdk21 (2026-10-12)

• 本棚（裏機能）の直し: 出力が Kindle（.mobi）の設定で本棚から落とそうとしたときに、断る理由と直し方を出す。ランキングから本棚へ戻るボタンを分かりやすくした

v1.7.0-jdk21 (2026-10-12)

• 青空文庫の作品の URL は、図書カードのテキスト（zip）から変換する: HTML から読み戻すと傍点・字下げ・見出しなどが落ちていた。GUI でも zip の URL を変換まで進める
• Web 変換: 本文のカンマ区切りの数字が消える件、題の ［＃ が注記として読まれる件を修正。話の題・章の題の数字は narou.rb と同じ形になる（前の版と見た目が変わる）
• 出力が変わる直し: 縦書きの短い左右中央のページを本当に中央に、Web の章の中扉の後に改ページ、章の扉の柱を柱として出す、EPUB の中の改行コードを LF に
• 変換が止まる・本文が消える件の修正: 表題より前の閉じない注記、閉じていないルビ・外字注記、CLI のまとめての変換で 1 冊の失敗が残りを止める件など。一覧は RELEASE_NOTES.md

This is the beginning of the README. Read the rest at the original. Read the full README ↗