AsciiDoc is a markup language for documentation. Asciidoctor is a popular implementation of a rendering engine for AsciiDoc.
Conventions allow you to add formatting to your text and structure it with tables, lists and chapters. You can keep your AsciiDoc files in a versioning system like Git to track all changes. Many companies and open source projects use it to write their technical documentation.
My talk “Asciidoctor Deep Dive” shows you the details on how to tackle corner cases in formatting. The second part of the talk shows you how to create PDF files with the PDF extension of Asciidoctor.
The slides are in English. You find a recording in English and German below. For the online news channel heise.developer I’ve written a German blog post “Documentation as Code mit Asciidoctor”.
An example repository is available on GitHub: https://github.com/ahus1/asciidoctor-deepdive
If you want to learn more about the topic, I’ve recorded a Udemy course “Technical Writing with AsciiDoc and IntelliJ IDEA”.
There’s also Hubert Sablonnière’s talk at Devoxx 2017: “Documentation as code (explained to my dad)”.
Contact me if you want me to talk about this topic at your meetup, company or conference. I’m also available for trainings and workshops.
- [en] Asciidoctor Deep Dive, JavaZone 2019 Oslo on 2019-01-09
- [de] Asciidoctor Deep Dive, JavaLand 2018 in Brühl on 2018-03-13..14
- [en] Continuous Delivery for your Documentation, Continuous Lifecycle 2017 in Mannheim on 2018-03-13..14
- [de] Gesunde Dokumentation mit Asciidoctor, Berlin Expert Days 2015 (Berlin) on 2015-09-17..18