EBOOK-CONVERT(1) calibre EBOOK-CONVERT(1) NAME ebook-convert - ebook-convert ebook-convert archivo_entrada archivo_salida [opciones] Convertir un libro electronico de un formato a otro. archivo_entrada es la entrada y archivo_salida es la salida. Deben indicarse ambos como los dos primeros argumentos de la orden. El formato del libro electronico de salida se define a partir de la extension de archivo_salida. archivo_salida puede tambien tener el formato especial .EXT, donde EXT es la extension 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 guion. Por ultimo, si archivo_salida no tiene extension, se interpreta como una carpeta y se generara un <> (OEB), formado por un conjunto de archivos HTML, en esa carpeta. Estos archivos son los que normalmente se habrian pasado al complemento de salida. Tras especificar los archivos de entrada y salida, se puede personalizar la conversion 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 despues use la opcion -h. Para una documentacion completa del sistema de conversion, vease Conversion de libros Cuando alguno de los argumentos de ebook-convert contenga espacios, pongalo entre comillas. Por ejemplo: "/some path/with spaces" Las opciones y sus valores predeterminados cambian segun los formatos de entrada y salida, por lo que siempre se debe probar con: ebook-convert myfile.input_format myfile.output_format -h A continuacion se muestran las opciones comunes a todas las conversiones, seguidas de las opciones especificas para cada formato de entrada y salida. o OPCIONES DE ENTRADA o OPCIONES DE SALIDA o APARIENCIA o PROCESADO HEURISTICO o BUSCAR Y SUSTITUIR o DETECCION DE ESTRUCTURA o INDICE o METADATOS o DEPURACION --help, -h mostrar este mensaje de ayuda y terminar --input-profile Especificar el perfil de entrada. El perfil de entrada provee informacion al sistema de conversion sobre como interpretar los distintos datos del documento de entrada. Por ejemplo, las longitudes dependientes de la resolucion (en pixeles). Las opciones son: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900 --list-recipes Mostrar una lista de formulas predefinidas. Puede crear un libro electronico a partir de una formula predefinida de esta manera: ebook-convert <> salida.epub --output-profile Especificar el perfil de salida. El perfil de salida le dice al sistema de conversion como 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 --version mostrar el numero de version del programa y terminar OPCIONES DE ENTRADA Opciones para controlar el procesado del archivo de entrada mobi --input-encoding Especificar la codificacion del documento de entrada. Esta opcion tiene preferencia sobre la codificacion que pueda declarar el propio documento. Es particularmente util para documentos que no declaran ninguna codificacion, o que lo hacen incorrectamente. OPCIONES DE SALIDA Opciones para controlar el procesado de la salida epub --dont-split-on-page-breaks Desactivar la division en los saltos de pagina. Normalmente los archivos de entrada se dividen automaticamente en dos archivos en cada salto de pagina. Esto genera un libro electronico que se procesa mas rapidamente y con menos recursos. Sin embargo, la division es un proceso lento y, si el archivo de entrada contiene muchos saltos de pagina, es mejor desactivar la division. --epub-flatten Esta opcion es necesaria solo si pretende usar el EPUB con FBReaderJ. Con esta opcion se simplificara el sistema de archivos dentro del EPUB, poniendo todos los archivos en el nivel superior. --epub-inline-toc Insertar un indice que aparecera como parte del contenido principal del libro. --epub-max-image-size El tamano maximo de la imagen (ancho x alto). Un valor de none significa que se utiliza el tamano de pantalla del perfil de salida. Un valor de profile significa que no se especifica ningun tamano maximo. Por ejemplo, un valor de 100x200 hara que todas las imagenes se redimensionen para que su anchura no sea superior a 100 pixeles y su altura no sea superior a 200 pixeles. Tenga en cuenta que esto solo afecta al tamano de los propios archivos de imagen. Cualquier imagen puede tener un tamano diferente dependiendo del estilo que se le aplique en el documento. --epub-toc-at-end Colocar el indice insertado al final del libro en lugar de al principio. --epub-version La version de EPUB del archivo que se genera. EPUB 2 es la mas ampliamente compatible, use EPUB 3 solo si sabe que lo necesita. --extract-to Extraer los contenidos del archivo generado EPUB a la carpeta especificada. Los contenidos de la carpeta primero son eliminados, asi que tenga cuidado. --flow-size Dividir todos los archivos HTML mayores de este tamano (en kB). Esto es necesario porque algunos lectores ePub no pueden manejar archivos muy grandes. El valor predeterminado de 260KB es el tamano requerido por Adobe Digital Editions. Establecer en 0 para desactivar la division por tamano. --no-default-epub-cover Normalmente, si el archivo de entrada no tiene portada y no especifica una, se generara una portada con el titulo, autores, etc. Esta opcion desactiva la generacion de esta portada. --no-svg-cover No usar SVG para la portada del libro. Use esta opcion si el EPUB va a usarse en un dispositivo que no soporta SVG, como el iPhone o el JetBook Lite. Sin esta opcion, dichos dispositivos mostraran la portada como una pagina en blanco. --preserve-cover-aspect-ratio Cuando se utilice una portada con un archivo en formato SVG esta opcion hace que la portada se escale para cubrir el area disponible de pantalla, pero conserva su relacion de aspecto (la relacion entre la anchura y la altura). Esto supone que puede haber margenes blancos a los lados o arriba y abajo de la imagen, pero la imagen no se distorsionara. Sin esta opcion la imagen puede distorsionarse ligeramente pero no tendra margenes en blanco. --pretty-print Si se indica, el complemento de salida intentara crear una salida que sea lo mas humanamente legible posible. Puede no tener ningun efecto sobre algunos complementos de salida. --toc-title Titulo para cualquier indice generado en el texto. APARIENCIA Opciones para controlar el aspecto de la salida --asciiize Transliterar caracteres Unicode a la representacion ASCII. Tenga cuidado al usar esta opcion, ya que reemplazara los caracteres Unicode con ASCII. Por ejemplo, sustituira <> por <>. Tenga en cuenta tambien que en los casos en los que existen multiples representaciones para un caracter determinado (por ejemplo, caracteres compartidos por la escritura china y japonesa) se usara la representacion basada en el idioma de la interfaz de calibre. --base-font-size Tamano de letra base en pt. Todos los tamanos de letra en el libro generado se pondran en relacion a este tamano. Si elige un tamano mayor, hara que todas las letras de salida sean mas grandes, o al contrario. De manera predeterminada, cuando el valor es cero, el tamano de letra base se decide basandose en el perfil de salida seleccionado. --change-justification Cambiar la justificacion del texto. El valor <> hace que el texto justificado en el origen quede alineado a la izquierda (no justificado). El valor <> hace que el texto no justificado quede justificado. El valor <> (el predeterminado) no altera la justificacion del archivo de origen. Tenga en cuenta que no todos los formatos de salida admiten justificacion. --disable-font-rescaling Desactivar el redimensionado de los tamanos de letra. --embed-all-fonts Incrustar todos los tipos de letra referenciados en el documento de entrada pero no incrustados todavia. Esta opcion buscara en el sistema los tipos de letra y, si se encuentran, se incrustaran. La incrustacion solo funciona si el formato al que se convierte admite tipos de letra incrustados, como EPUB, AZW3, DOCX o PDF. Asegurese de tener una licencia adecuada para incrustar los tipos de letras usados en el documento. --embed-font-family Incrustar el tipo de letra especificado en el libro. Esto establece el tipo de letra <> 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 opcion de filtrar estilos para eliminar tipos de letra del documento de entrada. Tenga en cuenta que la incrustacion de tipos de letra solo funciona con algunos formatos de salida, principalmente EPUB, AZW3 y DOCX. --expand-css De manera predeterminada, calibre usa una forma abreviada para algunas propiedades CSS como <>, <>, <>, etc. Esta opcion 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. --extra-css La ruta a una hoja de estilo CSS o CSS en bruto. Esta hoja de estilo CSS se agregara a las reglas de estilo del archivo de origen, por lo que puede usarse para anular dichas reglas. --filter-css Una lista de propiedades CSS, separadas por comas, que se eliminaran de todas las reglas de estilo CSS. Esto es util si hay alguna informacion de estilo que hace que no se pueda cambiar en algun dispositivo. Por ejemplo: font-family,color,margin-left,margin-right --font-size-mapping Correspondencia entre los tamanos de letra de CSS y tamanos en pt. Un ejemplo podria ser 12, 12, 14, 16, 18, 20, 22, 24. Estas son las correspondencias para los tamanos de xx-small a xx-large, y el ultimo tamano para letras enormes. El algoritmo para ampliar o reducir el texto emplea estos tamanos para determinar el tamano de letra de manera inteligente. El comportamiento predeterminado es usar una correspondencia basada en el perfil de salida seleccionado. --insert-blank-line Insertar una linea en blanco entre parrafos. No funcionara si el archivo de origen no define parrafos (etiquetas

o

). --insert-blank-line-size Establece la altura de las lineas en blanco que se insertan (en unidades em). La altura de las lineas entre los parrafos sera el doble del valor que se introduzca aqui. --keep-ligatures Mantener las ligaduras presentes en el documento de entrada. Una ligadura es una forma especial de escribir una secuencia de caracteres como ff, fi, ffl, etc. La mayoria de los lectores no soportan ligaduras en sus tipos de letra predeterminados, por lo que no pueden mostrarlas correctamente. De manera predeterminada, calibre convertira una ligadura en sus caracteres separados. Por el contrario, seleccionar esta opcion las mantendra. --line-height Altura de linea en pt. Controla el espacio entre lineas consecutivas de texto. Solo se aplica a elementos que no definen su propia altura de linea. En la mayoria de los casos, la opcion de altura de linea minima es mas util. De manera predeterminada no se modifica la altura de linea. --linearize-tables Algunos documentos mal disenados usan tablas para controlar la disposicion del texto en la pagina. Cuando se convierten estos documentos suelen dar lugar a texto que se sale de la pagina y otros problemas. Esta opcion extrae el contenido de las tablas y lo presenta de manera lineal. --margin-bottom Establecer el margen inferior en pt. El valor predeterminado es 5.0. Un numero negativo desactiva esta opcion (se mantendra el margen existente en el documento original). Nota: Los formatos basados en paginas, como PDF y DOCX tienen sus propias configuraciones de margen que tienen prioridad. --margin-left Establecer el margen izquierdo en pt. El valor predeterminado es 5.0. Un numero negativo desactiva esta opcion (se mantendra el margen existente en el documento original). Nota: Los formatos basados en paginas, como PDF y DOCX tienen sus propias configuraciones de margen que tienen prioridad. --margin-right Establecer el margen derecho en pt. El valor predeterminado es 5.0. Un numero negativo desactiva esta opcion (se mantendra el margen existente en el documento original). Nota: Los formatos basados en paginas, como PDF y DOCX tienen sus propias configuraciones de margen que tienen prioridad. --margin-top Establecer el margen superior en pt. El valor predeterminado es 5.0. Un numero negativo desactiva esta opcion (se mantendra el margen existente en el documento original). Nota: Los formatos basados en paginas, como PDF y DOCX tienen sus propias configuraciones de margen que tienen prioridad. --minimum-line-height La altura minima de la linea, como porcentaje del tamano de letra calculado para el elemento. calibre se asegurara de que cada elemento tenga esta altura de linea como minimo, a pesar de lo que indique el documento de entrada. Asignar 0 para desactivar. El valor predeterminado es 120%. Utilice esta opcion preferentemente a la especificacion directa de la altura de linea, a menos que sepa lo que esta haciendo. Por ejemplo, puede conseguir texto <> asignandole un valor de 240. --remove-paragraph-spacing Eliminar el espacio entre parrafos. Tambien establece sangrado en cada parrafo de 1,5em. La eliminacion del espacio no funciona si el archivo de origen no define parrafos (etiquetas

o

). --remove-paragraph-spacing-indent-size Cuando calibre elimina las lineas en blanco entre parrafos, automaticamente establece una sangria para que se distingan bien los parrafos. Esta opcion controla la anchura de esta sangria (en unidades em). Si asigna un valor negativo se usara la sangria especificada en el documento de entrada, es decir, calibre no cambia la sangria. --smarten-punctuation Convierte comillas rectas, rayas y puntos suspensivos en sus equivalentes tipograficos correctos. Para mas detalles, vease https://daringfireball.net/projects/smartypants. --subset-embedded-fonts Reducir caracteres en todos los tipos de letra incrustados. Cada tipo de letra incrustado se recorta para que contenga solo los caracteres que se usan en el documento. Esto reduce el tamano de los archivos de tipo de letra. Resulta util si incrusta un tipo de letra particularmente extenso con muchos caracteres sin usar. --transform-css-rules Ruta al archivo que contiene las reglas para transformar los estilos CSS de este libro. La manera mas facil de crear dicho archivo es usar el asistente para creacion de reglas en la interfaz grafica de calibre. Se accede a el en la seccion < Transformar estilos>> del cuadro de dialogo de conversion. Una vez creadas las reglas, se puede usar el boton <> para guardarlas en un archivo. --transform-html-rules Ruta al archivo que contiene las reglas para transformar el HTML de este libro. La manera mas facil de crear dicho archivo es usar el asistente para creacion de reglas en la interfaz grafica de calibre. Se accede a el en la seccion < Transformar HTML>> del cuadro de dialogo de conversion. Una vez creadas las reglas, se puede usar el boton <> para guardarlas en un archivo. --unsmarten-punctuation Convertir comillas, raya y puntos suspensivos tipograficos a sus equivalentes mas simples. PROCESADO HEURISTICO 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- * . --disable-dehyphenate Analizar las palabras con guion en todo el documento. El propio documento se utiliza como un diccionario para determinar si cada guion debe mantenerse o eliminarse. --disable-delete-blank-paragraphs Eliminar los parrafos vacios del documento cuando existen entre otros parrafos --disable-fix-indents Convertir los sangrias creados a partir de varios espacios duros en sangrados en codigo CSS. --disable-format-scene-breaks Los marcadores de salto de escena alineados a la izquierda se centraran. Los saltos de escena con multiples lineas en blanco se sustituiran por lineas horizontales. --disable-italicize-common-cases Buscar palabras y patrones que denotan cursiva y ponerlos en cursiva. --disable-markup-chapter-headings Detectar cabeceras y subcabeceras de capitulos sin formato y convertirlas en etiquetas h2 y h3. Esta configuracion no creara un indice, pero se puede utilizar junto con la deteccion de estructura para crear uno. --disable-renumber-headings Busca secuencias de etiquetas

o

. Las etiquetas se renumeran para evitar la division en el medio de una cabecera de capitulo. --disable-unwrap-lines Unir lineas basandose en la puntuacion y otros indicios de formato. --enable-heuristics Activar el procesado heuristico. Esta opcion debe estar activada para que se pueda realizar cualquier tipo de procesado heuristico. --html-unwrap-factor Escala utilizada para determinar la longitud a la cual una linea debe unirse a otra linea. Los valores validos son numeros decimales entre 0 y 1. El valor predeterminado es 0.4, un poco menos de la mitad de la linea. Si solo unas pocas lineas del documento necesitan unirse, deberia reducir el valor --replace-scene-breaks Sustituir saltos de escena por el texto especificado. De manera predeterminada se usa el texto existente en el documento de entrada. BUSCAR Y SUSTITUIR Modificar el texto y la estructura del documento utilizando patrones definidos por el usuario. --search-replace Ruta a un archivo que contiene expresiones regulares de busqueda y sustitucion. El archivo debe contener lineas alternas de expresiones regulares seguidas por patrones de sustitucion (que pueden ser lineas en blanco). La expresion regular debe ajustarse a la sintaxis de expresiones regulares de Python y el archivo debe estar codificado como UTF-8. --sr1-replace Texto de sustitucion para el texto encontrado con sr1-search. --sr1-search Patron de busqueda (expresion regular) que se sustituira por sr1-replace. --sr2-replace Texto de sustitucion para el texto encontrado con sr2-search. --sr2-search Patron de busqueda (expresion regular) que se sustituira por sr2-replace. --sr3-replace Texto de sustitucion para el texto encontrado con sr3-search. --sr3-search Patron de busqueda (expresion regular) que sera sustituida por sr3-replace. DETECCION DE ESTRUCTURA Control de autodeteccion de estructura de documento. --chapter Expresion XPath para detectar titulos de capitulo. El comportamiento predeterminado es considerar como titulos de capitulo las etiquetas

o

que contengan las palabras <>, <>, <
>, <>, <> o <>, asi como cualquier etiqueta que tenga class="chapter". La expresion debe dar como resultado una lista de elementos. Para desactivar la deteccion de capitulos use la expresion <>. Vease el Cursillo de XPath en el Manual de usuario de calibre para obtener mas ayuda sobre el uso de esta opcion. --chapter-mark Especificar como marcar los capitulos detectados. Con el valor <>, se insertara un salto de pagina antes de cada capitulo; con <> se insertara una linea antes de cada capitulo; con <> se marcaran los capitulos con un salto de pagina y una linea; con <> se deshabilitara el marcado de capitulos. --disable-remove-fake-margins Algunos documentos especifican los margenes de pagina anadiendo margenes a la izquierda y derecha de cada parrafo, calibre intentara detectar y eliminar estos margenes. A veces esto puede ocasionar que se eliminen margenes que deberian mantenerse. En tal caso, puede desactivar la eliminacion. --insert-metadata Incluir los metadatos al principio del libro. Util para lectores de libros electronicos que no manejan los metadatos directamente. --page-breaks-before Una expresion XPath. Se insertan saltos de pagina antes de los elementos especificados. Para desactivarlo use la expresion: / --prefer-metadata-cover Usar preferentemente la portada detectada en el archivo de origen en vez de la portada especificada. --remove-first-image Eliminar la primera imagen del libro de entrada. Es util 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 tendra dos imagenes de portada si no activa esta opcion. --start-reading-at Una expresion XPath para detectar donde debe comenzar la lectura del documento. Algunos programas de lectura de libros electronicos (entre ellos el Kindle) usan esta ubicacion como la posicion desde donde iniciar el libro. Lea el tutorial Xpath en el Manual de usuario de calibre para obtener mayor informacion acerca de esta funcion. INDICE Controla la generacion automatica del indice. De manera predeterminada, si el archivo de entrada tiene un Indice, se usara este en lugar del generado automaticamente. --duplicate-links-in-toc Al crear un indice a partir de enlaces en el documento de entrada, permitir entradas duplicadas, es decir, permitir mas de una entrada con el mismo texto, siempre que apunten a diferentes partes del texto. --level1-toc Expresion XPath que especifica todas las etiquetas que deben anadirse en el primer nivel del indice. Si se indica, tiene prioridad sobre otras formas de autodeteccion. Pueden encontrarse algunos ejemplos en el Cursillo de XPath en el Manual de usuario de calibre. --level2-toc Expresion XPath que especifica todas las etiquetas que deben anadirse en el segundo nivel del indice. Cada entrada se anade bajo la entrada previa del nivel uno. Pueden encontrarse algunos ejemplos en el Cursillo de XPath en el Manual de usuario de calibre. --level3-toc Expresion XPath que especifica todas las etiquetas que deben anadirse en el tercer nivel del indice. Cada entrada se anade bajo la entrada previa del nivel dos. Pueden encontrarse algunos ejemplos en el Cursillo de XPath en el Manual de usuario de calibre. --max-toc-links Numero maximo de enlaces a incluir dentro del indice. El valor 0 desactiva esta opcion. Valor predeterminado: 50. Los enlaces solo se agregan al indice si se deteca un numero de capitulos menor que el umbral especificado. --no-chapters-in-toc No anadir los capitulos autodetectados al indice. --toc-filter Eliminar entradas del indice cuyos titulos se corresponden con la expresion regular especificada. Las entradas marcadas y todas sus ramas son eliminadas. --toc-threshold Si se detectan menos capitulos que este numero, entonces se anaden enlaces al indice. Valor predeterminado: 6 --use-auto-toc Normalmente, si el archivo de origen tiene un indice, se usa este en vez del autogenerado. Con esta opcion siempre se usara el autogenerado. METADATOS Opciones para asignar metadatos en la salida --author-sort Texto que se usara para ordenar por autor. --authors Establecer autores. Si hay varios autores deben separarse por <<&>>. --book-producer Establecer el productor del libro. --comments Establecer la descripcion del libro. --cover Establecer como portada el archivo o URL especificado --isbn Establecer el ISBN del libro. --language Establecer el idioma. --pubdate Establecer la fecha de publicacion (se supone la zona horaria actual, a menos que se especifique otra zona horaria) --publisher Establecer la editorial del libro. --rating Establecer la valoracion. Debe ser un numero entre 1 y 5. --read-metadata-from-opf, --from-opf, -m Leer metadatos del archivo OPF especificado. Los metadatos leidos de este archivo anularan cualquier metadato que haya en el archivo de origen. --series Establecer la serie a la que pertenece el libro. --series-index Establecer la posicion del libro en esta serie. --tags Establecer etiquetas para el libro. Debe ser una lista separada por comas. --timestamp Establecer la fecha y hora del libro (ya no se usa) --title Establecer el titulo. --title-sort La version del titulo que se usara para ordenar. DEPURACION Opciones para ayudar con la depuracion de la conversion --debug-pipeline, -d Guardar la salida de las distintas etapas del proceso de conversion en la carpeta especificada. Util si no esta seguro de en que punto del proceso de conversion esta ocurriendo un error. --verbose, -v Nivel de detalles. Emplear varias veces para obtener mas detalles. Si se emplea dos veces se mostraran todos los detalles, con una vez se mostraran detalles intermedios y si no se emplea los detalles seran minimos. AUTHOR Kovid Goyal COPYRIGHT Kovid Goyal 7.10.0 mayo 03, 2024 EBOOK-CONVERT(1)