Debian Codegraph @

man-pages/pt/man1/ebook-convert.1

raw
1 .\" Man page generated from reStructuredText
2 .\" by the Docutils 0.22.4 manpage writer.
3 .
4 .
5 .nr rst2man-indent-level 0
6 .
7 .de1 rstReportMargin
8 \\$1 \\n[an-margin]
9 level \\n[rst2man-indent-level]
10 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11 -
12 \\n[rst2man-indent0]
13 \\n[rst2man-indent1]
14 \\n[rst2man-indent2]
15 ..
16 .de1 INDENT
17 .\" .rstReportMargin pre:
18 . RS \\$1
19 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20 . nr rst2man-indent-level +1
21 .\" .rstReportMargin post:
22 ..
23 .de UNINDENT
24 . RE
25 .\" indent \\n[an-margin]
26 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27 .nr rst2man-indent-level -1
28 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30 ..
31 .TH "EBOOK-CONVERT" "1" "setembro 18, 2026" "9.15.0" "calibre"
32 .SH NAME
33 ebook-convert \- ebook-convert
34 .INDENT 0.0
35 .INDENT 3.5
36 .sp
37 .EX
38 ebook\-convert ficheiro_entrada ficheiro_saída [opções]
39 .EE
40 .UNINDENT
41 .UNINDENT
42 .sp
43 Converte um formato de livro digital noutro formato
44 .sp
45 ficheiro_entrada (input_file) é a fonte e o ficheiro_saída (output_file) é o resultado final. Os dois devem ser especificados como os dois primeiros argumentos para o comando.
46 .sp
47 O formato do resultado final é calculado através da extensão de ficheiro do ficheiro_saída. O ficheiro_saída pode ter também o formato especial .EXT onde EXT é a extensão do ficheiro de saída. Neste caso, o nome do formato do ficheiro de saída é derivado do nome do ficheiro de entrada. Note que o nome do ficheiro não pode começar com um hífen. Finalmente, se ficheiro_saída não tiver extensão, então será tratado como pasta e será gravado nessa pasta um \(dqlivro digital aberto\(dq (OEB) composto por ficheiros HTML. Estes ficheiros são os ficheiros que normalmente seriam passados pelo plugin de saída.
48 .sp
49 Depois de especificar o ficheiro de entrada e o de saída poderá personalizar a conversão através da especificação de várias opções. As opções disponíveis dependem dos tipos de ficheiro de entrada e do de saída. Para obter ajuda neste tópico indique o ficheiro de entrada e o de saída seguido da opção \-h .
50 .sp
51 Para obter a documentação completa do sistema de conversão veja
52 Conversão de livros digitais \%<#\:conversion>
53 .sp
54 Sempre que passar argumentos para o \fBebook\-convert\fP que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
55 .sp
56 As opções e os valores das opções variam dependendo simultaneamente do formato de entrada e saída. Assim você deve sempre verificar com:
57 .INDENT 0.0
58 .INDENT 3.5
59 .sp
60 .EX
61 ebook\-convert myfile.input_format myfile.output_format \-h
62 .EE
63 .UNINDENT
64 .UNINDENT
65 .sp
66 Abaixo estão as opções que são comuns a todas as conversões, seguidas das opções especificas a cada formato de entrada e saída.
67 .INDENT 0.0
68 .IP \(bu 2
69 OPÇÕES DE ORIGEM
70 .IP \(bu 2
71 OPÇÕES DE DESTINO
72 .IP \(bu 2
73 VISUAL
74 .IP \(bu 2
75 PROCESSAMENTO HEURÍSTICO
76 .IP \(bu 2
77 PESQUISAR E SUBSTITUIR
78 .IP \(bu 2
79 DETEÇÃO DE ESTRUTURA
80 .IP \(bu 2
81 ÍNDICE
82 .IP \(bu 2
83 METADADOS
84 .IP \(bu 2
85 DEPURAR
86 .UNINDENT
87 .INDENT 0.0
88 .TP
89 .B \-\-help, \-h
90 mostrar esta mensagem de ajuda e sair
91 .UNINDENT
92 .INDENT 0.0
93 .TP
94 .B \-\-input\-profile
95 Especificar o perfil de origem. O perfil de origem indica ao sistema de conversão sobre como interpretar várias informações no documento de origem. Por exemplo, comprimentos dependentes da resolução (i. e. comprimento em píxeis). Escolhas disponíveis: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900
96 .UNINDENT
97 .INDENT 0.0
98 .TP
99 .B \-\-list\-recipes
100 Listar nomes das receitas nativas. Poderá criar um livro digital a partir das receitas criadas como em: ebook\-convert \fB\(dq\fPNome da receita.receita\fB\(dq\fP output.epub
101 .UNINDENT
102 .INDENT 0.0
103 .TP
104 .B \-\-output\-profile
105 Especifica o perfil de saída. O perfil de saída indica ao sistema de conversão como otimizar o documento criado para o dispositivo especificado. Em alguns casos, um perfil de saída pode ser utilizado para otimizar a saída para um dispositivo em particular, mas isso raramente é necessário. As escolhas são:cybookg3, cybook_opus, default, generic_eink, generic_eink_hd, generic_eink_large, 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
106 .UNINDENT
107 .INDENT 0.0
108 .TP
109 .B \-\-version
110 mostrar o número da versão do programa e sair
111 .UNINDENT
112 .SH OPÇÕES DE ORIGEM
113 .sp
114 Opções para controlar o processamento do ficheiro de origem mobi
115 .INDENT 0.0
116 .TP
117 .B \-\-input\-encoding
118 Especifica a codificação de caracteres para o documento de origem. Se definida, esta opção irá sobrepor\-se a qualquer codificação declarada no documento. Particularmente útil em documentos que não declaram uma codificação ou que possuem declarações de codificação erradas
119 .UNINDENT
120 .SH OPÇÕES DE DESTINO
121 .sp
122 Opções para controlar o processamento do ficheiro de destino epub
123 .INDENT 0.0
124 .TP
125 .B \-\-dont\-split\-on\-page\-breaks
126 Desligar a separação nas quebras de página. Normalmente os ficheiros de origem são automaticamente separados, nas quebras de página, em dois ficheiros. Isto faz com que o livro de destino seja analisado mais rapidamente e ocupando menos recursos. No entanto a separação é um processo lento e se o seu ficheiro de origem tiver muitas quebras de página deve desligar a separação nas quebras de página.
127 .UNINDENT
128 .INDENT 0.0
129 .TP
130 .B \-\-epub\-flatten
131 Esta opção só é necessária se pretende utilizar EPUB com o FBReaderJ. Vai remover a estrutura de ficheiros do formato EPUB colocando todas as imagens no nível de topo.
132 .UNINDENT
133 .INDENT 0.0
134 .TP
135 .B \-\-epub\-inline\-toc
136 Inserir um índice incorporado que irá aparecer como parte do conteúdo principal do livro.
137 .UNINDENT
138 .INDENT 0.0
139 .TP
140 .B \-\-epub\-max\-image\-size
141 O tamanho máximo da imagem (largura x altura). Um valor de profile significa utilizar o tamanho do ecrã do perfil de saída. Um valor de none significa que nenhum tamanho máximo é especificado. Por exemplo, um valor de 100x200 fará com que todas as imagens sejam redimensionadas de tal maneira que a sua largura não tenha mais do que 100 pixéis e a sua altura não tenha mais do que 200 pixéis. Note que isto apenas afeta o tamanho real dos ficheiros de imagem. Qualquer imagem pode ser exibida num tamanho diferente dependendo do estilo que lhe for aplicado no documento.
142 .UNINDENT
143 .INDENT 0.0
144 .TP
145 .B \-\-epub\-toc\-at\-end
146 Colocar o índice incorporado no final do livro em vez de no início.
147 .UNINDENT
148 .INDENT 0.0
149 .TP
150 .B \-\-epub\-version
151 A versão do ficheiro EPUB a ser gerado. O EPUB 2 é o mais compatível, use apenas o EPUB 3 se achar que realmente precisa dele.
152 .UNINDENT
153 .INDENT 0.0
154 .TP
155 .B \-\-extract\-to
156 Extrair o conteúdo do livro gerado para a pasta especificada. Tenha cuidado: o conteúdo da pasta será primeiro apagado.
157 .UNINDENT
158 .INDENT 0.0
159 .TP
160 .B \-\-flow\-size
161 Dividir todos os ficheiros HTML maiores que este tamanho (em KB). Isto é necessário porque a maioria dos leitores EPUB não lida bem com ficheiros muito grandes. A predefinição de 260KB é o tamanho requerido por Adobe Digital Editions. Definir para 0 para desativar a divisão baseada no tamanho.
162 .UNINDENT
163 .INDENT 0.0
164 .TP
165 .B \-\-no\-default\-epub\-cover
166 Normalmente, se o ficheiro de origem não tem capa, e se não especificar uma, será gerada uma capa predefinida com o título, autores, etc. Esta opção desativa a criação dessa capa.
167 .UNINDENT
168 .INDENT 0.0
169 .TP
170 .B \-\-no\-svg\-cover
171 Não utilizar SVG para a capa do livro. Utilize esta opção se o seu EPUB for utilizado num dispositivo que não suporte SVG, como o iPhone o JetBook Lite. Sem esta opção estes dispositivos mostrarão uma capa em branco.
172 .UNINDENT
173 .INDENT 0.0
174 .TP
175 .B \-\-preserve\-cover\-aspect\-ratio
176 Quando utilizar uma capa SVG, esta opção permite esticar a capa para a área do ecrã disponível mas preservando o aspeto (proporção largura/altura). Isto significa que podem surgir margens brancas nos lados ou no topo e fundo da imagem mas a imagem não será distorcida.
177 .UNINDENT
178 .INDENT 0.0
179 .TP
180 .B \-\-pretty\-print
181 Se especificado, o plugin de saída irá tentar criar um ficheiro o mais próximo possível da leitura humana. Poderá não produzir alterações em alguns plugins de saída.
182 .UNINDENT
183 .INDENT 0.0
184 .TP
185 .B \-\-toc\-title
186 Título para qualquer índice incorporado gerado.
187 .UNINDENT
188 .SH VISUAL
189 .sp
190 Opções para controlar o visual e funcionamento do ficheiro de destino
191 .INDENT 0.0
192 .TP
193 .B \-\-asciiize
194 Transliterar caracteres Unicode para uma representação em ASCII. Utilize com cuidado porque irá substituir os caracteres Unicode por ASCII. Por exemplo, irá substituir \fB\(dq\fPPelé\fB\(dq\fP por \fB\(dq\fPPele\fB\(dq\fP\&. Note também que em certos casos onde existem representações múltiplas de um carácter (por exemplo caracteres partilhados pelo Chinês e Japonês) será utilizada a representação baseada no idioma da interface atual do Calibre.
195 .UNINDENT
196 .INDENT 0.0
197 .TP
198 .B \-\-base\-font\-size
199 O tamanho base do tipo de letra em pts. Todos os tamanhos dos tipos de letra no livro produzido vão ser alterados proporcionalmente, baseados neste tamanho. Ao escolher um tamanho maior os tipos de letra no ficheiro de destino serão maiores e vice versa. Por predefinição, se o valor for zero, o tamanho base do tipo de letra é escolhido baseado no perfil de destino que escolheu.
200 .UNINDENT
201 .INDENT 0.0
202 .TP
203 .B \-\-change\-justification
204 Mudar justificação do texto. Um valor de \fB\(dq\fPleft\fB\(dq\fP vai converter todo o texto justificado no original para texto com alinhamento à esquerda (ou seja, sem justificação). Um valor de \fB\(dq\fPjustify\fB\(dq\fP converte todo o texto sem justificação para justificado. Um valor de \fB\(dq\fPoriginal\fB\(dq\fP (a predefinição) não altera a justificação no ficheiro fonte. Tenha em conta que apenas alguns formatos de saída suportam a justificação de texto.
205 .UNINDENT
206 .INDENT 0.0
207 .TP
208 .B \-\-disable\-font\-rescaling
209 Desativar a alteração proporcional do tamanho dos tipos de letra.
210 .UNINDENT
211 .INDENT 0.0
212 .TP
213 .B \-\-embed\-all\-fonts
214 Incorporar todos os tipos de letra referenciada no documento de entrada, mas que ainda não foram incorporadas. Isto irá procurar no seu sistema por tipo de letra, e se as encontrar, irá incorporá\-las. A incorporação só irá funcionar se o formato que está a converter suporta letras incorporadas, p.ex. EPUB, AZW3, DOCX ou PDF. Por favor, garanta que tem a licença adequada para incorporar os tipos de letra utilizadas neste documento.
215 .UNINDENT
216 .INDENT 0.0
217 .TP
218 .B \-\-embed\-font\-family
219 Incorporar a família tipográfica especificada no livro. Isto especifica o tipo de letra base a ser utilizada pelo livro. Se o documento de entrada especificar os seus próprios tipos de letra, eles poderão sobrescrever o tipo de letra base. Pode usar a opção de filtragem de informação de estilos para remover os tipos de letra do documento de entrada. Note que a incorporação de tipos de letra só funciona com certos formatos de saída, principalmente com EPUB, AZW3 e DOCX.
220 .UNINDENT
221 .INDENT 0.0
222 .TP
223 .B \-\-expand\-css
224 Por predefinição, o Calibre vai usar o modo abreviado para várias propriedades CSS como margem, espaçamento, contorno, etc. Esta opção fará com que use a forma expandida. Note que o CSS é sempre expandido ao gerar ficheiros EPUB com o perfil de saída definido para um dos perfis do Nook, porque o Nook não permite CSS abreviado.
225 .UNINDENT
226 .INDENT 0.0
227 .TP
228 .B \-\-extra\-css
229 O caminho para a folha de estilos CSS ou CSS em bruto. Este CSS vai ser adicionado às regras de estilo do ficheiro de origem de modo a ser usado para se sobrepor a essas regras.
230 .UNINDENT
231 .INDENT 0.0
232 .TP
233 .B \-\-filter\-css
234 Uma lista separada por vírgulas de propriedades CSS que serão removidas de todas as regras de estilo do CSS. Isto é útil se a presença de informações de alguns estilos impede o estilo de ser anulado no seu dispositivo. Por exemplo: font\-family,color,margin\-left,margin\-right
235 .UNINDENT
236 .INDENT 0.0
237 .TP
238 .B \-\-font\-size\-mapping
239 Mapeamento dos nomes dos tipos de letra CSS para tamanhos em pts. Um exemplo de definição é 12,12,14,16,18,20,22,24. Estes são os mapeamentos para os tamanhos xx\-small até xx\-large, sendo o tamanho final o maior. O algoritmo de alteração proporcional dos tipos de letra usa estes tamanhos para alterar de forma inteligente o tamanho dos tipos de letra. A predefinição é usar um mapeamento baseado no perfil de destino que escolheu.
240 .UNINDENT
241 .INDENT 0.0
242 .TP
243 .B \-\-insert\-blank\-line
244 Inserir uma linha em branco entre os parágrafos. Não funciona se o ficheiro de origem não usar parágrafos (etiquetas <p> ou <div>).
245 .UNINDENT
246 .INDENT 0.0
247 .TP
248 .B \-\-insert\-blank\-line\-size
249 Definir a altura das linhas inseridas em branco (valores \fB\(aq\fPem\fB\(aq\fP). A altura das linhas entre parágrafos será duas vezes o tamanho definido aqui.
250 .UNINDENT
251 .INDENT 0.0
252 .TP
253 .B \-\-keep\-ligatures
254 Preserva as ligaturas presentes no documento de entrada. Uma ligatura é um formato especial para mostrar um par de caracteres tal como ff, fi, fl, etc. A maioria dos leitores não têm suporte para ligaturas nos seus tipos de letra predefinidos e não conseguem mostrá\-las corretamente. Por predefinição, o Calibre irá transformar uma ligatura no seu par correspondente de caracteres normais. Note que aqui as ligaturas significam apenas ligaturas Unicode e não ligaturas criadas via CSS ou por estilos de fontes. Esta opção irá preservar as ligaturas.
255 .UNINDENT
256 .INDENT 0.0
257 .TP
258 .B \-\-line\-height
259 A altura da linha em pontos. Controlar espaçamento entre linhas consecutivas de texto. Apenas aplicar elementos que não definam a sua própria altura de linha. Na maioria dos casos, é mais útil usar a opção de altura mínima de linha. Por predefinição não será feita qualquer manipulação da altura de linha.
260 .UNINDENT
261 .INDENT 0.0
262 .TP
263 .B \-\-linearize\-tables
264 Alguns documentos mal paginados usam tabelas para controlar a disposição do texto na página. Quando convertidos, estes documentos apresentam texto que sai para fora da página bem como outros problemas. Esta opção extrai o conteúdo das tabelas e apresenta\-o de uma forma linear.
265 .UNINDENT
266 .INDENT 0.0
267 .TP
268 .B \-\-margin\-bottom
269 Definir a margem inferior em pts. A predefinição é 5.0. Definir este valor para 0 irá fazer com que nenhuma margem seja definida (as margens do documento original serão preservadas). Nota: formatos já com medidas da páginas pré\-estabelecidas como PDF e DOCX já têm as sua próprias definições de margem determinadas.
270 .UNINDENT
271 .INDENT 0.0
272 .TP
273 .B \-\-margin\-left
274 Definir a margem esquerda em pts. A predefinição é 5.0. Definir este valor para 0 irá fazer com que nenhuma margem seja definida (as margens do documento original serão preservadas). Nota: formatos já com medidas da páginas pré\-estabelecidas como PDF e DOCX já têm as sua próprias definições de margem determinadas e que têm precedência.
275 .UNINDENT
276 .INDENT 0.0
277 .TP
278 .B \-\-margin\-right
279 Definir a margem direita em pts. A predefinição é 5.0. Definir este valor para 0 irá fazer com que nenhuma margem seja definida (as margens do documento original serão preservadas). Nota: formatos já com medidas da páginas pré\-estabelecidas como PDF e DOCX já têm as sua próprias definições de margem determinadas.
280 .UNINDENT
281 .INDENT 0.0
282 .TP
283 .B \-\-margin\-top
284 Definir a margem superior em pts. A predefinição é 5.0. Definir este valor para 0 irá fazer com que nenhuma margem seja definida (as margens do documento original serão preservadas). Nota: formatos já com medidas da páginas pré\-estabelecidas como PDF e DOCX já têm as sua próprias definições de margem determinadas e que têm precedência.
285 .UNINDENT
286 .INDENT 0.0
287 .TP
288 .B \-\-minimum\-line\-height
289 A altura mínima da linha, como percentagem calculada a partir do tamanho de letra do elemento. O Calibre irá assegurar\-se que cada elemento tem um altura de linha de pelo menos o valor aqui definido, independentemente do que o documento ativo especificar. Defina com Zero para desativar isto. A predefinição é 120% . Use de preferência esta definição em vez da especificação direta da altura de linha, a não ser que saiba exatamente o que está a fazer. Por exemplo, pode obter texto com \fB\(dq\fPespaço duplo\fB\(dq\fP se definir isto com 240.
290 .UNINDENT
291 .INDENT 0.0
292 .TP
293 .B \-\-remove\-paragraph\-spacing
294 Remover o espaçamento entre parágrafos. Também define uma indentação nos parágrafos de 1.5em. A remoção do espaçamento não funciona se o ficheiro de origem não usar parágrafos (etiquetas <p> ou <div>).
295 .UNINDENT
296 .INDENT 0.0
297 .TP
298 .B \-\-remove\-paragraph\-spacing\-indent\-size
299 Quando o Calibre remove linhas em branco entre parágrafos, insere automaticamente uma indentação de parágrafo para garantir que os parágrafos sejam facilmente distinguíveis. Esta opção controla o tamanho desse avanço (unidade de medida \fB\(dq\fPem\fB\(dq\fP). Se inserir um valor negativo, será utilizado o avanço especificado no documento, o que significa que o Calibre não modificará a indentação.
300 .UNINDENT
301 .INDENT 0.0
302 .TP
303 .B \-\-smarten\-punctuation
304 Convert plain quotes, dashes and ellipsis to their typographically correct equivalents. For details, see: \%<https://\:daringfireball\:.net/\:projects/\:smartypants>\&.
305 .UNINDENT
306 .INDENT 0.0
307 .TP
308 .B \-\-subset\-embedded\-fonts
309 Segmentar todos os tipos de letra incorporadas. Todos os tipos de letra incorporados serão reduzidas para conter apenas os símbolos utilizados no documento. Isto diminui o tamanho dos ficheiros de tipos de letra. È particularmente útil se estiver a incorporar um tipo de letra pesado e com muitos símbolos não utilizados.
310 .UNINDENT
311 .INDENT 0.0
312 .TP
313 .B \-\-transform\-css\-rules
314 Caminho para um ficheiro que contém as regras para transformar os estilos CSS neste livro. O modo mais fácil de criar este ficheiro é usar o Assistente para criar regras na interface gráfica do Calibre. Para tal, aceda à secção \fB\(dq\fPAparência\->Transformar estilos\fB\(dq\fP do diálogo de conversão. Uma vez criadas as regras, pode usar o botão \fB\(dq\fPExportar\fB\(dq\fP para as guardar num ficheiro.
315 .UNINDENT
316 .INDENT 0.0
317 .TP
318 .B \-\-transform\-html\-rules
319 Caminho para um ficheiro que contém as regras para transformar o HTML neste livro. O modo mais fácil de criar este ficheiro é usar o Assistente para criar regras na interface gráfica do Calibre. Para tal, aceda à secção \fB\(dq\fPAparência\->Transformar HTML\fB\(dq\fP do diálogo de conversão. Uma vez criadas as regras, pode usar o botão \fB\(dq\fPExportar\fB\(dq\fP para as guardar num ficheiro.
320 .UNINDENT
321 .INDENT 0.0
322 .TP
323 .B \-\-unsmarten\-punctuation
324 Converter citações elegantes, traços e reticências aos seus equivalentes simples.
325 .UNINDENT
326 .SH PROCESSAMENTO HEURÍSTICO
327 .sp
328 Modifique o texto do documento e a sua estrutura usando padrões comuns. Desativada por predefinição. Usar \-\-enable\-heuristics para ativar. Ações individuais podem ser desativadas com as opções \-\-disable\-* .
329 .INDENT 0.0
330 .TP
331 .B \-\-disable\-dehyphenate
332 Analisa o documento por palavras que contenham hífenes. O documento será utilizado como um dicionário para determinar se os hífenes devem ser mantidos ou removidos.
333 .UNINDENT
334 .INDENT 0.0
335 .TP
336 .B \-\-disable\-delete\-blank\-paragraphs
337 Remover parágrafos vazios do documento quando estão entre outros parágrafos
338 .UNINDENT
339 .INDENT 0.0
340 .TP
341 .B \-\-disable\-fix\-indents
342 Transforma a indentação criada a partir de espaços impartíveis múltiplos em indentações CSS.
343 .UNINDENT
344 .INDENT 0.0
345 .TP
346 .B \-\-disable\-format\-scene\-breaks
347 Marcadores de quebra de cena alinhados à esquerda são centrados. Substituir quebras de cenas suaves que usam várias linhas em branco por linhas horizontais.
348 .UNINDENT
349 .INDENT 0.0
350 .TP
351 .B \-\-disable\-italicize\-common\-cases
352 Pesquisar por palavras comuns e padrões que denotam itálicos e tornar esse texto itálico
353 .UNINDENT
354 .INDENT 0.0
355 .TP
356 .B \-\-disable\-markup\-chapter\-headings
357 Detetar cabeçalhos e subcabeçalhos de capítulos sem formatação. Trocá\-los para etiquetas h2 e h3. Esta opção não irá criar um índice, mas pode ser utilizada juntamente com a estrutura de deteção para o criar.
358 .UNINDENT
359 .INDENT 0.0
360 .TP
361 .B \-\-disable\-renumber\-headings
362 Pesquisar por ocorrências de etiquetas html <h1> ou <h2>. As etiquetas serão renumeradas para evitar divisões no meio de cabeçalhos de capítulos.
363 .UNINDENT
364 .INDENT 0.0
365 .TP
366 .B \-\-disable\-unwrap\-lines
367 Unifique as linhas usando pontuação e outras pistas de formatação.
368 .UNINDENT
369 .INDENT 0.0
370 .TP
371 .B \-\-enable\-heuristics
372 Ativar o processamento heurístico. Esta opção deve ser ativada para que o processamento heurístico ocorra.
373 .UNINDENT
374 .INDENT 0.0
375 .TP
376 .B \-\-html\-unwrap\-factor
377 Escala utilizada para determinar o tamanho em que uma linha deve ter as quebras eliminadas. Valores válidos são decimais entre 0 e 1. A predefinição é 0.4, um pouco abaixo do tamanho médio de uma linha. Se apenas algumas linhas do documento precisam de quebras eliminadas, este valor deve ser reduzido.
378 .UNINDENT
379 .INDENT 0.0
380 .TP
381 .B \-\-replace\-scene\-breaks
382 Substitui quebras de lógica no texto especificado. Pelas definições, o texto do documento já escrito será usado.
383 .UNINDENT
384 .SH PESQUISAR E SUBSTITUIR
385 .sp
386 Modificar o texto e estrutura do documento de acordo com padrões definidos pelo utilizador.
387 .INDENT 0.0
388 .TP
389 .B \-\-search\-replace
390 Caminho para um ficheiro que contém expressões de pesquisa e substituição comuns. O ficheiro deve conter linhas alternadas de expressão comum seguida do padrão de substituição (que pode ser uma linha vazia). As expressões regulares devem estar na sintaxe Python regex e o ficheiro deve estar codificado em UTF\-8.
391 .UNINDENT
392 .INDENT 0.0
393 .TP
394 .B \-\-sr1\-replace
395 Substituição para substituir o texto encontrado com a sr1\-search
396 .UNINDENT
397 .INDENT 0.0
398 .TP
399 .B \-\-sr1\-search
400 Padrão de pesquisa (expressão regular) a ser substituído por um sr1\-replace
401 .UNINDENT
402 .INDENT 0.0
403 .TP
404 .B \-\-sr2\-replace
405 Substituição para substituir o texto encontrado com a sr2\-search
406 .UNINDENT
407 .INDENT 0.0
408 .TP
409 .B \-\-sr2\-search
410 Padrão de pesquisa (expressão regular) a ser substituído pela sr2\-replace
411 .UNINDENT
412 .INDENT 0.0
413 .TP
414 .B \-\-sr3\-replace
415 Substituição para substituir o texto encontrado com a sr3\-replace
416 .UNINDENT
417 .INDENT 0.0
418 .TP
419 .B \-\-sr3\-search
420 Padrão de pesquisa (expressão regular) a ser substituído pela sr3\-replace
421 .UNINDENT
422 .SH DETEÇÃO DE ESTRUTURA
423 .sp
424 Controlar a deteção automática da estrutura do documento.
425 .INDENT 0.0
426 .TP
427 .B \-\-add\-alt\-text\-to\-img
428 Quando uma etiqueta <img> não possui um atributo Alt, verifica os metadados de texto alternativo da imagem associada e usa isso para preencher o atributo Alt. O atributo Alt melhora a acessibilidade, fornecendo descrições de texto para utilizadores que não conseguem ver ou interpretar completamente o conteúdo visual.
429 .UNINDENT
430 .INDENT 0.0
431 .TP
432 .B \-\-chapter
433 Uma expressão XPath para apagar os títulos dos capítulos. A predefinição é considerar as etiquetas <h1> ou <h2> que contém as palavras \fB\(dq\fPcapítulo\fB\(dq\fP,\fB\(dq\fPlivro\fB\(dq\fP,\fB\(dq\fPsecção\fB\(dq\fP, \fB\(dq\fPprólogo\fB\(dq\fP, \fB\(dq\fPepilogo\fB\(dq\fP ou \fB\(dq\fPparte\fB\(dq\fP como títulos de capítulos assim como quaisquer etiquetas que tenham class=\fB\(dq\fPchapter\fB\(dq\fP\&. A expressão usada deve avaliar uma lista de elementos. Para desativar a deteção de capítulos, use a expressão \fB\(dq\fP/\fB\(dq\fP\&. Veja o tutorial do XPath no Manual do Utilizador do Calibre para mais ajudas no uso desta função.
434 .UNINDENT
435 .INDENT 0.0
436 .TP
437 .B \-\-chapter\-mark
438 Especificar como marcar os capítulos detetados. Um valor \fB\(dq\fPquebra de página\fB\(dq\fP vai inserir quebras de página antes dos capítulos. Um valor \fB\(dq\fPregra\fB\(dq\fP vai inserir uma linha antes dos capítulos. Um valor \fB\(dq\fPnenhum\fB\(dq\fP vai desativar a marcação de capítulos e um valor \fB\(dq\fPambos\fB\(dq\fP irá usar tanto quebras de página como linhas para marcar os capítulos.
439 .UNINDENT
440 .INDENT 0.0
441 .TP
442 .B \-\-disable\-remove\-fake\-margins
443 Alguns documentos especificam tamanhos de margem direita e esquerda individualmente para cada parágrafo. O Calibre tentará detetar e remover estas margens. Alguma vezes, isso pode causar a remoção indevida de margens. Neste caso, pode desativar a remoção.
444 .UNINDENT
445 .INDENT 0.0
446 .TP
447 .B \-\-insert\-metadata
448 Inserir os metadados no início do livro. Isto é útil se o seu leitor não suporta apresentar/pesquisar os metadados diretamente.
449 .UNINDENT
450 .INDENT 0.0
451 .TP
452 .B \-\-page\-breaks\-before
453 Uma expressão XPath. Serão inseridas quebras de página antes dos elementos especificados. Para desativar use a expressão: /
454 .UNINDENT
455 .INDENT 0.0
456 .TP
457 .B \-\-prefer\-metadata\-cover
458 Usar a capa detetada no ficheiro de origem em vez da capa especificada.
459 .UNINDENT
460 .INDENT 0.0
461 .TP
462 .B \-\-remove\-first\-image
463 Remover a primeira imagem do livro especificado. Útil se o documento especificado possui uma imagem de capa não reconhecida como tal. Se tal existir, e no caso desta opção não ter sido especificada, quando definir uma capa no Calibre o documento gerado ficará com duas imagens de capa.
464 .UNINDENT
465 .INDENT 0.0
466 .TP
467 .B \-\-start\-reading\-at
468 Uma expressão XPath para detetar a localização no documento a partir do qual se deve iniciar a leitura. Alguns programas de leitura de livros digitais (como por exemplo o Kindle) usam esta localização como posição para abertura do livro. Veja o tutorial do XPath no Manual do Utilizador do Calibre para mais ajuda no uso desta função.
469 .UNINDENT
470 .SH ÍNDICE
471 .sp
472 Controlar a geração automática de um índice. Por predefinição, se o ficheiro de origem tiver um índice, este é utilizado em vez do gerado automaticamente.
473 .INDENT 0.0
474 .TP
475 .B \-\-duplicate\-links\-in\-toc
476 Quando criar um índice a partir de hiperligações no documento de entrada, permitir entradas duplicadas. Por ex: permitir mais de uma entrada com o mesmo texto, desde que apontem para localizações diferentes.
477 .UNINDENT
478 .INDENT 0.0
479 .TP
480 .B \-\-level1\-toc
481 Expressão XPath que especifica todas as etiquetas que deverão ser adicionadas ao primeiro nível do índice. Se isto for especificado, terá precedência em relação a outras formas de deteção automática. Consulte o tutorial do XPath no Manual do utilizador do Calibre para exemplos.
482 .UNINDENT
483 .INDENT 0.0
484 .TP
485 .B \-\-level2\-toc
486 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 do nível um. Consulte o tutorial do XPath no Manual do Utilizador do Calibre para exemplos.
487 .UNINDENT
488 .INDENT 0.0
489 .TP
490 .B \-\-level3\-toc
491 Expressão XPath que especifica todas as etiquetas que deverão ser adicionadas no Índice do terceiro nível. Cada entrada será adicionada abaixo da entrada anterior no nível dois. Consulte o tutorial do XPath no Manual do Utilizador do Calibre para exemplos.
492 .UNINDENT
493 .INDENT 0.0
494 .TP
495 .B \-\-max\-toc\-links
496 Número máximo de atalhos a inserir no índice. Definir para 0 para desativar. A predefinição é: 50. Os atalhos só são adicionados ao índice se forem detetados menos que o limite de capítulos.
497 .UNINDENT
498 .INDENT 0.0
499 .TP
500 .B \-\-no\-chapters\-in\-toc
501 Não adicionar ao Índice os capítulos detetados automaticamente.
502 .UNINDENT
503 .INDENT 0.0
504 .TP
505 .B \-\-toc\-filter
506 Remove as entradas do Índice cujos títulos correspondem à expressão regular especificada. As entradas correspondentes e as suas dependentes são removidas.
507 .UNINDENT
508 .INDENT 0.0
509 .TP
510 .B \-\-toc\-threshold
511 Se forem detetados menos capítulos do que este número, os atalhos serão adicionados ao índice. A predefinição é: 6
512 .UNINDENT
513 .INDENT 0.0
514 .TP
515 .B \-\-use\-auto\-toc
516 Normalmente, se o ficheiro de origem já tem um Índice este é utilizado em vez do gerado automaticamente. Com esta opção o gerado automaticamente é sempre utilizado.
517 .UNINDENT
518 .SH METADADOS
519 .sp
520 Opções para definir os metadados no ficheiro de saída
521 .INDENT 0.0
522 .TP
523 .B \-\-author\-sort
524 Expressão a ser usada quando ordenar por autor.
525 .UNINDENT
526 .INDENT 0.0
527 .TP
528 .B \-\-authors
529 Definir os autores. Múltiplos autores devem ser separados por um e comercial (ampersand).
530 .UNINDENT
531 .INDENT 0.0
532 .TP
533 .B \-\-book\-producer
534 Definir o produtor do livro.
535 .UNINDENT
536 .INDENT 0.0
537 .TP
538 .B \-\-comments
539 Definir a descrição do livro.
540 .UNINDENT
541 .INDENT 0.0
542 .TP
543 .B \-\-cover
544 Define a capa para o ficheiro de imagem especificado ou de um URL
545 .UNINDENT
546 .INDENT 0.0
547 .TP
548 .B \-\-isbn
549 Definir ISBN do livro.
550 .UNINDENT
551 .INDENT 0.0
552 .TP
553 .B \-\-language
554 Definir idioma.
555 .UNINDENT
556 .INDENT 0.0
557 .TP
558 .B \-\-pubdate
559 Definir a data de publicação (esta é assumida no fuso horário local, a menos que um fuso horário seja explicitamente especificado)
560 .UNINDENT
561 .INDENT 0.0
562 .TP
563 .B \-\-publisher
564 Definir a editora do livro.
565 .UNINDENT
566 .INDENT 0.0
567 .TP
568 .B \-\-rating
569 Definir a pontuação. Deve ser um algarismo entre 1 e 5.
570 .UNINDENT
571 .INDENT 0.0
572 .TP
573 .B \-\-read\-metadata\-from\-opf, \-\-from\-opf, \-m
574 Ler os metadados do ficheiro OPF especificado. Os metadados lidos deste ficheiro vão sobrepor\-se aos metadados no ficheiro de origem.
575 .UNINDENT
576 .INDENT 0.0
577 .TP
578 .B \-\-series
579 Definir a série a que este livro pertence.
580 .UNINDENT
581 .INDENT 0.0
582 .TP
583 .B \-\-series\-index
584 Definir o índice do livro nesta série.
585 .UNINDENT
586 .INDENT 0.0
587 .TP
588 .B \-\-tags
589 Definir as etiquetas do livro. Deve ser uma lista separada por vírgulas.
590 .UNINDENT
591 .INDENT 0.0
592 .TP
593 .B \-\-timestamp
594 Definir a marca temporal do livro (algo já em desuso)
595 .UNINDENT
596 .INDENT 0.0
597 .TP
598 .B \-\-title
599 Definir o título.
600 .UNINDENT
601 .INDENT 0.0
602 .TP
603 .B \-\-title\-sort
604 A versão do título a ser usada para a alfabetação.
605 .UNINDENT
606 .SH DEPURAR
607 .sp
608 Opções para ajudar com a depuração da conversão
609 .INDENT 0.0
610 .TP
611 .B \-\-debug\-pipeline, \-d
612 Guarda o resultado, na pasta especificada, dos diferentes estágios da cadeia de conversão. Será útil se não tem a certeza em que etapa do processo de conversão é que está a ocorrer o erro.
613 .UNINDENT
614 .INDENT 0.0
615 .TP
616 .B \-\-verbose, \-v
617 Nível de verbosidade. Especifique múltiplas vezes para aumentar a verbosidade. Se especificar duas vezes obterá uma verbosidade completa, uma vez terá uma verbosidade média e zero vezes uma verbosidade mínima.
618 .UNINDENT
619 .SH Author
620 Kovid Goyal
621 .SH Copyright
622 Kovid Goyal
623 .\" End of generated man page.