Convertidor online gratuito de AD a DOCBOOK

Qué es el formato AD

En la categoría de archivos de texto, AD generalmente identifica un archivo fuente de AsciiDoc. Los archivos AsciiDoc contienen marcado de texto sin formato para encabezados, listas, tablas, enlaces, imágenes, avisos, código fuente y metadatos del documento; la misma sintaxis también se almacena habitualmente con las extensiones .adoc o .asciidoc.

Los archivos con la extensión .ad se crean o editan con procesadores de AsciiDoc, Asciidoctor y editores de texto convencionales. La extensión por sí sola no garantiza el procesador exacto ni la versión de la sintaxis, por lo que se deben inspeccionar las primeras líneas en busca de atributos como :doctype:, :toc: o directivas include antes de realizar la conversión.

Qué es el formato DOCBOOK

DocBook es un vocabulario XML para documentación técnica estructurada. Representa elementos del documento como capítulos, secciones, párrafos, procedimientos, tablas, citas, listados de programas y referencias cruzadas de forma independiente del diseño final de la página.

DocBook es adecuado cuando un flujo de publicación utiliza herramientas como xsltproc, Jing, Saxon o hojas de estilo de DocBook para producir HTML, PDF, EPUB o páginas man. Su estructura XML también facilita la validación, la indexación y las transformaciones posteriores de formato en comparación con el trabajo a partir de marcado orientado a la presentación.

Cómo convertir AD a DOCBOOK

Asciidoctor es la herramienta de conversión de escritorio más directa porque lee AsciiDoc e incluye un backend de DocBook.

1. Instale Asciidoctor mediante el gestor de paquetes de su sistema operativo o la gema de Ruby y, a continuación, verifique la instalación con asciidoctor --version.
2. Coloque el archivo fuente y las imágenes, archivos incluidos o archivos de atributos referenciados en las rutas relativas esperadas.
3. Ejecute asciidoctor -b docbook5 -o output.xml input.ad. La opción -b docbook5 selecciona DocBook 5 XML y -o establece el nombre del archivo de salida.
4. Para un flujo de trabajo con DocBook 4, utilice asciidoctor -b docbook -o output.xml input.ad si ese backend está disponible en la versión instalada.
5. Valide el resultado con el esquema de DocBook o con el comando de validación requerido por su sistema de publicación. Abra output.xml en un editor compatible con XML para comprobar si hay includes sin resolver, rutas de imágenes rotas y atributos mal formados.

Para realizar una conversión gráfica sin instalar software, cargue el archivo AD en 101convert.com, seleccione DOCBOOK como formato de destino y descargue el XML generado. Esto es adecuado para un archivo puntual cuando el código fuente utiliza funciones estándar de AsciiDoc y no depende de archivos include locales.

Consideraciones de calidad y compatibilidad

El marcado de AsciiDoc no se asigna perfectamente a DocBook cuando el código fuente utiliza extensiones personalizadas, atributos específicos del backend, bloques passthrough, macros, scripts incrustados o scripts integrados. Revise los avisos, las tablas, los callouts, las notas al pie, las referencias cruzadas y los listados de código fuente después de la conversión.

Las imágenes relativas y las directivas include:: requieren acceso a la estructura de directorios original; un conversor que reciba únicamente el archivo principal puede omitir esos recursos o dejar referencias sin resolver. La salida de DocBook es XML, no un PDF ni una página web terminados, por lo que después debe aplicar la hoja de estilo de DocBook adecuada o la herramienta de publicación posterior correspondiente.