Conversor online gratuito de ASCIIDOC para ODT

Os arquivos ASCIIDOC são convenientes para documentação controlada por versão, mas muitos aplicativos de escritório exigem o formato OpenDocument Text para edição ou entrega. A conversão para ODT preserva o documento como um arquivo de processamento de texto editável que o LibreOffice e outros programas compatíveis com OpenDocument podem abrir.

O que é o formato ASCIIDOC

AsciiDoc é um formato leve de marcação para escrever documentos estruturados em texto simples. Os autores usam marcações como títulos, listas, links, tabelas, advertências, blocos de código-fonte e atributos, em vez de armazenar a formatação diretamente em um arquivo de processamento de texto.

Os arquivos normalmente usam a extensão .adoc ou .asciidoc. Asciidoctor e Asciidoc criam e processam esses arquivos, que aparecem frequentemente em documentação de software, arquivos README, manuais técnicos e repositórios de documentação gerenciados com Git.

O que é o formato ODT

ODT é o formato OpenDocument Text, um formato de documento baseado em ZIP definido pelo padrão OpenDocument. Ele armazena texto editável, estilos de parágrafo e caracteres, tabelas, imagens, metadados e informações de layout de página.

O LibreOffice Writer abre e edita arquivos ODT diretamente; o Apache OpenOffice e outros aplicativos compatíveis com OpenDocument também podem lê-los. O ODT é útil quando os destinatários precisam de um documento paginado com formatação editável, em vez do código-fonte de marcação.

Como realmente converter ASCIIDOC para ODT

O fluxo de trabalho mais confiável em desktop usa o Asciidoctor para produzir DocBook XML e, em seguida, o Pandoc para criar o arquivo ODT.

1. Instale o Asciidoctor e o Pandoc. Com o Ruby instalado, o Asciidoctor pode ser instalado usando gem install asciidoctor; instale o Pandoc a partir do pacote oficial para desktop correspondente ao seu sistema operacional.
2. Abra um terminal no diretório que contém o arquivo de origem.
3. Converta a origem AsciiDoc para DocBook 5 XML:
   asciidoctor -b docbook5 -o intermediate.xml input.adoc
4. Converta o arquivo XML intermediário para ODT:
   pandoc -f docbook -t odt intermediate.xml -o output.odt
5. Abra output.odt no LibreOffice Writer e verifique títulos, tabelas, imagens, quebras de página, notas de rodapé e blocos de código.

Para um arquivo AsciiDoc com imagens ou arquivos incluídos, execute os comandos no diretório de origem para que os caminhos relativos sejam resolvidos corretamente. Se a origem usar um atributo, passe-o ao Asciidoctor com uma opção como -a toc= ou defina-o no cabeçalho do documento.

Se não quiser instalar software, você pode converter o arquivo gratuitamente em 101convert.com usando o conversor de ASCIIDOC para ODT.

Limitações de qualidade e compatibilidade

A conversão passa por dois modelos de formato, portanto os recursos específicos do AsciiDoc podem não ser mapeados exatamente para ODT. Títulos, parágrafos, ênfase, listas, links, tabelas, imagens e blocos de código básicos geralmente são transferidos, enquanto funções complexas, temas personalizados do Asciidoctor, extensões, conteúdo condicional, macros e estilos avançados de advertências podem exigir ajustes manuais.

A origem AsciiDoc descreve a estrutura; o ODT também exige estilos de página, fontes, margens, cabeçalhos, rodapés e paginação. O Pandoc aplica seus próprios padrões de documento, portanto inspecione o resultado no LibreOffice e modifique os estilos em vez de depender da aparência original do AsciiDoc. Incorpore ou instale as fontes necessárias antes da exportação final se a paginação consistente for importante.

Mantenha o XML intermediário até que a validação seja concluída. Ele ajuda a identificar se um problema se originou na etapa de análise do Asciidoctor ou no gravador de ODT do Pandoc.