Writing an InfoQ mini book with Asciidoctor
summary
Shows a concrete pipeline that uses Asciidoctor plus Gradle to produce HTML, PDF, EPUB and MOBI from a single source, with the example repo infoq-mini-book on GitHub. Uses git for copy edits, IntelliJ or any editor with live preview via BrowserSync, Gradle watch to rebuild, and KindleGen (manual install) for MOBI; Lulu printing produces a proper 6x9 physical mini book about 100–140 pages. Editors use AsciiDocFX or GitHub PRs; build scripts work but include hard‑coded bits to remove.
AI-written summary · about
chapters (5)
- 0:00Start
- 0:17Writing a book is hard
- 8:34Writing Asciidoctor
- 14:21InfoQ Editing Process
- 14:44Info Publishing Process
related talks
51mGetting started with Asciidoctor
47mDocumentation as code (explained to my dad)
46mAsciidoctor: because writing docs does not have to suck
41mStop making fool of yourself about documentation
19mReproducible, dynamic, and elegant books with Quarto
44mPushing documentation (so it doesn't hurt anymore)
50mContinuous and Automated Documentation Docs As Code in Practice
31mCreating a documentation site for users with AsciiDoc and Antora