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 为 扩 展 名 的 特 殊 格 式 。 在 这 种 情 况 下 ， 输 出 文 件 的 名 称 则 使 用 输 入 文 件 的 名 称 。 注 意 ： 文 件 名 不 能 以 连 字 号 作 为 开 头 。 如 果 output_file 不 含 扩 展 名 ， 那 么 它 将 被 视 为 一 个 目 录 并 将 会 在 该 目 录 下 生 成 HTML 格 式 的 “开 放 式 电 子 书 (OEB)”。 这 些 文 件 会 被 视 为 正 常 文 件 而 被 输 出 插 件 所 识 别 。

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

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

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

選 項 以 及 選 項 的 預 設 值 都 取 決 於 輸 入 和 輸 出 格 式 ， 所 以 您 應 該 經 常 檢 查

ebook-convert myfile.input_format myfile.output_format -h

以 下 是 一 些 常 見 轉 化 的 選 項 ， 接 著 是 特 定 輸 入 輸 出 的 選 項

•

輸 入 選 項

•

輸 出 選 項

•

介 面 外 觀

•

探 索 式 處 理

•

搜 尋 與 取 代

•

結 構 偵 測

•

目 錄

•

元 数 据

•

除 錯

--help, -h

顯 示 說 明 訊 息 並 退 出

--input-profile

指 定 輸 入 設 定 檔 。 輸 入 設 定 檔 會 提 供 轉 換 系 統 關 於 如 何 轉 譯 輸 入 檔 案 中 各 類 資 訊 的 方 式 。 例 如 關 係 解 析 度 的 長 度 （ 以 像 素 計 的 長 度 ） 。 選 擇 有 ： 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

Specify the output profile. The output profile tells the conversion system how to optimize the created document for the specified device. In some cases, an output profile can be used to optimize the output for a particular device, but this is rarely necessary. Choices are: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_hd, generic_eink_large, generic_eink

--version

顯 示 程 式 版 本 編 號 並 退 出

輸 入 選 項

用 來 控 制 匯 入 mobi 的 檔 案 處 理 選 項
--input-encoding

指 定 輸 入 文 件 的 字 元 編 碼 。 如 果 設 定 這 個 選 項 就 會 覆 蓋 任 何 由 文 件 本 身 宣 告 的 編 碼 。 尤 其 當 文 件 沒 有 宣 告 任 何 編 碼 或 文 件 所 宣 告 的 編 碼 有 誤 時 會 很 有 幫 助 。

輸 出 選 項

用 來 控 制 輸 出 epub 處 理 的 選 項
--dont-split-on-page-breaks

關 閉 按 分 頁 符 切 割 。 預 設 情 況 下 ， 程 式 會 按 分 頁 符 將 輸 入 檔 案 切 分 割 為 多 個 檔 案 。 由 此 程 式 可 以 使 用 較 少 的 電 腦 資 源 來 解 析 和 輸 出 結 果 。 當 然 分 割 操 作 會 增 加 處 理 時 間 ， 如 果 輸 入 檔 案 含 有 較 多 的 分 頁 符 ， 請 關 閉 此 功 能 。

--epub-flatten

仅 在 你 需 要 使 用 FBReaderJ 阅 读 EPUB 文 件 时 使 用 本 选 项 。 启 用 本 选 项 会 消 除 EPUB 文 件 中 的 目 录 结 构 ， 把 所 有 文 件 放 到 同 一 层 目 录 中 。

--epub-inline-toc

插 入 行 內 目 錄 ， 會 成 為 主 要 書 本 內 容 的 一 部 分 。

--epub-max-image-size

The maximum image size (width x height). A value of none means use the screen size from the output profile. A value of profile means no maximum size is specified. For example, a value of 100x200 will cause all images to be resized so that their width is no more than 100 pixels and their height is no more than 200 pixels. Note that this only affects the size of the actual image files themselves. Any given image may be rendered at a different size depending on the styling applied to it in the document.

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

Title for any generated inline table of contents.

介 面 外 觀

用 來 控 制 介 面 外 觀 輸 出 之 選 項
--asciiize

Transliterate Unicode characters to an ASCII representation. Use with care because this will replace Unicode characters with ASCII. For instance it will replace " Pelé " with " Pele " . Also, note that in cases where there are multiple representations of a character (characters shared by Chinese and Japanese for instance) the representation based on the current calibre interface language will be used.

--base-font-size

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

--change-justification

更 改 文 本 對 齊 方 式 。 使 用 值 " left " 將 轉 換 資 源 中 所 有 的 文 本 為 左 對 齊 。 (如 ： 未 對 齊 ) 使 用 值 " justify " 將 轉 換 資 源 中 所 有 的 未 對 齊 的 文 本 為 對 齊 。 使 用 值 " original " (預 設 )則 不 更 改 源 檔 案 的 對 齊 方 式 。 請 注 意 ， 僅 部 分 輸 出 格 式 支 持 對 齊 方 式 。

--disable-font-rescaling

關 閉 字 體 縮 放 功 能 。

--embed-all-fonts

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

--embed-font-family

在 書 中 嵌 入 指 定 字 型 。 這 指 定 了 書 中 使 用 的 「 基 礎 」 字 型 。 如 果 輸 入 檔 案 自 己 指 定 了 字 型 ， 就 有 可 能 覆 蓋 這 個 基 礎 字 型 。 您 可 以 使 用 過 濾 樣 式 資 訊 的 選 項 來 去 除 輸 入 檔 案 的 字 型 。 注 意 ， 字 型 嵌 入 只 在 一 些 輸 出 格 式 中 有 用 ， 主 要 是 EPUB、 AZW3 和 DOCX。

--expand-css

預 設 情 況 下 ， calibre 將 使 用 各 種 CSS屬 性 的 簡 寫 形 式 ， 如 邊 距 、 填 充 、 邊 框 等 。 此 選 項 將 使 用 完 整 的 展 開 形 式 。 注 意 ， 在 產 生 EPUB檔 案 時 ， 由 於 Nook不 能 處 理 速 記 CSS， 所 以 將 輸 出 設 定 檔 案 設 定 為 Nook設 定 檔 案 中 的 一 個 ， CSS總 是 被 展 開 的 。

--extra-css

CSS 樣 式 表 或 原 生 CSS 的 路 徑 。 這 個 CSS 會 添 加 到 來 源 檔 案 的 樣 式 規 則 中 ， 因 此 可 以 用 來 覆 蓋 那 些 規 則 。

--filter-css

以 逗 号 分 隔 的 CSS 属 性 列 表 ， 将 移 除 所 有 CSS 样 式 规 则 。 这 是 非 常 有 用 的 ， 如 果 存 在 的 一 些 样 式 信 息 ， 防 止 覆 盖 你 的 的 设 备 上 的 样 式 信 息 。 例 如 ： 字 体 系 列 ， 颜 色 ， 左 边 距 ， 右 边 距

--font-size-mapping

將 CSS 字 型 名 稱 映 射 到 字 型 大 小 （ 以 pts 計 ） 。 舉 例 來 說 您 可 以 設 為 12,12,14,16,18,20,22,24。 這 些 設 定 值 的 對 應 會 從 xx-small 到 xx-large， 最 後 一 個 大 小 就 會 是 最 大 的 字 型 。 字 型 縮 放 演 算 法 會 使 用 這 些 大 小 來 適 當 的 縮 放 字 型 。 預 設 使 用 的 映 射 方 式 是 以 您 所 選 擇 的 輸 出 設 定 檔 為 準 。

--insert-blank-line

在 章 節 之 間 插 入 空 行 . 如 果 來 源 檔 案 不 使 用 章 節 標 記 (<p> 或 <div> 標 記 ) 本 選 項 將 不 起 作 用 。

--insert-blank-line-size

設 定 插 入 的 空 白 列 高 度 (以 em 計 )。 在 段 落 之 間 的 高 度 會 是 這 裡 設 定 的 兩 倍 。

--keep-ligatures

Preserve ligatures present in the input document. A ligature is a combined character of a pair of characters like ff, fi, fl et cetera. Most readers do not have support for ligatures in their default fonts, so they are unlikely to render correctly. By default, calibre will turn a ligature into the corresponding pair of normal characters. Note that ligatures here mean only unicode ligatures not ligatures created via CSS or font styles. This option will preserve them instead.

--line-height

pt 行 高 。 控 制 兩 行 高 度 距 離 。 僅 僅 適 用 於 未 定 義 行 高 的 元 素 。 大 多 數 情 況 下 ， 最 小 行 高 值 更 加 有 用 。 預 設 不 進 行 行 高 操 控 。

--linearize-tables

有 些 設 計 不 良 的 檔 案 會 使 用 表 格 來 控 制 頁 面 文 字 的 排 版 。 在 轉 換 這 些 檔 案 時 常 會 發 生 文 字 超 出 頁 面 的 問 題 。 這 個 選 項 會 將 表 格 的 內 容 讀 取 出 來 ， 並 重 新 以 直 線 的 方 式 呈 現 它 。

--margin-bottom

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

--margin-left

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

--margin-right

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

--margin-top

设 定 上 边 距 ， 单 位 pts。 默 认 为 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 表 达 式 用 于 检 测 章 节 标 题 。 默 认 考 虑 使 用 <h1> 或 <h2> 标 签 来 涵 括 “章 节 ”， “书 籍 ”， “节 选 ”， “前 言 ”， “结 束 语 ”， 或 者 使 用 任 何 标 签 包 含 级 别 =“章 节 ”的 “部 分 ”做 为 章 节 标 题 。 使 用 的 表 达 式 必 须 评 估 元 素 列 表 。 要 禁 用 检 测 章 节 ， 请 使 用 表 达 式 “/”。 请 参 阅 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

指 定 應 添 加 到 目 錄 級 別 1的 所 有 標 籤 的 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