電子書籍のフォーマットを変換します。出力する電子書籍のフォーマットは、出力ファイルの拡張子から推測されます。指定することも可能です。この場合、出力ファイル名の本体部分は、入力ファイル名のものが使用されます。ファイル名の先頭にハイフンは使えませんので注意してください。フォーマットで、指定したディレクトリに出力されます。入力ファイルと出力ファイルを指定した後ろに、変換をカスタマイズするための様々なオプションを指定することができます。使用可能なオプションは、入出力のファイルタイプに依存します。オプションを指定してください。渡す場合には、クォーテーションマークでくくってください。入力フォーマットと出力フォーマットに固有のオプションです。-hこのヘルプメッセージを表示して終了--input-profile入力プロファイルを指定する。入力プロファイルは、変換のためのシステム情報を提供し、様々な入力文書の情報をどのように解釈するかを指定する。解像度に依存する長さ(つまり、ピクセルごとの長さ)などがあります。sony900--list-recipesビルトイン・レシピ名の一覧を表示。以下のようにしてビルトイン・レシピから電子書籍を作成できます。output.epub--output-profile出力プロファイルを指定します。出力プロファイルは変換システムに、指定したデバイス毎のドキュメントの最適化(例えば画面サイズに合わせた画像のリサイズなど)を指定します。特定のデバイス用の最適化を行うことも可能ですが、普通はそこまで必要にはならないでしょう。処理制御オプション--input-encoding入力された文書の文字エンコーディングを指定します。このオプションを設定した場合、文書内で宣言されるエンコーディングは無視されます。文書がエンコーディング宣言を行っていない場合や、エンコーディング宣言に問題がある場合に有効です。出力オプション¶epub出力処理をコントロールするためのオプション--dont-split-on-page-breaks改ページでのファイル分割をしません。通常、入力ファイルは自動的に改ページの部分で2つのファイルに分割されます。これによりパースが速く、使用リソースの少ない電子書籍が出力されます。分割作業は遅いので、ファイルに大量の改ページがある場合は改ページでの分割をしないでください。--epub-flattenこのオプションはFBReaderJでEPUBを見る場合のみに必要になります。EPUB内のファイルのレイアウトをフラットにし、すべてのファイルをトップレベルに配置します。--epub-inline-tocインラインの目次を本の本文の一部として挿入します。--epub-toc-at-end本の最初ではなく最後にインラインの目次を挿入します。--epub-version生成するEPUBファイルのバージョンです。互換性が最も高いのはEPUB2です。EPUB3は、どうしてもそれが必要とわかっているときに限り指定してください。ファイルの内容を指定したディレクトリに展開する。最初にディレクトリの内容が消されるので、注意してください。--flow-size指定した容量(KB)以上のHTMLファイルを分割します。EPUBリーダーは大きなファイルサイズを扱えないのでこのオプションは重要です。0を設定すると分割を無効にします。--no-default-epub-cover通常、入力ファイルに表紙がなく指定しなかった場合、タイトルや著者などからデフォルトの表紙が作成されます。このオプションでは表紙の生成を無効にします。--no-svg-coverSVGを本の表紙に使用しない。LiteのようなSVGをサポートしないデバイスで使用する場合に使ってください。指定しないと、それらのデバイスでは表紙が白紙になってしまいます。--preserve-cover-aspect-ratioSVGの表紙を使う場合、このオプションはアスペクト比(縦横の比率)を保ったまま、表紙を画面のサイズに広げます。これにより表紙の両端や上下に白い部分ができる事がありますが、表紙は歪みません。このオプションを使わないと表紙がいくらか歪みますが白い部分はできません。--pretty-print指定した場合は、出力プラグインはできる限り人が読めるような出力を生成しようとします。一部の出力プラグインには、なにも効果がない可能性があります。--toc-titleすべての生成されたインラインの目次に使われるタイトル。出力の外観を調整するためのオプション--asciiizeUnicode文字をASCII表記に変換します。注意して使ってください。Горбачёв"が変換されます。それと、文字に複数の表記がある場合(例えば中国語と日本語で共有されている文字)、表記は現在のCalibreのインタフェース言語が使われます。--base-font-sizeフォントサイズの単位はptです。作成された本の中のすべてのフォントサイズは、ここで指定したフォントサイズに従って再指定されます。大きいサイズを指定すれば出力されたファイル中のフォントが大きくなり、逆に小さいサイズを指定すれば小さくなります。デフォルトの値である0を指定した場合には、ベースとするフォントサイズは指定した出力プロファイルに従って自動的に選択されます。--change-justificationテキスト揃えを変更します。「左」に設定すると揃えるべきすべてのテキストを左寄せにします。「揃える」にすると揃っていないすべてのテキストを揃えます。「オリジナル」(デフォルト)にすると元ファイルの揃えを変えません。一部のフォーマットのみで揃えがサポートされている事に注意してください。--disable-font-rescalingすべてのフォントサイズの拡大縮小を止める--embed-all-fonts入力ドキュメントから参照されているフォントで、まだ埋め込まれていないフォントをすべて埋め込みます。この機能は、システム上のフォントを検索し、見つかればそれを埋め込みます。場合にしか機能しません。ドキュメントにフォントを埋め込むための、適切なライセンスを所有していることを確認してください。--embed-font-family書籍に指定したフォントを埋め込みます。これは書籍に使われる「ベース」フォントを指定します。入力ドキュメントがフォントを指定していた場合には、それがベースフォントより優先されます。(そうしたくない場合には、スタイル情報絞り込みを使って、入力ドキュメントからフォントを取り除いてください)。ようないくつかのフォーマットでしか機能しません。等を指定する際に、短縮形式を使用します。このオプションを有効にすると、短縮形式の代わりにすべて展開された形式を使用します。NookプロファイルはNookが短縮形式を取り扱えないため、この設定にかかわらず常に展開された形式を使用する設定になっていることに留意ください。--extra-cssCSSスタイルシートへのパスかCSS自身を指定します。このCSSは入力ファイルのスタイル・ルールに追加されるので、既存のルールをオーバーライドすることもできます。--filter-cssCSSスタイルルールから削除する、すべてのCSSプロパティのカンマ区切りのリスト。一部のスタイル情報があるとデバイスが受け付けない場合に便利です。例:font-family,color,margin-left,margin-right--font-size-mappingCSSフォント名からポイントでのフォントサイズへのマッピング。xx-largeまでのマッピングで、最後のサイズになると巨大なフォントになります。フォントの再変換アルゴリズムはこれらのサイズを賢く変換します。デフォルトでは、選択した出力プロファイルに基づいたマッピングが使用されます。--insert-blank-line段落の間に空行を挿入します。入力ファイルが段落(<p>や<div>タグ)を使っていない場合は動作しません。--insert-blank-line-size挿入される空行の高さを設定(単位em)。段落の間の行高さはこの設定値の倍の高さになります。--keep-ligatures入力ドキュメント内の合字をそのままにします。合字とは2つの文字を組み合わせて表現する特別な文字です。(例:ff,fi,fl等)大半のリーダーは標準のフォントで合字をサポートしないので、これらが正しく表示される可能性は低いです。デフォルトではCalibreは合字を2つの通常文字に変換します。このオプションはそれらをそのままにします。--line-heightポイントでの行の高さ。連続するテキストの行と行の間のスペースを調整します。行の高さ情報のないエレメントにのみ適用されます。場合には最低の行の高さの設定のほうが便利でしょう。デフォルトではこの行の高さの設定はありません。--linearize-tables一部のデザインの良くない文書では、ページのテキストレイアウトにテーブルを使用しているものがあります。いった文書を変換すると、ページがはみ出したり乱れることがよくあります。このオプションを使うと、テーブルから内容を抜き出して直線的な配置に置き換えます。--margin-bottom下の余白をpt単位で指定。(オリジナルのドキュメント内に設定された余白を使用します)。PDFやDOCXなど固定ページフォーマットでは、そのフォーマットでの指定が優先します。--margin-left左の余白をpt単位で指定。(オリジナルのドキュメント内に設定された余白を使用します)。PDFやDOCXなど固定ページフォーマットでは、そのフォーマットでの指定が優先します。--margin-right右の余白をpt単位で指定。(オリジナルのドキュメント内に設定された余白を使用します)。PDFやDOCXなど固定ページフォーマットでは、そのフォーマットでの指定が優先します。--margin-top上の余白をpt単位で指定。(オリジナルのドキュメント内に設定された余白を使用します)。PDFやDOCXなど固定ページフォーマットでは、そのフォーマットでの指定が優先します。--minimum-line-height計算されたフォントサイズのパーセントに基づく、最小の行の高さです。入力文章の指定にかかわらず、Calibreはすべてのエレメントで最低限この行の高さになることを保障します。ゼロにすると無効になります。デフォルトは120%です。この意味がよくわかっている場合にのみ、設定からこの行の高さの設定を直接指定してください。「2倍の高さ」を指定する場合には設定を240にしてください。--remove-paragraph-spacing段落の間の空白を取り除く。同時に段落のインデントを1.5emにします。この機能は入力ファイルが段落(<p>や<div>タグ)をサポートしない場合には動作しません。--remove-paragraph-spacing-indent-sizeCalibreがパラグラフ間の空白行を削除する時に、パラグラフを見えやすくするために自動的にパラグラフのインデントを設定します。このオプションはそのインデントの幅をコントロールします。(単位em)もしこの値を負にした場合、入力されたドキュメントで指定されたインデントを使います。Calibreはインデントを変えません。--smarten-punctuation引用記号、ダッシュ、省略記号を印刷上の正しいものに変換します。--subset-embedded-fontsすべての埋め込みフォントをサブセット化する。すべての埋め込みフォントはこのドキュメントで使用された文字のみに縮小され、フォントファイルのサイズを減らすことができます。使用していない文字が多い、大きなフォントを埋め込むときに便利でしょう。--transform-css-rulesこの本のCSSスタイルを変更するルールを記述したファイルへのパス。GUIにあるルール作成のウィザードを利用することです。「外観→スタイル変換」セクションにあるダイアログからアクセスしてください。ルールを作成したら、「エクスポート」ボタンを使ってファイルに保存することができます。--unsmarten-punctuationファンシークオート、ダッシュ、省略記号をそれぞれの標準的に対応する物に変換する。共通のパターンを使ってドキュメントのテキストと構造を変更します。デフォルトでは無効になっています。--enable-heuristicsを使って有効にします。オプションで無効にすることができます。--disable-dehyphenateドキュメント中のハイフネーションされた単語を分析します。ドキュメント自身を辞書として使い、ハイフンをそのままにするか取り除くかを決定します。--disable-delete-blank-paragraphs2つの段落に挟まれた、空白の段落を取り除きます。--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~1まです。デフォルトは0.4で、真ん中より少し小さいあたりです。行しか折り返しする必要が無い場合にはこの値を下げてください。--replace-scene-breaksシーン区切りを指定したテキストで置き換えます。デフォルトでは入力ドキュメントからのテキストが使われます。検索と置換¶ユーザ定義のパターンを使って文章や構造を変更します。--search-replace検索と置換の正規表現を含むファイルのパスを指定します。ファイルの内容は、検索の正規表現の行と、置換パターン(置換パターンは空行も可)の行が交互になるようにしてください。--sr1-replace検索1-検索パターンから置き換わる、置換文字列--sr1-search検索1-置換文字列と置き換えられる、検索パターン(正規表現)--sr2-replace検索2-検索パターンから置き換わる、置換文字列--sr2-search検索2-置換文字列と置き換えられる、検索パターン(正規表現)--sr3-replace検索3-検索パターンから置き換わる、置換文字列--sr3-search検索3-置換文字列と置き換えられる、検索パターン(正規表現)構造の検出¶ドキュメント構造の自動判別を制御--chapter章タイトルを検出するためのXPathの式。ものを章タイトルとします。使用する式は、エレメントのリストを評価するものでなくてはなりません。XPathのチュートリアルは、Calibreのユーザマニュアルを参照してください。--chapter-mark見つかった章をどのようにマーキングするか指定します。「改ページ」を選ぶと章の前に改ページを挿入します。「ルール」を選ぶと章の前に行を挿入します。「なし」を選ぶとマーキングを行いません。「両方」を選ぶと改ページと行の両方を挿入します。--disable-remove-fake-marginsいくつかの文章は、各段落に左右のマージンを指定することで、ページのマージンを指定しています。Calibreはそれらのマージンを見つけて削除しようとしますが、たまに、これが原因でマージン全体がなくなってしまうことがあります。そのような場合、削除を無効にすることができます。--insert-metadata本の書誌情報を本の最初に奥付として挿入する。これは電子書籍リーダーが、書誌情報を直接表示したり検索したりといった機能を持たない場合に有効です。--page-breaks-beforeXPath式を指定します。XPathで指定された要素の直前にページブレークが挿入されます。--prefer-metadata-cover指定した表紙よりもソースファイルから検知した表紙を優先して使います。--remove-first-image入力電子書籍から最初の画像を取り除きます。入力ドキュメントに表紙として認識されない表紙がある場合に有用です。その際、Calibreで表紙を指定すると表紙が2つになってしまうのを、このオプションを指定することで避けることができます。--start-reading-at読書を開始する場所を指定するXPath式です。いくつかの電子書籍リーダー(最も典型的なにはKindle)は、本を開いたときに、ここで指定した場所から開きます。この機能を使用するより詳しい情報は、CalibreのユーザーマニュアルのXPathチュートリアルを参照してください。目次の自動生成をコントロールします。デフォルトでは、入力ファイルに目次があった場合に優先的に自動生成されます。--duplicate-links-in-tocもし目次を入力ドキュメントのリンクから作成する場合、重複するエントリーを許す。1つ以上のリンクが同じテキストで、違う場所を指している場合など。追加するタグをすべて指定するXPath式です。これが指定された場合、他の目次の自動検出により優先されます。XPathのチュートリアルは、Calibreのユーザマニュアル等を参照してください。追加するタグをすべて指定するXPath式です。項目の下に追加されます。XPathのチュートリアルは、Calibreのユーザマニュアル等を参照してください。追加するタグをすべて指定するXPath式です。項目の下に追加されます。XPathのチュートリアルは、Calibreのユーザマニュアル等を参照してください。--max-toc-links目次に入れられる最大のリンク数。0にすると無限になります。リンクは、最低の章の数の設定以下の場合にのみ、追加されるます。--no-chapters-in-toc目次に自動判定された章を追加しない--toc-filter目次から削除する項目を指定するための正規表現による指定。マッチした項目とその子項目は削除されます。--toc-thresholdこの数以下の章が見つかった場合、目次にリンクが追加されます。6--use-auto-toc元のファイルに目次がある場合、通常、設定に従い自動生成されます。このオプションは常に自動生成を行います。出力の書誌情報の設定オプション--author-sort著者で並び替える時に使う文字列。--authors著者を設定します。複数の著者はアンド記号でつなげてください。--book-producer本の製作者を設定します。--comments電子書籍の説明を設定--cover表紙を指定したファイルまたはURLに設定する--isbn本のISBNコードを設定します。--language言語を設定します。(タイムゾーンが明示的に指定されない限り、ローカルなタイムゾーンとみなします)--publisher電子書籍の発行者を設定--rating1~5の番号で、評価を設定します。-m指定したOPFファイルから書誌情報を読み込む。このファイルから読み込んだ書誌情報は、ソースファイルの書誌情報を上書きします。--seriesこの本のシリーズ名を指定--series-indexこのシリーズの本の巻数を設定します。--tags本にタグを設定します。カンマ区切りのリストである必要があります。--timestamp本のタイムスタンプを設定(他では一切使われません)--titleタイトルの設定--title-sortタイトルのバージョンを並び替えに使う。-d指定したディレクトリに変換の各ステージでの出力を保存します。変換プロセスのどのステージでバグが起こっているのか確信がない場合に便利です。-vデバッグ出力の量のレベル指定します。複数回指定すると、出力量が増えます。2回指定すると出力量が最大になります。1回が中程度の出力量で、指定しなければ一番少ない出力量になります。