Debian Codegraph @

man-pages/gl/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 [opcións]
39 .EE
40 .UNINDENT
41 .UNINDENT
42 .sp
43 Converte un libro electrónico dun formato a outro.
44 .sp
45 input_file é a entrada e output_file é a saída. Ambos deben especificarse como os dous primeiros argumentos do comando.
46 .sp
47 O formato de saída do libro electrónico dedícase a partir da extensión do ficheiro output_file. ficheiro_saída tamén pode ter o formato especial .EXT onde EXT é a extensión do ficheiro de saída. Neste caso, o nome do ficheiro de saída deriva do nome do ficheiro de entrada. Teña en conta que os nomes de ficheiros non deben comezar cun guión. Finalmente, se output_file non ten extensión, entón trátase como un cartafol e escríbese nese cartafol un «libro electrónico aberto» (OEB) composto por ficheiros HTML. Estes ficheiros son os ficheiros que normalmente se pasarían ao complemento de saída.
48 .sp
49 Despois de especificar o ficheiro de entrada e saída, pode personalizar a conversión especificando varias opcións. As opcións dispoñibles dependen dos tipos de ficheiros de entrada e saída. Para obter axuda sobre eles, especifique o ficheiro de entrada e saída e despois use a opción \-h.
50 .sp
51 Para a documentación completa do sistema de conversión consulte
52 E\-book conversion \%<#\:conversion>
53 .sp
54 Sempre que lle pases argumentos a \fBebook\-convert\fP que teñan espazos neles, pon os argumentos entre comiñas. Por exemplo: «/some path/with spaces»
55 .sp
56 As opcións e os valores predeterminados das opcións cambian dependendo de ambos
57 formatos de entrada e saída, polo que sempre debes comprobar con:
58 .INDENT 0.0
59 .INDENT 3.5
60 .sp
61 .EX
62 ebook\-convert myfile.input_format myfile.output_format \-h
63 .EE
64 .UNINDENT
65 .UNINDENT
66 .sp
67 A continuación móstranse as opcións que son comúns a todas as conversións, seguidas da
68 opcións específicas para cada formato de entrada e saída.
69 .INDENT 0.0
70 .IP \(bu 2
71 OPCIÓNS DE ENTRADA
72 .IP \(bu 2
73 OPCIÓNS DE SAÍDA
74 .IP \(bu 2
75 APARENCIA
76 .IP \(bu 2
77 PROCESAMENTO HEURÍSTICO
78 .IP \(bu 2
79 BUSCAR E SUBSTITUÍR
80 .IP \(bu 2
81 DETECCIÓN DA ESTRUTURA
82 .IP \(bu 2
83 ÍNDICE
84 .IP \(bu 2
85 METADATOS
86 .IP \(bu 2
87 DEPURACIÓN
88 .UNINDENT
89 .INDENT 0.0
90 .TP
91 .B \-\-help, \-h
92 mostrar esta mensaxe de axuda e saír
93 .UNINDENT
94 .INDENT 0.0
95 .TP
96 .B \-\-input\-profile
97 Especificar o perfil de entrada. O perfil de entrada dálle información ao sistema de conversión sobre como interpretar os distintos datos do documento de entrada. Por exemplo, as lonxitudes dependentes da resolución (en píxeles). As opcións son: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900
98 .UNINDENT
99 .INDENT 0.0
100 .TP
101 .B \-\-list\-recipes
102 Lista os nomes das receitas integradas. Podes crear un libro electrónico a partir dunha receita integrada como esta: ebook\-convert «Recipe Name.recipe» output.epub
103 .UNINDENT
104 .INDENT 0.0
105 .TP
106 .B \-\-output\-profile
107 Especifique o perfil de saída. O perfil de saída indica ao sistema de conversión como optimizar o documento creado para o dispositivo especificado. Nalgúns casos, pódese usar un perfil de saída para optimizar a saída dun dispositivo en particular, pero isto raramente é necesario. As opcións son:cybookg3, cybook_opus, default, 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, generic_eink, generic_eink_large, generic_eink_hd
108 .UNINDENT
109 .INDENT 0.0
110 .TP
111 .B \-\-version
112 mostrar o número de versión do programa e saír
113 .UNINDENT
114 .SH OPCIÓNS DE ENTRADA
115 .sp
116 Opcións para controlar o procesamento do ficheiro de entrada mobi
117 .INDENT 0.0
118 .TP
119 .B \-\-input\-encoding
120 Especificar a codificación de caracteres do documento de entrada. Se se establece esta opción, substituirá calquera codificación declarada no propio documento. En particular é útil para documentos sen codificación declarada ou con erros na declaración da codificación.
121 .UNINDENT
122 .SH OPCIÓNS DE SAÍDA
123 .sp
124 Opcións para controlar o procesamento da saída epub
125 .INDENT 0.0
126 .TP
127 .B \-\-dont\-split\-on\-page\-breaks
128 Desactiva a división nos saltos de páxina. Normalmente, os ficheiros de entrada divídense automaticamente en cada salto de páxina en dous ficheiros. Isto dá un libro electrónico de saída que se pode analizar máis rápido e con menos recursos. Non obstante, a división é lenta e se o ficheiro fonte contén un número moi grande de saltos de páxina, debería desactivar a división nos saltos de páxina.
129 .UNINDENT
130 .INDENT 0.0
131 .TP
132 .B \-\-epub\-flatten
133 Esta opción é necesaria soamente se pretende usar o EPUB con FBReaderJ. Con esta opción simplificarase o sistema de ficheiros dentro do EPUB, poñendo todos os ficheiros no nivel superior.
134 .UNINDENT
135 .INDENT 0.0
136 .TP
137 .B \-\-epub\-inline\-toc
138 Inserir un índice na liña que aparecerá como parte do contido do libro pincipal.
139 .UNINDENT
140 .INDENT 0.0
141 .TP
142 .B \-\-epub\-max\-image\-size
143 O tamaño máximo da imaxe (ancho x alto). Un valor de profile significa usar o tamaño da pantalla do perfil de saída. Un valor de none significa que non se especifica un tamaño máximo. Por exemplo, un valor de 100x200 fará que todas as imaxes se cambien de tamaño para que a súa anchura non sexa superior a 100 píxeles e a súa altura non sexa superior a 200 píxeles. Teña en conta que isto só afecta o tamaño dos ficheiros de imaxe actuais. Calquera imaxe pode renderizarse cun tamaño diferente dependendo do estilo que se lle aplique no documento.
144 .UNINDENT
145 .INDENT 0.0
146 .TP
147 .B \-\-epub\-toc\-at\-end
148 Poña o índice inserido ao final do libro no canto do comezo.
149 .UNINDENT
150 .INDENT 0.0
151 .TP
152 .B \-\-epub\-version
153 A versión do ficheiro EPUB que se vai xerar. EPUB 2 é o máis compatible, só usa EPUB 3 se sabes que realmente o necesitas.
154 .UNINDENT
155 .INDENT 0.0
156 .TP
157 .B \-\-extract\-to
158 Extrae o contido do libro xerado á carpeta especificada. O contido da carpeta é eliminado primeiro, así que ten coidado.
159 .UNINDENT
160 .INDENT 0.0
161 .TP
162 .B \-\-flow\-size
163 Divide todos os ficheiros HTML máis grandes que este tamaño (en KB). Isto é necesario xa que a maioría dos lectores de EPUB non poden manexar ficheiros de gran tamaño. O valor predeterminado de 260KB é o tamaño necesario para Adobe Digital Editions. Establécese en 0 para desactivar a división en función do tamaño.
164 .UNINDENT
165 .INDENT 0.0
166 .TP
167 .B \-\-no\-default\-epub\-cover
168 Normalmente, se o ficheiro de entrada non ten capa e non especifica unha, xerarase unha capa co título, autores, etc. Esta opción desactiva a xeración desta capa.
169 .UNINDENT
170 .INDENT 0.0
171 .TP
172 .B \-\-no\-svg\-cover
173 Non usar un SVG para a capa dun libro. Debe usar esta opción se o EPUB vai ser empregado nun dispositivo que non é compatible con SVG, como o iPhone ou de JetBook Lite. Sen esta opción, cada dispositivo amosará a capa como unha páxina en branco.
174 .UNINDENT
175 .INDENT 0.0
176 .TP
177 .B \-\-preserve\-cover\-aspect\-ratio
178 Ao empregar unha capa en branco, esta opción implicará que a capa escalarase a toda a área da pantalla dispoñíbel mais manterá a relación de aspecto. Isto implica que pode ter bordos en branco aos lados ou na parte superior e inferior, mais a imaxe non pode estar distorsionada. Sen esta opción, a imaxe pode distorsionarse, mais non terá bordos.
179 .UNINDENT
180 .INDENT 0.0
181 .TP
182 .B \-\-pretty\-print
183 Se está especificado, o complemento de saída tratará de crear unha saída o máis lexíbel posíbel. Pode non funcionar no caso dalgúns complementos de saída.
184 .UNINDENT
185 .INDENT 0.0
186 .TP
187 .B \-\-toc\-title
188 Título para calquera índice en liña xerada.
189 .UNINDENT
190 .SH APARENCIA
191 .sp
192 Opcións para controlar o aspecto da saída
193 .INDENT 0.0
194 .TP
195 .B \-\-asciiize
196 Translitera os caracteres Unicode a unha representación ASCII. Use con coidado porque isto substituirá os caracteres Unicode por ASCII. Por exemplo, substituirá «Pelé» por «Pele». Ademais, teña en conta que nos casos nos que hai varias representacións dun carácter (caracteres compartidos por chinés e xaponés, por exemplo) empregarase a representación baseada na linguaxe da interface de calibre actual.
197 .UNINDENT
198 .INDENT 0.0
199 .TP
200 .B \-\-base\-font\-size
201 O tamaño da fonte base en pts. Todos os tamaños de letra do libro producido serán reescalados en función deste tamaño. Escollendo un tamaño maior podes facer que as fontes da saída sexan máis grandes e viceversa. De xeito predeterminado, cando o valor é cero, escóllese o tamaño da fonte base en función do perfil de saída que escolleches.
202 .UNINDENT
203 .INDENT 0.0
204 .TP
205 .B \-\-change\-justification
206 Cambiar a xustificación do texto. O valor «esquerda» fai que o texto xustificado na orixe quede aliñado á esquerda (non xustificado). O valor «xustificar» fai que o texto non xustificado quede xustificado. O valor «orixinal» (o predeterminado) non altera a xustificación do ficheiro fonte. Teña en conta que non todos os formatos de saída admiten xustificación.
207 .UNINDENT
208 .INDENT 0.0
209 .TP
210 .B \-\-disable\-font\-rescaling
211 Desactivar o redimensionamento dos tamaños de letra.
212 .UNINDENT
213 .INDENT 0.0
214 .TP
215 .B \-\-embed\-all\-fonts
216 Incrustar todos os tipos de letra a que se fai referencia no documento de entrada pero que aínda non están incrustados. Isto buscará no teu sistema os tipos de letra e, se se atopan, incorporaranse. A incrustación só funcionará se o formato ao que estás convertendo admite fontes incrustadas, como EPUB, AZW3, DOCX ou PDF. Asegúrese de ter a licenza adecuada para incorporar os tipos de letra utilizados neste documento.
217 .UNINDENT
218 .INDENT 0.0
219 .TP
220 .B \-\-embed\-font\-family
221 Inserir a familia de fontes especificada no libro. Isto especifica a fonte «base» utilizada para o libro. Se o documento de entrada especifica as súas propias fontes, poden substituír esta fonte base. Podes usar a opción de información de estilo de filtro para eliminar fontes do documento de entrada. Teña en conta que a incorporación de fontes só funciona con algúns formatos de saída, principalmente EPUB, AZW3 e DOCX.
222 .UNINDENT
223 .INDENT 0.0
224 .TP
225 .B \-\-expand\-css
226 Por defecto, calibre usará a forma abreviada para varias propiedades CSS como marxe, recheo, bordo, etc. Esta opción fará que use o formulario expandido completo no seu lugar. Teña en conta que CSS sempre se expande cando se xeran ficheiros EPUB co perfil de saída definido nun dos perfís de Nook xa que o Nook non pode xestionar CSS abreviado.
227 .UNINDENT
228 .INDENT 0.0
229 .TP
230 .B \-\-extra\-css
231 Tanto a ruta dunha folla de estilo CSS como CSS directo. Este CSS será anexado ás regras de estilo do ficheiro orixinal, de modo que poida usarse para sobreescribir aquelas regras.
232 .UNINDENT
233 .INDENT 0.0
234 .TP
235 .B \-\-filter\-css
236 Unha lista separada por comas de propiedades CSS que se eliminarán de todas as regras de estilo CSS. Isto é útil se a presenza dalgunha información de estilo impide que se anule no teu dispositivo. Por exemplo: fonte\-familia, cor, marxe\-esquerda, marxe\-dereita
237 .UNINDENT
238 .INDENT 0.0
239 .TP
240 .B \-\-font\-size\-mapping
241 Correspondencia entre os tamaños de letra de CSS e tamaños en pt. Un exemplo podería ser 12,12,14,16,18,20,22,24. Estas son as correspondencias para os tamaños de xx\-small a xx\-large, e o último tamaño para letras enormes. O algoritmo para ampliar ou reducir o texto emprega estes tamaños para determinar o tamaño de letra de maneira intelixente. Por omisión, o valor é usar unha correspondencia baseada no perfil de saída seleccionado.
242 .UNINDENT
243 .INDENT 0.0
244 .TP
245 .B \-\-insert\-blank\-line
246 Inserir unha liña en branco entre parágrafos. Non funciona se o ficheiro de orixe non define parágrafos (etiquetas <p> ou <div>).
247 .UNINDENT
248 .INDENT 0.0
249 .TP
250 .B \-\-insert\-blank\-line\-size
251 Establece a altura das liñas en branco inseridas (en em). A altura das liñas entre parágrafos será o dobre do valor establecido aquí.
252 .UNINDENT
253 .INDENT 0.0
254 .TP
255 .B \-\-keep\-ligatures
256 Conserva as ligaduras presentes no documento de entrada. Unha ligadura é un carácter combinado dun par de caracteres como ff, fi, fl et cetera. A maioría dos lectores non teñen soporte para ligaduras nas súas fontes predeterminadas, polo que é improbable que se representen correctamente. Por defecto, gauge converterá unha ligadura no par de caracteres normais correspondente. Teña en conta que aquí as ligaduras significan só ligaduras Unicode, non ligaduras creadas mediante CSS ou estilos de fonte. Esta opción conservaraos no seu lugar.
257 .UNINDENT
258 .INDENT 0.0
259 .TP
260 .B \-\-line\-height
261 A altura de liña en pt. Controla o espazo entre liñas consecutivas de texto. Só se lle aplica a elementos que non definen a súa propia altura de liña. Na maioría dos casos, a opción de altura de liña mínima é máis útil. De modo predeterminado, non se modifica a altura da liña.
262 .UNINDENT
263 .INDENT 0.0
264 .TP
265 .B \-\-linearize\-tables
266 Algúns documentos mal deseñados usan táboas para controlar a disposición do texto na páxina. Cando se converten estes documentos adoitan dar lugar a texto que se sae da páxina e outros problemas. Esta opción extrae o contido das táboas e preséntao de maneira lineal.
267 .UNINDENT
268 .INDENT 0.0
269 .TP
270 .B \-\-margin\-bottom
271 Establece a marxe inferior en pts. O predeterminado é %dpredeterminado. Establecer isto a menos de cero fará que non se estableza ningunha marxe (conservarase a configuración da marxe no documento orixinal). Nota: os formatos orientados á páxina, como PDF e DOCX, teñen a súa propia configuración de marxes que teñen prioridade.
272 .UNINDENT
273 .INDENT 0.0
274 .TP
275 .B \-\-margin\-left
276 Establece a marxe esquerda en pts. O predeterminado é %d predeterminado. Establecer isto a menos de cero fará que non se estableza ningunha marxe (conservarase a configuración da marxe no documento orixinal). Nota: os formatos orientados á páxina, como PDF e DOCX, teñen a súa propia configuración de marxes que teñen prioridade.
277 .UNINDENT
278 .INDENT 0.0
279 .TP
280 .B \-\-margin\-right
281 Establece a marxe dereita en pts. O predeterminado é %dpredeterminado. Establecer isto a menos de cero fará que non se estableza ningunha marxe (conservarase a configuración da marxe no documento orixinal). Nota: os formatos orientados á páxina, como PDF e DOCX, teñen a súa propia configuración de marxes que teñen prioridade.
282 .UNINDENT
283 .INDENT 0.0
284 .TP
285 .B \-\-margin\-top
286 Establece a marxe superior en pts. O predeterminado é %dpredeterminado. Establecer isto a menos de cero fará que non se estableza ningunha marxe (conservarase a configuración da marxe no documento orixinal). Nota: os formatos orientados á páxina, como PDF e DOCX, teñen a súa propia configuración de marxes que teñen prioridade.
287 .UNINDENT
288 .INDENT 0.0
289 .TP
290 .B \-\-minimum\-line\-height
291 A altura mínima da liña, como porcentaxe do tamaño de tipo de letra do elemento calculado. Calibre asegurará que cada elemento teña esta altura de liña como mínimo, malia o que indique o documento de entrada. Asignar 0 para desactivar. De modo predeterminado é 120%. Utiliza esta opción preferentemente á especificación directa da altura de liña, non sendo que saiba o que está a facer. Por exemplo, pode conseguir texto con «dobre espazo» asignándolle un valor de 240.
292 .UNINDENT
293 .INDENT 0.0
294 .TP
295 .B \-\-remove\-paragraph\-spacing
296 Retirar o espazo entre parágrafos. Tamén estabelece o sangrado na primeira liña de cada parágrafo de 1,5em. A retirada do espazo non funciona se o ficheiro de orixe non define parágrafos (etiquetas <p> o <div>).
297 .UNINDENT
298 .INDENT 0.0
299 .TP
300 .B \-\-remove\-paragraph\-spacing\-indent\-size
301 Cando calibre elimina liñas en branco entre parágrafos, establece automaticamente unha sangría de parágrafo para garantir que os parágrafos se poidan distinguir facilmente. Esta opción controla o ancho desa sangría (en em). Se estableces este valor negativo, úsase a sangría especificada no documento de entrada, é dicir, o calibre non cambia a sangría.
302 .UNINDENT
303 .INDENT 0.0
304 .TP
305 .B \-\-smarten\-punctuation
306 Converter comiñas simples, trazos e puntos suspensivos ás súas equivalencias tipográficas correctas. Para máis detalles, ver: \%<https://\:daringfireball\:.net/\:projects/\:smartypants>\&.
307 .UNINDENT
308 .INDENT 0.0
309 .TP
310 .B \-\-subset\-embedded\-fonts
311 Subconxunta todas as fontes incrustadas. Cada tipo de letra incrustado redúcese para conter só os glifos utilizados neste documento. Isto diminúe o tamaño dos ficheiros de fontes. Útil se está incorporando un tipo de letra especialmente grande con moitos glifos sen usar.
312 .UNINDENT
313 .INDENT 0.0
314 .TP
315 .B \-\-transform\-css\-rules
316 Ruta a un ficheiro que contén regras para transformar os estilos CSS deste libro. O xeito máis sinxelo de crear un ficheiro deste tipo é usar o asistente para crear regras na GUI de calibre. Accede a el na sección «Aspecto e sensación\->Transformar estilos» do diálogo de conversión. Unha vez creadas as regras, pode usar o botón «Exportar» para gardalas nun ficheiro.
317 .UNINDENT
318 .INDENT 0.0
319 .TP
320 .B \-\-transform\-html\-rules
321 Ruta a un ficheiro que contén regras para transformar o HTML deste libro. O xeito máis sinxelo de crear un ficheiro deste tipo é usar o asistente para crear regras na GUI de calibre. Accede a el na sección «Aspecto e sensación\->Transformar HTML» do diálogo de conversión. Unha vez creadas as regras, pode usar o botón «Exportar» para gardalas nun ficheiro.
322 .UNINDENT
323 .INDENT 0.0
324 .TP
325 .B \-\-unsmarten\-punctuation
326 Converte citas, trazos e elipses elegantes aos seus equivalentes sinxelos.
327 .UNINDENT
328 .SH PROCESAMENTO HEURÍSTICO
329 .sp
330 Modificar o texto e a estrutura do documento utilizando patróns habituais. Empregue \-\-enable\-heuristics para activar. As accións individuais pódense desactivar coas opcións \-\-disable\-
331 .nf
332 *
333 .fi
334 \&.
335 .INDENT 0.0
336 .TP
337 .B \-\-disable\-dehyphenate
338 Analiza as palabras con guión en todo o documento. O propio documento se usa coma un dicionario para determinar se cada guión se debe manter ou eliminarse.
339 .UNINDENT
340 .INDENT 0.0
341 .TP
342 .B \-\-disable\-delete\-blank\-paragraphs
343 Eliminar do documento os parágrafos baleiros que hai entre outros parágrafos
344 .UNINDENT
345 .INDENT 0.0
346 .TP
347 .B \-\-disable\-fix\-indents
348 Converter os sangrados creados a partir de varios espazos duros en sangrados de CSS.
349 .UNINDENT
350 .INDENT 0.0
351 .TP
352 .B \-\-disable\-format\-scene\-breaks
353 Os marcadores de salto de escena aliñados á esquerda están aliñados ao centro. Substitúe os saltos de escena suaves que usan varias liñas en branco por regras horizontais.
354 .UNINDENT
355 .INDENT 0.0
356 .TP
357 .B \-\-disable\-italicize\-common\-cases
358 Buscar palabras e patróns que habitualmente estean en cursiva e poñelos en cursiva.
359 .UNINDENT
360 .INDENT 0.0
361 .TP
362 .B \-\-disable\-markup\-chapter\-headings
363 Detectar cabeceiras e subcabeceiras de capítulos sen formato e convertilas en etiquetas h2 e h3. Esta configuración non creará un índice, pero pódese utilizar xunto coa detección de estrutura para crear uno.
364 .UNINDENT
365 .INDENT 0.0
366 .TP
367 .B \-\-disable\-renumber\-headings
368 Busca secuencias de etiquetas <h1> ou <h2>. As etiquetas renumeran para evitar que de dividan os ficheiros en medio dunha cabeceira de capítulo.
369 .UNINDENT
370 .INDENT 0.0
371 .TP
372 .B \-\-disable\-unwrap\-lines
373 Unir liñas baseándose na puntuación e noutros indicios de formato.
374 .UNINDENT
375 .INDENT 0.0
376 .TP
377 .B \-\-enable\-heuristics
378 Activar o procesamento heurístico. Esta opción debe estar activada para que se poida realizar calquera tipo de procesametno heurístico.
379 .UNINDENT
380 .INDENT 0.0
381 .TP
382 .B \-\-html\-unwrap\-factor
383 Escala para determinar a lonxitude para unir liñas. Os valores correctos son números decimais entre 0 e 1. O valor predeterminado é 0.4, un pouco menos da metade da liña. Se soamente unhas poucas liñas do documento necesitan unirse, debería reducir o valor
384 .UNINDENT
385 .INDENT 0.0
386 .TP
387 .B \-\-replace\-scene\-breaks
388 Substituír saltos de escea polo texto especificado. De maneira predeterminada úsase o texto existente no documento de entrada.
389 .UNINDENT
390 .SH BUSCAR E SUBSTITUÍR
391 .sp
392 Modificar o texto do documento e a estrutura usando patróns definidos.
393 .INDENT 0.0
394 .TP
395 .B \-\-search\-replace
396 Ruta a un ficheiro que contén buscar e substituír expresións regulares. O ficheiro debe conter liñas alternas de expresión regular seguidas dun patrón de substitución (que pode ser unha liña baleira). A expresión regular debe estar na sintaxe regex de Python e o ficheiro debe estar codificado en UTF\-8.
397 .UNINDENT
398 .INDENT 0.0
399 .TP
400 .B \-\-sr1\-replace
401 Texto de substitución para o texto encontrado con sr1\-search.
402 .UNINDENT
403 .INDENT 0.0
404 .TP
405 .B \-\-sr1\-search
406 Patrón de busca (expresión regular) que se substituirá por sr1\-replace.
407 .UNINDENT
408 .INDENT 0.0
409 .TP
410 .B \-\-sr2\-replace
411 Texto de substitución para o texto atopado con sr2\-search.
412 .UNINDENT
413 .INDENT 0.0
414 .TP
415 .B \-\-sr2\-search
416 Patrón de busca (expresión regular) que se substituirá por sr2\-replace.
417 .UNINDENT
418 .INDENT 0.0
419 .TP
420 .B \-\-sr3\-replace
421 Texto de substitución para o texto atopado con sr3\-search.
422 .UNINDENT
423 .INDENT 0.0
424 .TP
425 .B \-\-sr3\-search
426 Patrón de busca (expresión regular) que se substituirá por sr3\-replace.
427 .UNINDENT
428 .SH DETECCIÓN DA ESTRUTURA
429 .sp
430 Control de autodetección de estrutura de documento.
431 .INDENT 0.0
432 .TP
433 .B \-\-add\-alt\-text\-to\-img
434 Cando unha <img> etiqueta non ten atributo alt, comproba o ficheiro de imaxe asociado para ver se contén metadatos que especifiquen texto alternativo e úsao para completar o atributo alt. O atributo alt mellora a accesibilidade ao proporcionar descricións de texto para os usuarios que non poden ver ou interpretar completamente o contido visual.
435 .UNINDENT
436 .INDENT 0.0
437 .TP
438 .B \-\-chapter
439 Unha expresión XPath para detectar títulos de capítulos. O predeterminado é considerar <h1>ou<h2> etiquetas que conteñan as palabras «capítulo», «libro», «sección», «prólogo», «epílogo» ou «parte» como títulos de capítulo, así como calquera etiqueta que teña class=\fB\(dq\fPchapter\fB\(dq\fP\&. A expresión utilizada debe avaliarse como unha lista de elementos. Para desactivar a detección de capítulos, use a expresión «/». Consulte o Titorial de XPath no Manual de usuario de calibre para obter máis axuda sobre o uso desta función.
440 .UNINDENT
441 .INDENT 0.0
442 .TP
443 .B \-\-chapter\-mark
444 Especificar como marcar os capítulos detectados. Un valor «pagebreak» inserirá un salto de páxina antes de cada capítulo. Un valor de «rule» inserirá unha liña antes de cada capítulo. «both» marcará os capítulos cun salto de páxina e unha liña en branco. «none» desactivará o marcado de capítulos e un valor de «both» usará ambos saltos de páxina e liñas para marcar capítulos.
445 .UNINDENT
446 .INDENT 0.0
447 .TP
448 .B \-\-disable\-remove\-fake\-margins
449 Algúns documentos especifican as marxes de páxina engadindo marxes á esquerda e dereita de cada parágrafo, Calibre intentará detectar e eliminar estas marxes. Ás veces isto pode ocasionar que se eliminen marxes que deberían manterse. En tal caso, pode desactivar a eliminación.
450 .UNINDENT
451 .INDENT 0.0
452 .TP
453 .B \-\-insert\-metadata
454 Insira os metadatos do libro ao comezo do libro. Isto é útil se o teu lector de libros electrónicos non admite mostrar/buscar metadatos directamente.
455 .UNINDENT
456 .INDENT 0.0
457 .TP
458 .B \-\-page\-breaks\-before
459 Unha expresión XPath. Os saltos de páxina insírense antes dos elementos especificados. Para desactivar use a expresión: /
460 .UNINDENT
461 .INDENT 0.0
462 .TP
463 .B \-\-prefer\-metadata\-cover
464 Usar a capa detectada no ficheiro de orixe mellor que a capa especificada.
465 .UNINDENT
466 .INDENT 0.0
467 .TP
468 .B \-\-remove\-first\-image
469 Elimina a primeira imaxe do libro electrónico de entrada. Útil se o documento de entrada ten unha imaxe de portada que non se identifica como portada. Neste caso, se estableces unha portada en calibre, o documento de saída acabará con dúas imaxes de portada se non especificas esta opción.
470 .UNINDENT
471 .INDENT 0.0
472 .TP
473 .B \-\-start\-reading\-at
474 Unha expresión XPath para detectar a localización do documento na que comezar a ler. Algúns programas de lectura de libros electrónicos (o máis destacado o Kindle) usan esta localización como a posición na que abrir o libro. Consulte o tutorial de XPath no Manual de usuario de calibre para obter máis axuda sobre o uso desta función.
475 .UNINDENT
476 .SH ÍNDICE
477 .sp
478 Controla a xeración automática do Índice. De modo predeterminado, se o ficheiro orixe ten un índice, usarase esta preferentemente respecto do xerado automaticamente.
479 .INDENT 0.0
480 .TP
481 .B \-\-duplicate\-links\-in\-toc
482 Ao crear un índice a partir de ligazóns no documento de entrada, permita entradas duplicadas, é dicir. permiten máis dunha entrada co mesmo texto, sempre que apunten a unha localización diferente.
483 .UNINDENT
484 .INDENT 0.0
485 .TP
486 .B \-\-level1\-toc
487 Expresión XPath que especifica todas as etiquetas que se deben engadir ó índice no nivel un. Se se especifica isto, terá prioridade sobre outras formas de detección automática. Consulte o Titorial XPath no Manual de usuario de calibre para obter exemplos.
488 .UNINDENT
489 .INDENT 0.0
490 .TP
491 .B \-\-level2\-toc
492 Expresión XPath que especifica todas as etiquetas que se deben engadir ó índice no nivel dous. Cada entrada engádese baixo unha entrada do nivel anterior. Consulte o Titorial XPath no Manual de usuario de calibre para obter exemplos.
493 .UNINDENT
494 .INDENT 0.0
495 .TP
496 .B \-\-level3\-toc
497 Expresión XPath que especifica todas as etiquetas que se deben engadir ó índice no nivel tres. Cada entrada engádese baixo a entrada de nivel dous anterior. Consulte o Titorial XPath no Manual de usuario de calibre para obter exemplos.
498 .UNINDENT
499 .INDENT 0.0
500 .TP
501 .B \-\-max\-toc\-links
502 Número máximo de ligazóns que se incluirán no Índice de contidos. O valor 0 desactiva a opción. Valor predeterminado: 50. Só se engadirán ligazóns no IdC se se detecta un número de capítulos menor que o estabelecido como limiar.
503 .UNINDENT
504 .INDENT 0.0
505 .TP
506 .B \-\-no\-chapters\-in\-toc
507 Non engadir os capítulos autodetectados ó índice.
508 .UNINDENT
509 .INDENT 0.0
510 .TP
511 .B \-\-toc\-filter
512 Retirar entradas do Índice con títulos que se corresponden coa expresión regular especificada. As entradas correspondentes e todas as subordinadas serán retiradas.
513 .UNINDENT
514 .INDENT 0.0
515 .TP
516 .B \-\-toc\-threshold
517 Se se detecta menos deste número de capítulos, entón engádense ligazóns ao Índice. Valor predeterminado: 6
518 .UNINDENT
519 .INDENT 0.0
520 .TP
521 .B \-\-use\-auto\-toc
522 Normalmente, se o ficheiro de orixe ten un Índice, úsase este en vez do autoxerado. Con esta opción sempre se usará o autoxerado.
523 .UNINDENT
524 .SH METADATOS
525 .sp
526 As opcións para asignar metadatos na saída
527 .INDENT 0.0
528 .TP
529 .B \-\-author\-sort
530 Texto que se usará para ordenación por autor.
531 .UNINDENT
532 .INDENT 0.0
533 .TP
534 .B \-\-authors
535 Estabelecer os autores. Se hai varios autores deben separarse por «&».
536 .UNINDENT
537 .INDENT 0.0
538 .TP
539 .B \-\-book\-producer
540 Definir o produtor do libro.
541 .UNINDENT
542 .INDENT 0.0
543 .TP
544 .B \-\-comments
545 Establece a descrición do libro electrónico.
546 .UNINDENT
547 .INDENT 0.0
548 .TP
549 .B \-\-cover
550 Estabelecer a capa desde o ficheiro ou o URL especificado
551 .UNINDENT
552 .INDENT 0.0
553 .TP
554 .B \-\-isbn
555 Definir o ISBN do libro.
556 .UNINDENT
557 .INDENT 0.0
558 .TP
559 .B \-\-language
560 Definir o idioma.
561 .UNINDENT
562 .INDENT 0.0
563 .TP
564 .B \-\-pubdate
565 Establece a data de publicación (suponse que está na zona horaria local, a menos que se especifique explícitamente a zona horaria)
566 .UNINDENT
567 .INDENT 0.0
568 .TP
569 .B \-\-publisher
570 Establece o editor de libros electrónicos.
571 .UNINDENT
572 .INDENT 0.0
573 .TP
574 .B \-\-rating
575 Estabelecer a valoración. Debe ser un número entre 1 e 5.
576 .UNINDENT
577 .INDENT 0.0
578 .TP
579 .B \-\-read\-metadata\-from\-opf, \-\-from\-opf, \-m
580 Ler metadatos do ficheiro OPF especificado. Os metadatos destes ficheiro sobreescribiran calquera metadato do ficheiro de orixe.
581 .UNINDENT
582 .INDENT 0.0
583 .TP
584 .B \-\-series
585 Establece a serie á que pertence este libro electrónico.
586 .UNINDENT
587 .INDENT 0.0
588 .TP
589 .B \-\-series\-index
590 Estabelecer a posición que ocupa o libro nesta colectánea.
591 .UNINDENT
592 .INDENT 0.0
593 .TP
594 .B \-\-tags
595 Estabelecer etiquetas para o libro. Debe ser unha lista separada por comas.
596 .UNINDENT
597 .INDENT 0.0
598 .TP
599 .B \-\-timestamp
600 Establece a marca de tempo do libro (xa non se usa en ningún lugar)
601 .UNINDENT
602 .INDENT 0.0
603 .TP
604 .B \-\-title
605 Definir o título.
606 .UNINDENT
607 .INDENT 0.0
608 .TP
609 .B \-\-title\-sort
610 A versión do título que se usará para ordenación.
611 .UNINDENT
612 .SH DEPURACIÓN
613 .sp
614 Opción para axudar coa depuración da conversión
615 .INDENT 0.0
616 .TP
617 .B \-\-debug\-pipeline, \-d
618 Garda a saída das diferentes etapas da canalización de conversión no cartafol especificado. Útil se non está seguro en que fase do proceso de conversión se está a producir un erro.
619 .UNINDENT
620 .INDENT 0.0
621 .TP
622 .B \-\-verbose, \-v
623 Nivel de verbosidade. Especifique varias veces para unha maior verbosidade. Especificalo dúas veces dará lugar a unha verbosidade completa, unha vez media e cero veces a menos verbosidade.
624 .UNINDENT
625 .SH Author
626 Kovid Goyal
627 .SH Copyright
628 Kovid Goyal
629 .\" End of generated man page.