Convertidor online gratuito de ASCIIDOC a TEX

Qué es el formato ASCIIDOC

AsciiDoc es un formato de marcado ligero para documentación estructurada. Los archivos suelen usar .adoc o .asciidoc y contienen encabezados, listas, enlaces, tablas, bloques de código fuente, imágenes, atributos, inclusiones y advertencias en texto plano legible.

Asciidoctor y el procesador AsciiDoc original crean y renderizan estos archivos. Puede encontrarlos en repositorios de documentación de software, archivos README, manuales, libros y proyectos de publicación de sitios estáticos. AsciiDoc está diseñado para producir formatos como HTML, páginas man y DocBook, en lugar de TeX nativo.

Qué es el formato TEX

TEX es código fuente para el sistema de composición tipográfica TeX. En la conversión práctica de documentos, LaTeX suele ser el resultado TEX previsto porque proporciona clases de documento, secciones, referencias, matemáticas, tablas, bibliografías y compatibilidad con paquetes.

Un archivo .tex se edita como texto plano y se compila con un motor de TeX como pdflatex, xelatex o lualatex. TEX resulta útil cuando el documento final debe cumplir una plantilla editorial o académica, producir una paginación coherente o conservar un flujo de trabajo de archivo basado en código fuente.

Cómo convertir realmente ASCIIDOC a TEX

El método de línea de comandos más fiable utiliza Asciidoctor como generador intermedio de DocBook y Pandoc como convertidor de DocBook a LaTeX.

1. Instale Asciidoctor y Pandoc. Verifique su instalación con asciidoctor --version y pandoc --version.
2. Abra una terminal en el directorio que contiene el archivo fuente y genere DocBook XML:
   asciidoctor -b docbook5 -o manual.xml manual.adoc
3. Convierta el XML en un archivo fuente LaTeX independiente:
   pandoc manual.xml --from=docbook --to=latex --standalone -o manual.tex
4. Compile el archivo resultante cuando necesite un PDF:
   pdflatex manual.tex
   Ejecute el compilador dos veces si el documento contiene referencias cruzadas o una tabla de contenido.

Conserve manual.xml hasta haber comprobado el resultado; proporciona una representación intermedia que facilita el diagnóstico de errores de conversión. Como opción basada en el navegador, 101convert.com ofrece un convertidor gratuito que no requiere instalar software.

Límites de calidad y compatibilidad

Este proceso produce sintaxis LaTeX en un archivo .tex, no necesariamente sintaxis TeX simple. Los atributos de AsciiDoc, las directivas condicionales, las extensiones, los convertidores personalizados, las tablas complejas, los callouts, las advertencias y los archivos incluidos pueden requerir correcciones manuales o preprocesamiento.

Compruebe las rutas de las imágenes, la codificación de caracteres, los caracteres de escape, los enlaces, las citas, el diseño de las tablas y la estructura de los encabezados en el código fuente generado. Pandoc puede requerir paquetes LaTeX para funciones como tablas avanzadas, resaltado de sintaxis o diagramas. Si el código fuente utiliza extensiones de Asciidoctor o temas personalizados, esas reglas de presentación no se transfieren automáticamente a LaTeX y deben recrearse con paquetes LaTeX o cambios en la plantilla.