OPÇÕES DE ENTRADA
Opções para controlar o processamento do arquivo de
entrada mobi
- --input-encoding
- Especificar a codificação de caracteres do documento de
entrada. Se escolhida, esta opção irá substituir
qualquer outra codificação declarada pelo próprio
documento. Particularmente útil para documentos que não
declaram uma codificação ou que possuem
declarações de codificação incorretas.
OPÇÕES DE SAÍDA
Opções para controlar o processamento do arquivo de
saída epub
- --dont-split-on-page-breaks
- Turn off splitting at page breaks. Normally, input files are automatically
split at every page break into two files. This gives an output e-book that
can be parsed faster and with less resources. However, splitting is slow
and if your source file contains a very large number of page breaks, you
should turn off splitting on page breaks.
- --epub-flatten
- Esta opção só é necessária se
você pretende utilizar o formato EPUB no FBReaderJ. Ele vai achatar
o sistema de arquivos dentro do EPUB, colocando todos os arquivos para o
nível superior.
- --epub-inline-toc
- Insira um índice em linha que irão aparecer como parte do
conteúdo do livro principal.
- --epub-toc-at-end
- Colocar o índice em linha inserida no final do livro, em vez do
começo.
- Extraia os conteúdo dos EPUB arquivo gerado para a pasta
especificada. Os conteúdos da pasta são deletados primeiro,
então tenha cuidado.
- --flow-size
- Divida todos os arquivos HTML maiores que este tamanho (em KB). Isto
é necessário já que a maioria dos leitores de EPUB
não dão conta de arquivos grandes. O padrão de 260KB
é o tamanho exigido para o Adobe Digital Editions. Configure para 0
para desabilitar a divisão baseada no tamanho.
- --no-default-epub-cover
- Normalmente, se o arquivo de entrada não tem capa e você
não especificou uma, uma capa padrão é gerada com o
título, autores, etc. Esta opção desabilita a
geração desta capa.
- --no-svg-cover
- Não use SVG para a capa do livro. Use esta opção se
seu EPUB irá ser usado em um dispositivo que não suporta
SVG, como o iPhone ou o JetBook Lite. Sem esta opção, ambos
dispositivos irão mostrar a capa como uma página em
branco.
- --preserve-cover-aspect-ratio
- Quando estiver usando uma capa SVG, esta opção irá
fazer a capa se ajustar ao tamanho da área da tela, mas preservando
seu aspecto sem deformação (largura e comprimento). Isto
quer dizer que pode haver bordas brancas nos lados ou na parte de cima e
em baixo da imagem, mas ela nunca ficará deformada. Sem esta
opção a imagem pode ser visivelmente deformada, mas
não haverão bordas brancas.
- --pretty-print
- Se especificado, o plug-in de saída tentará produzir uma
saída que seja tão legível por pessoas quanto
possível. Pode não ter efeito para alguns plug-ins de
saída.
- --toc-title
- Título para qualquer índice gerado em linha.
Opções para controlar a aparência do arquivo
de saída
- --asciiize
- Transliterar caracteres Unicode em uma representação ASCII.
Use com cuidado, porque isso irá substituir caracteres Unicode por
ASCII. Por exemplo, ele irá substituir
"Михаил
Горбачёв"
com "Mikhail Gorbachiov". Além disso,
observe que nos casos em que existem várias
representações de um caractere (caracteres compartilhados
por chineses e japoneses, por exemplo), será usada a
representação com base no idioma atual da interface do
calibre.
- --base-font-size
- O tamanho base da fonte em pontos. Todos os tamanhos de fonte no livro
produzido serão redimensionados com base neste tamanho. Ao escolher
um tamanho maior, você pode fazer com que as fontes fiquem maiores
no livro e vice vice-versa. Por padrão, o tamanho base da fonte
é escolhido com base no perfil de saída que você
escolheu.
- --change-justification
- Mudar a justificação do texto. Um valor de
"Esquerda" converte todo o texto justificado na
origem para texto alinhado a esqueda (por ex. sem
justificação). Um valor de
"Justificado" converte todo o texto não
justificado para justificado. Um valor de
"Original" (o padrão) não muda a
justificação do arquivo de origem. Note que somente alguns
formatos de saída suportam justificação.
- --embed-all-fonts
- Incorporar todas as fontes que referenciam o documento de entrada pode
não estar atualmente incorporado. Isso irá procurar no seu
sistema por fontes, e se encontradas, elas serão incorporadas.
Incorporar somente irá funcionar no formato que você
está convertendo que suporte fontes incorporadas, como EPUB, AZW3,
DOCX ou PDF. Por favor, tenha a certeza de que você possui a
licensa apropriada para incorporar as fontes utilizadas neste
documento.
- --embed-font-family
- Coloque a fonte especificada no livro. Isto especifica a fonte
"base" usada no livro. Se o documento de entrada
especifica suas próprias fontes, elas podem sobrepor esta fonte
base. Você pode usar a opção "Filtrar
informação de estilo" para remover fontes do
documento de entrada. Note que isso funciona somente com alguns formatos
de saída, principalmente EPUB, AZW3 e AZW3.
- --expand-css
- By default, calibre will use the shorthand form for various CSS properties
such as margin, padding, border, etc. This option will cause it to use the
full expanded form instead. Note that CSS is always expanded when
generating EPUB files with the output profile set to one of the Nook
profiles as the Nook cannot handle shorthand CSS.
- O caminho para uma folha de estilo CSS ou CSS puro. Este CSS será
acrescentado às regras de estilo do arquivo de origem, de modo a
substituir aquelas regras.
- --filter-css
- Uma lista de propriedades CSS separadas por vírgulas que
será removida de todas as regras de estilo do CSS. Isto é
útil se a presença de informações dos estilo
previna-o de ser sobrescrito no seu dispositivo. Por exemplo:
font-family,color,margin-left,margin-right
- --font-size-mapping
- Mapeamento de nomes de fonte em CSS para tamanhos de fonte em pontos. Um
exemplo de configuração é 12,12,14,16,18,20,22,24.
Estes são os mapeamentos para os tamanhos de muito pequeno
(xx-small) a muito grande (xx-large), com o último tamanho sendo
para fontes enormes (huge). O algoritmo de redimensionamento de fonte usa
estes tamanhos para redimensionar as fontes de forma inteligente. O
padrão é usar um mapeamento com base no perfil de
saída que você escolheu.
- --insert-blank-line
- Insere uma linha em branco entre parágrafos. Não irá
funcionar se o arquivo de origem não usa parágrafos
(etiquetas <p> ou <div>).
- --insert-blank-line-size
- Definir a altura das linhas em branco inseridas (em 'em'). a
altura das linhas entre paragrafos será duas vezes o tamanho
definido aqui.
- --keep-ligatures
- Preserva as ligaduras presentes no documento de entrada. Uma ligadura
é um formato especial para mostrar um par de caracteres como ff,
fi, fl, etc. A maioria dos leitores não tem suporte para ligaduras
em suas fontes padrões, então eles não conseguem
mostrá-las corretamente. Por padrão, o calibe irá
transformar uma ligadura em seu par correspondente de caracteres normais.
Esta opção irá preservar as ligaduras.
- --line-height
- A altura da linha em pts. Controla o espaçamento entre linhas
consecutivas de texto. Só se aplica a elementos que não
definem a sua altura de linha própria. Na maioria dos casos, a
opção de altura mínima de linha é mais
útil. Por padrão nenhuma manipulação de altura
de linha é executada.
- --linearize-tables
- Alguns documentos mal modelados usam tabelas para controlar a
disposição do texto na página. Quando convertidos
estes documentos geralmente ficam com texto fora da página e outros
problemas. Esta opção irá extrair o conteúdo
das tabelas e mostra ele forma linear.
- --margin-bottom
- Set the bottom margin in pts. Default is 5.0. Setting this to less than
zero will cause no margin to be set (the margin setting in the original
document will be preserved). Note: Page oriented formats such as PDF and
DOCX have their own margin settings that take precedence.
- --margin-left
- Set the left margin in pts. Default is 5.0. Setting this to less than zero
will cause no margin to be set (the margin setting in the original
document will be preserved). Note: Page oriented formats such as PDF and
DOCX have their own margin settings that take precedence.
- --margin-right
- Set the right margin in pts. Default is 5.0. Setting this to less than
zero will cause no margin to be set (the margin setting in the original
document will be preserved). Note: Page oriented formats such as PDF and
DOCX have their own margin settings that take precedence.
- --margin-top
- Set the top margin in pts. Default is 5.0. Setting this to less than zero
will cause no margin to be set (the margin setting in the original
document will be preserved). Note: Page oriented formats such as PDF and
DOCX have their own margin settings that take precedence.
- --minimum-line-height
- A altura mínima de linha, como uma percentagem do tamanho do
elemento de fonte calculado. O calibre irá garantir que cada
elemento tenha uma altura de linha de pelo menos esta
configuração, independentemente do que o documento de
entrada especifica. Configure para zero para desativar. O padrão
é 120%. Use esta configuração de preferência
para a especificação direta de altura de linha, a menos que
você saiba o que está fazendo. Por exemplo, você pode
conseguir "espaço duplo" texto definindo
isso para 240.
- --remove-paragraph-spacing
- Remova espaço entre parágrafos. Também configura um
espaçamento de 1,5 linhas nos parágrafos.
Remoção de espaços não irão funcionar
se o arquivo de origem não usa parágrafos (etiquetas
<p> ou <div>).
- --remove-paragraph-spacing-indent-size
- Quando calibre remove linhas em branco entre parágrafos, ele insere
automaticamente um recuo de linha, para garantir que parágrafos
sejam facilmente distinguíveis. Esta opção controla o
tamanho da quebra de linha (em "em"). Se
você inserir um valor negativo, o recuo especificado no documento
será utilizado, isso significa que calibre não
modificará o recuo.
- --smarten-punctuation
- Convert plain quotes, dashes and ellipsis to their typographically correct
equivalents. For details, see
https://daringfireball.net/projects/smartypants
- --subset-embedded-fonts
- Subconjunto de todas as fontes incorporadas. Cada fonte incorporada
é reduzida para conter apenas os glifos usados
neste documento. Isto diminui o tamanho dos arquivos de
fonte. Útil se você estiver incorporando particularmente
fontes grandes com lotes de glifos não utilizados.
- --transform-css-rules
- Path to a file containing rules to transform the CSS styles in this book.
The easiest way to create such a file is to use the wizard for creating
rules in the calibre GUI. Access it in the "Look &
feel->Transform styles" section of the conversion dialog.
Once you create the rules, you can use the
"Export" button to save them to a file.
Modifique o documento de texto e sua estrutura usando
padrões comuns. Inicialmente desativado. Use --enable-heuristics para
ativar. Ações individuais podem ser desabilitaras com as
--disable-* opções.
- --disable-dehyphenate
- Analiza palavras que contenham hifén no documento. O documento
será utilizado como um dicionário para determinar se
hiféns devem ser mantidos ou removidos.
- --disable-format-scene-breaks
- Marcadores de quebra de cena alinhados à esquerda são
centralizados. Substituir quebras de cenas suaves que usam várias
linhas em branco por linhas horizontais.
- --disable-markup-chapter-headings
- Detectar títulos e subtítulos de capítulos sem
formatação. Trocá-los para marcações h2
e h3. Esta opção não irá criar um
índice, mas pode ser utilizada junto com a estrutura de
detecção para criar um.
- --disable-renumber-headings
- Procura ocorrências sequenciais de etiquetas <h1> ou
<h2>. As etiquetas serão renomeadas para evitar quebra no
meio do título dos capítulos.
- --enable-heuristics
- Permitir processamento heurístico. Esta opção
deverá estar ativada para que qualquer processamento
heurístico seja feito.
- --html-unwrap-factor
- Escala usada para determinar o tamanho que a linha deve ter quando as
quebras forem eliminadas. Valores válidos são decimais entre
0 e 1. O padrão é 0.4, um pouco abaixo da média do
tamanho da linha. Se apenas algumas linhas do documento necessitam ter
suas linhas eliminadas, este valor deve ser reduzido.
- --replace-scene-breaks
- Substituir quebras de cena com o texto especificado. Por padrão, o
texto do documento de entrada será usado.
Modificar o texto do documento e estrutura usando os
padrões definidos pelo usuário.
- --search-replace
- Path to a file containing search and replace regular expressions. The file
must contain alternating lines of regular expression followed by
replacement pattern (which can be an empty line). The regular expression
must be in the Python regex syntax and the file must be UTF-8
encoded.
- --sr1-replace
- Substituição para substituir o texto encontrado com a busca
sr1.
- --sr1-search
- Padrão de busca (expressão regular) para ser
substituído pelo substituto P&S-1.
- --sr2-replace
- Substituição para substituir o texto encontrado com a busca
sr2.
- --sr2-search
- Padrão de busca (expressão regular) para ser
substituído pelo substituto P&S-2.
- --sr3-replace
- Substituição para substituir o texto encontrado com a busca
sr3.
- --sr3-search
- Padrão de busca (expressão regular) para ser
substituído por sr2-replace.
Auto-detecção do controle da estrutura de
documento.
- --chapter
- An XPath expression to detect chapter titles. The default is to consider
<h1> or <h2> tags that contain the words
"chapter", "book",
"section", "prologue",
"epilogue" or "part" as
chapter titles as well as any tags that have
class="chapter". The expression used must evaluate
to a list of elements. To disable chapter detection, use the expression
"/". See the XPath Tutorial in the calibre User
Manual for further help on using this feature.
- --chapter-mark
- Especifique como marcar os capítulos detectados. O valor
"pagebreak" irá inserir uma quebra de
página antes dos capítulos. "Rule"
irá inserir uma linha antes de cada capítulo.
"none" irá desligar a
marcação de capítulos, enquanto
"both" irá inserir uma quebra de
página e uma linha para marcar os capítulos.
- --disable-remove-fake-margins
- Alguns documentos especificam os tamanhos de margem direita e esquerda
individualmente para cada parágrafo. O calibre tentará
detectar e remover estas margens. Alguma vezes, isso pode causar a
remoção indevida de margens. Neste caso, você pode
desativar a remoção.
- --insert-metadata
- Insert the book metadata at the start of the book. This is useful if your
e-book reader does not support displaying/searching metadata
directly.
- --page-breaks-before
- Uma expressão XPath. Quebras de página são inseridas
antes dos elementos especificados. Para desativar, utilize a
expressão: /
- --remove-first-image
- Remove the first image from the input e-book. Useful if the input document
has a cover image that is not identified as a cover. In this case, if you
set a cover in calibre, the output document will end up with two cover
images if you do not specify this option.
- --start-reading-at
- An XPath expression to detect the location in the document at which to
start reading. Some e-book reading programs (most prominently the Kindle)
use this location as the position at which to open the book. See the XPath
tutorial in the calibre User Manual for further help using this
feature.
ÍNDICE
Controlar a geração automática do
Índice. Por padrão, se o arquivo fonte tem um índice,
ele será usado no lugar do que seria gerado automaticamente.
- --duplicate-links-in-toc
- Ao criar de um índice a partir de links contidos no documento de
entrada, é permitido entradas duplicadas, isto é: permitir
mais de uma entrada com o mesmo texto, desde que eles apontem para locais
diferentes.
- --level1-toc
- Expressão XPath que especifica todas as etiquetas que
deverão ser adicionadas no primeiro nível do índice.
Se estiver especificada, terá precedência em
relação a outras formas de detecção
automática. Consulte o tutorial do XPath no Manual do
Usuário do calibre para exemplos.
- --level2-toc
- Expressão XPath que especifica todas as etiquetas que
deverão ser adicionadas no segundo nível do índice.
Cada entrada será adicionada abaixo da entrada anterior no
nível um. Consulte o tutorial do XPath no Manual do Usuário
do calibre para exemplos.
- --level3-toc
- Expressão XPath que especifica todas as etiquetas que
deverão ser adicionadas no terceiro nível do índice.
Cada entrada será adicionada abaixo da entrada anterior no
nível dois. Consulte o tutorial do XPath no Manual do
Usuário do calibre para exemplos.
- --max-toc-links
- Número máximo de links para inserir no índice. Use 0
para desativar. O padrão é: 50. Os links serão
adicionados ao índice apenas se o número encontrado for
menor que o limite máximo de capítulos.
- --toc-filter
- Remover os itens do índice cujos títulos correspondem
à expressão regular especificada. Os itens correspondentes e
subitens serão removidos.
- --toc-threshold
- Se um número de capítulos menor do que este for detectado,
links a eles serão adicionados para o índice. Padrão:
6.
- --use-auto-toc
- Normalmente, se o arquivo fonte já tem um índice, ele
é usado com preferência em relação ao que
é gerado automaticamente. Com esta opção, o que
é gerado automaticamente será sempre usado.
Opções para escolher os metadados no arquivo de
saída
- --authors
- Configura os autores. Múltiplos autores devem ser separados por
"&".
- Set the e-book description.
- --cover
- Configura a capa para o arquivo específico ou URL
- --isbn
- Defina o ISBN do livro.
- --pubdate
- Set the publication date (assumed to be in the local timezone, unless the
timezone is explicitly specified)
- --rating
- Defina a avaliação. Deve ser um número entre 1 e
5.
- --series
- Set the series this e-book belongs to.
- --series-index
- Define o índice do livro nesta série.
- --tags
- Defina etiquetas para o livro. Faça uma lista separada por
vírgulas.
- --timestamp
- Definir a marca temporal do livro (não é mais usada em lugar
algum)
- --title-sort
- A versão do título a ser usada na
ordenação.
Opções para auxiliar no debugging da
conversão
- --debug-pipeline,
-d
- Salvar o resultado de diferentes etapas do processo de conversão
para a pasta especificada. Útil se você não tem
certeza em que etapa do processo de conversão está ocorrendo
um erro.
- --verbose,
-v
- Nível de verbosidade. Especifique várias vezes para maior
verbosidade. Especificando-o duas vezes resultará em verbosidade
completa, enquanto a verbosidade média e zero vezes menos
verbosidade.