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 [オ プ シ ョ ン ]

電 子 書 籍 を あ る 形 式 か ら 別 の 形 式 に 変 換 し ま す 。

input_file に は 入 力 フ ァ イ ル 、 output_file に は 出 力 フ ァ イ ル を 指 定 し ま す 。 コ マ ン ド の 最 初 の 2 つ の 引 数 と し て 両 方 と も 指 定 す る 必 要 が あ り ま す 。

出 力 す る 電 子 書 籍 の 形 式 は 、 output_file の フ ァ イ ル 拡 張 子 か ら 推 測 し ま す 。 output_fileは 特 別 な 形 式 EXT (EXT は 出 力 フ ァ イ ル 拡 張 子 ) に す る こ と も で き ま す 。 こ の 場 合 、 出 力 フ ァ イ ル の 名 前 は 入 力 フ ァ イ ル の 名 前 か ら 導 き 出 さ れ ま す 。 フ ァ イ ル 名 の 先 頭 の 文 字 に ハ イ フ ン は 使 用 で き ま せ ん 。 output_fileに 拡 張 子 が な い 場 合 に は フ ォ ル ダ と み な し 、 HTMLフ ァ イ ル に よ り 構 成 さ れ る 「 open e-book」 (OEB) が そ の フ ォ ル ダ に 書 き 込 ま れ ま す 。 こ れ ら の フ ァ イ ル は 通 常 、 出 力 プ ラ グ イ ン に 渡 さ れ る た め の も の で す 。

入 力 フ ァ イ ル と 出 力 フ ァ イ ル を 指 定 し た 後 に 、 さ ま ざ ま な オ プ シ ョ ン を 指 定 し て 変 換 を カ ス タ マ イ ズ す る こ と が 可 能 で す 。 ど の オ プ シ ョ ン を 使 用 で き る か は 、 入 力 フ ァ イ ル と 出 力 フ ァ イ ル の 種 類 に よ っ て 決 ま り ま す 。 使 用 可 能 な オ プ シ ョ ン の ヘ ル プ を 表 示 す る に は 、 入 力 フ ァ イ ル と 出 力 フ ァ イ ル を 指 定 し た 後 に -h オ プ シ ョ ン を 指 定 し て く だ さ い 。

変 換 シ ス テ ム の 詳 し い 説 明 は 次 を 参 照 し て く だ さ い 。 電 子 書 籍 変 換

ス ペ ー ス を 含 む 引 数 を 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

出 力 プ ロ フ ァ イ ル を 指 定 し ま す 。 出 力 プ ロ フ ァ イ ル は 変 換 シ ス テ ム に 、 指 定 し た デ バ イ ス 毎 の ド キ ュ メ ン ト の 最 適 化 を 指 定 し ま す 。 特 定 の デ バ イ ス 用 の 最 適 化 を 行 う こ と も 可 能 で す が 、 普 通 は そ こ ま で 必 要 に は な ら な い で し ょ う 。 選 択 肢 :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, generic_eink_hd, generic_eink_large

--version

プ ロ グ ラ ム の バ ー ジ ョ ン 番 号 を 表 示 し て 終 了

入 力 オ プ シ ョ ン

入 力 フ ァ イ ル mobi の 処 理 制 御 オ プ シ ョ ン
--input-encoding

入 力 さ れ た 文 書 の 文 字 エ ン コ ー デ ィ ン グ を 指 定 し ま す 。 こ の オ プ シ ョ ン を 設 定 し た 場 合 、 文 書 内 で 宣 言 さ れ る エ ン コ ー デ ィ ン グ は 無 視 さ れ ま す 。 特 に 、 文 書 が エ ン コ ー デ ィ ン グ 宣 言 を 行 っ て い な い 場 合 や 、 エ ン コ ー デ ィ ン グ 宣 言 に 問 題 が あ る 場 合 に 有 効 で す 。

出 力 オ プ シ ョ ン

epub出 力 処 理 を コ ン ト ロ ー ル す る た め の オ プ シ ョ ン
--dont-split-on-page-breaks

改 ペ ー ジ で の フ ァ イ ル 分 割 を し ま せ ん 。 通 常 、 入 力 フ ァ イ ル は 自 動 的 に 改 ペ ー ジ の 部 分 で 2つ の フ ァ イ ル に 分 割 さ れ ま す 。 こ れ に よ り パ ー ス が 速 く 、 使 用 リ ソ ー ス の 少 な い 電 子 書 籍 が 出 力 さ れ ま す 。 し か し な が ら 分 割 作 業 は 遅 い の で 、 フ ァ イ ル に 大 量 の 改 ペ ー ジ が あ る 場 合 は 改 ペ ー ジ で の 分 割 を し な い で く だ さ い 。

--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フ ァ イ ル の バ ー ジ ョ ン で す 。 互 換 性 が 最 も 高 い の は EPUB2で す 。 EPUB3は 、 ど う し て も そ れ が 必 要 と わ か っ て い る と き に 限 り 指 定 し て く だ さ い 。

--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を 本 の 表 紙 に 使 用 し な い 。 こ の オ プ シ ョ ン は iPhoneや JetBook Liteの よ う な SVGを サ ポ ー ト し な い デ バ イ ス で 使 用 す る 場 合 に 使 っ て く だ さ い 。 指 定 し な い と 、 そ れ ら の デ バ イ ス で は 表 紙 が 白 紙 に な っ て し ま い ま す 。

--preserve-cover-aspect-ratio

SVGの 表 紙 を 使 う 場 合 、 こ の オ プ シ ョ ン は 縦 横 比 を 保 っ た ま ま 、 表 紙 を 画 面 の サ イ ズ に 広 げ ま す 。 こ れ に よ り 表 紙 の 両 端 や 上 下 に 白 い 部 分 が で き る 事 が あ り ま す が 、 表 紙 は 歪 み ま せ ん 。 こ の オ プ シ ョ ン を 使 わ な い と 表 紙 が い く ら か 歪 み ま す が 白 い 部 分 は で き ま せ ん 。

--pretty-print

指 定 し た 場 合 は 、 出 力 プ ラ グ イ ン は で き る 限 り 人 が 読 め る よ う な 出 力 を 生 成 し よ う と し ま す 。 一 部 の 出 力 プ ラ グ イ ン に は 、 な に も 効 果 が な い 可 能 性 が あ り ま す 。

--toc-title

Title for any generated inline table of contents.

外 観

出 力 の 外 観 を 調 整 す る た め の オ プ シ ョ ン
--asciiize

Unicode文 字 を ASCII表 記 に 翻 訳 し ま す 。 Unicode文 字 が ASCIIで 置 き 換 わ る こ と に な る た め 注 意 し て 使 っ て く だ さ い 。 例 え ば " Pelé " " Pele " に 置 換 さ れ ま す 。 ま た 文 字 に 複 数 の 表 記 が あ る 場 合 ( 例 え ば 中 国 語 と 日 本 語 で 共 有 さ れ て い る 文 字 ) 、 表 記 は 現 在 の calibreの イ ン タ フ ェ ー ス 言 語 が 使 わ れ ま す 。

--base-font-size

フ ォ ン ト サ イ ズ の 単 位 は ptで す 。 作 成 さ れ た 本 の 中 の す べ て の フ ォ ン ト サ イ ズ は 、 こ こ で 指 定 し た フ ォ ン ト サ イ ズ に 従 っ て 再 指 定 さ れ ま す 。 大 き い サ イ ズ を 指 定 す れ ば 出 力 さ れ た フ ァ イ ル 中 の フ ォ ン ト が 大 き く な り 、 逆 に 小 さ い サ イ ズ を 指 定 す れ ば 小 さ く な り ま す 。 デ フ ォ ル ト の 値 で あ る 0を 指 定 し た 場 合 に は 、 ベ ー ス と す る フ ォ ン ト サ イ ズ は 指 定 し た 出 力 プ ロ フ ァ イ ル に 従 っ て 自 動 的 に 選 択 さ れ ま す 。

--change-justification

テ キ ス ト 揃 え を 変 更 し ま す 。 「 左 」 に 設 定 す る と 揃 え る べ き す べ て の テ キ ス ト を 左 寄 せ に し ま す 。 「 揃 え る 」 に す る と 揃 っ て い な い す べ て の テ キ ス ト を 揃 え ま す 。 「 オ リ ジ ナ ル 」 ( デ フ ォ ル ト ) に す る と 元 フ ァ イ ル の 揃 え を 変 え ま せ ん 。 注 : 一 部 の 形 式 の み で 揃 え が サ ポ ー ト さ れ て い る 事 に 注 意 し て く だ さ い 。

--disable-font-rescaling

す べ て の フ ォ ン ト サ イ ズ の 拡 大 縮 小 を 止 め る

--embed-all-fonts

入 力 ド キ ュ メ ン ト か ら 参 照 さ れ て い る フ ォ ン ト で 、 ま だ 埋 め 込 ま れ て い な い フ ォ ン ト を す べ て 埋 め 込 み ま す 。 こ の 機 能 は 、 シ ス テ ム 上 の フ ォ ン ト を 検 索 し 、 見 つ か れ ば そ れ を 埋 め 込 み ま す 。 フ ォ ン ト の 埋 め 込 み は 、 変 換 先 の 形 式 が 埋 め 込 み を サ ポ ー ト し て い る 場 合 、 例 え ば EPUB, AZW3, DOCX, PDF の 場 合 に し か 機 能 し ま せ ん 。 ド キ ュ メ ン ト に フ ォ ン ト を 埋 め 込 む た め の 、 適 切 な ラ イ セ ン ス を 所 有 し て い る こ と を 確 認 し て く だ さ い 。

--embed-font-family

書 籍 に 指 定 し た フ ォ ン ト を 埋 め 込 み ま す 。 こ れ は 書 籍 に 使 わ れ る 「 ベ ー ス 」 フ ォ ン ト を 指 定 し ま す 。 も し 入 力 ド キ ュ メ ン ト が フ ォ ン ト を 指 定 し て い た 場 合 に は 、 そ れ が ベ ー ス フ ォ ン ト よ り 優 先 さ れ ま す 。 ( そ う し た く な い 場 合 に は 、 ス タ イ ル 情 報 絞 り 込 み を 使 っ て 、 入 力 ド キ ュ メ ン ト か ら フ ォ ン ト を 取 り 除 い て く だ さ い ) 。 注 意 : フ ォ ン ト 埋 め 込 み は EPUB, AZW3, DOCX の よ う な い く つ か の 形 式 で し か 機 能 し ま せ ん 。

--expand-css

デ フ ォ ル ト で calibre は 、 CSSの margin, padding, border, 等 を 指 定 す る 際 に 、 短 縮 形 式 を 使 用 し ま す 。 こ の オ プ シ ョ ン を 有 効 に す る と 、 短 縮 形 式 の 代 わ り に す べ て 展 開 さ れ た 形 式 を 使 用 し ま す 。 Nookプ ロ フ ァ イ ル は Nookが 短 縮 形 式 を 取 り 扱 え な い た め 、 こ の 設 定 に か か わ ら ず 常 に 展 開 さ れ た 形 式 を 使 用 す る 設 定 に な っ て い る こ と に 留 意 く だ さ い 。

--extra-css

CSSス タ イ ル シ ー ト へ の パ ス か CSS自 身 を 指 定 し ま す 。 こ の CSSは 入 力 フ ァ イ ル の ス タ イ ル ・ル ー ル に 追 加 さ れ る の で 、 既 存 の ル ー ル を オ ー バ ー ラ イ ド す る こ と も で き ま す 。

--filter-css

CSSス タ イ ル ル ー ル か ら 削 除 す る 、 す べ て の CSSプ ロ パ テ ィ の カ ン マ 区 切 り の リ ス ト 。 一 部 の ス タ イ ル 情 報 が あ る と デ バ イ ス が 受 け 付 け な い 場 合 に 便 利 で す 。 例 : font-family,color,margin-left,margin-right

--font-size-mapping

CSSフ ォ ン ト 名 か ら ポ イ ン ト で の フ ォ ン ト サ イ ズ へ の マ ッ ピ ン グ 。 ( 例 : 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

ポ イ ン ト で の 行 の 高 さ 。 連 続 す る テ キ ス ト の 行 と 行 の 間 の ス ペ ー ス を 調 整 し ま す 。 行 の 高 さ 情 報 の な い エ レ メ ン ト に の み 適 用 さ れ ま す 。 た い て い の 場 合 に は 最 低 の 行 の 高 さ の 設 定 の ほ う が 便 利 で し ょ う 。 デ フ ォ ル ト で は こ の 行 の 高 さ の 設 定 は あ り ま せ ん 。

--linearize-tables

一 部 の デ ザ イ ン の 良 く な い 文 書 で は 、 ペ ー ジ の テ キ ス ト レ イ ア ウ ト に テ ー ブ ル を 使 用 し て い る も の が あ り ま す 。 こ う い っ た 文 書 を 変 換 す る と 、 ペ ー ジ が は み 出 し た り 乱 れ る こ と が よ く あ り ま す 。 こ の オ プ シ ョ ン を 使 う と 、 テ ー ブ ル か ら 内 容 を 抜 き 出 し て 直 線 的 な 配 置 に 置 き 換 え ま す 。

--margin-bottom

下 の 余 白 を pt単 位 で 指 定 。 デ フ ォ ル ト は 5.0。 こ の 値 に 0以 下 の 数 値 を 指 定 す る と 余 白 を 設 定 し ま せ ん (オ リ ジ ナ ル の ド キ ュ メ ン ト 内 に 設 定 さ れ た 余 白 を 使 用 し ま す )。 注 : PDFや DOCXな ど 固 定 ペ ー ジ 形 式 で は 、 そ の 形 式 で の 指 定 が 優 先 し ま す 。

--margin-left

左 の 余 白 を pt単 位 で 指 定 。 デ フ ォ ル ト は 5.0。 こ の 値 に 0以 下 の 数 値 を 指 定 す る と 余 白 を 設 定 し ま せ ん (オ リ ジ ナ ル の ド キ ュ メ ン ト 内 に 設 定 さ れ た 余 白 を 使 用 し ま す )。 注 : PDFや DOCXな ど 固 定 ペ ー ジ 形 式 で は 、 そ の 形 式 で の 指 定 が 優 先 し ま す 。

--margin-right

右 の 余 白 を pt単 位 で 指 定 。 デ フ ォ ル ト は 5.0。 こ の 値 に 0以 下 の 数 値 を 指 定 す る と 余 白 を 設 定 し ま せ ん (オ リ ジ ナ ル の ド キ ュ メ ン ト 内 に 設 定 さ れ た 余 白 を 使 用 し ま す )。 注 : PDFや DOCXな ど 固 定 ペ ー ジ 形 式 で は 、 そ の 形 式 で の 指 定 が 優 先 し ま す 。

--margin-top

上 の 余 白 を pt単 位 で 指 定 。 デ フ ォ ル ト は 5.0。 こ の 値 に 0以 下 の 数 値 を 指 定 す る と 余 白 を 設 定 し ま せ ん (オ リ ジ ナ ル の ド キ ュ メ ン ト 内 に 設 定 さ れ た 余 白 を 使 用 し ま す )。 注 : PDFや DOCXな ど 固 定 ペ ー ジ 形 式 で は 、 そ の 形 式 で の 指 定 が 優 先 し ま す 。

--minimum-line-height

計 算 さ れ た フ ォ ン ト サ イ ズ の パ ー セ ン ト に 基 づ く 、 最 小 の 行 の 高 さ で す 。 入 力 文 章 の 指 定 に か か わ ら ず 、 calibreは す べ て の エ レ メ ン ト で 最 低 限 こ の 行 の 高 さ に な る こ と を 保 障 し ま す 。 ゼ ロ に す る と 無 効 に な り ま す 。 デ フ ォ ル ト は 120% で す 。 こ の 意 味 が よ く わ か っ て い る 場 合 に の み 、 設 定 か ら こ の 行 の 高 さ の 設 定 を 直 接 指 定 し て く だ さ い 。 例 え ば 、 「 2倍 の 高 さ 」 を 指 定 す る 場 合 に は 設 定 を 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 GUI 上 で ウ ィ ザ ー ド を 使 用 し て ル ー ル を 作 成 す る こ と で す 。 外 観 -> HTML 変 換 セ ク シ ョ ン で 変 換 ダ イ ア ロ グ を 開 い て く だ さ い 。 ル ー ル を 作 成 し た 後 は 「 エ ク ス ポ ー ト 」 ボ タ ン を 使 っ て フ ァ イ ル に 保 存 で き ま す 。

--unsmarten-punctuation

フ ァ ン シ ー ク オ ー ト 、 ダ ッ シ ュ 、 省 略 記 号 を そ れ ぞ れ の 標 準 的 に 対 応 す る 物 に 変 換 す る 。

ヒ ュ ー リ ス テ ィ ッ ク 処 理

共 通 の パ タ ー ン を 使 っ て ド キ ュ メ ン ト の テ キ ス ト と 構 造 を 変 更 し ま す 。 デ フ ォ ル ト で は 無 効 に な っ て い ま す 。 --enable-heuristicsを 使 っ て 有 効 に し ま す 。 個 々 の ア ク シ ョ ン は 、 --disable-* オ プ シ ョ ン で 無 効 に す る こ と が で き ま す 。
--disable-dehyphenate

ド キ ュ メ ン ト 中 の ハ イ フ ネ ー シ ョ ン さ れ た 単 語 を 分 析 し ま す 。 ド キ ュ メ ン ト 自 身 を 辞 書 と し て 使 い 、 ハ イ フ ン を そ の ま ま に す る か 取 り 除 く か を 決 定 し ま す 。

--disable-delete-blank-paragraphs

2つ の 段 落 に 挟 ま れ た 、 空 白 の 段 落 を 取 り 除 き ま す 。

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

検 索 1-検 索 パ タ ー ン か ら 置 き 換 わ る 、 置 換 文 字 列

--sr1-search

検 索 1-置 換 文 字 列 と 置 き 換 え ら れ る 、 検 索 パ タ ー ン ( 正 規 表 現 )

--sr2-replace

検 索 2-検 索 パ タ ー ン か ら 置 き 換 わ る 、 置 換 文 字 列

--sr2-search

検 索 2-置 換 文 字 列 と 置 き 換 え ら れ る 、 検 索 パ タ ー ン ( 正 規 表 現 )

--sr3-replace

検 索 3-検 索 パ タ ー ン か ら 置 き 換 わ る 、 置 換 文 字 列

--sr3-search

検 索 3-置 換 文 字 列 と 置 き 換 え ら れ る 、 検 索 パ タ ー ン ( 正 規 表 現 )

構 造 の 検 出

ド キ ュ メ ン ト 構 造 の 自 動 判 別 を 制 御
--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> タ グ の う ち " chapter " , " book " , " section " , " prologue " , " epilogue " , " part " を 含 む も の 、 お よ び class= " chapter " の も の を 章 タ イ ト ル と し ま す 。 使 用 す る 式 は 、 エ レ メ ン ト の リ ス ト を 評 価 す る も の で な く て は な り ま せ ん 。 章 の 検 出 を 無 効 に す る に は 、 " / " 式 を 使 用 し ま す 。 XPathの チ ュ ー ト リ ア ル は 、 calibreの ユ ー ザ マ ニ ュ ア ル を 参 照 し て く だ さ い 。

--chapter-mark

見 つ か っ た 章 を ど の よ う に マ ー キ ン グ す る か 指 定 し ま す 。 「 改 ペ ー ジ 」 を 選 ぶ と 章 の 前 に 改 ペ ー ジ を 挿 入 し ま す 。 「 ル ー ル 」 を 選 ぶ と 章 の 前 に 行 を 挿 入 し ま す 。 「 な し 」 を 選 ぶ と マ ー キ ン グ を 行 い ま せ ん 。 「 両 方 」 を 選 ぶ と 改 ペ ー ジ と 行 の 両 方 を 挿 入 し ま す 。

--disable-remove-fake-margins

い く つ か の 文 章 は 、 各 段 落 に 左 右 の マ ー ジ ン を 指 定 す る こ と で 、 ペ ー ジ の マ ー ジ ン を 指 定 し て い ま す 。 calibreは そ れ ら の マ ー ジ ン を 見 つ け て 削 除 し よ う と し ま す が 、 た ま に 、 こ れ が 原 因 で マ ー ジ ン 全 体 が な く な っ て し ま う こ と が あ り ま す 。 そ の よ う な 場 合 、 削 除 を 無 効 に す る こ と が で き ま す 。

--insert-metadata

本 の 書 誌 を 本 の 最 初 に 奥 付 と し て 挿 入 す る 。 こ れ は 電 子 書 籍 リ ー ダ が 、 書 誌 を 直 接 表 示 し た り 検 索 し た り と い っ た 機 能 を 持 た な い 場 合 に 有 効 で す 。

--page-breaks-before

XPath式 を 指 定 し ま す 。 XPathで 指 定 さ れ た 要 素 の 直 前 に ペ ー ジ ブ レ ー ク が 挿 入 さ れ ま す 。 無 効 に す る に は 、 式 : / を 使 用 し て く だ さ い 。

--prefer-metadata-cover

指 定 し た 表 紙 よ り も ソ ー ス フ ァ イ ル か ら 検 知 し た 表 紙 を 優 先 し て 使 い ま す 。

--remove-first-image

入 力 電 子 書 籍 か ら 最 初 の 画 像 を 取 り 除 き ま す 。 入 力 ド キ ュ メ ン ト に 表 紙 と し て 認 識 さ れ な い 表 紙 が あ る 場 合 に 有 用 で す 。 そ の 際 、 calibreで 表 紙 を 指 定 す る と 表 紙 が 2つ に な っ て し ま う の を 、 こ の オ プ シ ョ ン を 指 定 す る こ と で 避 け る こ と が で き ま す 。

--start-reading-at

読 書 を 開 始 す る 場 所 を 指 定 す る XPath式 で す 。 い く つ か の 電 子 書 籍 リ ー ダ (最 も 典 型 的 な に は Kindle)は 、 本 を 開 い た と き に 、 こ こ で 指 定 し た 場 所 か ら 開 き ま す 。 こ の 機 能 を 使 用 す る よ り 詳 し い 情 報 は 、 calibreの ユ ー ザ マ ニ ュ ア ル の XPathチ ュ ー ト リ ア ル を 参 照 し て く だ さ い 。

目 次

目 次 の 自 動 生 成 を コ ン ト ロ ー ル し ま す 。 デ フ ォ ル ト で は 、 入 力 フ ァ イ ル に 目 次 が あ っ た 場 合 に 優 先 的 に 自 動 生 成 さ れ ま す 。
--duplicate-links-in-toc

も し 目 次 を 入 力 ド キ ュ メ ン ト の リ ン ク か ら 作 成 す る 場 合 、 重 複 す る エ ン ト リ ー を 許 す 。 例 え ば 、 1つ 以 上 の リ ン ク が 同 じ テ キ ス ト で 、 違 う 場 所 を 指 し て い る 場 合 な ど 。

--level1-toc

目 次 の レ ベ ル 1 に 追 加 す る タ グ を す べ て 指 定 す る XPath式 で す 。 こ れ が 指 定 さ れ た 場 合 、 他 の 目 次 の 自 動 検 出 に よ り 優 先 さ れ ま す 。 XPathの チ ュ ー ト リ ア ル は 、 calibreの ユ ー ザ マ ニ ュ ア ル 等 を 参 照 し て く だ さ い 。

--level2-toc

目 次 の レ ベ ル 2 に 追 加 す る タ グ を す べ て 指 定 す る XPath式 で す 。 指 定 さ れ た 項 目 は 、 直 前 の レ ベ ル 1 の 項 目 の 下 に 追 加 さ れ ま す 。 XPathの チ ュ ー ト リ ア ル は 、 calibreの ユ ー ザ マ ニ ュ ア ル 等 を 参 照 し て く だ さ い 。

--level3-toc

目 次 の レ ベ ル 3 に 追 加 す る タ グ を す べ て 指 定 す る XPath式 で す 。 指 定 さ れ た 項 目 は 、 直 前 の レ ベ ル 2 の 項 目 の 下 に 追 加 さ れ ま す 。 XPathの チ ュ ー ト リ ア ル は 、 calibreの ユ ー ザ マ ニ ュ ア ル 等 を 参 照 し て く だ さ い 。

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

デ バ ッ グ 出 力 の 量 の レ ベ ル 指 定 し ま す 。 複 数 回 指 定 す る と 、 出 力 量 が 増 え ま す 。 2回 指 定 す る と 出 力 量 が 最 大 に な り ま す 。 1回 が 中 程 度 の 出 力 量 で 、 指 定 し な け れ ば 一 番 少 な い 出 力 量 に な り ま す 。

AUTHOR

Kovid Goyal

COPYRIGHT

Kovid Goyal