.\" 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" "xaneiro 10, 2025" "7.24.0" "calibre"
.SH NAME
ebook-polish \- ebook-polish
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ebook\-polish [opcións] ficheiro_entrada [ficheiro_saída]
.EE
.UNINDENT
.UNINDENT
.sp
Pulir libros consiste en poñerlle o brillo da perfección
os teus libros electrónicos coidadosamente elaborados.
.sp
Pulido tenta minimizar os cambios no código interno do teu libro electrónico.
A diferenza da conversión, non aplana CSS, renomea ficheiros, cambia o tipo de letra
tamaños, axustar as marxes, etc. Cada acción realiza só o conxunto mínimo de
cambios necesarios para o efecto desexado.
.sp
Deberías usar esta ferramenta como último paso no proceso de creación do teu libro electrónico.
.sp
Teña en conta que o pulido só funciona nos ficheiros AZW3 ou EPUBdos formatos.
.sp
Sempre que lle pases argumentos a \fBebook\-polish\fP que teñan espazos neles, pon os argumentos entre comiñas. Por exemplo: \(dq/some path/with spaces\(dq
.SH [OPCIÓNS]
.INDENT 0.0
.TP
.B \-\-add\-soft\-hyphens, \-H
Engade guións suaves a todas as palabras do libro. Isto permite renderizar o libro mellor cando o texto está xustificado, en lectores que non admiten a guionización.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-compress\-images, \-i
Comprimir sen perdas as imaxes do libro para reducir o tamaño dos ficheiros afectando a calidade da imaxe.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cover, \-c
Camiño a unha imaxe de portada. Cambia a portada especificada no libro electrónico. Se non hai tapa ou a tapa non está correctamente identificada, insire unha nova tapa.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-download\-external\-resources, \-d
Descarga recursos externos como imaxes, follas de estilo, etc. que apunten a URL en lugar de ficheiros do libro. Todos estes recursos descargaranse e engadiranse ao libro para que o libro xa non faga referencia a ningún recurso externo.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-embed\-fonts, \-e
Incrustar todas as fontes ás que se fai referencia no documento e que aínda non estean incrustadas. Isto escaneará o teu ordenador para buscar os tipos de letra e, se se atopan, serán incrustado no documento. Asegúrese de ter a licenza adecuada para incorporar os tipos de letra utilizados neste documento.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help, \-h
mostrar esta mensaxe de axuda e saír
.UNINDENT
.INDENT 0.0
.TP
.B \-\-jacket, \-j
Insira unha páxina \fB\(dq\fPcamiseta do libro\fB\(dq\fP ao comezo do libro que contén todos os metadatos do libro, como título, etiquetas, autores, series, comentarios, etc. Substituirase calquera funda de libro anterior.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-opf, \-o
Ruta a un ficheiro OPF. Os metadatos do libro actualízanse a partir do ficheiro OPF.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remove\-jacket
Elimina unha páxina anterior de sobrecuberta de libro inserida.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remove\-soft\-hyphens
Elimina os guións suaves de todo o texto do libro.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remove\-unused\-css, \-u
Elimina todas as regras CSS non utilizadas das follas de estilo e do <style> etiquetas. Algúns libros creados a partir de modelos de produción poden ter un gran número de regras CSS adicionais que non coinciden con ningún contido real. Estas regras adicionais poden retardar os lectores que precisan analizalos todos.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-smarten\-punctuation, \-p
Converte guións de texto simple, puntos suspensivos, comiñas, guións múltiples, etc equivalentes tipograficamente correctos. Teña en conta que o algoritmo ás veces pode xerar resultados incorrectos, especialmente cando interveñen comiñas simples ao comezo das contraccións.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-subset\-fonts, \-f
Subconfigurar fontes significa reducir unha fonte incrustada para que contén só os caracteres usados ​​desa fonte no libro. Isto reduce moito o tamaño dos ficheiros de fonte (reducindo o tipo de letra á metade tamaños de ficheiros é común). Por exemplo, se o libro usa unha fonte específica para as cabeceiras, entón o subconxunto reducirá ese tipo de letra para conter só o personaxes presentes nas cabeceiras reais do libro. Ou se o book incorpora as versións en negra e cursiva dunha fonte, pero en negra e o texto en cursiva é relativamente raro, ou está completamente ausente, entón as fontes en negra e cursiva poden reducirse a só unhas poucas caracteres ou completamente eliminado. O único inconveniente de subconfigurar fontes é que se, máis tarde data na que decides engadir máis texto aos teus libros, o recén engadido É posible que o texto non estea cuberto pola fonte do subconxunto.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-upgrade\-book, \-U
Actualiza as estruturas internas do libro, se é posible. Por exemplo, actualiza os libros de EPUB 2 a EPUB 3.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose
Produce unha saída máis detallada, útil para a depuración.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version
mostrar o número de versión do programa e saír
.UNINDENT
.SH AUTHOR
Kovid Goyal
.SH COPYRIGHT
Kovid Goyal
.\" Generated by docutils manpage writer.
.