Man page - ebook-convert(1)

Packages contains this manual

Available languages:

en fr mr pt_BR is es kn it ca pl vi nb sl lv pt eo ms ko fa eu et nl ar da cs gl tr zh_HK sk hu bg sv hr ja he lt uk fi ru ro zh_TW sr ka el zh_CN de

Manual

EBOOK-CONVERT

NAME
输 入 格 式 选 项
输 出 格 式 选 项
界 面 外 观
智 能 处 理
查 找 与 替 换
结 构 检 测
目 录
元 数 据
调 试
AUTHOR
COPYRIGHT

NAME

ebook-convert - ebook-convert

ebook-convert input_file output_file [options]

转 换 不 同 格 式 的 电 子 书 。

input_file 表 示 输 入 文 件 ， output_file 表 示 输 出 文 件 。 这 两 者 作 为 命 令 行 参 数 必 须 指 定 到 最 前 面 。

输 出 电 子 书 格 式 由 output_file的 文 件 扩 展 名 推 测 。 output_file也 可 以 是 特 殊 格 式 .EXT， 其 中 EXT是 输 出 文 件 扩 展 名 。 在 这 种 情 况 下 ， 输 出 文 件 的 名 称 源 自 输 入 文 件 的 名 称 。 请 注 意 ， 文 件 名 不 能 以 连 字 符 开 头 。 如 果 output_file不 含 扩 展 名 ， 那 么 它 将 被 视 为 一 个 文 件 夹 ， 由 HTML文 件 组 成 的 “开 放 电 子 书 ”（ OEB） 将 被 写 入 该 文 件 夹 。 这 些 文 件 会 被 视 为 正 常 文 件 而 被 输 出 插 件 所 识 别 。

在 指 定 输 入 和 输 出 文 件 后 ， 你 可 以 自 定 义 特 定 的 转 换 选 项 。 根 据 输 入 和 输 出 文 件 格 式 不 同 可 用 的 转 换 选 项 也 不 同 。 如 需 获 取 针 对 输 入 和 输 出 文 件 的 帮 助 ， 请 在 命 令 行 中 输 入 -h。

对 于 转 换 系 统 的 完 整 文 档 请 查 阅 电 子 书 转 换

每 当 您 将 包 含 空 格 的 参 数 传 递 给 %p程 序 时 ， 请 将 参 数 放 在 引 号 中 。 例 如 : "/some path/with spaces"

选 项 以 及 选 项 的 默 认 值 都 取 决 于 输 入 和 输 出 格 式 ， 所 以 你 应 该 经 常 检 查 :

ebook-convert myfile.input_format myfile.output_format -h

以 下 是 一 些 常 见 转 化 的 选 项 ， 接 着 是 特 定 输 入 输 出 的 选 项

•

输 入 格 式 选 项

•

输 出 格 式 选 项

•

界 面 外 观

•

智 能 处 理

•

查 找 与 替 换

•

结 构 检 测

•

目 录

•

元 数 据

•

调 试

--help, -h

显 示 此 帮 助 信 息 并 退 出

--input-profile

设 置 输 入 配 置 。 输 入 配 置 让 程 序 了 解 如 何 解 析 输 入 文 档 并 进 行 转 换 。 例 如 页 面 分 辨 率 (i.e. 以 像 素 为 单 位 )。 可 选 项 有 ： cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900

--list-recipes

列 出 内 建 的 规 则 名 。 你 可 以 通 过 如 下 命 令 创 建 基 于 内 建 的 规 则 的 电 子 书 ： ebook-convert " Recipe Name.recipe " output.epub

--output-profile

指 定 输 出 配 置 文 件 . 输 出 配 置 文 件 可 以 指 示 转 换 系 统 如 何 为 特 定 的 设 备 对 生 成 的 文 档 进 行 优 化 . 在 某 些 情 况 下 , 输 出 配 置 文 件 可 以 对 一 种 特 定 的 设 备 进 行 优 化 输 出 , 但 这 种 情 况 很 少 使 用 . 请 选 择 :cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, ipad, ipad3, irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire, kindle_oasis, kindle_pw, kindle_pw3, kindle_scribe, kindle_voyage, kobo, msreader, mobipocket, nook, nook_color, nook_hd_plus, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd, pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape, sonyt3, tablet, generic_eink_large, generic_eink, generic_eink_hd

--version

显 示 程 序 版 本 号 并 退 出

输 入 格 式 选 项

处 理 输 入 mobi 文 件 的 选 项 设 置
--input-encoding

指 定 输 入 文 件 的 字 符 编 码 。 该 设 置 将 覆 盖 文 档 声 明 的 字 符 编 码 。 该 设 置 对 于 处 理 未 声 明 字 符 编 码 和 字 符 编 码 声 明 错 误 的 输 入 文 件 十 分 有 用 。

输 出 格 式 选 项

处 理 输 出 epub 的 选 项 设 置
--dont-split-on-page-breaks

关 闭 在 分 页 符 处 将 文 件 切 分 为 多 个 的 功 能 . 通 常 , 会 在 分 页 符 处 将 输 入 文 件 做 切 分 生 成 多 个 文 件 . 由 此 可 以 输 出 使 用 资 源 少 、 解 析 快 的 电 子 书 . 当 然 切 分 操 作 会 增 加 处 理 时 间 , 如 果 输 入 文 件 含 有 较 多 的 分 页 符 , 请 关 闭 此 功 能 .

--epub-flatten

仅 当 需 要 使 用 FBReaderJ阅 读 EPUB文 件 时 使 用 本 选 项 。 启 用 本 选 项 会 消 除 EPUB文 件 中 的 目 录 层 级 ， 把 所 有 文 件 放 到 顶 层 目 录 中 。

--epub-inline-toc

插 入 一 个 内 嵌 目 录 ， 将 会 作 为 书 籍 内 容 。

--epub-max-image-size

最 大 图 片 大 小 （ 宽 x高 ） 。 值 none表 示 使 用 输 出 配 置 文 件 中 的 屏 幕 大 小 。 值 profile 表 示 不 指 定 最 大 大 小 。 例 如 ， 值 100x200将 调 整 所 有 图 片 的 大 小 ， 使 其 宽 度 不 超 过 100 个 像 素 ， 高 度 不 超 过 200 个 象 素 。 请 注 意 ， 这 只 会 影 响 实 际 图 片 文 件 本 身 的 大 小 。 任 何 给 定 的 图 片 都 可 以 根 据 文 档 中 应 用 的 样 式 以 不 同 的 大 小 进 行 渲 染 。

--epub-toc-at-end

在 书 籍 的 末 尾 插 入 内 嵌 目 录 ， 而 不 是 书 籍 开 头 。

--epub-version

生 成 的 EPUB文 件 的 版 本 。 EPUB 2 是 最 具 广 泛 兼 容 性 的 ， 只 有 在 必 要 时 才 使 用 EPUB 3。

--extract-to

Extract the contents of the generated book to the specified folder. The contents of the folder are first deleted, so be careful.

--flow-size

将 大 于 该 大 小 (以 KB为 单 位 ) 的 HTML文 件 切 分 为 多 个 文 件 。 由 于 多 数 EPUB阅 读 器 无 法 打 开 太 大 的 文 件 ， 故 此 功 能 很 有 必 要 。 默 认 值 260KB 是 Adobe Digital Editions 的 所 需 大 小 。 设 置 为 0以 禁 用 基 于 大 小 的 切 分 。

--no-default-epub-cover

通 常 ， 如 导 入 的 文 件 无 封 面 图 片 并 且 你 也 未 指 定 ， 则 会 生 成 一 张 带 有 书 名 、 作 者 等 信 息 的 默 认 封 面 。 此 选 项 可 以 禁 止 此 封 面 的 生 成 。

--no-svg-cover

禁 用 SVG格 式 的 图 片 作 为 书 籍 封 面 。 如 果 你 打 算 将 EPUB 文 件 用 到 不 支 持 SVG 格 式 的 设 备 (如 iPhone 或 JetBook Lite)中 的 话 ， 请 使 用 该 选 项 。 不 选 中 此 选 项 的 话 ， 这 类 设 备 将 只 能 将 封 面 显 示 为 一 个 空 白 页 。

--preserve-cover-aspect-ratio

当 使 用 SVG 封 面 时 ， 该 选 项 会 使 封 面 平 铺 满 有 效 的 屏 幕 区 ， 但 仍 会 保 持 它 的 纵 横 比 。 这 意 味 着 可 能 会 在 图 片 顶 部 或 底 部 产 生 白 边 ， 但 是 图 片 本 身 不 会 变 形 。 不 选 该 选 项 的 话 ， 图 片 可 能 会 轻 微 变 形 ， 但 不 会 有 白 边 。

--pretty-print

如 果 开 启 本 选 项 ， 输 出 插 件 将 尽 量 生 成 可 读 的 输 出 内 容 。 对 于 某 些 输 出 插 件 本 选 项 可 能 不 起 作 用 。

--toc-title

生 成 的 内 嵌 到 书 籍 的 目 录 的 标 题 。

界 面 外 观

输 出 的 界 面 外 观 选 项 设 置
--asciiize

将 Unicode字 符 转 换 为 ASCII表 示 形 式 。 请 小 心 使 用 ， 因 为 这 将 用 ASCII替 换 Unicode字 符 。 例 如 ， 它 将 用 “Pele”替 换 “Pelé”。 此 外 ， 请 注 意 ， 如 果 一 个 字 符 有 多 个 表 示 形 式 （ 例 如 ， 中 文 和 日 语 共 享 的 字 符 ） ， 则 将 基 于 Calibre界 面 语 言 的 来 确 定 所 用 的 形 式 。

--base-font-size

基 准 字 体 大 小 （ 以 PT为 单 位 ） 。 在 生 成 的 书 籍 中 所 有 的 字 体 尺 寸 将 基 于 这 个 大 小 重 新 缩 放 。 通 过 选 择 更 大 的 尺 寸 ， 可 以 使 输 出 中 的 字 体 更 大 ， 反 之 亦 然 。 默 认 情 况 下 ， 当 值 为 0时 ， 根 据 你 选 择 的 ' 输 出 配 置 ' 确 定 基 准 字 体 大 小 。

--change-justification

更 改 文 本 对 齐 方 式 。 使 用 值 " 左 对 齐 " 将 转 换 资 源 中 所 有 的 文 本 为 左 对 齐 。 (如 ： 未 对 齐 ) 使 用 值 " justify " 将 转 换 资 源 中 所 有 的 未 对 齐 的 文 本 为 居 中 对 齐 。 使 用 值 " original " (默 认 )则 不 更 改 源 文 件 的 对 齐 方 式 。 请 注 意 ， 仅 部 分 输 出 格 式 支 持 对 齐 方 式 。

--disable-font-rescaling

禁 用 文 字 大 小 缩 放 功 能 。

--embed-all-fonts

嵌 入 输 入 文 档 中 引 用 到 但 未 嵌 入 的 字 体 。 软 件 会 在 你 的 系 统 中 查 找 这 些 字 体 ， 找 到 了 就 嵌 入 。 字 体 嵌 入 只 有 当 你 的 目 标 格 式 支 持 时 才 有 用 ， 例 如 EPUB、 AZW3、 DOCX 和 PDF。 请 保 证 你 拥 有 在 文 档 中 嵌 入 字 体 的 合 适 授 权 。

--embed-font-family

在 书 籍 中 嵌 入 指 定 的 字 体 。 这 里 指 定 了 书 籍 中 使 用 的 “基 础 ”字 体 。 如 果 输 入 文 件 指 定 了 字 体 ， 就 有 可 能 覆 盖 此 处 的 基 础 字 体 。 你 可 以 使 用 “过 滤 样 式 信 息 ”的 选 项 来 删 除 输 入 文 档 中 指 定 的 字 体 。 注 意 ， 字 体 内 嵌 只 在 一 些 输 出 格 式 中 有 用 ， 主 要 是 EPUB、 AZW3 和 DOCX。

--expand-css

默 认 情 况 下 ， calibre 将 使 用 各 种 CSS属 性 的 简 写 形 式 ， 如 边 距 margin、 填 充 padding、 边 框 border等 。 此 选 项 将 使 用 完 整 书 写 方 式 。 注 意 ， 在 生 成 EPUB文 件 时 ， 由 于 Nook不 能 处 理 简 写 的 CSS， 所 以 将 ' 输 出 配 置 ' 设 置 为 Nook配 置 中 的 一 个 时 ， CSS总 是 使 用 完 整 书 写 。

--extra-css

CSS 样 式 表 或 原 始 CSS 文 件 路 径 。 该 CSS 样 式 表 将 会 被 添 加 到 源 文 件 的 样 式 规 则 中 ， 它 可 以 用 于 覆 盖 那 些 样 式 规 则 。

--filter-css

将 从 所 有 CSS样 式 规 则 中 删 除 的 以 逗 号 分 隔 的 CSS 属 性 列 表 。 如 果 某 些 样 式 信 息 阻 碍 了 阅 读 器 设 备 中 的 样 式 设 置 ， 则 此 选 项 非 常 有 用 。 例 如 ： 字 体 、 颜 色 、 左 边 距 、 右 边 距

--font-size-mapping

将 CSS字 体 名 称 映 射 为 以 PT为 单 位 的 字 体 大 小 . 例 如 您 可 以 将 这 里 的 值 设 为 12,12,14,16,18,20,22,24. 这 些 设 置 是 从 xx-small到 xx-large的 对 应 映 射 , 最 后 的 大 小 作 为 对 应 的 字 体 最 大 尺 寸 的 映 射 . 字 体 缩 放 算 法 使 用 这 些 大 小 来 智 能 地 缩 放 字 体 ， 默 认 使 用 ' 输 出 配 置 ' 中 指 定 的 映 射 关 系 .

--insert-blank-line

在 章 节 之 间 插 入 空 行 . 如 果 源 文 件 不 使 用 章 节 标 签 (<p> 或 <div> 标 签 ) 本 选 项 将 不 起 作 用 。

--insert-blank-line-size

设 置 插 入 的 空 行 的 高 度 （ 单 位 ： em） 。 段 落 间 的 空 行 高 度 会 是 两 倍 于 这 个 设 置 值 。

--keep-ligatures

保 留 输 入 文 档 中 的 连 字 。 连 字 是 一 对 字 符 的 组 合 字 符 ， 如 ff、 fi、 fl等 。 大 部 分 阅 读 器 在 使 用 默 认 字 体 时 不 支 持 “连 字 ”， 所 以 常 常 无 法 正 常 显 示 。 默 认 情 况 下 ， calibre 会 把 “连 字 ”转 换 成 对 应 的 一 对 普 通 字 符 。 请 注 意 ， 这 里 的 连 字 仅 指 unicode连 字 ， 而 不 是 通 过 CSS或 字 体 样 式 创 建 的 连 字 。 这 个 选 项 将 保 留 这 些 连 字 。

--line-height

行 高 （ 以 PT为 单 位 ） 。 控 制 连 续 文 本 行 之 间 的 行 高 。 仅 适 用 于 未 定 义 自 身 行 高 的 内 容 元 素 。 大 多 数 情 况 下 ， 最 小 行 高 值 更 加 有 用 。 默 认 不 做 行 高 调 整 。

--linearize-tables

一 些 布 局 不 佳 的 源 文 件 使 用 表 格 来 设 置 页 面 布 局 ， 可 能 会 导 致 输 出 文 件 中 的 正 文 超 过 页 面 范 围 。 本 选 项 设 定 程 序 将 内 容 从 表 格 中 提 取 出 并 以 线 型 布 局 排 列 输 出 。

--margin-bottom

设 定 下 边 距 ， 单 位 pt。 默 认 为 5.0。 如 果 设 置 为 负 值 表 示 不 使 用 页 边 距 （ 保 留 使 用 原 始 文 档 的 页 边 距 ） 。 提 示 ： 面 向 页 面 的 格 式 如 PDF和 docx有 自 己 优 先 的 边 距 设 置 。

--margin-left

设 定 左 边 距 ， 单 位 pt。 默 认 为 5.0。 如 果 设 置 为 负 值 表 示 不 使 用 页 边 距 （ 保 留 使 用 原 始 文 档 的 页 边 距 ） 。 提 示 ： 面 向 页 面 的 格 式 如 PDF和 docx有 自 己 优 先 的 边 距 设 置 。

--margin-right

设 置 右 边 距 ， 单 位 pt， 默 认 为 5.0。 如 果 设 置 为 负 值 表 示 不 使 用 页 边 距 （ 保 留 使 用 原 始 文 档 的 页 边 距 ） 。 提 示 ： 面 向 页 面 的 格 式 如 PDF和 docx有 自 己 优 先 的 边 距 设 置 。

--margin-top

设 定 上 边 距 ， 单 位 pt。 默 认 为 5.0。 如 果 设 置 为 负 值 表 示 不 使 用 页 边 距 （ 保 留 使 用 原 始 文 档 的 页 边 距 ） 。 提 示 ： 面 向 页 面 的 格 式 如 PDF和 docx有 自 己 优 先 的 边 距 设 置 。

--minimum-line-height

最 小 行 高 ， 以 内 容 中 的 元 素 计 算 字 体 大 小 的 百 分 比 来 表 示 。 calibre将 确 保 内 容 中 的 每 个 元 素 的 行 高 至 少 为 此 设 置 ， 无 论 输 入 文 档 如 何 设 置 。 设 置 为 零 以 禁 用 。 默 认 值 为 120%。 除 非 您 知 道 正 在 执 行 的 操 作 ， 否 则 请 优 先 使 用 此 设 置 ， 而 不 是 行 高 规 范 。 例 如 ， 通 过 将 其 设 置 为 240， 可 以 实 现 文 本 的 “双 倍 行 距 ”。

--remove-paragraph-spacing

删 除 段 落 之 间 的 空 行 . 同 时 设 置 段 落 缩 进 为 1.5em. 如 果 源 文 件 不 使 用 段 落 标 记 (<p>或 者 <div>标 签 )程 序 将 不 删 除 段 落 空 行 .

--remove-paragraph-spacing-indent-size

当 calibre 删 除 段 落 之 间 空 行 时 ， 它 会 自 动 设 置 一 个 段 落 缩 进 ， 以 确 保 轻 松 区 分 段 落 。 此 选 项 控 制 缩 进 的 宽 度 (单 位 em)。 如 果 你 将 此 值 设 置 为 负 数 ， 则 使 用 输 入 文 档 中 自 身 定 义 的 缩 进 ， 换 句 话 说 就 是 calibre 不 更 改 缩 进 处 理 。

--smarten-punctuation

将 普 通 引 号 、 破 折 号 和 省 略 号 转 换 为 与 它 们 对 应 的 正 确 印 刷 体 。 有 关 详 情 , 请 参 阅 https://daringfireball.net/projects/smartypants 。

--subset-embedded-fonts

只 嵌 入 字 体 中 用 到 的 字 。 每 种 嵌 入 字 体 缩 减 到 只 包 含 文 档 中 用 到 的 字 型 。 这 能 减 小 字 体 文 件 的 体 积 。 在 嵌 入 特 别 大 的 ， 包 含 大 量 未 使 用 字 的 字 体 时 有 用 (如 中 文 )。

--transform-css-rules

包 含 转 换 本 书 中 CSS样 式 的 规 则 的 文 件 路 径 。 创 建 这 样 一 个 文 件 的 最 简 单 方 法 是 在 calibre GUI中 使 用 向 导 创 建 规 则 。 在 “界 面 外 观 ->转 换 样 式 ”的 转 换 对 话 框 部 分 访 问 它 。 一 旦 创 建 规 则 ， 就 可 以 使 用 “导 出 ”按 钮 将 它 们 保 存 到 文 件 中 。

--transform-html-rules

包 含 转 换 本 书 中 的 HTML的 规 则 的 文 件 的 路 径 。 创 建 这 样 一 个 文 件 的 最 简 单 方 法 是 在 calibre图 形 用 户 界 面 中 使 用 向 导 创 建 规 则 。 在 “外 观 ->转 换 HTML”的 转 换 对 话 框 部 分 访 问 它 。 一 旦 创 建 规 则 ， 就 可 以 使 用 “导 出 ”按 钮 将 它 们 保 存 到 文 件 中 。

--unsmarten-punctuation

将 各 种 形 式 的 引 号 、 破 折 号 和 省 略 号 转 换 到 它 们 的 标 准 形 式 。

智 能 处 理

使 用 常 见 规 则 修 改 文 档 内 容 与 结 构 。 默 认 禁 用 。 使 用 --enable-heuristics 启 用 该 功 能 。 具 体 选 项 可 以 通 过 --disable-* 参 数 禁 用 。
--disable-dehyphenate

分 析 文 档 中 带 有 连 字 符 的 字 词 。 这 个 文 档 本 身 被 作 为 一 个 词 典 来 确 定 连 字 符 应 该 被 保 留 还 是 被 删 除 。

--disable-delete-blank-paragraphs

删 除 文 档 中 每 个 段 落 间 的 空 白 段 落 。

--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

包 含 查 找 替 换 正 则 表 达 式 的 文 件 路 径 。 该 文 件 必 须 包 含 正 则 表 达 式 交 替 行 后 面 跟 着 替 换 规 则 （ 它 可 以 是 一 个 空 行 ） 。 正 则 表 达 式 必 须 是 Python正 则 表 达 式 的 语 法 并 且 文 件 必 须 是 UTF-8编 码 。

--sr1-replace

sr1-search搜 索 到 的 内 容 的 替 换 文 本 。

--sr1-search

要 被 sr1-replace替 换 的 搜 索 规 则 （ 正 则 表 达 式 ） 。

--sr2-replace

sr2-search搜 索 到 的 内 容 的 替 换 文 本

--sr2-search

要 被 sr2-replace替 换 的 搜 索 规 则 （ 正 则 表 达 式 ） 。

--sr3-replace

sr3-search搜 索 到 的 内 容 的 替 换 文 本

--sr3-search

要 被 sr3-replace替 换 的 搜 索 规 则 （ 正 则 表 达 式 ） 。

结 构 检 测

设 置 自 动 检 测 文 档 结 构 。
--add-alt-text-to-img

When an <img> tag has no alt attribute, check the associated image file for metadata that specifies alternate text, and use it to fill in the alt attribute. The alt attribute improves accessibility by providing text descriptions for users who cannot see or fully interpret visual content.

--chapter

用 于 检 测 章 节 标 题 的 XPath表 达 式 。 默 认 情 况 下 ， 将 包 含 单 词 “chapter”、 “book”、 “section”、 “prolog”、 “epilogue”或 “part”的 <h1>或 <h2>标 签 以 及 任 何 具 有 class＝ “chapter”的 标 签 被 视 为 章 节 标 题 。 所 用 表 达 式 的 必 须 使 用 上 述 列 出 的 元 素 。 要 禁 用 章 节 检 测 ， 请 使 用 表 达 式 “/”。 有 关 使 用 此 功 能 的 更 多 帮 助 ， 请 参 阅 calibre用 户 手 册 中 的 XPath教 程 。

--chapter-mark

指 定 如 何 标 记 检 测 到 的 章 节 。 值 “pagebreak”将 在 章 节 之 前 插 入 分 页 符 。 值 “rule”将 在 章 节 前 插 入 一 个 空 行 。 值 “none”将 禁 用 章 节 标 记 ， 值 “both”将 同 时 插 入 分 页 符 和 一 个 空 行 来 标 记 章 节 。

--disable-remove-fake-margins

有 些 文 档 通 过 在 每 个 段 落 上 指 定 左 右 边 距 来 指 定 页 边 距 。 calibre 会 尝 试 检 测 并 删 除 这 些 页 边 距 。 有 时 候 calibre 会 错 误 的 删 除 不 应 该 删 除 的 页 边 距 ， 在 这 种 情 况 下 ， 你 可 以 禁 用 这 项 功 能 。

--insert-metadata

将 书 籍 元 数 据 添 加 到 书 籍 的 开 头 。 如 果 你 的 电 子 书 阅 读 设 备 不 支 持 直 接 显 示 和 搜 索 元 数 据 ， 该 功 能 可 能 有 所 帮 助 。

--page-breaks-before

XPath表 达 式 。 分 页 符 插 入 在 指 定 元 素 之 前 。 要 禁 用 ， 请 使 用 表 达 式 ： /

--prefer-metadata-cover

使 用 从 源 文 件 中 检 测 到 的 封 面 文 件 .

--remove-first-image

删 除 输 入 电 子 书 的 第 一 张 图 片 。 用 于 输 入 文 档 有 一 个 封 面 图 像 但 其 没 有 被 设 为 封 面 的 情 况 。 在 这 种 情 况 下 ， 如 果 你 在 calibre 设 置 了 封 面 ， 又 没 有 选 择 该 项 ， 输 出 文 件 将 最 终 有 两 个 封 面 图 片 。

--start-reading-at

用 于 检 测 文 档 阅 读 时 的 起 始 页 的 位 置 的 XPath 表 达 式 。 某 些 电 子 书 阅 读 器 (以 Kindle 为 代 表 )使 用 此 位 置 来 打 开 书 籍 。 请 参 阅 calibre 用 户 手 册 中 的 XPath 教 程 了 解 使 用 此 功 能 的 更 多 帮 助 。

目 录

设 置 自 动 生 成 目 录 。 默 认 情 况 下 若 源 文 件 有 目 录 ， 它 将 被 优 先 使 用 ， 而 不 是 自 动 创 建 。
--duplicate-links-in-toc

当 从 输 入 文 档 中 的 链 接 创 建 目 录 时 ， 允 许 创 建 重 复 项 。 即 允 许 目 录 中 出 现 名 称 相 同 的 项 ， 前 提 是 它 们 指 向 文 档 中 不 同 的 位 置 。

--level1-toc

XPath表 达 式 ， 指 定 应 添 加 到 一 级 目 录 中 的 所 有 标 签 。 如 果 设 置 了 此 项 ， 则 它 优 先 于 其 他 形 式 的 自 动 检 测 。 有 关 示 例 ， 请 参 阅 calibre用 户 手 册 中 的 XPath教 程 。

--level2-toc

XPath表 达 式 ， 指 定 应 添 加 到 二 级 目 录 中 的 所 有 标 签 。 每 项 都 添 加 到 前 一 级 目 录 项 下 。 有 关 示 例 ， 请 参 阅 calibre用 户 手 册 中 的 XPath教 程 。

--level3-toc

XPath表 达 式 ， 指 定 应 添 加 到 三 级 目 录 中 的 所 有 标 签 。 每 项 都 将 加 入 到 二 级 目 录 项 下 。 请 参 阅 calibre 用 户 手 册 中 XPath 教 程 的 例 子 。

--max-toc-links

目 录 中 的 链 接 的 数 量 的 上 限 。 设 置 为 0 表 示 禁 用 。 默 认 值 ： 50。 只 有 在 检 测 到 少 于 阈 值 数 量 的 章 节 时 ， 才 会 将 链 接 添 加 到 目 录

--no-chapters-in-toc

不 将 自 动 检 测 到 的 章 节 添 加 到 目 录 。

--toc-filter

从 目 录 中 删 除 标 题 与 指 定 正 则 表 达 式 匹 配 的 内 容 。 该 内 容 及 其 所 有 子 项 都 将 被 删 除

--toc-threshold

如 果 检 测 到 的 章 节 少 于 此 数 量 ， 则 将 链 接 也 添 加 到 目 录 中 。 默 认 值 : 6

--use-auto-toc

通 常 情 况 下 ， 优 先 使 用 源 文 件 中 已 有 的 目 录 。 打 开 本 选 项 来 强 制 使 用 自 动 生 成 的 目 录 。

元 数 据

设 定 输 出 的 元 数 据 选 项
--author-sort

用 来 进 行 按 作 者 排 序 的 关 键 字 符 串 。

--authors

设 置 作 者 。 多 个 作 者 之 间 请 使 用 & 符 号 分 隔 。

--book-producer

设 置 书 籍 制 作 人 。

--comments

设 置 电 子 书 描 述 。

--cover

设 置 封 面 为 指 定 文 件 或 URL

--isbn

设 置 书 籍 的 ISBN。

--language

设 置 书 籍 语 言 。

--pubdate

设 置 发 布 日 期 （ 假 定 在 本 地 时 区 ， 除 非 明 确 指 定 时 区 ）

--publisher

设 置 电 子 书 出 版 商 。

--rating

设 置 评 分 。 评 荐 值 为 1 到 5 之 间 的 数 字 。

--read-metadata-from-opf, --from-opf, -m

从 指 定 OPF 文 件 中 读 元 数 据 。 读 取 的 元 数 据 将 覆 盖 源 文 件 中 定 义 的 其 他 元 数 据 。

--series

设 置 书 籍 所 属 丛 书 。

--series-index

设 置 丛 书 中 的 书 籍 索 引 。

--tags

设 置 书 籍 的 标 签 。 多 个 标 签 之 间 请 用 逗 号 隔 开 。

--timestamp

设 置 书 籍 创 建 日 期 (已 不 再 使 用 )

--title

设 置 书 名 。

--title-sort

用 来 排 序 的 书 名 版 本 。

调 试

用 于 调 试 转 换 的 选 项
--debug-pipeline, -d

将 转 换 传 输 途 径 不 同 阶 段 的 输 出 保 存 到 指 定 文 件 夹 。 如 果 您 不 确 定 在 转 换 过 程 的 哪 个 阶 段 发 生 错 误 ， 这 很 有 用 。

--verbose, -v

详 细 程 度 。 指 定 多 次 来 提 高 详 细 程 度 ： 指 定 两 次 是 最 详 细 ， 一 次 是 中 等 ， 零 次 是 最 简 略 。

AUTHOR

Kovid Goyal

COPYRIGHT

Kovid Goyal