Spice Up Asciidoctor Documentation With Java
summary
Shows how to run Asciidoctor on the JVM with AsciidoctorJ, use it as a CLI or Gradle/Maven dependency, and extend the parser with Java extensions that actually work. Demonstrates an inline macro processor turning "mastodon:mrhaki" into a clickable link, an include processor that embeds RSS as Asciidoc lists, and registering extensions via META-INF/services so a jar plugs into the CLI. Generates HTML and PDF, supports converting strings or files, and is unit-testable; the examples compile and produce the expected output.
AI-written summary · about
chapters (29)
- 0:00Introduction to session
- 1:07About the speaker
- 1:49Agenda overview
- 2:31What is Asciidoctor
- 3:33Introducing AsciidoctorJ
- 3:55Asciidoc markup basics
- 5:20Common Asciidoc features
- 6:22Custom blocks and extensions
- 7:25Including source code
- 8:46Using AsciidoctorJ CLI
- 9:51Generating HTML output
- 10:55Integration with build tools
- 11:58Using AsciidoctorJ in Java code
- 13:25Converting files programmatically
- 15:30Generating PDF output
- 16:11Converting strings
- 18:06Document structure access
- 19:56Transformation process explained
- 21:00Abstract syntax tree basics
- 22:05Extending parsing process
- 23:49Extending generation process
- 25:34Writing inline macro processor
- 31:56Testing custom processor
- 37:21Packaging extensions for CLI
- 39:30Using extensions in CLI
- 41:15Writing include processor
- 43:43Using existing extensions
- 44:45Popular extension examples
- 46:07Q&A and resources
related talks
51mGetting started with Asciidoctor
46mAsciidoctor: because writing docs does not have to suck
01h 00mLevels of Docs as Code
29mAsciidoctor: New, Noteworthy, and Beyond
37mCode the documentation instead of documenting the code
41mStop making fool of yourself about documentation
25mDocumentation as Code, Where to Start?
50mContinuous and Automated Documentation Docs As Code in Practice