Debian Codegraph @

man-pages/es/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" "septiembre 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 archivo_entrada archivo_salida [opciones]
39 .EE
40 .UNINDENT
41 .UNINDENT
42 .sp
43 Convertir un libro electrónico de un formato a otro.
44 .sp
45 archivo_entrada es la entrada y archivo_salida es la salida. Deben indicarse ambos como los dos primeros argumentos de la orden.
46 .sp
47 El formato del libro electrónico de salida se define a partir de la extensión de archivo_salida. archivo_salida puede también tener el formato especial .EXT, donde EXT es la extensión del archivo de salida. En este caso, el nombre del archivo de salida se obtiene a partir del nombre del archivo de entrada. Tenga en cuenta que los nombres de archivo no deben comenzar con guión. Por último, si archivo_salida no tiene extensión, se interpreta como una carpeta y se generará un «open eBook» (OEB), formado por un conjunto de archivos HTML, en esa carpeta. Estos archivos son los que normalmente se habrían pasado al complemento de salida.
48 .sp
49 Tras especificar los archivos de entrada y salida, se puede personalizar la conversión indicando varias opciones. Las opciones disponibles dependen de los tipos de archivo de entrada y salida. Para obtener ayuda sobre estas opciones, especifique los nombres de archivo de entrada y salida y después use la opción \-h.
50 .sp
51 Para una documentación completa del sistema de conversión, véase
52 Conversión de libros \%<#\:conversion>
53 .sp
54 Cuando alguno de los argumentos de \fBebook\-convert\fP contenga espacios, póngalo entre comillas. Por ejemplo: \(dq/some path/with spaces\(dq
55 .sp
56 Las opciones y sus valores predeterminados cambian según los formatos de
57 entrada y salida, por lo que siempre se debe probar con:
58 .sp
59 ebook\-convert myfile.input_format myfile.output_format \-h
60 .sp
61 A continuación se muestran las opciones comunes a todas las conversiones,
62 seguidas de las opciones específicas para cada formato de entrada y salida.
63 .INDENT 0.0
64 .IP \(bu 2
65 OPCIONES DE ENTRADA
66 .IP \(bu 2
67 OPCIONES DE SALIDA
68 .IP \(bu 2
69 APARIENCIA
70 .IP \(bu 2
71 PROCESAMIENTO HEURÍSTICO
72 .IP \(bu 2
73 BUSCAR Y SUSTITUIR
74 .IP \(bu 2
75 DETECCIÓN DE ESTRUCTURA
76 .IP \(bu 2
77 ÍNDICE
78 .IP \(bu 2
79 METADATOS
80 .IP \(bu 2
81 DEPURACIÓN
82 .UNINDENT
83 .INDENT 0.0
84 .TP
85 .B \-\-help, \-h
86 mostrar este mensaje de ayuda y terminar
87 .UNINDENT
88 .INDENT 0.0
89 .TP
90 .B \-\-input\-profile
91 Especificar el perfil de entrada. El perfil de entrada provee información al sistema de conversión sobre cómo interpretar los distintos datos del documento de entrada. Por ejemplo, las longitudes dependientes de la resolución (en píxeles). Las opciones son: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900
92 .UNINDENT
93 .INDENT 0.0
94 .TP
95 .B \-\-list\-recipes
96 Mostrar una lista de fórmulas predefinidas. Puede crear un libro electrónico a partir de una fórmula predefinida de esta manera: ebook\-convert «Nombre de fórmula.recipe» salida.epub
97 .UNINDENT
98 .INDENT 0.0
99 .TP
100 .B \-\-output\-profile
101 Especificar el perfil de salida. El perfil de salida le dice al sistema de conversión cómo optimizar el documento creado para un dispositivo determinado. En algunos casos, es necesario un perfil de salida para generar documentos que funcionen en ciertos dispositivos, pero no suele ser necesario. Las opciones 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_hd, generic_eink_large
102 .UNINDENT
103 .INDENT 0.0
104 .TP
105 .B \-\-version
106 mostrar el número de versión del programa y terminar
107 .UNINDENT
108 .SH OPCIONES DE ENTRADA
109 .sp
110 Opciones para controlar el procesado del archivo de entrada mobi
111 .INDENT 0.0
112 .TP
113 .B \-\-input\-encoding
114 Especificar la codificación del documento de entrada. Esta opción tiene preferencia sobre la codificación que pueda declarar el propio documento. Es particularmente útil para documentos que no declaran ninguna codificación, o que lo hacen incorrectamente.
115 .UNINDENT
116 .SH OPCIONES DE SALIDA
117 .sp
118 Opciones para controlar el procesado de la salida epub
119 .INDENT 0.0
120 .TP
121 .B \-\-dont\-split\-on\-page\-breaks
122 Desactivar la división en los saltos de página. Normalmente los archivos de entrada se dividen automáticamente en dos archivos en cada salto de página. Esto genera un libro electrónico que se procesa más rápidamente y con menos recursos. Sin embargo, la división es un proceso lento y, si el archivo de entrada contiene muchos saltos de página, es mejor desactivar la división.
123 .UNINDENT
124 .INDENT 0.0
125 .TP
126 .B \-\-epub\-flatten
127 Esta opción es necesaria sólo si pretende usar el EPUB con FBReaderJ. Con esta opción se simplificará el sistema de archivos dentro del EPUB, poniendo todos los archivos en el nivel superior.
128 .UNINDENT
129 .INDENT 0.0
130 .TP
131 .B \-\-epub\-inline\-toc
132 Insertar un índice que aparecerá como parte del contenido principal del libro.
133 .UNINDENT
134 .INDENT 0.0
135 .TP
136 .B \-\-epub\-max\-image\-size
137 El tamaño máximo de la imagen (ancho x alto). Un valor de profile significa que se utiliza el tamaño de pantalla del perfil de salida. Un valor de none significa que no se especifica ningún tamaño máximo. Por ejemplo, un valor de 100x200 hará que todas las imágenes se redimensionen para que su anchura no sea superior a 100 píxeles y su altura no sea superior a 200 píxeles. Tenga en cuenta que esto sólo afecta al tamaño de los propios archivos de imagen. Cualquier imagen puede tener un tamaño diferente dependiendo del estilo que se le aplique en el documento.
138 .UNINDENT
139 .INDENT 0.0
140 .TP
141 .B \-\-epub\-toc\-at\-end
142 Colocar el índice insertado al final del libro en lugar de al principio.
143 .UNINDENT
144 .INDENT 0.0
145 .TP
146 .B \-\-epub\-version
147 La versión de EPUB del archivo que se genera. EPUB 2 es la más ampliamente compatible, use EPUB 3 sólo si sabe que lo necesita.
148 .UNINDENT
149 .INDENT 0.0
150 .TP
151 .B \-\-extract\-to
152 Extraer los contenidos del libro generado a la carpeta especificada. Los contenidos de la carpeta primero son eliminados, así que tenga cuidado.
153 .UNINDENT
154 .INDENT 0.0
155 .TP
156 .B \-\-flow\-size
157 Dividir todos los archivos HTML mayores de este tamaño (en kB). Esto es necesario porque algunos lectores ePub no pueden manejar archivos muy grandes. El valor predeterminado de 260KB es el tamaño requerido por Adobe Digital Editions. Establecer en 0 para desactivar la división por tamaño.
158 .UNINDENT
159 .INDENT 0.0
160 .TP
161 .B \-\-no\-default\-epub\-cover
162 Normalmente, si el archivo de entrada no tiene portada y no especifica una, se generará una portada con el título, autores, etc. Esta opción desactiva la generación de esta portada.
163 .UNINDENT
164 .INDENT 0.0
165 .TP
166 .B \-\-no\-svg\-cover
167 No usar SVG para la portada del libro. Use esta opción si el EPUB va a usarse en un dispositivo que no soporta SVG, como el iPhone o el JetBook Lite. Sin esta opción, dichos dispositivos mostrarán la portada como una página en blanco.
168 .UNINDENT
169 .INDENT 0.0
170 .TP
171 .B \-\-preserve\-cover\-aspect\-ratio
172 Cuando se utilice una portada con un archivo en formato SVG esta opción hace que la portada se escale para cubrir el área disponible de pantalla, pero conserva su relación de aspecto (la relación entre la anchura y la altura). Esto supone que puede haber márgenes blancos a los lados o arriba y abajo de la imagen, pero la imagen no se distorsionará. Sin esta opción la imagen puede distorsionarse ligeramente pero no tendrá margenes en blanco.
173 .UNINDENT
174 .INDENT 0.0
175 .TP
176 .B \-\-pretty\-print
177 Si se indica, el complemento de salida intentará crear una salida que sea lo más humanamente legible posible. Puede no tener ningún efecto sobre algunos complementos de salida.
178 .UNINDENT
179 .INDENT 0.0
180 .TP
181 .B \-\-toc\-title
182 Título para cualquier índice generado en el texto.
183 .UNINDENT
184 .SH APARIENCIA
185 .sp
186 Opciones para controlar el aspecto de la salida
187 .INDENT 0.0
188 .TP
189 .B \-\-asciiize
190 Transliterar caracteres Unicode a la representación ASCII. Tenga cuidado al usar esta opción, ya que reemplazará los caracteres Unicode con ASCII. Por ejemplo, sustituirá «Pelé» por «Pele». Tenga en cuenta también que en los casos en los que existen múltiples representaciones para un carácter determinado (por ejemplo, caracteres compartidos por la escritura china y japonesa) se usará la representación basada en el idioma de la interfaz de calibre.
191 .UNINDENT
192 .INDENT 0.0
193 .TP
194 .B \-\-base\-font\-size
195 Tamaño de letra base en pt. Todos los tamaños de letra en el libro generado se pondrán en relación a este tamaño. Si elige un tamaño mayor, hará que todas las letras de salida sean más grandes, o al contrario. De manera predeterminada, cuando el valor es cero, el tamaño de letra base se decide basándose en el perfil de salida seleccionado.
196 .UNINDENT
197 .INDENT 0.0
198 .TP
199 .B \-\-change\-justification
200 Cambiar la justificación del texto. El valor «left» hace que el texto justificado en el origen quede alineado a la izquierda (no justificado). El valor «justify» hace que el texto no justificado quede justificado. El valor «original» (el predeterminado) no altera la justificación del archivo de origen. Tenga en cuenta que no todos los formatos de salida admiten justificación.
201 .UNINDENT
202 .INDENT 0.0
203 .TP
204 .B \-\-disable\-font\-rescaling
205 Desactivar el redimensionado de los tamaños de letra.
206 .UNINDENT
207 .INDENT 0.0
208 .TP
209 .B \-\-embed\-all\-fonts
210 Incrustar todos los tipos de letra referenciados en el documento de entrada pero no incrustados todavía. Esta opción buscará en el sistema los tipos de letra y, si se encuentran, se incrustarán. La incrustación sólo funciona si el formato al que se convierte admite tipos de letra incrustados, como EPUB, AZW3, DOCX o PDF. Asegúrese de tener una licencia adecuada para incrustar los tipos de letras usados en el documento.
211 .UNINDENT
212 .INDENT 0.0
213 .TP
214 .B \-\-embed\-font\-family
215 Incrustar el tipo de letra especificado en el libro. Esto establece el tipo de letra «base» utilizado en el libro. Si el documento de entrada especifica sus propios tipos de letra, pueden tener prioridad sobre este tipo de letra base. Puede usar la opción de filtrar estilos para eliminar tipos de letra del documento de entrada. Tenga en cuenta que la incrustación de tipos de letra sólo funciona con algunos formatos de salida, principalmente EPUB, AZW3 y DOCX.
216 .UNINDENT
217 .INDENT 0.0
218 .TP
219 .B \-\-expand\-css
220 De manera predeterminada, calibre usa una forma abreviada para algunas propiedades CSS como «margin», «padding», «border», etc. Esta opción hace que se use la forma expandida completa en su lugar. Tenga en cuenta que el CSS siempre se expande cuando se generan archivos EPUB con uno de los perfiles de salida para Nook, ya que los lectores Nook no admiten CSS abreviado.
221 .UNINDENT
222 .INDENT 0.0
223 .TP
224 .B \-\-extra\-css
225 La ruta a una hoja de estilo CSS o CSS en bruto. Esta hoja de estilo CSS se agregará a las reglas de estilo del archivo de origen, por lo que puede usarse para anular dichas reglas.
226 .UNINDENT
227 .INDENT 0.0
228 .TP
229 .B \-\-filter\-css
230 Una lista de propiedades CSS, separadas por comas, que se eliminarán de todas las reglas de estilo CSS. Esto es útil si hay alguna información de estilo que hace que no se pueda cambiar en algún dispositivo. Por ejemplo: font\-family,color,margin\-left,margin\-right
231 .UNINDENT
232 .INDENT 0.0
233 .TP
234 .B \-\-font\-size\-mapping
235 Correspondencia entre los tamaños de letra de CSS y tamaños en pt. Un ejemplo podría ser 12, 12, 14, 16, 18, 20, 22, 24. Éstas son las correspondencias para los tamaños de xx\-small a xx\-large, y el último tamaño para letras enormes. El algoritmo para ampliar o reducir el texto emplea estos tamaños para determinar el tamaño de letra de manera inteligente. El comportamiento predeterminado es usar una correspondencia basada en el perfil de salida seleccionado.
236 .UNINDENT
237 .INDENT 0.0
238 .TP
239 .B \-\-insert\-blank\-line
240 Insertar una línea en blanco entre párrafos. No funcionará si el archivo de origen no define párrafos (etiquetas <p> o <div>).
241 .UNINDENT
242 .INDENT 0.0
243 .TP
244 .B \-\-insert\-blank\-line\-size
245 Establece la altura de las líneas en blanco que se insertan (en unidades em). La altura de las líneas entre los párrafos será el doble del valor que se introduzca aquí.
246 .UNINDENT
247 .INDENT 0.0
248 .TP
249 .B \-\-keep\-ligatures
250 Mantener las ligaduras presentes en el documento de entrada. Una ligadura es un carácter combinado para secuencia de caracteres como ff, fi, ffl, etc. La mayoría de los lectores no soportan ligaduras en sus tipos de letra predeterminados, por lo que no pueden mostrarlas correctamente. De manera predeterminada, calibre convertirá una ligadura en sus caracteres separados. Tenga en cuenta que esta opción se refiere únicamente a las ligaduras Unicode, no a las creadas mediante CSS o estilos de tipo de letra. Por el contrario, seleccionar esta opción las mantendrá.
251 .UNINDENT
252 .INDENT 0.0
253 .TP
254 .B \-\-line\-height
255 Altura de línea en pt. Controla el espacio entre líneas consecutivas de texto. Sólo se aplica a elementos que no definen su propia altura de línea. En la mayoría de los casos, la opción de altura de línea mínima es más útil. De manera predeterminada no se modifica la altura de línea.
256 .UNINDENT
257 .INDENT 0.0
258 .TP
259 .B \-\-linearize\-tables
260 Algunos documentos mal diseñados usan tablas para controlar la disposición del texto en la página. Cuando se convierten estos documentos suelen dar lugar a texto que se sale de la página y otros problemas. Esta opción extrae el contenido de las tablas y lo presenta de manera lineal.
261 .UNINDENT
262 .INDENT 0.0
263 .TP
264 .B \-\-margin\-bottom
265 Establecer el margen inferior en pt. El valor predeterminado es 5.0. Un número negativo desactiva esta opción (se mantendrá el margen existente en el documento original). Nota: Los formatos basados en páginas, como PDF y DOCX tienen sus propias configuraciones de margen que tienen prioridad.
266 .UNINDENT
267 .INDENT 0.0
268 .TP
269 .B \-\-margin\-left
270 Establecer el margen izquierdo en pt. El valor predeterminado es 5.0. Un número negativo desactiva esta opción (se mantendrá el margen existente en el documento original). Nota: Los formatos basados en páginas, como PDF y DOCX tienen sus propias configuraciones de margen que tienen prioridad.
271 .UNINDENT
272 .INDENT 0.0
273 .TP
274 .B \-\-margin\-right
275 Establecer el margen derecho en pt. El valor predeterminado es 5.0. Un número negativo desactiva esta opción (se mantendrá el margen existente en el documento original). Nota: Los formatos basados en páginas, como PDF y DOCX tienen sus propias configuraciones de margen que tienen prioridad.
276 .UNINDENT
277 .INDENT 0.0
278 .TP
279 .B \-\-margin\-top
280 Establecer el margen superior en pt. El valor predeterminado es 5.0. Un número negativo desactiva esta opción (se mantendrá el margen existente en el documento original). Nota: Los formatos basados en páginas, como PDF y DOCX tienen sus propias configuraciones de margen que tienen prioridad.
281 .UNINDENT
282 .INDENT 0.0
283 .TP
284 .B \-\-minimum\-line\-height
285 La altura mínima de la línea, como porcentaje del tamaño de letra calculado para el elemento. calibre se asegurará de que cada elemento tenga esta altura de línea como mínimo, a pesar de lo que indique el documento de entrada. Asignar 0 para desactivar. El valor predeterminado es 120%. Utilice esta opción preferentemente a la especificación directa de la altura de línea, a menos que sepa lo que está haciendo. Por ejemplo, puede conseguir texto «doble espaciado» asignándole un valor de 240.
286 .UNINDENT
287 .INDENT 0.0
288 .TP
289 .B \-\-remove\-paragraph\-spacing
290 Eliminar el espacio entre párrafos. También establece sangrado en cada párrafo de 1,5em. La eliminación del espacio no funciona si el archivo de origen no define párrafos (etiquetas <p> o <div>).
291 .UNINDENT
292 .INDENT 0.0
293 .TP
294 .B \-\-remove\-paragraph\-spacing\-indent\-size
295 Cuando calibre elimina las líneas en blanco entre párrafos, automáticamente establece una sangría para que se distingan bien los párrafos. Esta opción controla la anchura de esta sangría (en unidades em). Si asigna un valor negativo se usará la sangría especificada en el documento de entrada, es decir, calibre no cambia la sangría.
296 .UNINDENT
297 .INDENT 0.0
298 .TP
299 .B \-\-smarten\-punctuation
300 Convierte comillas rectas, rayas y puntos suspensivos en sus equivalentes tipográficos correctos. Para más detalles, véase \%<https://\:daringfireball\:.net/\:projects/\:smartypants>\&.
301 .UNINDENT
302 .INDENT 0.0
303 .TP
304 .B \-\-subset\-embedded\-fonts
305 Reducir caracteres en todos los tipos de letra incrustados. Cada tipo de letra incrustado se recorta para que contenga sólo los caracteres que se usan en el documento. Esto reduce el tamaño de los archivos de tipo de letra. Resulta útil si incrusta un tipo de letra particularmente extenso con muchos caracteres sin usar.
306 .UNINDENT
307 .INDENT 0.0
308 .TP
309 .B \-\-transform\-css\-rules
310 Ruta al archivo que contiene las reglas para transformar los estilos CSS de este libro. La manera más fácil de crear dicho archivo es usar el asistente para creación de reglas en la interfaz gráfica de calibre. Se accede a él en la sección «Apariencia > Transformar estilos» del cuadro de diálogo de conversión. Una vez creadas las reglas, se puede usar el botón «Exportar» para guardarlas en un archivo.
311 .UNINDENT
312 .INDENT 0.0
313 .TP
314 .B \-\-transform\-html\-rules
315 Ruta al archivo que contiene las reglas para transformar el HTML de este libro. La manera más fácil de crear dicho archivo es usar el asistente para creación de reglas en la interfaz gráfica de calibre. Se accede a él en la sección «Apariencia > Transformar HTML» del cuadro de diálogo de conversión. Una vez creadas las reglas, se puede usar el botón «Exportar» para guardarlas en un archivo.
316 .UNINDENT
317 .INDENT 0.0
318 .TP
319 .B \-\-unsmarten\-punctuation
320 Convertir comillas, raya y puntos suspensivos tipográficos a sus equivalentes más simples.
321 .UNINDENT
322 .SH PROCESAMIENTO HEURÍSTICO
323 .sp
324 Modificar el texto y estructura del documento usando patrones comunes. Desactivado de manera predeterminada. Use \-\-enable\-heuristics para activarlo. Las acciones individuales pueden desactivarse con las opciones \-\-disable\-
325 .nf
326 *
327 .fi
328 \&.
329 .INDENT 0.0
330 .TP
331 .B \-\-disable\-dehyphenate
332 Analizar las palabras con guión en todo el documento. El propio documento se utiliza como un diccionario para determinar si cada guión debe mantenerse o eliminarse.
333 .UNINDENT
334 .INDENT 0.0
335 .TP
336 .B \-\-disable\-delete\-blank\-paragraphs
337 Eliminar los párrafos vacíos del documento cuando existen entre otros párrafos
338 .UNINDENT
339 .INDENT 0.0
340 .TP
341 .B \-\-disable\-fix\-indents
342 Convertir los sangrías creados a partir de varios espacios duros en sangrados en código CSS.
343 .UNINDENT
344 .INDENT 0.0
345 .TP
346 .B \-\-disable\-format\-scene\-breaks
347 Los marcadores de salto de escena alineados a la izquierda se centrarán. Los saltos de escena con múltiples líneas en blanco se sustituirán por líneas horizontales.
348 .UNINDENT
349 .INDENT 0.0
350 .TP
351 .B \-\-disable\-italicize\-common\-cases
352 Buscar palabras y patrones que denotan cursiva y ponerlos en cursiva.
353 .UNINDENT
354 .INDENT 0.0
355 .TP
356 .B \-\-disable\-markup\-chapter\-headings
357 Detectar cabeceras y subcabeceras de capítulos sin formato y convertirlas en etiquetas h2 y h3. Esta configuración no creará un índice, pero se puede utilizar junto con la detección de estructura para crear uno.
358 .UNINDENT
359 .INDENT 0.0
360 .TP
361 .B \-\-disable\-renumber\-headings
362 Busca secuencias de etiquetas <h1> o <h2>. Las etiquetas se renumeran para evitar la división en el medio de una cabecera de capítulo.
363 .UNINDENT
364 .INDENT 0.0
365 .TP
366 .B \-\-disable\-unwrap\-lines
367 Unir líneas basándose en la puntuación y otros indicios de formato.
368 .UNINDENT
369 .INDENT 0.0
370 .TP
371 .B \-\-enable\-heuristics
372 Activar el procesado heurístico. Esta opción debe estar activada para que se pueda realizar cualquier tipo de procesado heurístico.
373 .UNINDENT
374 .INDENT 0.0
375 .TP
376 .B \-\-html\-unwrap\-factor
377 Escala utilizada para determinar la longitud a la cual una línea debe unirse a otra línea. Los valores válidos son números decimales entre 0 y 1. El valor predeterminado es 0.4, un poco menos de la mitad de la línea. Si sólo unas pocas líneas del documento necesitan unirse, debería reducir el valor
378 .UNINDENT
379 .INDENT 0.0
380 .TP
381 .B \-\-replace\-scene\-breaks
382 Sustituir saltos de escena por el texto especificado. De manera predeterminada se usa el texto existente en el documento de entrada.
383 .UNINDENT
384 .SH BUSCAR Y SUSTITUIR
385 .sp
386 Modificar el texto y la estructura del documento utilizando patrones definidos por el usuario.
387 .INDENT 0.0
388 .TP
389 .B \-\-search\-replace
390 Ruta a un archivo que contiene expresiones regulares de búsqueda y sustitución. El archivo debe contener líneas alternas de expresiones regulares seguidas por patrones de sustitución (que pueden ser líneas en blanco). La expresión regular debe ajustarse a la sintaxis de expresiones regulares de Python y el archivo debe estar codificado como UTF\-8.
391 .UNINDENT
392 .INDENT 0.0
393 .TP
394 .B \-\-sr1\-replace
395 Texto de sustitución para el texto encontrado con sr1\-search.
396 .UNINDENT
397 .INDENT 0.0
398 .TP
399 .B \-\-sr1\-search
400 Patrón de búsqueda (expresión regular) que se sustituirá por sr1\-replace.
401 .UNINDENT
402 .INDENT 0.0
403 .TP
404 .B \-\-sr2\-replace
405 Texto de sustitución para el texto encontrado con sr2\-search.
406 .UNINDENT
407 .INDENT 0.0
408 .TP
409 .B \-\-sr2\-search
410 Patrón de búsqueda (expresión regular) que se sustituirá por sr2\-replace.
411 .UNINDENT
412 .INDENT 0.0
413 .TP
414 .B \-\-sr3\-replace
415 Texto de sustitución para el texto encontrado con sr3\-search.
416 .UNINDENT
417 .INDENT 0.0
418 .TP
419 .B \-\-sr3\-search
420 Patrón de búsqueda (expresión regular) que será sustituida por sr3\-replace.
421 .UNINDENT
422 .SH DETECCIÓN DE ESTRUCTURA
423 .sp
424 Control de autodetección de estructura de documento.
425 .INDENT 0.0
426 .TP
427 .B \-\-add\-alt\-text\-to\-img
428 Cuando una etiqueta <img> no tiene atributo «alt», se comprueba si el archivo de imagen asociado tiene metadatos que especifiquen el texto alternativo y se usa para completar el atributo «alt». El atributo «alt» mejora la accesibilidad proporcionando una descripción textual para los usuarios que no pueden ver o interpretar por completo el contenido visual.
429 .UNINDENT
430 .INDENT 0.0
431 .TP
432 .B \-\-chapter
433 Expresión XPath para detectar títulos de capítulo. El comportamiento predeterminado es considerar como títulos de capítulo las etiquetas <h1> o <h2> que contengan las palabras «chapter», «book», «section», «prologue», «epilogue» o «part», así como cualquier etiqueta que tenga class=\fB\(dq\fPchapter\fB\(dq\fP\&. La expresión debe dar como resultado una lista de elementos. Para desactivar la detección de capítulos use la expresión «/». Véase el Cursillo de XPath en el Manual de usuario de calibre para obtener más ayuda sobre el uso de esta opción.
434 .UNINDENT
435 .INDENT 0.0
436 .TP
437 .B \-\-chapter\-mark
438 Especificar cómo marcar los capítulos detectados. Con el valor «pagebreak», se insertará un salto de página antes de cada capítulo; con «rule» se insertará una línea antes de cada capítulo; con «both» se marcarán los capítulos con un salto de página y una línea; con «none» se deshabilitará el marcado de capítulos.
439 .UNINDENT
440 .INDENT 0.0
441 .TP
442 .B \-\-disable\-remove\-fake\-margins
443 Algunos documentos especifican los márgenes de página añadiendo márgenes a la izquierda y derecha de cada párrafo, calibre intentará detectar y eliminar estos márgenes. A veces esto puede ocasionar que se eliminen márgenes que deberían mantenerse. En tal caso, puede desactivar la eliminación.
444 .UNINDENT
445 .INDENT 0.0
446 .TP
447 .B \-\-insert\-metadata
448 Incluir los metadatos al principio del libro. Útil para lectores de libros electrónicos que no manejan los metadatos directamente.
449 .UNINDENT
450 .INDENT 0.0
451 .TP
452 .B \-\-page\-breaks\-before
453 Una expresión XPath. Se insertan saltos de página antes de los elementos especificados. Para desactivarlo use la expresión: /
454 .UNINDENT
455 .INDENT 0.0
456 .TP
457 .B \-\-prefer\-metadata\-cover
458 Usar preferentemente la portada detectada en el archivo de origen en vez de la portada especificada.
459 .UNINDENT
460 .INDENT 0.0
461 .TP
462 .B \-\-remove\-first\-image
463 Eliminar la primera imagen del libro de entrada. Es útil si el documento de entrada tiene una imagen de portada no identificada como tal. En tal caso, si asigna una portada en calibre, el documento de salida tendrá dos imágenes de portada si no activa esta opción.
464 .UNINDENT
465 .INDENT 0.0
466 .TP
467 .B \-\-start\-reading\-at
468 Una expresión XPath para detectar dónde debe comenzar la lectura del documento. Algunos programas de lectura de libros electrónicos (entre ellos el Kindle) usan esta ubicación como la posición desde donde iniciar el libro. Lea el tutorial Xpath en el Manual de usuario de calibre para obtener mayor información acerca de esta función.
469 .UNINDENT
470 .SH ÍNDICE
471 .sp
472 Controla la generación automática del índice. De manera predeterminada, si el archivo de entrada tiene un Índice, se usará éste en lugar del generado automáticamente.
473 .INDENT 0.0
474 .TP
475 .B \-\-duplicate\-links\-in\-toc
476 Al crear un índice a partir de enlaces en el documento de entrada, permitir entradas duplicadas, es decir, permitir más de una entrada con el mismo texto, siempre que apunten a diferentes partes del texto.
477 .UNINDENT
478 .INDENT 0.0
479 .TP
480 .B \-\-level1\-toc
481 Expresión XPath que especifica todas las etiquetas que deben añadirse en el primer nivel del índice. Si se indica, tiene prioridad sobre otras formas de autodetección. Pueden encontrarse algunos ejemplos en el Cursillo de XPath en el Manual de usuario de calibre.
482 .UNINDENT
483 .INDENT 0.0
484 .TP
485 .B \-\-level2\-toc
486 Expresión XPath que especifica todas las etiquetas que deben añadirse en el segundo nivel del índice. Cada entrada se añade bajo la entrada previa del nivel uno. Pueden encontrarse algunos ejemplos en el Cursillo de XPath en el Manual de usuario de calibre.
487 .UNINDENT
488 .INDENT 0.0
489 .TP
490 .B \-\-level3\-toc
491 Expresión XPath que especifica todas las etiquetas que deben añadirse en el tercer nivel del índice. Cada entrada se añade bajo la entrada previa del nivel dos. Pueden encontrarse algunos ejemplos en el Cursillo de XPath en el Manual de usuario de calibre.
492 .UNINDENT
493 .INDENT 0.0
494 .TP
495 .B \-\-max\-toc\-links
496 Número máximo de enlaces a incluir dentro del índice. El valor 0 desactiva esta opción. Valor predeterminado: 50. Los enlaces sólo se agregan al índice si se deteca un número de capítulos menor que el umbral específicado.
497 .UNINDENT
498 .INDENT 0.0
499 .TP
500 .B \-\-no\-chapters\-in\-toc
501 No añadir los capitulos autodetectados al índice.
502 .UNINDENT
503 .INDENT 0.0
504 .TP
505 .B \-\-toc\-filter
506 Eliminar entradas del índice cuyos títulos se corresponden con la expresión regular especificada. Las entradas marcadas y todas sus ramas son eliminadas.
507 .UNINDENT
508 .INDENT 0.0
509 .TP
510 .B \-\-toc\-threshold
511 Si se detectan menos capítulos que este número, entonces se añaden enlaces al índice. Valor predeterminado: 6
512 .UNINDENT
513 .INDENT 0.0
514 .TP
515 .B \-\-use\-auto\-toc
516 Normalmente, si el archivo de origen tiene un índice, se usa éste en vez del autogenerado. Con esta opción siempre se usará el autogenerado.
517 .UNINDENT
518 .SH METADATOS
519 .sp
520 Opciones para asignar metadatos en la salida
521 .INDENT 0.0
522 .TP
523 .B \-\-author\-sort
524 Texto que se usará para ordenar por autor.
525 .UNINDENT
526 .INDENT 0.0
527 .TP
528 .B \-\-authors
529 Establecer autores. Si hay varios autores deben separarse por «&».
530 .UNINDENT
531 .INDENT 0.0
532 .TP
533 .B \-\-book\-producer
534 Establecer el productor del libro.
535 .UNINDENT
536 .INDENT 0.0
537 .TP
538 .B \-\-comments
539 Establecer la descripción del libro.
540 .UNINDENT
541 .INDENT 0.0
542 .TP
543 .B \-\-cover
544 Establecer como portada el archivo o URL especificado
545 .UNINDENT
546 .INDENT 0.0
547 .TP
548 .B \-\-isbn
549 Establecer el ISBN del libro.
550 .UNINDENT
551 .INDENT 0.0
552 .TP
553 .B \-\-language
554 Establecer el idioma.
555 .UNINDENT
556 .INDENT 0.0
557 .TP
558 .B \-\-pubdate
559 Establecer la fecha de publicación (se supone la zona horaria actual, a menos que se especifique otra zona horaria)
560 .UNINDENT
561 .INDENT 0.0
562 .TP
563 .B \-\-publisher
564 Establecer la editorial del libro.
565 .UNINDENT
566 .INDENT 0.0
567 .TP
568 .B \-\-rating
569 Establecer la calificación. Debe ser un número entre 1 y 5.
570 .UNINDENT
571 .INDENT 0.0
572 .TP
573 .B \-\-read\-metadata\-from\-opf, \-\-from\-opf, \-m
574 Leer metadatos del archivo OPF especificado. Los metadatos leídos de este archivo anularán cualquier metadato que haya en el archivo de origen.
575 .UNINDENT
576 .INDENT 0.0
577 .TP
578 .B \-\-series
579 Establecer la serie a la que pertenece el libro.
580 .UNINDENT
581 .INDENT 0.0
582 .TP
583 .B \-\-series\-index
584 Establecer la posición del libro en esta serie.
585 .UNINDENT
586 .INDENT 0.0
587 .TP
588 .B \-\-tags
589 Establecer etiquetas para el libro. Debe ser una lista separada por comas.
590 .UNINDENT
591 .INDENT 0.0
592 .TP
593 .B \-\-timestamp
594 Establecer la fecha y hora del libro (ya no se usa)
595 .UNINDENT
596 .INDENT 0.0
597 .TP
598 .B \-\-title
599 Establecer el título.
600 .UNINDENT
601 .INDENT 0.0
602 .TP
603 .B \-\-title\-sort
604 La versión del título que se usará para ordenar.
605 .UNINDENT
606 .SH DEPURACIÓN
607 .sp
608 Opciones para ayudar con la depuración de la conversión
609 .INDENT 0.0
610 .TP
611 .B \-\-debug\-pipeline, \-d
612 Guardar la salida de las distintas etapas del proceso de conversión en la carpeta especificada. Útil si no está seguro de en qué punto del proceso de conversión está ocurriendo un error.
613 .UNINDENT
614 .INDENT 0.0
615 .TP
616 .B \-\-verbose, \-v
617 Nivel de detalles. Emplear varias veces para obtener más detalles. Si se emplea dos veces se mostrarán todos los detalles, con una vez se mostrarán detalles intermedios y si no se emplea los detalles serán mínimos.
618 .UNINDENT
619 .SH Author
620 Kovid Goyal
621 .SH Copyright
622 Kovid Goyal
623 .\" End of generated man page.