CALIBRE-DEBUG(1)

NAME
calibre-debug - calibre-debug

            calibre-debug [選項]

Various command line interfaces useful for debugging calibre. With no options, this command starts an embedded Python interpreter. You can also run the main calibre GUI, the calibre E-book viewer and the calibre editor in debug mode.

It also contains interfaces to various bits of calibre that do not have dedicated command line tools, such as font subsetting, the E-book diff tool and so on.

You can also use calibre-debug to run standalone scripts. To do that use it like this:
        calibre-debug -e myscript.py -- --option1 --option2 file1 file2 ...

Everything after the -- is passed to the script. You can also use calibre-debug as a shebang in scripts, like this:
        #!/usr/bin/env -S calibre-debug -e -- --

每当向具有它们自己空间的:command:
`
calibre-debug`传递参数时，用引号括起这些参数。例如: "/some path/with spaces"

[選項]

    --add-simple-plugin
        藉由指定包含外掛代碼的 py 檔案路徑，來加入簡單外掛（即只由一個 .py 檔案組成的外掛）

    --command, -c
        執行 Python 程式碼

    --debug-device-driver, -d
        已發現偵錯裝置

    --default-programs
        從 Windows 預設程式註冊 / 註銷 calibre。 --default-programs = (register|unregister)

    --diff
        執行calibre diff工具。例如： calibre-debug --diff file1 file2

    --edit-book
        Launch the calibre "Edit book" tool in debug mode. As with -g use -- to pass command line arguments.

    --exec-file, -e
        執行存有 Python 程式碼的檔案

    --explode-book, -x
        將書解體到指定目錄中。 用法： -x file.epub output_dir 將圖書匯出為 HTML 檔案和中繼資料的集合，您可以使用標準 HTML 編輯工具對其進行編輯。該用法適用於 EPUB、AZW3、HTMLZ 和 DOCX 檔案。

    --export-all-calibre-data
        Export all calibre data (books/settings/plugins). Normally, you will be asked for the export folder and the libraries to export. You can also specify them as command line arguments to skip the questions. Use absolute paths for the export folder and libraries. The special keyword "all" can be used to export all libraries. Examples: calibre-debug --export-all-calibre-data # for interactive use 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 # export all known libraries

    --gui, -g
        Run the GUI with debugging enabled. Debug output is printed to stdout and stderr. To pass command line arguments use -- followed by the arguments, for example: calibre-debug -g -- /path/to/ebook

    --gui-debug
        以偵錯主控台啟動GUI，並將記錄日誌寫入到指定路徑，僅供內部使用，使用 -g選項啟動以偵錯主控台啟動GUI。

    --help, -h
        顯示說明訊息並退出

    --implode-book, -i
        聚合以前炸開過的書籍。 用法：-i output_dir file.epub 從 output_dir 的檔案中匯入該圖書，該檔案必須是由之前呼叫 --explode-book 建立的。一定要指定與炸開時使用的檔案類型相同的檔案類型。

    --import-calibre-data
        匯入先前匯出的calibre數據

    --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 環境時輸出路徑是必需的

    --run-plugin, -r
        Run a plugin that provides a command line interface. For example: calibre-debug -r "Plugin name" -- file1 --option1 Everything after the -- will be passed to the plugin as arguments.

    --run-test, -t
        Run the named test(s). Use the special value "all" to run all tests. If the test name starts with a period it is assumed to be a module name. If the test name starts with @ it is assumed to be a category name.

    --run-without-debug
        Don't run with the DEBUG flag set

    --shutdown-running-calibre, -s
        原因是有執行中的 calibre 實體，如果有，應該將它關閉，注意如果有任何執行中的工作，它們會被直接中止，因此請小心使用。

    --subset-font, -f
        將特定字體子集化，使用在這個選項之後使用「--」以向字體子集程式傳送選項

    --test-build
        測試構建中的二進制模組

    --un-kepubify
        Convert the specified KEPUB file to EPUB without doing a full conversion. This is what the Kobo driver does when importing files from the device.

    --version
        顯示程式版本編號並退出

    --viewer, -w
        Run the E-book viewer in debug mode. As with -g use -- to pass command line arguments.

Author
Kovid Goyal

Copyright
Kovid Goyal