Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Asciidoctor in 15min

935 views

Published on

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

Published in: Software
  • Be the first to comment

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

×