EBOOK-POLISH(1)

NAME
ebook-polish - ebook-polish

ebook-polish [选项] 输入文件 [输出文件]

Polishing books is all about putting the shine of perfection onto your carefully crafted e-books.

Polishing tries to minimize the changes to the internal code of your e-book. Unlike conversion, it does not flatten CSS, rename files, change font sizes, adjust margins, etc. Every action performs only the minimum set of changes needed for the desired effect.

You should use this tool as the last step in your e-book creation process.

Note that polishing only works on files in the AZW3 或 EPUB formats.

Whenever you pass arguments to ebook-polish that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"

[选项]

--compress-images, -i
    无损压缩书中的图片，减少文件大小而不影响图片质量。

--cover, -c
    Path to a cover image. Changes the cover specified in the e-book. If no cover is present, or the cover is not properly identified, inserts a new cover.

--embed-fonts, -e
    文档中尚未嵌入所有引用的字体。此操作将会扫描您电脑中的字体， 如果找到这些字体，将嵌入这些字体到文档中。 请确保您有足够的权限来使用内嵌字体的文档。

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

--jacket, -j
    Insert a "book jacket" page at the start of the book that contains all the book metadata such as title, tags, authors, series, comments, etc. Any previous book jacket will be replaced.

--opf, -o
    OPF文件路径。从OPF文件更新书中的元数据。

--remove-jacket
    移除先前插入的书籍封面页。

--remove-unused-css, -u
    从样式表和 <style> 标签中删除所有未使用的 CSS 规则。 有些用出版模板制作的书籍会有大量不匹配任何内容的附加 CSS 规则。 这些附加 CSS 规则会减慢阅读器的速度，因为它们必须先全部解析。

--smarten-punctuation, -p
    把纯文本中的破折号、省略号、引号、多个连字符转换为排版正确的等效形式。 注意，该算法可能有时会产生不正确的结果，特别是当缩写开头有单引号时。

--subset-fonts, -f
    嵌入子集字体意味着可以减少内嵌字体的体积大小，因为只 使用书籍中所需要调用的字符。这有助于大幅减少字体文件的大 小（通常能减少近一半的体积）。 举个例子，如果一本书为标题使用了特定的字体，子集字体 将只保留使用标题字符中使用的字体。或者是如果书籍内嵌了字 体的粗体和斜体，但是却很少使用粗体和斜体，那么粗体和斜体 可能会被精简为少量的字符，甚至是完全被移除。 子集字体唯一的缺点是，如果您想在以后为您的书籍添加更 多的内容，新的内容可能无法使用原有的子集字体。

--upgrade-book, -U
    Upgrade the internal structures of the book, if possible. For instance, upgrades EPUB 2 books to EPUB 3 books.

--verbose
    产生更详细的输出，有利于调试。

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

AUTHOR
Kovid Goyal

COPYRIGHT
Kovid Goyal