.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "EBOOK-POLISH" "1" "2月 14, 2025" "7.26.0" "calibre"
.SH NAME
ebook-polish \- ebook-polish
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ebook\-polish [選項] 輸入檔案 [輸出檔案]
.EE
.UNINDENT
.UNINDENT
.sp
打磨書籍就是在完善您精心製作的電子書的基礎上精益求精。
.sp
打磨將嘗試盡量減少對您的電子書內部代碼的變化。與轉換不同，它不執行壓縮CSS、重新命名檔案、變更字型大小、調整邊距等操作。每個動作只執行效果所需的最小變化集。
.sp
您應該在電子書創作過程中最後使用這個工具。
.sp
注意，打磨只對AZW3 或 EPUB格式的檔案起作用。
.sp
每当向具有它们自己空间的:command:
.nf
\(ga
.fi
ebook\-polish\(ga传递参数时，用引号括起这些参数。例如: \(dq/some path/with spaces\(dq
.SH [選項]
.INDENT 0.0
.TP
.B \-\-add\-soft\-hyphens, \-H
给书中的所有单词添加软连字符。这样，在不支持连字的电子阅读器中，当文本对齐时，可以更好地渲染呈现图书。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-compress\-images, \-i
无损压缩书中的图片，减少文件大小而不影响图片质量。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cover, \-c
图片封面路径。更改指定的ebook封面。如果提供封面，或者封面没有正确识别，插入一个新的封面。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-download\-external\-resources, \-d
Download external resources such as images, stylesheets, etc. that point to URLs instead of files in the book. All such resources will be downloaded and added to the book so that the book no longer references any external resources.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-embed\-fonts, \-e
文件中尚未嵌入所有引用的字體。此操作將會掃描您電腦中的字體， 如果找到這些字體，將嵌入這些字體到文件中。 請確保您有足夠的權限來使用內嵌字體的文件。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help, \-h
顯示說明訊息並退出
.UNINDENT
.INDENT 0.0
.TP
.B \-\-jacket, \-j
在书籍的开头插入一个“书籍护封”页，它包含所有的书籍元数据，如 书名、标签、作者、系列、评论等。任何以前的书籍护封都将被替换。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-opf, \-o
OPF 檔案路徑。書籍中的元數據是從 OPF 檔案更新。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remove\-jacket
移除先前插入的書本封面頁。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remove\-soft\-hyphens
从本书所有文字中删除软连字符。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remove\-unused\-css, \-u
Remove all unused CSS rules from stylesheets and <style> tags. Some books created from production templates can have a large number of extra CSS rules that don\fB\(aq\fPt match any actual content. These extra rules can slow down readers that need to parse them all.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-smarten\-punctuation, \-p
把纯文本中的破折号、省略号、引号、多个连字符转换为排版正确的等效形式。 注意，该算法可能有时会产生不正确的结果，特别是当缩写开头有单引号时。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-subset\-fonts, \-f
嵌入子集字體意味著可以減少內嵌字體的體積大小，因為只 使用書本中所需要調用的字元。這有助於大幅減少字體檔案的大 小（通常能減少近一半的體積）。 舉個例子，如果一本書為標題使用了特定的字體，子集字體 將只保留使用標題字元中使用的字體。或者是如果書本內嵌了字 體的粗體和斜體，但是卻很少使用粗體和斜體，那麼粗體和斜體 可能會被精簡為少量的字元，甚至是完全被移除。 子集字體唯一的缺點是，如果您想在以後為您的書本添加更 多的內容，新的內容可能無法使用原有的子集字體。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-upgrade\-book, \-U
如果可能, 升级本书的内部结构。 比如, 升级 EPUB 2 书籍到 EPUB 3 书籍。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose
產生更詳細的輸出，以利除錯。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version
顯示程式版本編號並退出
.UNINDENT
.SH AUTHOR
Kovid Goyal
.SH COPYRIGHT
Kovid Goyal
.\" Generated by docutils manpage writer.
.