Calibre 常用命令行工具详解之 ebook-convert

全能电子书管理软件 Calibre 除了可视化操作界面，还附带了一系列命令行工具（Command Line Interface），这些工具独立实用。如果你熟悉命令线的使用，想提高处理电子书的效率，或者想自动化一些与电子书处理相关的工作，这些工具会对你很有帮助。本文来自 Calibre 在这些命令行工具中选择了常用的 3 型，分别为：ebook-meta、ebook-convert、calibre-smtp，详细介绍它们是如何使用的，以及它们适用于哪些应用场景。这些内容需要你知道一点命令。

   

目录

   

1、元数据命令：ebook-meta
1、读取电子书元数据
2、写入电子书元数据
2、格式转换命令：ebook-convert
1、基本用法
2、转换示例
3、可用选项
4、应用场景
3、邮件推送命令：calibre-smtp
1、基本用法
2、转换示例
3、可用选项
4、应用场景

本文涉及的命令行工具需要在命令提示符中使用（Windows 系统)或终端（macOS 或 Linux 系统)使用。如果电脑是 Windows 系统一般安装在 Calibre 之后就可以用了。假如电脑是 macOS 或 Linux 系统，安装 Calibre 直接使用前，需要手动将命令行工具的路径添加到系统变量中。

2、格式转换命令：ebook-convert

ebook-convert    可以说是 Calibre 最核心的功能之一，也是朋友们最常用的功能，它的功能是将一本电子书从一种格式转换为另一种格式，带界面的 Calibre 转换电子书格式也是通过调用来实现的。其实命令下的 ebook-convert    使用更快，占用更少的资源。让我们详细了解一下这本书。

1、基本用法

Calibre 官方文档给出的 ebook-convert    指令用法如下：

ebook-convert input_file output_file [options]

转换格式指令有 2 个必填参数和多个可选项。其中 input_file    输入文件格式，output_file    输出文件格式，[options]    是输入和输出文件格式的可用选项。这些选项将使用默认值，默认值将随不同的输入和输出格式而变化。这些选项稍后将被详细解释。

ebook-convert    默认支持的输入文件格式包括：azw4,chm,comic,djvu,docx,epub,fb2,htlz,html,lit,lrf,mobi,odt,pdb,pdf,pml,rb,rtf,recipe,snb,tcr,txt；默认支持的输出文件格式包括：azw3,docx,epub,fb2,html,htmlz,lit,lrf,mobi,oeb,pdb,pdf,pml,rb,rtf,snb,tcr,txt,txtz。

ebook-convert    输出文件的格式是通过指定输出文件名的后缀来确定的。例如，您将输出文件名指定为 example.azw3，所以输出的文件是 AZW3 格式，指定为 example.mobi 就是 MOBI 格式。

若输出文件名未指定后缀名，ebook-convert    将其视为文件夹(不存在的将自动创建)，并将输入的电子书文件转换为 HTML 文件组成的 Open eBook（OEB）将这些文件输出到文件夹中，通常会传输到输出插件。这种操作很像 KindleUnpack    功能可以将电子书分解成源文件。

请注意，无论输入还是输出，其路径或文件名都不能连接到字符-一开始，如果有空间，必须将其放入引号中。

2、转换示例

假设文件被称为假设example.epub”的 ePub 格式电子书转化为 MOBI 格式可直接执行以下指令：

ebook-convert example.epub example.mobi

这里有一个小技巧。如果您想在转换前后使文件名相同，只需输入后缀名即可输出文件名，如下所示：

ebook-convert example.epub .mobi

除了不同格式之间的相互转换外，ebook-convert    也可以用脚本抓取 RSS 或抓取 HTML 页面制作电子书。书伴以前写过 ebook-convert    用例，即《Calibre 用教程抓取网站页面制作电子书》本文介绍了如何通过编写 Recipe 脚本转换电子书。除手动编写脚本外，Calibre 还内置了一些现成的脚本，可以通过 ebook-convert    的特殊选项--list-recipes    列出指令如下：

ebook-convert --list-recipts

* 注：在 macOS 或 Linux 在系统中，为了方便在终端中浏览长列表，可以在指令后面添加参数 | less。

不同于自己写脚本，这些内置脚本不需要指定路径，可以直接 ebook-convert    调用，比如你找到了感兴趣的内容源，直接在源名加 .recipe    可将其转换为电子书，指令如下：

ebook-convert 'The Economist.recipe' 'The Economist.mobi'

需要注意的是，这些内容源大多来自国外网站，一些内容源的脚本可能需要科学上网才能正常使用。

3、可用选项

ebook-convert    指令中的 [options]，它的功能是通过指定不同的选项来定义当前的转换，您可以通过这些预设选项更准确地控制输入和输出。这些选项包括一般选项根据不同输入输出格式的选项。在执行转换指令时，可以添加一个参数 -h    查看可用选项的详细说明，如下所示：

ebook-convert example.txt example.mobi -h

例如，当您输入上述指令时，您可以看到相关输入文件格式 TXT 和输出文件格式 MOBI 相关可选项及其详细说明。当然，如果你想知道所有可选项的详细说明，也可以去 Calibre 官方帮助页面浏览。

为便于查询，书伴 ebook-convert    通用可选项(包括:界面外观、智能处理、搜索替换、结构检测、目录、元数据、调试)和 Kindle 电子书格式转换相关选项的详细说明如下：

3.1、适配设置：

   

--input-profile=INPUT_PROFILE
设置输入配置文件。该配置文件允许程序知道如何分析输入文件并进行转换。例如，页面分辨率(i.e. 以像素为单位)。cybookg3、cybook_opus、default、hanlinv3、hanlinv5、illiad、irexdr1000、irexdr800、kindle、msreader、mobipocket、nook、sony、sony300、sony900。

   

--output-profile=OUTPUT_PROFILE
设置输出配置文件。输出配置文件允许转换系统优化指定的设备文件（如根据设备屏幕大小缩放图片）。在某些情况下，特定设备的输出可以通过输出配置文件进行优化，但几乎没有必要。可选项包括：cybookg3、cybook_opus、default、generic_eink、generic_eink_hd、generic_eink_large、hanlinv3、hanlinv5、illiad、ipad、ipad3、irexdr1000、irexdr800、jetbook5、kindle、kindle_dx、kindle_fire、kindle_oasis、kindle_pw、kindle_pw3、kindle_voyage、kobo、msreader、mobipocket、nook、nook_color、nook_hd_plus、pocketbook_900、pocketbook_pro_912、galaxy、sony、sony300、sony900、sony-landscape、sonyt3、tablet。

【 可用项内容较长，默认已隐藏，点击我展开 】

以上这些 ebook-convert    可选项的中文解释来自其命令提示符中的帮助文档。如果原文档没有翻译成中文，可能会有不准确的地方。如果您在阅读过程中看到它，请指出它。

4、应用场景

灵活使用 ebook-convert    这种命令行工具可以在许多自动化工作中发挥作用，如使用脚本批量转换电子书，定期执行脚本抓取新闻并推送到 Kindle 中等。具体如何应用，以后书伴会陆续发表相关文章。

————–

接下来要介绍的是 calibre-smtp。未完待续……