Conversor online gratuito de ASCIIDOC para TEXTILE

O que é o formato ASCIIDOC

AsciiDoc é um formato leve de marcação armazenado como texto simples, geralmente com as extensões .adoc ou .asciidoc. Ele oferece suporte a títulos de documentos, seções, avisos, tabelas, referências cruzadas, atributos, listagens de código-fonte, imagens e inclusões.

Os arquivos são criados e processados pelo Asciidoctor, pelo processador AsciiDoc mais antigo, pelo AsciidocFX, pelo Antora e por editores de texto. Projetos de documentação, arquivos README, manuais, notas de versão e arquivos-fonte de sites estáticos costumam utilizá-lo. A sintaxe do AsciiDoc varia entre as implementações, e as extensões do Asciidoctor podem adicionar recursos que não fazem parte do formato básico.

O que é o formato TEXTILE

Textile é uma linguagem de marcação em texto simples usada por algumas wikis, sistemas de gerenciamento de conteúdo, ferramentas de publicação e aplicações web mais antigas. Sua sintaxe usa marcadores curtos, como h1. Heading para títulos, *bold* para texto em negrito, _italic_ para itálico e "link text":https://example.com para links.

Textile continua sendo útil quando a aplicação de destino possui um analisador de Textile, mas não oferece suporte a AsciiDoc. Como é texto simples, o arquivo convertido pode ser editado com qualquer editor de texto e versionado sem um formato de documento binário. As implementações de Textile diferem quanto ao suporte a tabelas, atributos, notas de rodapé e sintaxe estendida.

Como converter ASCIIDOC para TEXTILE de fato

Para uma conversão rápida sem instalar software, use o conversor em 101convert.com: carregue o arquivo .adoc ou .asciidoc, selecione TEXTILE como formato de saída, inicie a conversão e baixe o arquivo .textile resultante.

Para uma conversão local e repetível, use o Asciidoctor para criar DocBook XML e o Pandoc para criar Textile. O Pandoc não analisa de forma confiável todos os dialetos do AsciiDoc diretamente, portanto esse fluxo em duas etapas deixa a interpretação da sintaxe de origem a cargo do Asciidoctor.

1. Instale o Asciidoctor e o Pandoc usando o método de instalação de pacotes apropriado para o seu sistema operacional.
2. Abra um terminal no diretório que contém o arquivo de origem.
3. Execute asciidoctor -b docbook5 -o intermediate.xml input.adoc. Substitua input.adoc pelo nome de arquivo real. Use input.asciidoc quando essa for a extensão da origem.
4. Converta o documento intermediário com pandoc -f docbook -t textile intermediate.xml -o output.textile.
5. Abra output.textile em um editor de texto ou importe-o para a aplicação Textile de destino e verifique o resultado renderizado.

Se a origem usar inclusões locais, execute o Asciidoctor a partir do diretório do projeto para que os caminhos relativos sejam resolvidos corretamente. Por exemplo, asciidoctor -b docbook5 -o intermediate.xml chapters/index.adoc pode exigir que os caminhos de inclusão e os atributos do projeto estejam disponíveis nesse diretório de trabalho.

Limitações de qualidade e compatibilidade

A etapa intermediária do DocBook pode alterar detalhes de apresentação. Atributos do AsciiDoc, blocos condicionais, funções personalizadas, extensões, estilos de avisos, referências cruzadas não resolvidas e macros específicas do processador podem ser omitidos ou representados de forma diferente no Textile.

Verifique tabelas, listas aninhadas, formatação em linha, imagens, notas de rodapé, âncoras, blocos de código-fonte e links após a conversão. As imagens normalmente são referenciadas por caminho em vez de incorporadas; portanto, copie os arquivos de imagem e preserve a estrutura de diretórios relativa. Um renderizador de Textile pode não oferecer suporte a todos os recursos produzidos pelo Pandoc; construções não compatíveis podem aparecer como marcação escapada ou parágrafos comuns.

Mantenha o arquivo AsciiDoc original como fonte principal. Edite a saída Textile somente quando o sistema de destino exigir um ajuste pontual, pois repetir a conversão substituirá essas alterações.