ebook-convert - ebook-convert
ebook-convert archivo_entrada archivo_salida [opciones]
Convertir un libro electrónico 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 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 un directorio y se generará un «open eBook» (OEB),
formado por un conjunto de archivos HTML, en ese directorio. Estos archivos
son los que normalmente se habrían pasado al complemento de
salida.
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.
Para una documentación completa del sistema de
conversión, véase conversion
Cuando alguno de los argumentos de ebook-convert contenga
espacios, póngalo entre comillas. Por ejemplo: "/some path/with
spaces"
Las opciones y sus valores predeterminados cambian según
los formatos de entrada y salida, por lo que siempre se debe probar con:
ebook-convert myfile.input_format myfile.output_format -h
A continuación se muestran las opciones comunes a todas las
conversiones, seguidas de las opciones específicas para cada formato
de entrada y salida.
- OPCIONES DE ENTRADA
- OPCIONES DE SALIDA
- APARIENCIA
- PROCESADO HEURÍSTICO
- BUSCAR Y SUSTITUIR
- DETECCIÓN DE ESTRUCTURA
- ÍNDICE
- METADATOS
- DEPURACIÓN
- --help, -h
- mostrar este mensaje de ayuda y terminar
- --input-profile
- 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
- --list-recipes
- 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
- --output-profile
- 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 (por ejemplo, redimensionando las imágenes
según el tamaño de pantalla del dispositivo). 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_voyage, kobo,
msreader, mobipocket, nook, nook_color, nook_hd_plus, pocketbook_900,
pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape,
sonyt3, tablet, generic_eink, generic_eink_hd, generic_eink_large
- --version
- mostrar el número de versión del programa y terminar
Opciones para controlar el procesado del archivo de entrada
mobi.
- --input-encoding
- 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.
Opciones para controlar el procesado de la salida epub
- --dont-split-on-page-breaks
- 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.
- --epub-flatten
- 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.
- --epub-inline-toc
- Insertar un índice que aparecerá como parte del contenido
principal del libro.
- --epub-toc-at-end
- Colocar el índice insertado al final del libro en lugar de al
principio
- --epub-version
- 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.
- Extraer los contenidos del archivo generado EPUB al directorio
especificado. Los contenidos del directorio primero son eliminados,
así que tenga cuidado.
- --flow-size
- 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.
- --no-default-epub-cover
- 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.
- --no-svg-cover
- 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.
- --preserve-cover-aspect-ratio
- 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.
- --pretty-print
- 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.
- --toc-title
- Título para cualquier índice generado en el texto.
Opciones para controlar el aspecto de la salida
- --asciiize
- 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á
«Михаил
Горбачёв»
por «Mikhail Gorbachiov». 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.
- --base-font-size
- 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.
- --change-justification
- 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.
- --embed-all-fonts
- 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.
- --embed-font-family
- 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.
- --expand-css
- 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.
- 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.
- --filter-css
- 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
- --font-size-mapping
- 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.
- --insert-blank-line
- Insertar una línea en blanco entre párrafos. No
funcionará si el archivo de origen no define párrafos
(etiquetas <p> o <div>).
- --insert-blank-line-size
- 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í.
- --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 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. Por el contrario, seleccionar esta
opción las mantendrá.
- --line-height
- 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.
- --linearize-tables
- 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.
- --margin-bottom
- 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.
- --margin-left
- 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.
- --margin-right
- 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.
- --margin-top
- 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.
- --minimum-line-height
- 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.
- --remove-paragraph-spacing
- 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>).
- --remove-paragraph-spacing-indent-size
- 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.
- --smarten-punctuation
- Convierte comillas rectas, rayas y puntos suspensivos en sus equivalentes
tipográficos correctos. Para más detalles, véase
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 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.
- --transform-css-rules
- 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.
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 guión en todo el documento. El propio
documento se utiliza como un diccionario para determinar si cada
guión debe mantenerse o eliminarse.
- --disable-fix-indents
- Convertir los sangrados creados a partir de varios espacios duros en
sangrados en código CSS.
- --disable-format-scene-breaks
- 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.
- --disable-markup-chapter-headings
- 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.
- --disable-renumber-headings
- 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.
- --enable-heuristics
- Activar el procesado heurístico. Esta opción debe estar
activada para que se pueda realizar cualquier tipo de procesado
heurístico.
- --html-unwrap-factor
- 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.
- --replace-scene-breaks
- Sustituir saltos de escena por el texto especificado. De manera
predeterminada se usa el texto existente en el documento de entrada.
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 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.
- --sr1-replace
- Texto de sustitución para el texto encontrado con sr1-search.
- --sr1-search
- Patrón de búsqueda (expresión regular) que se
sustituirá por sr1-replace.
- --sr2-replace
- Texto de sustitución para el texto encontrado con sr2-search.
- --sr2-search
- Patrón de búsqueda (expresión regular) que se
sustituirá por sr2-replace.
- --sr3-replace
- Texto de sustitución para el texto encontrado con sr3-search.
- --sr3-search
- Patrón de búsqueda (expresión regular) que
será sustituida por sr3-replace.
Control de autodetección de estructura de documento.
- --chapter
- 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="chapter". 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.
- --chapter-mark
- 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.
- --disable-remove-fake-margins
- 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.
- --insert-metadata
- Incluir los metadatos al principio del libro. Útil para lectores de
libros electrónicos que no manejan los metadatos directamente.
- --page-breaks-before
- Una expresión XPath. Se insertan saltos de página antes de
los elementos especificados. Para desactivarlo use la expresión:
/
- --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 ú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.
- --start-reading-at
- 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.
ÍNDICE
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.
- --duplicate-links-in-toc
- 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.
- --level1-toc
- 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.
- --level2-toc
- 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.
- --level3-toc
- 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.
- --max-toc-links
- 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.
- --toc-filter
- Eliminar entradas del índice cuyos títulos se corresponden
con la expresión regular especificada. Las entradas marcadas y
todas sus ramas son eliminadas.
- --toc-threshold
- Si se detectan menos capítulos que este número, entonces se
añaden enlaces al índice. Valor predeterminado: 6
- --use-auto-toc
- 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.
Opciones para asignar metadatos en la salida
- --authors
- Establecer autores. Si hay varios autores deben separarse por
«&».
- Establecer la descripción del libro.
- --cover
- Establecer como portada el archivo o URL especificado
- --isbn
- Establecer el ISBN del libro.
- --pubdate
- Establecer la fecha de publicación (se supone la zona horaria
actual, a menos que se especifique otra zona horaria)
- --rating
- Establecer la valoración. Debe ser un número entre 1 y
5.
- --series
- Establecer la serie a la que pertenece el libro.
- --series-index
- Establecer la posición 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-sort
- La versión del título que se usará para ordenar.
Opciones para ayudar con la depuración de la
conversión
- --debug-pipeline,
-d
- Guardar la salida de las distintas etapas del proceso de conversión
en el directorio especificado. Útil si no está seguro de en
qué punto del proceso de conversión está ocurriendo
un error.
- --verbose,
-v
- 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.