ebook-polish - ebook-polish
ebook-polish [options] input_file [output_file]
Refinar livros serve para colocar um pouco mais de
perfeição nos seus preciosos livros digitais. O refinamento
tenta minimizar as alterações no código interno do seu
livro digital. Ao contrario da conversão, não faz grandes
alterações tais como achatar CSS, renomear ficheiros, alterar
o tamanho da letra, ajustar as margens, etc. Cada ação
realizada faz apenas o conjunto mínimo das alterações
necessárias para o efeito desejado. Deve usar esta ferramenta como o
passo final no processo de criação de livros digitais.
Note que o refinamento só funciona em livros nos formatos
AZW3 ou EPUB.
Sempre que passar argumentos para o ebook-polish que
contenham espaços ponha-os entre aspas. Por exemplo: "/some
path/with spaces"
- --add-soft-hyphens,
-H
- Adiciona hífenes discricionários a todas as palavras no
livro. Tal permite que o livro seja melhor renderizado quando o texto for
justificado em leitores que não suportam
hifenização.
- --compress-images,
-i
- Comprimir sem perdas as imagens no livro para reduzir o tamanho do
ficheiro e sem afetar a qualidade percetível das imagens.
- --cover,
-c
- Caminho para a imagem de capa. Altera a capa especificada no livro
digital. Se a capa não estiver presente ou não estiver
identificada corretamente, será inserida uma nova capa.
- --embed-fonts,
-e
- Incorporar todas os tipos de letra que sejam referenciados no documento e
ainda não estejam incorporados. Isto irá procurar no seu
computador pelos tipos de letra e, desde que sejam encontrados, vão
ser incorporados no documento. Por favor, certifique-se que possui uma
licença adequada para incorporar os tipos de letra utilizados neste
documento.
- --jacket,
-j
- Insere uma página de "sobrecapa" no inicio
do livro, mas após a capa, para apresentar todos os metadados
padrão tal como o título, etiquetas, autor, séries,
comentários, etc. Qualquer sobrecapa anterior será
substituída.
- --opf, -o
- Localização do ficheiro OPF. Os metadados do livro
são atualizados a partir do ficheiro OPF.
- --remove-unused-css,
-u
- Remover todas as regras CSS de folhas de estilo e etiquetas de
<estilo> não utilizadas. Alguns livros, criados a partir de
modelos de produção, podem ter um grande número de
regras CSS extra que não correspondem a qualquer conteúdo
atual. Estas regras extra podem tornar mais lentos os dispositivos
leitores porque terão de as analisar todas.
- --smarten-punctuation,
-p
- Converter traços de texto, reticências, aspas,
hífenes múltiplos, etc, nos seus equivalentes
tipograficamente corretos. Note que o algoritmo poderá, por vezes,
produzir resultados incorretos, especialmente quando estejam envolvidas
aspas simples no começo das contrações.
- --subset-fonts,
-f
- Segmentar tipos de letra significa reduzir um tipo de letra incorporado
para conter apenas os caracteres utilizados no livro do ficheiro desse
tipo de letra. Isto reduz consideravelmente o tamanho dos ficheiros de
tipos de letra (em relação ao ficheiro do tipo de letra a
redução pode ser de metade). Por exemplo, se o livro usa um
tipo de letra específico para os cabeçalhos, então ao
segmentar tipos de letra irá reduzir esse tipo de letra para conter
apenas os caracteres presentes nos cabeçalhos atuais no livro. Ou,
se o livro incorporar as versões em negrito e itálico de um
tipo de letra, mas o uso de texto em negrito e itálico é
relativamente raro, ou mesmo ausente, então os tipos de letra em
negrito e itálico podem ser reduzidos para apenas alguns caracteres
ou completamente removidas. A única desvantagem da
segmentação de tipos de letra é que se, mais tarde,
decidir adicionar mais texto aos seus livros, o texto
recém-adicionado pode não ser totalmente abrangido pelo
subconjunto de tipo de letra.
- --upgrade-book,
-U
- Atualizar as estruturas internas do livro, se possível. Por
exemplo, atualizar livros EPUB 2 para livros EPUB 3
- --verbose
- Produz saída de dados mais detalhada, útil para a
depuração.
- --version
- mostrar o número da versão do programa e sair