Provided by: calibre_7.26.0+ds-4build1_all 
NAME
ebook-convert - ebook-convert
ebook-convert input_file output_file [オプション]
電子書籍をある形式から別の形式に変換します。
input_file には入力ファイル、output_file には出力ファイルを指定します。コマンドの最初の 2 つの引数として
両方とも指定する必要があります。
出力する電子書籍の形式は、output_file のファイル拡張子から推測します。output_fileは特別な形式 EXT (EXT は
出力ファイル拡張子) にすることもできます。この場合、出力ファイルの名前は入力ファイルの名前から導き出され
ます。ファイル名の先頭の文字にハイフンは使用できません。output_fileに拡張子がない場合にはフォルダとみな
し、HTMLファイルにより構成される「open e-book」(OEB) がそのフォルダに書き込まれます。これらのファイルは通
常、出力プラグインに渡されるためのものです。
入力ファイルと出力ファイルを指定した後に、さまざまなオプションを指定して変換をカスタマイズすることが可能
です。どのオプションを使用できるかは、入力ファイルと出力ファイルの種類によって決まります。使用可能なオプ
ションのヘルプを表示するには、入力ファイルと出力ファイルを指定した後に -h オプションを指定してください。
変換システムの詳しい説明は次を参照してください。 電子書籍変換
スペースを含む引数を ebook-convert に渡す場合には、クォーテーションマークでくくってください。例: "/some
path/with spaces"
指定できるオプションとデフォルト値は、入力形式と出力形式の 両方に依存するので、以下で確認するようにしてく
ださい:
ebook-convert myfile.input_format myfile.output_format -h
下記のオプションは、ますすべての変換に共通するオプション、続いて 入力形式と出力形式に固有のオプションで
す。
• 入力オプション
• 出力オプション
• 外観
• ヒューリスティック処理
• 検索と置換
• 構造の検出
• 目次
• 書誌
• デバッグ
--help, -h
このヘルプメッセージを表示して終了
--input-profile
入力プロファイルを指定する。入力プロファイルは、変換のためのシステム情報を提供し、様々な入力文書の
情報をどのように解釈するかを指定する。たとえば、解像度に依存する長さ（つまり、ピクセルごとの長
さ）などがあります。選択肢: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad,
irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900
--list-recipes
ビルトイン・レシピ名の一覧を表示。以下のようにしてビルトイン・レシピから電子書籍を作成できます。:
ebook-convert "Recipe Name.recipe" output.epub
--output-profile
出力プロファイルを指定します。出力プロファイルは変換システムに、指定したデバイス毎のドキュメントの
最適化を指定します。特定のデバイス用の最適化を行うことも可能ですが、普通はそこまで必要にはならない
でしょう。選択肢:cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, ipad, ipad3,
irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire, kindle_oasis, kindle_pw,
kindle_pw3, kindle_scribe, kindle_voyage, kobo, msreader, mobipocket, nook, nook_color,
nook_hd_plus, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd, pocketbook_900,
pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape, sonyt3, tablet, generic_eink,
generic_eink_hd, generic_eink_large
--version
プログラムのバージョン番号を表示して終了
入力オプション
入力ファイル mobi の処理制御オプション
--input-encoding
入力された文書の文字エンコーディングを指定します。このオプションを設定した場合、文書内で宣言される
エンコーディングは無視されます。特に、文書がエンコーディング宣言を行っていない場合や、エンコーディ
ング宣言に問題がある場合に有効です。
出力オプション
epub出力処理をコントロールするためのオプション
--dont-split-on-page-breaks
改ページでのファイル分割をしません。通常、入力ファイルは自動的に改ページの部分で2つのファイルに分
割されます。これによりパースが速く、使用リソースの少ない電子書籍が出力されます。しかしながら分割作
業は遅いので、ファイルに大量の改ページがある場合は改ページでの分割をしないでください。
--epub-flatten
このオプションはFBReaderJでEPUBを見る場合のみに必要になります。EPUB内のファイルのレイアウトをフ
ラットにし、すべてのファイルをトップレベルに配置します。
--epub-inline-toc
インラインの目次を本の本文の一部として挿入します。
--epub-max-image-size
The maximum image size (width x height). A value of none means use the screen size from the output
profile. A value of profile means no maximum size is specified. For example, a value of 100x200
will cause all images to be resized so that their width is no more than 100 pixels and their
height is no more than 200 pixels. Note that this only affects the size of the actual image files
themselves. Any given image may be rendered at a different size depending on the styling applied
to it in the document.
--epub-toc-at-end
本の最初ではなく最後にインラインの目次を挿入します。
--epub-version
生成するEPUBファイルのバージョンです。互換性が最も高いのはEPUB2です。EPUB3は、どうしてもそれが必要
とわかっているときに限り指定してください。
--extract-to
指定したフォルダに生成された EPUB ファイルの内容を解凍。フォルダの中身は最初に削除されるので、注意
してください。
--flow-size
指定した容量(KB)以上のHTMLファイルを分割します。大抵のEPUBリーダは大きなファイルサイズを扱えないの
でこのオプションは重要です。デフォルトの 260KBは Adobe Digital Editions 向けのサイズです。0を設定
すると分割を無効にします。
--no-default-epub-cover
通常、入力ファイルに表紙がなく指定しなかった場合、タイトルや著者などからデフォルトの表紙が作成され
ます。このオプションでは表紙の生成を無効にします。
--no-svg-cover
SVGを本の表紙に使用しない。このオプションはiPhoneや JetBook LiteのようなSVGをサポートしないデバイ
スで使用する場合に使ってください。指定しないと、それらのデバイスでは表紙が白紙になってしまいます。
--preserve-cover-aspect-ratio
SVGの表紙を使う場合、このオプションは縦横比を保ったまま、表紙を画面のサイズに広げます。これにより
表紙の両端や上下に白い部分ができる事がありますが、表紙は歪みません。このオプションを使わないと表紙
がいくらか歪みますが白い部分はできません。
--pretty-print
指定した場合は、出力プラグインはできる限り人が読めるような出力を生成しようとします。一部の出力プラ
グインには、なにも効果がない可能性があります。
--toc-title
Title for any generated inline table of contents.
外観
出力の外観を調整するためのオプション
--asciiize
Unicode文字をASCII表記に翻訳します。Unicode文字がASCIIで置き換わることになるため注意して使ってくだ
さい。例えば "Pelé" は "Pele"に置換されます。また文字に複数の表記がある場合（例えば中国語と日本語
で共有されている文字）、表記は現在のcalibreのインタフェース言語が使われます。
--base-font-size
フォントサイズの単位はptです。作成された本の中のすべてのフォントサイズは、ここで指定したフォントサ
イズに従って再指定されます。大きいサイズを指定すれば出力されたファイル中のフォントが大きくなり、逆
に小さいサイズを指定すれば小さくなります。デフォルトの値である0を指定した場合には、ベースとする
フォントサイズは指定した出力プロファイルに従って自動的に選択されます。
--change-justification
テキスト揃えを変更します。「左」に設定すると揃えるべきすべてのテキストを左寄せにします。「揃え
る」にすると揃っていないすべてのテキストを揃えます。「オリジナル」（デフォルト）にすると元ファイル
の揃えを変えません。注: 一部の形式のみで揃えがサポートされている事に注意してください。
--disable-font-rescaling
すべてのフォントサイズの拡大縮小を止める
--embed-all-fonts
入力ドキュメントから参照されているフォントで、まだ埋め込まれていないフォントをすべて埋め込みま
す。この機能は、システム上のフォントを検索し、見つかればそれを埋め込みます。フォントの埋め込み
は、変換先の形式が埋め込みをサポートしている場合、例えば EPUB, AZW3, DOCX, PDF の場合にしか機能し
ません。ドキュメントにフォントを埋め込むための、適切なライセンスを所有していることを確認してくださ
い。
--embed-font-family
書籍に指定したフォントを埋め込みます。これは書籍に使われる「ベース」フォントを指定します。もし入力
ドキュメントがフォントを指定していた場合には、それがベースフォントより優先されます。（そうしたくな
い場合には、スタイル情報絞り込みを使って、入力ドキュメントからフォントを取り除いてください）。注
意：フォント埋め込みはEPUB, AZW3, DOCX のようないくつかの形式でしか機能しません。
--expand-css
デフォルトで calibre は、CSSのmargin, padding, border, 等を指定する際に、短縮形式を使用します。こ
のオプションを有効にすると、短縮形式の代わりにすべて展開された形式を使用します。Nookプロファイル
はNookが短縮形式を取り扱えないため、この設定にかかわらず常に展開された形式を使用する設定になってい
ることに留意ください。
--extra-css
CSSスタイルシートへのパスかCSS自身を指定します。このCSSは入力ファイルのスタイル･ルールに追加される
ので、既存のルールをオーバーライドすることもできます。
--filter-css
CSSスタイルルールから削除する、すべてのCSSプロパティのカンマ区切りのリスト。一部のスタイル情報があ
るとデバイスが受け付けない場合に便利です。例：font-family,color,margin-left,margin-right
--font-size-mapping
CSSフォント名からポイントでのフォントサイズへのマッピング。（例：12,12,14,16,18,20,22,24）xx-small
から xx-largeまでのマッピングで、最後のサイズになると巨大なフォントになります。フォントの再変換ア
ルゴリズムはこれらのサイズを賢く変換します。デフォルトでは、選択した出力プロファイルに基づいたマッ
ピングが使用されます。
--insert-blank-line
段落の間に空行を挿入します。入力ファイルが段落（<p>や<div>タグ）を使っていない場合は動作しません。
--insert-blank-line-size
挿入される空行の高さを設定（単位em）。段落の間の行高さはこの設定値の倍の高さになります。
--keep-ligatures
Preserve ligatures present in the input document. A ligature is a combined character of a pair of
characters like ff, fi, fl et cetera. Most readers do not have support for ligatures in their
default fonts, so they are unlikely to render correctly. By default, calibre will turn a ligature
into the corresponding pair of normal characters. Note that ligatures here mean only unicode
ligatures not ligatures created via CSS or font styles. This option will preserve them instead.
--line-height
ポイントでの行の高さ。連続するテキストの行と行の間のスペースを調整します。行の高さ情報のないエレメ
ントにのみ適用されます。たいていの場合には最低の行の高さの設定のほうが便利でしょう。デフォルトでは
この行の高さの設定はありません。
--linearize-tables
一部のデザインの良くない文書では、ページのテキストレイアウトにテーブルを使用しているものがありま
す。こういった文書を変換すると、ページがはみ出したり乱れることがよくあります。このオプションを使う
と、テーブルから内容を抜き出して直線的な配置に置き換えます。
--margin-bottom
下の余白をpt単位で指定。デフォルトは5.0。この値に0以下の数値を指定すると余白を設定しません (オリジ
ナルのドキュメント内に設定された余白を使用します)。注: PDFやDOCXなど固定ページ形式では、その形式で
の指定が優先します。
--margin-left
左の余白をpt単位で指定。デフォルトは5.0。この値に0以下の数値を指定すると余白を設定しません (オリジ
ナルのドキュメント内に設定された余白を使用します)。注: PDFやDOCXなど固定ページ形式では、その形式で
の指定が優先します。
--margin-right
右の余白をpt単位で指定。デフォルトは5.0。この値に0以下の数値を指定すると余白を設定しません (オリジ
ナルのドキュメント内に設定された余白を使用します)。注: PDFやDOCXなど固定ページ形式では、その形式で
の指定が優先します。
--margin-top
上の余白をpt単位で指定。デフォルトは5.0。この値に0以下の数値を指定すると余白を設定しません (オリジ
ナルのドキュメント内に設定された余白を使用します)。注: PDFやDOCXなど固定ページ形式では、その形式で
の指定が優先します。
--minimum-line-height
計算されたフォントサイズのパーセントに基づく、最小の行の高さです。入力文章の指定にかかわら
ず、calibreはすべてのエレメントで最低限この行の高さになることを保障します。ゼロにすると無効になり
ます。デフォルトは120％です。この意味がよくわかっている場合にのみ、設定からこの行の高さの設定を直
接指定してください。例えば、「2倍の高さ」を指定する場合には設定を240にしてください。
--remove-paragraph-spacing
段落の間の空白を取り除く。同時に段落のインデントを1.5emにします。この機能は入力ファイルが段落
（<p>や<div>タグ）をサポートしない場合には動作しません。
--remove-paragraph-spacing-indent-size
calibreがパラグラフ間の空白行を削除する時に、パラグラフを見えやすくするために自動的にパラグラフの
インデントを設定します。このオプションはそのインデントの幅をコントロールします。（単位em）もしこの
値を負にした場合、入力されたドキュメントで指定されたインデントを使います。つまりcalibreはインデン
トを変えません。
--smarten-punctuation
プレーンな引用符、ダッシュ、省略記号を、活字で正しい同等のものに変換します。詳細については、‐
https://daringfireball.net/projects/smartypants を参照してください。
--subset-embedded-fonts
すべての埋め込みフォントをサブセット化する。すべての埋め込みフォントはこのドキュメントで使用された
文字のみに縮小され、フォントファイルのサイズを減らすことができます。使用していない文字が多い、大き
なフォントを埋め込むときに便利でしょう。
--transform-css-rules
この本のCSSスタイルを変更するルールを記述したファイルへのパス。このファイルを作成する一番簡単な方
法は、calibre GUIにあるルール作成のウィザードを利用することです。「外観→スタイルを変換」セクション
にあるダイアログからアクセスしてください。ルールを作成したら、「エクスポート」ボタンを使ってファイ
ルに保存することができます。
--transform-html-rules
この本の中の HTML を変換するルールを含むファイルへのパス。そのようなファイルを作成する最も簡単な方
法は、calibre GUI 上でウィザードを使用してルールを作成することです。外観 -> HTML 変換セクションで
変換ダイアログを開いてください。ルールを作成した後は「エクスポート」ボタンを使ってファイルに保存で
きます。
--unsmarten-punctuation
ファンシークオート、ダッシュ、省略記号をそれぞれの標準的に対応する物に変換する。
ヒューリスティック処理
共通のパターンを使ってドキュメントのテキストと構造を変更します。デフォルトでは無効になっています。
--enable-heuristicsを使って有効にします。個々のアクションは、--disable-* オプションで無効にすることができ
ます。
--disable-dehyphenate
ドキュメント中のハイフネーションされた単語を分析します。ドキュメント自身を辞書として使い、ハイフン
をそのままにするか取り除くかを決定します。
--disable-delete-blank-paragraphs
2つの段落に挟まれた、空白の段落を取り除きます。
--disable-fix-indents
複数の（改行しない）スペースで作られたインデントを、CSSのインデントへ変換します。
--disable-format-scene-breaks
左寄せのシーン区切りマーカーを中央にします。複数行からなるソフト･シーン区切りを水平区切り線にしま
す。
--disable-italicize-common-cases
イタリック体で表示したり変換したりする常用句やパターンを検索します。
--disable-markup-chapter-headings
フォーマットされていない章タイトルやサブタイトルを見つけます。それらはh2とh3タグに変換されます。こ
の設定だけでは目次を作りませんが、目次作成の機能と同時に使用することができます。
--disable-renumber-headings
連続する<h1>や<h2>タグがあるか探します。タグは章のヘッダの途中で分割されないように、再番号づけされ
ます。
--disable-unwrap-lines
句読点やその他の形式要素によって、行折り返しを解除します。
--enable-heuristics
ヒューリスティック処理を有効にします。このオプションはヒューリスティック処理を行う場合に設定しま
す。
--html-unwrap-factor
行の折り返しをしない長さを決めるための比率。有効な値は０～１まです。デフォルトは0.4で、真ん中より
少し小さいあたりです。もし少しの行しか折り返しする必要が無い場合にはこの値を下げてください。
--replace-scene-breaks
シーン区切りを指定したテキストで置き換えます。デフォルトでは入力ドキュメントからのテキストが使われ
ます。
検索と置換
ユーザ定義のパターンを使って文章や構造を変更します。
--search-replace
検索と置換の正規表現を含むファイルのパスを指定します。ファイルの内容は、検索の正規表現の行と、置換
パターン(置換パターンは空行も可)の行が交互になるようにしてください。正規表現はPythonの文法に従
い、ファイルのエンコーディングは UTF-8 でなくてはいけません。
--sr1-replace
検索1-検索パターンから置き換わる、置換文字列
--sr1-search
検索1-置換文字列と置き換えられる、検索パターン（正規表現）
--sr2-replace
検索2-検索パターンから置き換わる、置換文字列
--sr2-search
検索2-置換文字列と置き換えられる、検索パターン（正規表現）
--sr3-replace
検索3-検索パターンから置き換わる、置換文字列
--sr3-search
検索3-置換文字列と置き換えられる、検索パターン（正規表現）
構造の検出
ドキュメント構造の自動判別を制御
--add-alt-text-to-img
When an <img> tag has no alt attribute, check the associated image file for metadata that
specifies alternate text, and use it to fill in the alt attribute. The alt attribute is used by
screen readers for assisting the visually challenged.
--chapter
章タイトルを検出するためのXPathの式。デフォルトでは、<h1> または <h2> タグのうち "chapter",
"book", "section", "prologue", "epilogue", "part" を含むもの、および class="chapter" のものを章タ
イトルとします。使用する式は、エレメントのリストを評価するものでなくてはなりません。章の検出を無効
にするには、"/" 式を使用します。XPathのチュートリアルは、calibreのユーザマニュアルを参照してくださ
い。
--chapter-mark
見つかった章をどのようにマーキングするか指定します。「改ページ」を選ぶと章の前に改ページを挿入しま
す。「ルール」を選ぶと章の前に行を挿入します。「なし」を選ぶとマーキングを行いません。「両方」を選
ぶと改ページと行の両方を挿入します。
--disable-remove-fake-margins
いくつかの文章は、各段落に左右のマージンを指定することで、ページのマージンを指定していま
す。calibreはそれらのマージンを見つけて削除しようとしますが、たまに、これが原因でマージン全体がな
くなってしまうことがあります。そのような場合、削除を無効にすることができます。
--insert-metadata
本の書誌を本の最初に奥付として挿入する。これは電子書籍リーダが、書誌を直接表示したり検索したりと
いった機能を持たない場合に有効です。
--page-breaks-before
XPath式を指定します。XPathで指定された要素の直前にページブレークが挿入されます。無効にするに
は、式: / を使用してください。
--prefer-metadata-cover
指定した表紙よりもソースファイルから検知した表紙を優先して使います。
--remove-first-image
入力電子書籍から最初の画像を取り除きます。入力ドキュメントに表紙として認識されない表紙がある場合に
有用です。その際、calibreで表紙を指定すると表紙が2つになってしまうのを、このオプションを指定するこ
とで避けることができます。
--start-reading-at
読書を開始する場所を指定するXPath式です。いくつかの電子書籍リーダ(最も典型的なにはKindle)は、本を
開いたときに、ここで指定した場所から開きます。この機能を使用するより詳しい情報は、calibreのユーザ
マニュアルのXPathチュートリアルを参照してください。
目次
目次の自動生成をコントロールします。デフォルトでは、入力ファイルに目次があった場合に優先的に自動生成され
ます。
--duplicate-links-in-toc
もし目次を入力ドキュメントのリンクから作成する場合、重複するエントリーを許す。例えば、1つ以上のリ
ンクが同じテキストで、違う場所を指している場合など。
--level1-toc
目次のレベル 1 に追加するタグをすべて指定するXPath式です。これが指定された場合、他の目次の自動検出
により優先されます。XPathのチュートリアルは、calibreのユーザマニュアル等を参照してください。
--level2-toc
目次のレベル 2 に追加するタグをすべて指定するXPath式です。指定された項目は、直前のレベル 1 の項目
の下に追加されます。XPathのチュートリアルは、calibreのユーザマニュアル等を参照してください。
--level3-toc
目次のレベル 3 に追加するタグをすべて指定するXPath式です。指定された項目は、直前のレベル 2 の項目
の下に追加されます。XPathのチュートリアルは、calibreのユーザマニュアル等を参照してください。
--max-toc-links
目次に入れられる最大のリンク数。0にすると無限になります。デフォルト: 50 。リンクは、最低の章の数の
設定以下の場合にのみ、追加されるます。
--no-chapters-in-toc
目次に自動判定された章を追加しない
--toc-filter
目次から削除する項目を指定するための正規表現による指定。マッチした項目とその子項目は削除されます。
--toc-threshold
この数以下の章が見つかった場合、目次にリンクが追加されます。デフォルト: 6
--use-auto-toc
元のファイルに目次がある場合、通常、設定に従い自動生成されます。このオプションは常に自動生成を行い
ます。
書誌
出力の書誌の設定オプション
--author-sort
著者で並び替える時に使う文字列。
--authors
著者を設定します。複数の著者はアンド記号でつなげてください。
--book-producer
本の製作者を設定します。
--comments
電子書籍の説明を設定
--cover
表紙を指定したファイルまたはURLに設定する
--isbn 本のISBNコードを設定します。
--language
言語を設定します。
--pubdate
発行日を設定 (タイムゾーンが明示的に指定されない限り、ローカルなタイムゾーンとみなします)
--publisher
電子書籍の発行者を設定
--rating
１～５の番号で、評価を設定します。
--read-metadata-from-opf, --from-opf, -m
指定したOPFファイルから書誌を読み込む。このファイルから読み込んだ書誌は、ソースファイルの書誌を上
書きします。
--series
この本のシリーズ名を指定
--series-index
このシリーズの本の巻数を設定します。
--tags 本にタグを設定します。カンマ区切りのリストである必要があります。
--timestamp
本のタイムスタンプを設定（他では一切使われません）
--title
タイトルの設定
--title-sort
タイトルのバージョンを並び替えに使う。
デバッグ
変換をデバッグする補助用のオプション
--debug-pipeline, -d
変換パイプラインのさまざまな段階からの出力を指定されたフォルダーに保存します。変換プロセスのどの段
階でバグが発生しているかわからない場合に便利です。
--verbose, -v
デバッグ出力の量のレベル指定します。複数回指定すると、出力量が増えます。2回指定すると出力量が最大
になります。1回が中程度の出力量で、指定しなければ一番少ない出力量になります。
AUTHOR
Kovid Goyal
COPYRIGHT
Kovid Goyal
7.26.0 2月 14, 2025 EBOOK-CONVERT(1)