Conversor online gratuito de AD para DOCBOOK

O que é o formato AD

Na categoria de arquivos de texto, AD geralmente identifica um arquivo-fonte AsciiDoc. Os arquivos AsciiDoc contêm marcação em texto simples para títulos, listas, tabelas, links, imagens, advertências, código-fonte e metadados do documento; a mesma sintaxe também é comumente armazenada com as extensões .adoc ou .asciidoc.

Os arquivos com a extensão .ad são criados ou editados com processadores AsciiDoc, Asciidoctor e editores de texto comuns. A extensão, por si só, não garante o processador exato nem a versão da sintaxe; portanto, examine as primeiras linhas em busca de atributos como :doctype:, :toc: ou diretivas de inclusão antes da conversão.

O que é o formato DOCBOOK

DocBook é um vocabulário XML para documentação técnica estruturada. Ele representa elementos do documento, como capítulos, seções, parágrafos, procedimentos, tabelas, citações, listagens de programas e referências cruzadas, independentemente do layout final da página.

DocBook é adequado quando um pipeline de publicação usa ferramentas como xsltproc, Jing, Saxon ou stylesheets do DocBook para produzir HTML, PDF, EPUB ou páginas de manual. Sua estrutura XML também facilita a validação, a indexação e as transformações posteriores de formato em comparação com o uso de marcação orientada à apresentação.

Como converter AD para DOCBOOK

Asciidoctor é a ferramenta de conversão para desktop mais direta, pois lê AsciiDoc e inclui um backend DocBook.

1. Instale o Asciidoctor usando o gerenciador de pacotes do seu sistema operacional ou o Ruby gem e verifique a instalação com asciidoctor --version.
2. Coloque o arquivo-fonte e todas as imagens referenciadas, os arquivos incluídos ou os arquivos de atributos nos caminhos relativos esperados.
3. Execute asciidoctor -b docbook5 -o output.xml input.ad. A opção -b docbook5 seleciona o XML DocBook 5, e -o define o nome do arquivo de saída.
4. Para um workflow DocBook 4, use asciidoctor -b docbook -o output.xml input.ad se esse backend estiver disponível na versão instalada.
5. Valide o resultado com o schema do DocBook ou com o comando de validação exigido pelo seu sistema de publicação. Abra output.xml em um editor compatível com XML para verificar inclusões não resolvidas, caminhos de imagem inválidos e atributos malformados.

Para uma conversão gráfica sem instalar software, faça upload do arquivo AD para 101convert.com, selecione DOCBOOK como formato de destino e baixe o XML gerado. Isso é adequado para um arquivo avulso quando a fonte usa recursos padrão do AsciiDoc e não depende de arquivos de inclusão locais.

Considerações sobre qualidade e compatibilidade

A marcação AsciiDoc não é mapeada perfeitamente para DocBook quando a fonte usa extensões personalizadas, atributos específicos do backend, blocos passthrough, macros ou scripts incorporados. Revise as advertências, tabelas, callouts, notas de rodapé, referências cruzadas e listagens de código-fonte após a conversão.

Imagens relativas e diretivas include:: exigem acesso à estrutura de diretórios original; um conversor que receba apenas o arquivo principal poderá omitir esses recursos ou deixar referências não resolvidas. A saída do DocBook é XML, não um PDF ou uma página da web finalizada; portanto, aplique a stylesheet apropriada do DocBook ou a ferramenta de publicação downstream posteriormente.