O slideshow foi denunciado.
Utilizamos seu perfil e dados de atividades no LinkedIn para personalizar e exibir anúncios mais relevantes. Altere suas preferências de anúncios quando desejar.

Asciidoctor in 15min

939 visualizações

Publicada em

A brief introduction to the world of Asciidoctor as delivered at an ACCU London meetup.

Publicada em: Software
  • Seja o primeiro a comentar

Asciidoctor in 15min

  1. 1. ASCIIDOCTOR IN 15MIN Schalk W. Cronjé
  2. 2. WHY? Focus on content, not formatting Source-control friendly No proprietary source format More powerful than Markdown, including Github MD Leanpub Markuva More user friendly than RText or LaTeX No need to fight Docbook
  3. 3. STATE OF SIMPLE PUBLISING 2014
  4. 4. FLAVOURS Asciidoctor (Ruby) Asciidoctorj (JVM) Asciidoctorjs (Javascript) Original Asciidoc (Python).
  5. 5. STATE OF ASCIIDOCTOR 2015
  6. 6. DRAWING SUPPORT PlantUML Ditaa Shaape BlockDiag, SeqDiag, ActDiag, NwDiag GraphViz DOT Via asciidoctor-diagram module
  7. 7. DRAWING SUPPORT +-------------+ | Asciidoctor |-------+ | diagram | | +-------------+ | PNG out ^ | | ditaa in | | v +--------+ +--------+----+ /--------------- | | --+ Asciidoctor +--> | | | Text | +-------------+ | Beautiful | |Document| | !magic! | | Output | | {d}| | | | | +---+----+ +-------------+ ---------------/
  8. 8. SOURCE CODE HIGHLIGHTING [source,cpp] ---- int main(int argc,char** argv) { std::cout << "Hello, world!" << std::endl; } ---- int main(int argc,char** argv) { std::cout << "Hello, world!" << std::endl; }
  9. 9. MATH EQUATIONS Asciimath Latexmath Limitation: Conversion rendered in cloud
  10. 10. BUILDTOOL SUPPORT Maven Gradle Ant Leiningen SBT Grunt
  11. 11. PROJECTS A number of projects use Asciidoctor for documentation complete with tested code snippets, including: Groovy Language Spring Griffon
  12. 12. ACTIVELY IN THE WORKS Asciidoctor → Leanpub Asciidoctor → Mallard Asciidoctor → LaTeX Asciidoctor → Pdf Asciidoctor → Epub
  13. 13. ABOUT THIS PRESENTATION Written in Asciidoctor Styled by asciidoctor-revealjs extension Built using: Gradle gradle-asciidoctor-plugin gradle-vfs-plugin https://bitbucket.org/ysb33r/asciidoctorinanutshell
  14. 14. DEMO
  15. 15. THANK YOU Schalk W. Cronjé ysb33r@gmail.com @ysb33r Read more at http://asciidoctor.org

×