EBOOK-POLISH(1)

NAME
ebook-polish - ebook-polish

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

润色书籍就是在你精心制作的电子书的基础上精益求精。

润色将尝试尽量减少对你的电子书内部代码的调整。与转换不同，它不做展开CSS、重命名文件、更改字体大小、调整边距等操作。每个动作只做所需的最小的调整。

建议您将此项工具用作电子书制作流程的最后一步。

注意，润色仅适用于AZW3 或 EPUB 或 KEPUB格式的文件。

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

[选项]

--add-soft-hyphens, -H
    给书中的所有字词添加软连字符。这样，在不支持断字的电子阅读器中，当文本对齐时，可以更好地渲染呈现书籍。

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

--cover, -c
    图片封面路径。更改指定的电子书的封面。如果无封面，或者封面没有正确识别，插入一个新的封面。

--download-external-resources, -d
    下载指向URL而不是书中文件的外部资源，如图片、样式表等。 所有这些资源都将被下载并添加到书籍中，这样书籍就不再引用任何外部资源。

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

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

--jacket, -j
    在书的开头插入“书籍扉页”。该页包含书籍的所有元数据，如书名、标签、作者、丛书、简介等。任何原有的扉页都将被替换。

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

--remove-jacket
    删除先前插入的书籍扉页。

--remove-soft-hyphens
    从本书所有文字中删除软连字符。

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

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

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

--upgrade-book, -U
    如果可能, 升级本书的内部结构。 比如, 升级 EPUB 2 书籍到 EPUB 3 书籍。

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

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

Author
Kovid Goyal

Copyright
Kovid Goyal