AsciiDoc é um formato em texto para produção de diversos tipos de documentos e publicações. Pode ser usado para gerar diferentes tipos de formatos, como HTML e PDF. Uma das facilidades do formato é permitir a tradução de legendas de figuras e tabelas.

Abaixo segue um exemplo: 

= Olá, AsciiDoc!
Doc Writer <[seu e-mail]>

Um exemplo de http://asciidoc.org[AsciiDoc].


== Primeira seção


.Título de tabela
|===
| c1 | c2 | c3
| d1 | d2 | d3
|===

Considerando que o nome do arquivo é teste.asciidoc, após rodar o comando asciidoc teste.asciidoc, o resultado será o seguinte:

png

Agora, repare na legenda da tabela: começa com "Table 1". Se quiser mudar para "Tabela 1", existem duas abordagens possíveis:

  1. Usando o comando asciidoc, insira :lang:pt-BR no cabeçalho (abaixo do autor).
  2. Usando o asciidoctor, rode o comando com -a table-caption=Tabela nos argumentos.

A diferença entre os dois comandos é que o primeiro é a implementação original, em Python, enquanto o segundo é uma nova implementação, em Ruby.

Leia também

asciidoc software documentação
comente