EBOOK-CONVERT(1) calibre EBOOK-CONVERT(1) NAME ebook-convert - ebook-convert ebook-convert arquivo_entrada arquivo_saida [opcoes] Converta um e-book de um formato para outro. arquivo_entrada e a entrada e arquivo_saida e a saida. Ambos devem ser especificados como os dois primeiros argumentos para o comando. O formato de e-book de saida e adivinhado a partir da extensao de arquivo do arquivo_saida. O arquivo_saida tambem pode ser do formato especial .EXT, em que EXT e a extensao do arquivo de saida. Nesse caso, o nome do arquivo de saida e derivado do nome do arquivo de entrada. Observe que os nomes dos arquivos nao devem comecar com um hifen. Finalmente, se o arquivo_saida nao tiver nenhuma extensao, ele sera tratado como uma pasta e um "e-book aberto" (OEB), consistindo de arquivos HTML, sera gravado nessa pasta. Esses arquivos sao os arquivos que normalmente teriam sido passados para o plugin de saida. Depois de especificar o arquivo de entrada e saida, voce pode personalizar a conversao especificando varias opcoes. As opcoes disponiveis dependem dos tipos de arquivo de entrada e saida. Para obter ajuda sobre eles, especifique o arquivo de entrada e saida e, em seguida, use a opcao -h. Para documentacao completa do sistema de conversao, consulte Conversao de E-book Sempre que voce for passar argumentos para ebook-convert que possuem espacos em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces" As opcoes e valores padrao para as opcoes alteram dependendo dos formatos de entrada e saida, por isso voce deve sempre verificar com: ebook-convert myfile.input_format myfile.output_format -h Abaixo estao as opcoes que sao comuns para todas as conversoes, seguido pelas opcoes especificas para cada formato de entrada e saida. o OPCOES DE ENTRADA o OPCOES DE SAIDA o APARENCIA o PROCESSAMENTO HEURISTICO o LOCALIZAR E SUBSTITUIR o DETECCAO DE ESTRUTURA o INDICE o METADADOS o DEPURACAO --help, -h mostrar esta mensagem de ajuda e sair --input-profile Especificar o perfil de origem. O perfil de origem da informacoes ao sistema de conversao sobre como interpretar varias informacoes no documento de origem. Por exemplo, comprimento dependente da resolucao (ou seja, comprimento em pixels). As escolhas sao: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900 --list-recipes Listar nomes de receita incorporados. Voce pode criar um e-book a partir de uma receita embutida como esta: ebook-convert "Nome da receita.recipe" output.epub --output-profile Especifica o perfil de saida. O perfil de saida diz ao sistema de conversao como otimizar o documento criado para o dispositivo especificado. Em alguns casos, um perfil de saida pode ser utilizado para otimizar a saida para um dispositivo em particular, mas isso raramente e necessario. As escolhas sao:cybookg3, cybook_opus, default, generic_eink, generic_eink_large, generic_eink_hd, hanlinv3, hanlinv5, illiad, ipad, ipad3, irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire, kindle_oasis, kindle_pw, kindle_pw3, kindle_scribe, kindle_voyage, kobo, msreader, mobipocket, nook, nook_color, nook_hd_plus, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd, pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape, sonyt3, tablet --version mostrar numero da versao do programa e sair OPCOES DE ENTRADA Opcoes para controlar o processamento do arquivo de entrada mobi --input-encoding Especificar a codificacao de caracteres do documento de entrada. Se escolhida, esta opcao ira substituir qualquer outra codificacao declarada pelo proprio documento. Particularmente util para documentos que nao declaram uma codificacao ou que possuem declaracoes de codificacao incorretas. OPCOES DE SAIDA Opcoes para controlar o processamento do arquivo de saida epub --dont-split-on-page-breaks Desativar a divisao nas quebras de pagina. Normalmente, os arquivos de entrada sao divididos automaticamente a cada quebra de pagina em dois arquivos. Isso fornece um e-book de saida que pode ser analisado mais rapidamente e com menos recursos. No entanto, a divisao e lenta e, se o arquivo de origem contiver um numero muito grande de quebras de pagina, voce devera desativar a divisao nas quebras de pagina. --epub-flatten Esta opcao so e necessaria se voce pretende utilizar o formato EPUB no FBReaderJ. Ele vai achatar o sistema de arquivos dentro do EPUB, colocando todos os arquivos no nivel superior. --epub-inline-toc Insira um indice em linha que irao aparecer como parte do conteudo do livro principal. --epub-max-image-size O tamanho maximo de imagem (largura x altura). Um valor de none significa utilizar o tamanho da tela do perfil de saida. Um valor de profile significa que nenhum tamanho maximo foi especificado. Por exemplo, um valor de 100x200 fara com que todas as imagens sejam redimensionadas de tal maneira que sua largura tenha nao mais que 100 pixels e sua altura tenha nao mais que 200 pixels. Note que isto somente afeta o tamanho real dos arquivos de imagem. Qualquer imagem pode ser exibida com um tamanho diferente dependendo do estilo aplicado a ela no documento. --epub-toc-at-end Colocar o indice em linha inserida no final do livro, em vez do comeco. --epub-version A versao do arquivo EPUB para ser gerado. O EPUB 2 e o mais compativel, use apenas o EPUB 3 se voce sabe que realmente precisa dele. --extract-to Extraia os conteudo do arquivo EPUB gerado para a pasta especificada. O conteudo da pasta e apagado primeiro, entao tenha cuidado. --flow-size Divida todos os arquivos HTML maiores que este tamanho (em KB). Isto e necessario ja que a maioria dos leitores de EPUB nao dao conta de arquivos grandes. O padrao de 260KB e o tamanho exigido para o Adobe Digital Editions. Configure para 0 para desabilitar a divisao baseada no tamanho. --no-default-epub-cover Normalmente, se o arquivo de entrada nao tem capa e voce nao especificou uma, uma capa padrao e gerada com o titulo, autores, etc. Esta opcao desabilita a geracao desta capa. --no-svg-cover Nao use SVG para a capa do livro. Use esta opcao se seu EPUB ira ser usado em um dispositivo que nao suporta SVG, como o iPhone ou o JetBook Lite. Sem esta opcao, ambos dispositivos irao mostrar a capa como uma pagina em branco. --preserve-cover-aspect-ratio Quando estiver usando uma capa SVG, esta opcao ira fazer a capa se ajustar ao tamanho da area da tela, mas preservando seu aspecto sem deformacao (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 ficara deformada. Sem esta opcao a imagem pode ser visivelmente deformada, mas nao haverao bordas brancas. --pretty-print Se especificado, o plugin de saida tentara produzir uma saida que seja tao legivel por pessoas quanto possivel. Pode nao ter efeito para alguns plugins de saida. --toc-title Titulo para qualquer indice gerado em linha. APARENCIA Opcoes para controlar a aparencia do arquivo de saida --asciiize Transformar caracteres Unicode em uma representacao ASCII. Use com cuidado, porque isso ira substituir caracteres Unicode por ASCII. Por exemplo, ele ira substituir "Pele" com "Pele". Alem disso, observe que nos casos em que existem varias representacoes de um caractere (caracteres compartilhados por chineses e japoneses, por exemplo), sera usada a representacao com base no idioma atual da interface do calibre. --base-font-size O tamanho da fonte base em pts. Todos os tamanhos de fonte no livro produzido serao redimensionados com base nesse tamanho. Ao escolher um tamanho maior, voce pode aumentar as fontes na saida e vice-versa. Por padrao, quando o valor e zero, o tamanho da fonte base e escolhido com base no perfil de saida escolhido. --change-justification Mudar a justificacao do texto. Um valor de "Esquerda" converte todo o texto justificado na origem para texto alinhado a esqueda (por ex. sem justificacao). Um valor de "Justificado" converte todo o texto nao justificado para justificado. Um valor de "Original" (o padrao) nao muda a justificacao do arquivo de origem. Note que somente alguns formatos de saida suportam justificacao. --disable-font-rescaling Desativar redimensionamento do tamanho das letras. --embed-all-fonts Incorporar todas as fontes que referenciam o documento de entrada pode nao estar atualmente incorporado. Isso ira procurar no seu sistema por fontes, e se encontradas, elas serao incorporadas. Incorporar somente ira funcionar no formato que voce esta convertendo que suporte fontes incorporadas, como EPUB, AZW3, DOCX ou PDF. Por favor, tenha a certeza de que voce 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 proprias fontes, elas podem sobrepor esta fonte base. Voce pode usar a opcao "Filtrar informacao de estilo" para remover fontes do documento de entrada. Note que isso funciona somente com alguns formatos de saida, principalmente EPUB, AZW3 e AZW3. --expand-css Por padrao, o calibre usara o formato abreviado para varias propriedades CSS, como margem, preenchimento, borda etc. Essa opcao fara com que ele use o formulario expandido completo. Observe que o CSS e sempre expandido ao gerar arquivos EPUB com o perfil de saida configurado para um dos perfis do Nook, pois o Nook nao pode manipular o CSS abreviado. --extra-css O caminho para uma folha de estilo CSS ou CSS puro. Este CSS sera acrescentado as regras de estilo do arquivo de origem, de modo a substituir aquelas regras. --filter-css Uma lista de propriedades CSS separadas por virgulas que sera removida de todas as regras de estilo do CSS. Isto e util se a presenca de informacoes 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 configuracao e 12,12,14,16,18,20,22,24. Estes sao os mapeamentos para os tamanhos de muito pequeno (xx-small) a muito grande (xx-large), com o ultimo tamanho sendo para fontes enormes (huge). O algoritmo de redimensionamento de fonte usa estes tamanhos para redimensionar as fontes de forma inteligente. O padrao e usar um mapeamento com base no perfil de saida que voce escolheu. --insert-blank-line Insere uma linha em branco entre paragrafos. Nao ira funcionar se o arquivo de origem nao usa paragrafos (tags

ou

). --insert-blank-line-size Definir a altura das linhas em branco inseridas (em 'em'). a altura das linhas entre paragrafos sera duas vezes o tamanho definido aqui. --keep-ligatures Preserva as ligaduras presentes no documento de entrada. Uma ligadura e um formato especial para mostrar um par de caracteres como ff, fi, fl, etc. A maioria dos leitores nao tem suporte para ligaduras em suas fontes padroes, entao eles nao conseguem mostra-las corretamente. Por padrao, o calibe ira transformar uma ligadura em seu par correspondente de caracteres normais. Esta opcao ira preservar as ligaduras. --line-height A altura da linha em pts. Controla o espacamento entre linhas consecutivas de texto. So se aplica a elementos que nao definem a sua altura de linha propria. Na maioria dos casos, a opcao de altura minima de linha e mais util. Por padrao nenhuma manipulacao de altura de linha e executada. --linearize-tables Alguns documentos mal modelados usam tabelas para controlar a disposicao do texto na pagina. Quando convertidos estes documentos geralmente ficam com texto fora da pagina e outros problemas. Esta opcao ira extrair o conteudo das tabelas e mostra ele forma linear. --margin-bottom Definir a margem inferior em pts. O padrao e %d. Definir isso para menos de zero fara com que nenhuma margem seja definida (a configuracao de margem no documento original sera preservada). Nota: Formatos orientados a paginas, como PDF e DOCX, tem suas proprias configuracoes de margem que tem precedencia. --margin-left Definir a margem esquerda em pts. O padrao e %d. Definir isso para menos de zero fara com que nenhuma margem seja definida (a configuracao de margem no documento original sera preservada). Nota: Formatos orientados a paginas, como PDF e DOCX, tem suas proprias configuracoes de margem que tem precedencia. --margin-right Definir a margem direita em pts. O padrao e %d. Definir isso para menos de zero fara com que nenhuma margem seja definida (a configuracao de margem no documento original sera preservada). Nota: Formatos orientados a paginas, como PDF e DOCX, tem suas proprias configuracoes de margem que tem precedencia. --margin-top Definir a margem superior em pts. O padrao e %d. Definir isso para menos de zero fara com que nenhuma margem seja definida (a configuracao de margem no documento original sera preservada). Nota: Formatos orientados a paginas, como PDF e DOCX, tem suas proprias configuracoes de margem que tem precedencia. --minimum-line-height A altura minima de linha, como uma percentagem do tamanho do elemento de fonte calculado. O calibre ira garantir que cada elemento tenha uma altura de linha de pelo menos esta configuracao, independentemente do que o documento de entrada especifica. Configure para zero para desativar. O padrao e 120%. Use esta configuracao de preferencia para a especificacao direta de altura de linha, a menos que voce saiba o que esta fazendo. Por exemplo, voce pode conseguir "espaco duplo" texto definindo isso para 240. --remove-paragraph-spacing Remove espaco entre paragrafos. Tambem configura um espacamento de 1,5 linhas nos paragrafos. A remocao de espacos nao irao funcionar se o arquivo de origem nao usa paragrafos (tags

ou

). --remove-paragraph-spacing-indent-size Quando calibre remove linhas em branco entre paragrafos, ele insere automaticamente um recuo de linha, para garantir que paragrafos sejam facilmente distinguiveis. Esta opcao controla o tamanho da quebra de linha (em "em"). Se voce inserir um valor negativo, o recuo especificado no documento sera utilizado, isso significa que calibre nao modificara o recuo. --smarten-punctuation Converta aspas, travessoes e reticencias em seus equivalentes tipograficamente corretos. Para detalhes, veja https://daringfireball.net/projects/smartypants. --subset-embedded-fonts Subconjunto de todas as fontes incorporadas. Cada fonte incorporada e reduzida para conter apenas os glifos usados neste documento. Isto diminui o tamanho dos arquivos de fonte. Util se voce estiver incorporando fontes particularmente grandes com muitos glifos nao utilizados. --transform-css-rules Caminho para um arquivo contendo regras para transformar os estilos CSS neste livro. A maneira mais facil de criar esse arquivo e usar o assistente para criar regras na GUI do calibre. Acesse-o na secao "Aparencia-> Transformar estilos" da caixa de dialogo de conversao. Depois de criar as regras, voce pode usar o botao "Exportar" para salva-las em um arquivo. --transform-html-rules Caminho para um arquivo contendo regras para transformar o HTML deste livro. A maneira mais facil de criar um arquivo como este e usar o Assistente para criar regras na interface grafica do calibre. Acesse-o na secao "Aparencia->Transformar HTML" no dialogo de conversao. Uma vez criadas as regras, voce pode usar o botao "Exportar" para salva-las em um arquivo. --unsmarten-punctuation Converter citacoes extravagantes, tracos e reticencias aos seus equivalentes simples. PROCESSAMENTO HEURISTICO Modifique o documento de texto e sua estrutura usando padroes comuns. Inicialmente desativado. Use --enable-heuristics para ativar. Acoes individuais podem ser desabilitaras com as --disable-* opcoes. --disable-dehyphenate Analiza palavras que contenham hifen no documento. O documento sera utilizado como um dicionario para determinar se hifens devem ser mantidos ou removidos. --disable-delete-blank-paragraphs Remova paragrafos vazios do documento quando eles existem entre outros paragrafos. --disable-fix-indents Transforma a identacao criada a partir de multiplas tabulacoes em identacoes CSS --disable-format-scene-breaks Marcadores de quebra de cena alinhados a esquerda sao centralizados. Substituir quebras de cenas suaves que usam varias linhas em branco por linhas horizontais. --disable-italicize-common-cases Procure por palavras e padroes comuns que deveriam ser italicos e os coloque em italico. --disable-markup-chapter-headings Detectar titulos e subtitulos de capitulos sem formatacao. Altera-os para tags h2 e h3. Esta opcao nao ira criar um indice, mas pode ser utilizada junto com a estrutura de deteccao para criar um. --disable-renumber-headings Procura ocorrencias sequenciais de tags

ou

. As tags serao renumeradas para evitar quebra no meio do titulo dos capitulos. --disable-unwrap-lines Eliminar quebra de linhas usando pontuacao e outras formas de formatacao. --enable-heuristics Permitir processamento heuristico. Esta opcao devera estar ativada para que qualquer processamento heuristico seja feito. --html-unwrap-factor Escala usada para determinar o tamanho que a linha deve ter quando as quebras forem eliminadas. Valores validos sao decimais entre 0 e 1. O padrao e 0.4, um pouco abaixo da media 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 padrao, o texto do documento de entrada sera usado. LOCALIZAR E SUBSTITUIR Modificar o texto do documento e estrutura usando os padroes definidos pelo usuario. --search-replace Caminho para um arquivo que contem pesquisa e substitui expressoes regulares. O arquivo deve conter linhas alternadas de expressao regular seguidas por padrao de substituicao (que pode ser uma linha vazia). A expressao regular deve estar na sintaxe de regex do Python e o arquivo deve ser codificado em UTF-8. --sr1-replace Substituicao para substituir o texto encontrado com a busca sr1. --sr1-search Padrao de busca (expressao regular) para ser substituido pelo substituto P&S-1. --sr2-replace Substituicao para substituir o texto encontrado com a busca sr2. --sr2-search Padrao de busca (expressao regular) para ser substituido pelo substituto P&S-2. --sr3-replace Substituicao para substituir o texto encontrado com a busca sr3. --sr3-search Padrao de busca (expressao regular) para ser substituido por sr2-replace. DETECCAO DE ESTRUTURA Auto-deteccao do controle da estrutura de documento. --chapter Uma expressao XPath para detectar titulos de capitulos. O padrao e considerar tags

ou

que contenham as palavras "capitulo", "livro", "sessao", "prologo", "epilogo" ou "parte" como titulos de capitulo, bem como quaisquer tags que tenham class = "chapter ". A expressao usada deve avaliar uma lista de elementos. Para desativar a deteccao de capitulos, use a expressao "/". Consulte o tutorial do XPath no manual do usuario do calibre para obter mais ajuda sobre como usar esse recurso. --chapter-mark Especifique como marcar os capitulos detectados. O valor "pagebreak" ira inserir uma quebra de pagina antes dos capitulos. "Rule" ira inserir uma linha antes de cada capitulo. "none" ira desligar a marcacao de capitulos, enquanto "both" ira inserir uma quebra de pagina e uma linha para marcar os capitulos. --disable-remove-fake-margins Alguns documentos especificam os tamanhos de margem direita e esquerda individualmente para cada paragrafo. O calibre tentara detectar e remover estas margens. Alguma vezes, isso pode causar a remocao indevida de margens. Neste caso, voce pode desativar a remocao. --insert-metadata Insira os metadados do livro no inicio do livro. Isso e util se o seu e-book reader nao suporta a exibicao / pesquisa de metadados diretamente. --page-breaks-before Uma expressao XPath. Quebras de pagina sao inseridas antes dos elementos especificados. Para desativar, utilize a expressao: / --prefer-metadata-cover Usar a capa detectada no arquivo fonte em relacao a capa especificada. --remove-first-image Remova a primeira imagem do e-book de entrada. Util se o documento de entrada tiver uma imagem de capa nao identificada como capa. Nesse caso, se voce definir uma capa em calibre, o documento de saida terminara com duas imagens de capa, se voce nao especificar essa opcao. --start-reading-at Uma expressao XPath para detectar o local no documento no qual comecar a ler. Alguns programas de leitura de livros eletronicos (mais proeminentemente o Kindle) usam esse local como a posicao na qual abrir o livro. Consulte o tutorial do XPath no Manual do Usuario do calibre para obter ajuda adicional ao usar essa funcao. INDICE Controlar a geracao automatica do Indice. Por padrao, se o arquivo fonte tem um indice, ele sera usado no lugar do que seria gerado automaticamente. --duplicate-links-in-toc Ao criar de um indice a partir de links contidos no documento de entrada, e permitido entradas duplicadas, isto e: permitir mais de uma entrada com o mesmo texto, desde que eles apontem para locais diferentes. --level1-toc Expressao XPath que especifica todas as tags que deverao ser adicionadas no primeiro nivel do indice. Se estiver especificada, tera precedencia em relacao a outras formas de deteccao automatica. Consulte o tutorial do XPath no Manual do Usuario do calibre para exemplos. --level2-toc Expressao XPath que especifica todas as tags que deverao ser adicionadas no segundo nivel do indice. Cada entrada sera adicionada abaixo da entrada anterior no nivel um. Consulte o tutorial do XPath no Manual do Usuario do calibre para exemplos. --level3-toc Expressao XPath que especifica todas as tags que deverao ser adicionadas no terceiro nivel do indice. Cada entrada sera adicionada abaixo da entrada anterior no nivel dois. Consulte o tutorial do XPath no Manual do Usuario do calibre para exemplos. --max-toc-links Numero maximo de links para inserir no indice. Use 0 para desativar. O padrao e: 50. Os links serao adicionados ao indice apenas se o numero encontrado for menor que o limite maximo de capitulos. --no-chapters-in-toc Nao adicionar para o indice os capitulos detectados automaticamente. --toc-filter Remover os itens do indice cujos titulos correspondem a expressao regular especificada. Os itens correspondentes e subitens serao removidos. --toc-threshold Se um numero de capitulos menor do que este for detectado, links a eles serao adicionados para o indice. Padrao: 6. --use-auto-toc Normalmente, se o arquivo fonte ja tem um indice, ele e usado com preferencia em relacao ao que e gerado automaticamente. Com esta opcao, o que e gerado automaticamente sera sempre usado. METADADOS Opcoes para escolher os metadados no arquivo de saida --author-sort O texto a ser usado quando ordenando por autor. --authors Configura os autores. Multiplos autores devem ser separados por "&". --book-producer Defina o produtor do livro. --comments Defina a descricao do e-book. --cover Configura a capa para o arquivo especifico ou URL --isbn Defina o ISBN do livro. --language Defina o idioma. --pubdate Definir a data de publicacao (supostamente no fuso horario local, a menos que o fuso horario seja especificado explicitamente) --publisher Defina o editor do e-book. --rating Defina a avaliacao. Deve ser um numero entre 1 e 5. --read-metadata-from-opf, --from-opf, -m Ler metadados de um arquivo OPF especifico. Metadados lidos deste arquivo irao substituir quaisquer metadados no arquivo de origem. --series Defina a serie a que este e-book pertence. --series-index Define o indice do livro nesta serie. --tags Defina etiquetas para o livro. Deve ser uma lista separada por virgulas. --timestamp Definir a marca temporal do livro (nao e mais usada em lugar algum) --title Defina o titulo. --title-sort A versao do titulo a ser usada na ordenacao. DEPURACAO Opcoes para auxiliar no debugging da conversao --debug-pipeline, -d Salvar o resultado de diferentes etapas do processo de conversao para a pasta especificada. Util se voce nao tem certeza em que etapa do processo de conversao esta ocorrendo um erro. --verbose, -v Nivel de verbosidade. Especifique varias vezes para maior verbosidade. Especificando-o duas vezes resultara em verbosidade completa, enquanto a verbosidade media e zero vezes menos verbosidade. AUTHOR Kovid Goyal COPYRIGHT Kovid Goyal 7.10.0 maio 03, 2024 EBOOK-CONVERT(1)