CALIBRE-DEBUG(1)

NAME
calibre-debug - calibre-debug

            calibre-debug [options]

各种有助于调试calibre的命令行接口。如果没有选项，此命令将启动内置的Python解释器。 你也可以在 debug 模式下运行主要的 cailbre GUI，calibre 电子书阅读器和 calibre 编辑器。

它还包含了各种没有专用命令行工具的calibre的接口，比如字体子集，电子书对比工具等等。

你也能用 calibre-debug 来运行独立的脚本。像这样来操作：
        calibre-debug -e myscript.py -- --option1 --option2 file1 file2 ...

    在 -- 后的的所有东西都被传输到了脚本里。您也可以在脚本中使用calibre debug作为shebang。类似这样：
        #!/usr/bin/env -S calibre-debug -e -- --

每当您将包含空格的参数传递给%p程序时，请将参数放在引号中。例如: "/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
        以调试模式启动 Calibre 的“编辑书籍”工具。与 -g（启动主程序 GUI 的选项）类似，请使用 -- 来传递命令行参数。

    --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）。调试输出信息将打印到标准输出（stdout）和标准错误（stderr）。要传递命令行参数，请使用 -- 符号，后面跟着参数，例如：calibre-debug -g --/path/to/ebook

    --gui-debug
        使用调试控制台运行用户界面，日志输出到指定路径。仅适用于内部使用，使用-g选项在调试模式下运行用户界面

    --help, -h
        显示此帮助信息并退出

    --implode-book, -i
        聚合以前拆解过的书籍。 用法：-i output_dir file.epub 从output_dir的文件中导入书籍，这些文件必须是由之前调用:option:
        `
        --explode-book`创建的。一定要指定与拆解时使用的文件格式相同的文件格式。

    --import-calibre-data
        导入先前导出的calibre数据

    --inspect-mobi, -m
        查看指定路径的 MOBI 文件

    --kepubify
        将指定的EPUB文件转换为KEPUB，但不进行完全转换。这是Kobo驱动程序将文件发送到设备时执行的操作。

    --paths
        设置 calibre 环境时输出路径是必需的

    --run-plugin, -r
        运行一个提供命令行接口的插件。例如： calibre-debug -r“插件名称”-- file1 --option1 在--后方的内容将被当作参数传递给插件。

    --run-test, -t
        运行命名的测试。使用特殊值“all”运行所有测试。如果测试名称以句点开头，则假定为模块名称。如果测试名称以@开头，则假定为属性名称。

    --run-without-debug
        不要在设置了DEBUG标志的情况下运行

    --shutdown-running-calibre, -s
        本操作会导致正在运行的 calibre 关闭。请注意：如果正在执行某些任务，那么这些任务会被强行中断。

    --subset-font, -f
        将指定的字体子集化。在此选项后使用 -- 来传递选项到字体子集化程序。

    --test-build
        在构建中测试二进制模组

    --un-kepubify
        将指定的EPUB文件转换为KEPUB，但不进行完全转换。这是Kobo驱动程序从设备导入文件时执行的操作。

    --version
        显示程序版本号并退出

    --viewer, -w
        以调试模式启动电子书阅读器。与 -g（启动主程序 GUI 的选项）类似，请使用 -- 来传递命令行参数。

Author
Kovid Goyal

Copyright
Kovid Goyal