View on GitHub

AozoraEpub3-JDK21

AozoraEpub3 - Aozora Bunko to EPUB 3 Converter (JDK 21)

🌐 English

使い方ガイド

目次

GUI での使い方

基本的な流れ

  1. アプリケーション起動
    • Windows: AozoraEpub3.exe をダブルクリック（推奨）
    • Unix/Linux/macOS: AozoraEpub3.sh を実行
    • または: java -jar AozoraEpub3.jar
  2. ファイル指定
    • 変換したい青空文庫テキストファイル（.txt または .zip）をドラッグ&ドロップ
    • または「ファイル選択」から開く
  3. 設定調整（オプション）
    • 表題・著者名の抽出方法
    • 表紙画像の指定
    • 縦書き/横書きの選択
    • 出力形式（.epub / .kepub.epub など）
  4. 変換実行
    • 変換ボタンをクリック
    • 完了後、入力ファイルと同じフォルダに EPUB ファイルが生成されます

Web小説サイトから直接変換

Web小説サイト（ニコニコ小説、小説家になろう など）のURLまたはURLショートカット（.url）をドラッグ&ドロップで取得・変換できます。（web/ 以下に定義ファイルがあるサイトのみ）

narou.rb互換 フォーマット設定: GUIメニューから「Web小説設定」を開くと以下の項目を設定できます:

設定項目 INIキー 説明 初期値
更新日時を各話に表示 show_post_date 各話の最終更新日時を本文末に表示 OFF
初回公開日を各話に表示 show_publish_date 改稿済の話の初回公開日を表示（更新日時と別行） OFF
前書き・後書きの自動検出 enable_author_comments *44/*48 個パターンで前書き・後書きを検出 ON
自動行頭字下げ enable_auto_indent 行頭の字下げを自動挿入 ON
改ページ直後の見出し化 enable_enchant_midashi 改ページ後の最初の行を見出しとして処理 ON
空行圧縮 enable_pack_blank_line 連続空行を圧縮 ON
漢数字変換 enable_convert_num_to_kanji アラビア数字を漢数字に変換 ON
英字全角化 enable_alphabet_to_zenkaku 短い英単語を全角に変換 ON
読了表示 enable_display_end_of_book 末尾に読了マークを表示 ON
かぎ括弧内自動連結 enable_auto_join_in_brackets かぎ括弧内の行を自動連結 ON
行末読点自動連結 enable_auto_join_line 読点で終わる行を次行と連結 ON

設定は setting_narourb.ini に保存され、narou.rb の setting.ini とキー互換があります。

注意事項:

主な設定項目

表題設定

表紙

ページ出力

ファイル形式

拡張子 対応デバイス 説明
.epub 標準 標準的な EPUB 3.3 準拠形式（EPUB 3.2後方互換）
.kepub.epub Kobo Kobo向け拡張形式
.fxl.kepub.epub Kobo Kobo固定レイアウト用
.mobi Kindle Kindle形式（kindlegenjの別途インストール必要）

画像処理

詳細設定

変換時の注意

テキスト修正が必要な場合

変換時のログに表示される以下の内容は、元のテキストを修正することをお勧めします：

外字（がいじ）の取り扱い

青空文庫の注記仕様で定義された外字は自動変換します：

※［＃「字名」、U+XXXX］  → UTF-8に変換
※［＃「字名」、第X水準X-XX-XX］  → UTF-8に変換（対応表利用）

対応コードが無い外字は代替文字で出力します。

4バイト文字について

Koboなど一部の端末では、4バイト文字（絵文字など）が行内で表示されない制限があります。設定で「4バイト文字変換」を無効にすると、4バイト文字を代替文字「〓」で表示し、小書きで元の字を注記として表示します。

コマンドライン実行

GUIを起動せずにコマンドラインで直接変換実行するには、入力ファイルを引数として指定します。

基本的な使い方

## GUI起動（引数なし）
java -jar AozoraEpub3.jar

## 入力ファイルを指定（CLI実行）
java -jar AozoraEpub3.jar [オプション] 入力ファイル

使い分け

実行方式 用途 コマンド
GUI 対話的な操作（推奨） java -jar AozoraEpub3.jar
CLI バッチ処理・スクリプト化 java -jar AozoraEpub3.jar -d out input.txt

主なオプション

オプション 説明 例
-h, --help ヘルプを表示  
-i <ファイル> INI設定ファイルを指定 -i settings.ini
-enc <エンコード> 入力ファイルのエンコード -enc UTF-8
-t <タイプ> タイトル抽出方法 -t 0 (0=本文内から抽出)
-c <画像> 表紙指定 -c cover.jpg
-d <パス> 出力先ディレクトリ -d ./output/
-ext <拡張子> 出力ファイル拡張子 -ext .kepub.epub
-of ファイル名から表題を生成  
-hor 横書きで出力  
-device <種別> 端末種別を指定 -device kindle
-url <URL> Web小説URLから直接変換 -url https://ncode.syosetu.com/nXXXX/
-narou narou.rb互換フォーマット設定を適用  
-interval <秒> ページ取得間隔（デフォルト 0.5秒） -interval 1.5
-cache <パス> キャッシュディレクトリ -cache .cache

実行例

## 標準的な変換
java -jar AozoraEpub3.jar input.txt

## 出力先を指定
java -jar AozoraEpub3.jar -d ./books/ input.txt

## Kobo形式で出力
java -jar AozoraEpub3.jar -ext .kepub.epub input.txt

## UTF-8エンコードで出力先を指定
java -jar AozoraEpub3.jar -enc UTF-8 -d ./output/ input.txt

## 複数ファイルを一括変換
java -jar AozoraEpub3.jar -d ./books/ file1.txt file2.txt file3.txt

## Web小説URLから直接変換
java -jar AozoraEpub3.jar -url https://ncode.syosetu.com/nXXXX/ -d ./output/

## narou.rb互換設定で変換
java -jar AozoraEpub3.jar -url https://ncode.syosetu.com/nXXXX/ -narou -d ./output/

注記: CLIのヘルプ表示は Commons CLI の新パッケージ org.apache.commons.cli.help.HelpFormatter を使用しており、従来と同等の形式で出力されます（内部非推奨APIの解消）。

テンプレートのカスタマイズ

AozoraEpub3では、EPUB生成に使用するVelocityテンプレートをカスタマイズできます。

テンプレートの優先順位

  1. 外部テンプレート（優先）: AozoraEpub3.jarと同じフォルダのtemplate/ディレクトリ
  2. 内蔵テンプレート（フォールバック）: JAR内に含まれるデフォルトテンプレート

カスタマイズ方法

  1. 配布ZIPに含まれるtemplate/フォルダから編集したいテンプレートを確認
  2. 必要なテンプレートファイル（.vmファイル）を編集
  3. AozoraEpub3.jarと同じ場所にtemplate/フォルダがあることを確認
配布ディレクトリ構成例:
your-directory/
├── AozoraEpub3.jar
├── template/           ← カスタマイズ可能
│   ├── OPS/
│   │   ├── package.vm
│   │   ├── nav.xhtml.vm
│   │   ├── css/
│   │   │   ├── vertical_text.vm
│   │   │   └── horizontal_text.vm
│   │   └── xhtml/
│   │       └── *.vm
│   └── META-INF/
│       └── *.vm
├── gaiji/              ← 外字追加可能
├── presets/            ← プリセット編集可能
└── web/

外部のtemplate/フォルダが存在しない場合、JAR内のデフォルトテンプレートが自動的に使用されます。

編集可能な主なテンプレート

テンプレート 用途
OPS/package.vm EPUB メタデータ・マニフェスト
OPS/nav.xhtml.vm ナビゲーション目次
OPS/css/vertical_text.vm 縦書きCSS
OPS/css/horizontal_text.vm 横書きCSS
OPS/xhtml/*.vm 本文XHTML生成

注意事項

トラブルシューティング

変換できない注記が多い

ファイルが開かない

表示がおかしい

メモリ不足エラー

大きなファイルの場合、メモリを増やして実行してください：

java -Xmx2g -jar AozoraEpub3.jar input.txt

既知の問題

ライセンス

ソースコードおよびバイナリ

GPL v3

ソースコードの流用、改変、再配布を行った場合も GPL v3 が適用されます。

変換データ

AozoraEpub3で変換した ePubファイルの著作権は入力データと同一になります。
ePubファイルの修正や配布は入力データの著作権内で自由に行うことができます。

ホーム | 開発者向けドキュメント | GitHub