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 as fontes que são referenciadas no documento e
ainda não estejam incorporadas. Isto irá procurar no seu
computador pelas fontes e, desde que sejam encontradas, vão ser
incorporadas no documento. Por favor, garanta que tem a licença
adequada para incorporar as fontes utilizadas 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 fontes significa reduzir uma fonte incorporada para conter
apenas os caracteres utilizados desta fonte no livro. Isto reduz
consideravelmente o tamanho dos ficheiros de fontes (pode reduzir o
tamanho do ficheiro da fonte para metade). Por exemplo, se o livro usa uma
fonte específica para os cabeçalhos, então ao
segmentar fontes irá reduzir esse tipo de fonte 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 uma
fonte, mas o texto em negrito e itálico é relativamente
raro, ou mesmo ausente, então as fontes em negrito e itálico
podem ser reduzidas para apenas alguns caracteres ou completamente
removidas. A única desvantagem para o segmentação de
fontes é que se, mais tarde, decidir adicionar mais texto aos seus
livros, o texto recém-adicionado pode não ser abrangido pelo
subconjunto da fonte.
- --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