calibre-debug

calibre-debug [options]

calibreのデバッグに役立つさまざまなコマンドラインインターフェース。オプションを指定しない場合、このコマンドは組み込みのPythonインタープリタを起動します。メインのcalibre GUI、calibre電子書籍ビューア、calibreエディタをデバッグモードで実行することもできます。

また、フォントのサブセット化、Eブックのdiffツールなど、専用のコマンドラインツールがないcalibreのさまざまな部分へのインターフェースも含まれています。 :command:`calibre-debug`を使用してスタンドアロンスクリプトを実行することもできます。そのためには、次のように使用します。

calibre-debug -e myscript.py -- --option1 --option2 file1 file2 ...

以降のすべてがスクリプトに渡されます。:command:`calibre-debug`をスクリプトのshebangとして使用することもできます。例:

#!/usr/bin/env -S calibre-debug -e -- --

スペースを含む引数を calibre-debug に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

[オプション]

--add-simple-plugin

プラグインのコードを含むpyファイルのpathを指定し、単純なプラグイン(単一の.pyファイルのみで構成されるプラグイン)を追加

--command, -c

Pythonコードを実行

--debug-device-driver, -d

デバイス認識をデバッグ

--default-programs

Windows の既定のプログラムに登録/登録解除 --default-programs = (register|unregister)

--diff

差分ツールを実行。例: calibre-debug --diff file1 file2

--edit-book

calibreの "本の編集" ツールをデバッグモードで起動します。-gオプションと同様に、コマンドライン引数を渡すには--オプションを使用します。

--exec-file, -e

ファイル中のPythonコードを実行

--explode-book, -x

指定されたディレクトリに本を分解。 使用例: -x file.epub output_dir 本をHTMLファイルと書誌のまとまりとしてエクスポートし、標準的なHTML編集ツールで編集できるようにします。EPUB, AZW3, HTMLZ, DOCX に利用可能です。

--export-all-calibre-data

calibreのすべてのデータ（本、設定、プラグイン）をエクスポートします。通常、エクスポート先のフォルダとライブラリを指定するよう求められます。コマンドライン引数として指定することで、これらの質問をスキップすることもできます。エクスポート先のフォルダとライブラリには絶対パスを使用してください。特別なキーワード "all" を使用すると、すべてのライブラリをエクスポートできます。例： calibre-debug --export-all-calibre-data # 対話型で使用 calibre-debug --export-all-calibre-data /path/to/empty/export/folder /path/to/library/folder1 /path/to/library2 calibre-debug --export-all-calibre-data /export/folder all # 既知のすべてのライブラリをエクスポート

--gui, -g

デバッグを有効にしてGUIを実行します。デバッグ出力は標準出力と標準エラー出力に表示されます。コマンドライン引数を渡すには、-- の後に引数を指定します。例: calibre-debug -g -- /path/to/ebook

--gui-debug

デバッグコンソールでGUIを実行し、指定されたpathにログを記録。内部での使用に限定し、GUIをデバッグモードで実行するには -g オプションを使用してください。

--help, -h

このヘルプメッセージを表示して終了

--implode-book, -i

分解された本を連結。 使用例: -i output_dir file.epub :option:`--explode-book`により分割されたファイルの置かれた output_dir を読み込んで連結し、本にします。必ず分割したときと同じファイルタイプを指定してください。

--import-calibre-data

以前エクスポートしたデータをインポート

--inspect-mobi, -m

指定されたパスのMOBIファイルを検査

--kepubify

Convert the specified EPUB file to KEPUB without doing a full conversion. This is what the Kobo driver does when sending files to the device.

--paths

calibreの環境設定に必要なpathを出力

--run-plugin, -r

コマンドラインインタフェースを提供するプラグインを実行。例: calibre-debug -r "Plugin name" -- file1 --option1 -- 以降にあるものは、すべてプラグインに引数として渡されます。

--run-test, -t

指定されたテストを実行します。すべてのテストを実行するには、特別な値 "all" を使用します。テスト名がピリオドで始まる場合はモジュール名とみなされます。テスト名が@で始まる場合はカテゴリ名とみなされます。

--run-without-debug

DEBUGフラグを設定して実行しないでください

--shutdown-running-calibre, -s

実行中のcalibreをシャットダウン。注意: ジョブが動作中であっても警告なしに終了するため、注意して実行してください。

--subset-font, -f

指定されたフォントをサブセット化。このオプションの後に "--" をつけるとフォント・サブセットプログラムにオプションを渡します。

--test-build

ビルド中にバイナリーモジュールをテスト

--un-kepubify

指定されたKEPUBファイルを、フル変換を行わずにEPUBに変換します。これは、Koboドライバがデバイスからファイルをインポートする際に行う処理です。

--version

プログラムのバージョン番号を表示して終了

--viewer, -w

電子書籍ビューアをデバッグモードで実行します。-g と同様に、-- を使用してコマンドライン引数を渡します。