ebook-polish

ebook-polish [options] input_file [output_file]

Polimento de livros tem a ver com buscar o brilho da perfeição em seus e-books cuidadosamente criados. Polir tenta minimizar as alterações no código interno do seu e-book. Diferente da conversão, ele nãoachata CSS, renomeia arquivos, muda tamanho de fonte, ajusta margens, etc. Cada ação realiza apenas o mínimo de mudanças necessárias para o efeito desejado.

Você deveria usar essa ferramenta como último passo na criação de e-books.

Note que embelezar funciona apenas em arquivos no formato AZW3 ou EPUB.

Sempre que você for passar argumentos para ebook-polish que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: “/some path/with spaces”

[opções]

--add-soft-hyphens, -H

Adicionar hifens condicionais a todas as palavras do livro. Isto permite uma melhor exibição de texto justificado em leitores que não suportam hifenização.

--compress-images, -i

Comprime imagens no livro sem perda, para reduzir o seu tamanho sem afetar a qualidade da imagem.

--cover, -c

Caminho para uma imagem de capa. Altera a capa especificada no e-book. Se não houver capa ou a capa não estiver identificada corretamente, insere uma nova capa.

--download-external-resources, -d

Baixar recursos externos como imagens, folhas de estilo, etc, que apontam para URLs em vez de arquivos no livro. Todos esses recursos serão baixados e adicionados ao livro, de tal forma que o livro não faça mais referência a recursos externos.

--embed-fonts, -e

incorporar todas as fontes que são referenciadas no documento e ainda não estão incorporadas. Isto irá analisar o seu computador pelas fontes, e se eles forem encontradas, elas serão incorporadas no documento. Certifique-se que você tenha a licença adequada para incorporar as fontes usadas neste documento.

--help, -h

mostrar esta mensagem de ajuda e sair

--jacket, -j

Inserir uma "sobrecapa de livro" no começo do livro que contenha todos os metadados do livro, como título, etiquetas, autores, série, comentários, etc. Qualquer sobrecapa anterior será substituída.

--opf, -o

Caminho para um arquivo OPF. Os metadados no livro é atualizado do arquivo OPF.

--remove-jacket

Remover uma página de sobrecapa de livro inserida anteriormente.

--remove-soft-hyphens

Remover hifens condicionais de todo o texto do livro.

--remove-unused-css, -u

Remove todas as regras CSS não utilizadas de folhas de estilo e elementos <style>. Alguns livros criados a partir de modelos de produção podem ter um grande número de regras CSS extras que não correspondem a qualquer conteúdo real. Estas regras extras podem retardar leitores que precisam processar todas elas.

--smarten-punctuation, -p

Converter traços simples texto, reticências, aspas, vários hífens, etc em seus equivalentes tipograficamente corretos. Observe que o algoritmo pode, algumas vezes produzir resultados incorretos, especialmente quando aspas simples no começo das contrações estão envolvidas.

--subset-fonts, -f

Criar um subconjunto de fontes significa reduzir uma fonte incorporada para conter apenas os caracteres utilizados desta fonte no livro. Isso reduz consideravelmente o tamanho dos arquivos de fonte (reduzir o tamanho do arquivo da fonte pela metade é comum). Por exemplo, se o livro usa uma fonte específica para os cabeçalhos, então o subconjunto irá reduzir esse tipo de fonte para conter apenas os caracteres presentes nos cabeçalhos atuais no livro. Ou, se o livro incorpora as versões em negrito e itálico de uma fonte, mas o texto em negrito e itálico é relativamente raro, ou ausente por completo, então as fontes em negrito e itálico podem ser reduzidas para apenas alguns caracteres ou completamente removida. A única desvantagem para o subconjunto de fontes é que se, algum dia mais tarde, você decidir adicionar mais texto aos seus livros, o texto recém-adicionado pode não ser abrangido pela subconjunto da fonte.

--upgrade-book, -U

Atualize as estruturas internas do livro, se possível. Por exemplo, atualiza livros EPUB 2 para livros EPUB 3.

--verbose

Produz saída mais detalhada, útil para depuração.

--version

mostrar número da versão do programa e sair