Convertidor online gratuito de ASCIIDOC a ODT

Los archivos ASCIIDOC son prácticos para la documentación controlada por versiones, pero muchas aplicaciones de oficina requieren el formato OpenDocument Text para editar o entregar documentos. La conversión a ODT conserva el documento como un archivo editable de procesamiento de textos que LibreOffice y otros programas compatibles con OpenDocument pueden abrir.

Qué es el formato ASCIIDOC

AsciiDoc es un formato ligero de marcado para escribir documentos estructurados en texto sin formato. Los autores utilizan elementos de marcado como encabezados, listas, enlaces, tablas, advertencias, bloques de código fuente y atributos, en lugar de almacenar el formato directamente en un archivo de procesamiento de textos.

Los archivos suelen utilizar la extensión .adoc o .asciidoc. Asciidoctor y Asciidoc crean y procesan estos archivos, que aparecen con frecuencia en documentación de software, archivos README, manuales técnicos y repositorios de documentación administrados con Git.

Qué es el formato ODT

ODT es el formato OpenDocument Text, un formato de documentos basado en ZIP definido por el estándar OpenDocument. Almacena texto editable, estilos de párrafo y carácter, tablas, imágenes, metadatos e información sobre el diseño de página.

LibreOffice Writer abre y edita directamente los archivos ODT; Apache OpenOffice y otras aplicaciones compatibles con OpenDocument también pueden leerlos. ODT resulta útil cuando los destinatarios necesitan un documento paginado con formato editable en lugar del código fuente de marcado.

Cómo convertir realmente ASCIIDOC a ODT

El flujo de trabajo de escritorio más fiable utiliza Asciidoctor para producir DocBook XML y, posteriormente, Pandoc para crear el archivo ODT.

1. Instale Asciidoctor y Pandoc. Con Ruby instalado, Asciidoctor puede instalarse mediante gem install asciidoctor; instale Pandoc desde su paquete de escritorio oficial para su sistema operativo.
2. Abra una terminal en el directorio que contiene el archivo de origen.
3. Convierta el código fuente AsciiDoc a DocBook 5 XML:
   asciidoctor -b docbook5 -o intermediate.xml input.adoc
4. Convierta el archivo XML intermedio a ODT:
   pandoc -f docbook -t odt intermediate.xml -o output.odt
5. Abra output.odt en LibreOffice Writer y compruebe los encabezados, las tablas, las imágenes, los saltos de página, las notas al pie y los bloques de código.

Para un archivo AsciiDoc con imágenes o archivos incluidos, ejecute los comandos desde el directorio de origen para que las rutas relativas se resuelvan correctamente. Si el origen utiliza un atributo, páselo a Asciidoctor con una opción como -a toc= o defínalo en el encabezado del documento.

Si no desea instalar software, puede convertir el archivo de forma gratuita en 101convert.com utilizando su conversor de ASCIIDOC a ODT.

Limitaciones de calidad y compatibilidad

La conversión pasa por dos modelos de formato, por lo que las funciones específicas de AsciiDoc pueden no trasladarse exactamente a ODT. Los encabezados, párrafos, énfasis, listas, enlaces, tablas, imágenes y bloques de código básicos suelen transferirse correctamente, mientras que los roles complejos, los temas personalizados de Asciidoctor, las extensiones, el contenido condicional, las macros y los estilos avanzados de advertencias pueden requerir ajustes manuales.

El código fuente AsciiDoc describe la estructura; ODT también requiere estilos de página, fuentes, márgenes, encabezados, pies de página y paginación. Pandoc aplica sus propios valores predeterminados de documento, por lo que debe inspeccionar el resultado en LibreOffice y modificar los estilos en lugar de confiar en la apariencia original de AsciiDoc. Incruste o instale las fuentes necesarias antes de la exportación final si es importante mantener una paginación coherente.

Conserve el XML intermedio hasta completar la validación. Esto ayuda a identificar si un problema se originó en la etapa de análisis de Asciidoctor o en el escritor ODT de Pandoc.