Diese Präsentation wurde erfolgreich gemeldet.
Wir verwenden Ihre LinkedIn Profilangaben und Informationen zu Ihren Aktivitäten, um Anzeigen zu personalisieren und Ihnen relevantere Inhalte anzuzeigen. Sie können Ihre Anzeigeneinstellungen jederzeit ändern.

Asciidoctor in 15min

938 Aufrufe

Veröffentlicht am

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

Veröffentlicht in: Software
  • Als Erste(r) kommentieren

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

×