{"id":8332,"date":"2024-06-15T00:00:00","date_gmt":"2024-06-15T04:00:00","guid":{"rendered":"https:\/\/old.fredlopes.com.br\/tipografia\/asciidoc\/"},"modified":"2024-06-15T00:00:00","modified_gmt":"2024-06-15T04:00:00","slug":"asciidoc","status":"publish","type":"page","link":"https:\/\/backup.fredlopes.com.br\/index.php\/tipografia\/asciidoc\/","title":{"rendered":"Asciidoc"},"content":{"rendered":"\n

A Asciidoc<\/a> \u00e9 uma linguagem de marca\u00e7\u00e3o<\/em> de texto criada para produzir documenta\u00e7\u00e3o t\u00e9cnica. Em palavras leigas, \u00e9 uma linguagem de programa\u00e7\u00e3o muito simples que adicionamos a textos puros para gerarmos um outro texto<\/em> formatado em outra linguagem mais complexa, como a HTML ou a DocBook.<\/p>\n\n\n\n

Um exemplo<\/h2>\n\n\n\n

Como \u00e9 melhor um exemplo do que uma montanha de explica\u00e7\u00f5es t\u00e9cnicas, considere o texto a seguir, no formato txt<\/strong>, com muito pouca formata\u00e7\u00e3o:<\/p>\n\n\n\n

Meu primeiro texto em Asciidoc
Fred Lopes <contato@fredlopes.com.br>

Este \u00e9 um texto de exemplo sobre a AsciiDoc.

Se\u00e7\u00e3o 1

Primeira se\u00e7\u00e3o apenas com um par\u00e1grafo.

Se\u00e7\u00e3o 2

Segunda se\u00e7\u00e3o, com uma lista

item 1
item 2

e duas subse\u00e7\u00f5es.

Subse\u00e7\u00e3o 1

Um pouco de linguagem de programa\u00e7\u00e3o Ruby:

puts \"Ol\u00e1, mundo!\"

Subse\u00e7\u00e3o 2

Um pouco de texto em it\u00e1lico, negrito e monoespa\u00e7ado.<\/pre>\n\n\n\n
Agora acrescente a ele alguns s\u00edmbolos, \u00e0s vezes sutis, como mostramos a seguir em vermelho<\/mark><\/strong>:<\/p>\n\n\n\n
=<\/mark><\/strong> Meu primeiro texto em Asciidoc
Fred Lopes <contato@fredlopes.com.br>

Este \u00e9 um texto de exemplo sobre a https:\/\/asciidoc.org\/[<\/mark><\/strong>AsciiDoc]<\/mark><\/strong>.

==<\/mark><\/strong> Se\u00e7\u00e3o 1

Primeira se\u00e7\u00e3o apenas com um par\u00e1grafo.

==<\/strong> <\/mark>Se\u00e7\u00e3o 2

Segunda se\u00e7\u00e3o, com uma lista

*<\/mark><\/strong> item 1
*<\/mark><\/strong> item 2

e duas subse\u00e7\u00f5es.

===<\/mark><\/strong> Subse\u00e7\u00e3o 1

Um pouco de linguagem de programa\u00e7\u00e3o Ruby:

[source,ruby]<\/mark><\/strong>
puts \"Ol\u00e1, mundo!\"

===<\/strong> <\/mark>Subse\u00e7\u00e3o 2

Um pouco de texto em _<\/mark><\/strong>it\u00e1lico_<\/mark><\/strong>, *<\/mark><\/strong>negrito*<\/mark><\/strong> e `<\/mark><\/strong>monoespa\u00e7ado`<\/mark><\/strong>.<\/pre>\n\n\n\n
O texto se tornou ligeiramente mais leg\u00edvel, mais estruturado. Mas esse \u00e9 s\u00f3 o passo intermedi\u00e1rio.<\/p>\n\n\n\n
Agora \u00e9 que a m\u00e1gica ocorre. Use um outro programa – em nosso caso, o AsciiDoctor<\/a> –  sobre esse segundo texto. Teremos a gera\u00e7\u00e3o de uma p\u00e1gina inteira da web, da qual fizemos s seguinte captura de tela:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Outro exemplo<\/h2>\n\n\n\n
Outro exemplo concreto \u00e9 meu livro sobre a TikZ<\/a>, em andamento.<\/p>\n\n\n\n
Como aprender?<\/h2>\n\n\n\n
O link a seguir \u00e9 fundamental:<\/p>\n\n\n\n