Conversor online gratuito de ADOC para PDF

Um destinatário, uma impressora, um sistema de arquivamento ou um fluxo de trabalho de documentos pode exigir um PDF de layout fixo em vez do código-fonte AsciiDoc editável. Renderizar o código-fonte como PDF preserva a paginação e torna o documento visualizável sem uma ferramenta AsciiDoc.

O que é o formato ADOC

ADOC é a extensão de nome de arquivo comum para um documento AsciiDoc; .asciidoc e .asc também são usadas. É um formato de código-fonte em texto simples que contém marcação para títulos, listas, links, tabelas, atributos, referências a imagens e diretivas include::.

Desenvolvedores, redatores técnicos e equipes de documentação usam arquivos ADOC com ferramentas como Asciidoctor, AsciidoctorJ e Antora. Um editor de texto exibe a marcação do código-fonte, como = Document title e == Section, e não o documento paginado produzido pela renderização.

O que é o formato PDF

PDF é um formato de descrição de página que mantém o tamanho da página, a tipografia, o espaçamento, as imagens e a paginação em diferentes sistemas operacionais e impressoras. É adequado para impressão, compartilhamento, cópias de arquivamento e documentos que precisam ser visualizados de maneira consistente em diferentes dispositivos.

O PDF é menos conveniente para edição do que o ADOC. Para documentação controlada por versão, edite o arquivo ADOC e gere novamente o PDF em vez de modificar o PDF diretamente.

Como converter um arquivo ADOC em PDF

Usando Asciidoctor PDF

Asciidoctor PDF é o conversor local mais direto, pois interpreta a sintaxe AsciiDoc e cria um PDF sem um arquivo HTML intermediário. Ele requer Ruby.

1. Instale Ruby caso ainda não esteja disponível no computador.
2. Instale Asciidoctor PDF a partir de um terminal com gem install asciidoctor-pdf.
3. Abra o terminal no diretório que contém o arquivo de origem ou forneça o caminho completo.
4. Execute asciidoctor-pdf document.adoc -o document.pdf.
5. Abra o resultado e verifique títulos, links, imagens, tabelas, blocos de código e quebras de página.

Substitua os nomes de arquivo pelos nomes reais do arquivo de origem e do arquivo de saída. Um tema de PDF personalizado pode ser fornecido com um atributo como -a pdf-theme=my-theme.yml, desde que o arquivo de tema e todas as fontes referenciadas estejam disponíveis.

Asciidoctor PDF também pode ser integrado a scripts e builds de documentação, o que é preferível quando os PDFs precisam ser regenerados de maneira consistente a partir de código-fonte controlado por versão.

Usando 101convert.com

Você pode converter o arquivo gratuitamente em 101convert.com sem instalar software: envie o arquivo .adoc, escolha PDF como formato de saída, inicie a conversão e baixe o resultado. Use o Asciidoctor PDF local para documentos confidenciais ou arquivos que dependam de imagens locais, includes, temas personalizados ou extensões.

Considerações sobre qualidade e compatibilidade

• Renomear document.adoc para document.pdf não converte o arquivo; o código-fonte AsciiDoc precisa ser renderizado.
• Os caminhos relativos das imagens e as diretivas include:: precisam ser resolvidos corretamente. Arquivos ausentes podem criar áreas de imagem em branco ou conteúdo de include não resolvido.
• Asciidoctor PDF usa seus próprios temas e regras de layout. O CSS usado na saída HTML do AsciiDoc não determina a aparência do PDF.
• As fontes precisam estar instaladas ou ser fornecidas ao build do PDF e devem conter os caracteres necessários. Caso contrário, os glifos podem ser substituídos ou exibidos como caixas de caracteres ausentes.
• Diagramas, gráficos, realce de sintaxe e exemplos de código gerados podem exigir extensões adicionais do AsciiDoc, executáveis ou etapas de build antes da geração do PDF.
• Tabelas longas e blocos de código podem ser quebrados de maneira inadequada nas divisas de página. Ajuste as larguras, as configurações do tema ou os controles de quebra de página e inspecione o PDF renderizado antes da distribuição.
• A saída PDF depende da versão do conversor, do tema, das fontes e dos recursos incluídos, portanto ambientes diferentes podem produzir uma paginação ligeiramente diferente.