Convertidor online gratuito de ASCIIDOC a EPUB

Los lectores de libros electrónicos y los sistemas de publicación suelen requerir EPUB en lugar de un archivo fuente de AsciiDoc. La conversión conserva sus encabezados, párrafos, listas, enlaces, imágenes y otro contenido estructurado en un formato adaptable que los lectores pueden abrir en teléfonos, tabletas y dispositivos dedicados para libros electrónicos.

Qué es el formato ASCIIDOC

AsciiDoc es un formato de marcado de texto plano para documentos estructurados, como libros, manuales, documentación de software, artículos y archivos README. Los autores escriben encabezados, listas, tablas, enlaces, bloques de código, atributos, referencias cruzadas y advertencias mediante una sintaxis de texto legible, en lugar de editar un documento binario.

Las extensiones de origen comunes incluyen .adoc, .asciidoc y .asc. Asciidoctor y Asciidoc utilizan estos archivos para generar documentos HTML, PDF, páginas man y EPUB. Los desarrolladores suelen encontrarlos en repositorios de documentación, proyectos de sitios estáticos, proyectos basados en Git y sistemas de compilación de documentación.

Qué es el formato EPUB

EPUB es un paquete de libro electrónico basado en ZIP que contiene contenido XHTML, hojas de estilo CSS, metadatos, archivos de navegación e imágenes, fuentes y otros recursos opcionales. EPUB 3 admite HTML semántico, diseños adaptables, navegación, audio o vídeo y escritura de derecha a izquierda o vertical cuando el sistema de lectura admite esas funciones.

A diferencia de un PDF de página fija, el contenido EPUB se adapta al tamaño de la pantalla, la configuración de fuente y la orientación del dispositivo de lectura. Es adecuado para distribuir documentación extensa o libros mediante lectores y bibliotecas de libros electrónicos, así como para comprobar el resultado con aplicaciones compatibles con EPUB.

Cómo convertir ASCIIDOC a EPUB

Usar Asciidoctor EPUB3

Asciidoctor EPUB3 es la opción más directa porque entiende las construcciones específicas de AsciiDoc en lugar de tratar el origen como un marcado genérico. Instala Ruby primero si aún no está disponible y, a continuación, instala el convertidor:

gem install asciidoctor-epub3

Desde el directorio que contiene el archivo de origen, ejecuta:

asciidoctor-epub3 book.adoc -o book.epub

Sustituye book.adoc por el nombre de archivo real. El convertidor lee el encabezado del documento, los archivos incluidos, las imágenes referenciadas, los atributos y los elementos estructurales, y luego escribe book.epub.

Para un proyecto con varios archivos, conserva los archivos de origen incluidos y los directorios de imágenes en las ubicaciones relativas esperadas. Un comando habitual con un directorio de trabajo personalizado es:

asciidoctor-epub3 -D output book.adoc

Establece los metadatos del documento en el encabezado de AsciiDoc antes de la conversión, por ejemplo:

= Book title
Author Name <author@example.com>
:revnumber: 1.0
:description: A short description
:doctype: book
:toc:
:sectnums:

Utiliza un atributo de imagen como :imagesdir: images cuando las rutas de las imágenes sean relativas a un directorio común. Comprueba que todas las imágenes referenciadas existan y utilicen un formato compatible con los sistemas de lectura de destino, normalmente JPEG, PNG o SVG.

Convertir sin instalar software

Puedes convertir el archivo de forma gratuita en el sitio web 101convert.com cuando no sea práctico instalar Ruby o Asciidoctor. Sube el archivo AsciiDoc, elige EPUB como formato de salida, inicia la conversión y descarga el libro electrónico generado.

Usar Pandoc como alternativa

Pandoc puede convertir directamente algunos documentos AsciiDoc:

pandoc book.adoc -o book.epub

Utiliza Pandoc para documentos relativamente sencillos o cuando ya forme parte del flujo de trabajo de publicación. Por lo general, Asciidoctor EPUB3 conserva de forma más fiable los atributos específicos de AsciiDoc, las advertencias, los archivos incluidos y las referencias cruzadas.

Calidad, compatibilidad y limitaciones

EPUB es adaptable, por lo que los saltos de línea fijos, las posiciones exactas de las páginas y las instrucciones de diseño propias de PDF no se pueden conservar de manera uniforme. Los números de página, el control de viudas y huérfanas y el ajuste de línea varían según el sistema de lectura y la configuración de fuente del usuario.

Las extensiones complejas de AsciiDoc, los convertidores personalizados, los diagramas incrustados, las macros no compatibles y el formato exclusivo de PDF pueden requerir ajustes manuales. Genera los archivos de diagramas antes de la conversión y utiliza rutas relativas para todos los recursos locales.

Abre el resultado en al menos un lector EPUB e inspecciona la tabla de contenido, la jerarquía de encabezados, los enlaces, los bloques de código, las tablas, las imágenes y los caracteres especiales. Para la validación a nivel de paquete, ejecuta EPUBCheck:

epubcheck book.epub

Corrige los recursos faltantes, el XHTML no válido, los errores de metadatos y las advertencias de navegación antes de distribuir el archivo.