Output rendering

HTML

• Hugo with its AsciiDoc support (with Asciidoctor)? :-)
• Jekyll AsciiDoc Plugin
• Quire and its Community Showcase. Some support for interactive maps based on Hugo. Does Quire support AsciiDoc?

Some examples, with automatic Table of Contents on the side, and with built-in search:

• ReSpec Documentation used by W3C
• DocuAPI theme with Hugo, see demo

PDF

How to convert asciidoc to pdf? - Stack Overflow

1. AsciiDoc → Asciidoctor.js → HTML → wkhtmltopdf → PDF
   (Ctrl+Shift+P, select "AsciiDoc: Export document as PDF", from Visual Studio Code: asciidoctor.asciidoctor-vscode)
2. AsciiDoc → _Asciidoctor PDF → PDF
   (Ctrl+Shift+P, select "AsciiDoc: Export document as PDF", from Visual Studio Code: asciidoctor.asciidoctor-vscode, with setting "Use_asciidoctorpdf" turned on)
3. Asciidoctor PDF (using Prawn)
4. AsciiDoc → Asciidoctor or AsciiDoc → DocBook → DocBook XSL and Apache FOP → PDF
   (asciidoctor/asciidoctor-fopub: A portable DocBook-to-PDF build command that wraps DocBook XSL and Apache FOP)
5. AsciiDoc → Asciidoctor or AsciiDoc → DocBook → dblatex → PDF
6. If Quire works, use its PDF generation method? (with PrinceXML?)

To do: To test and compare.

More explorations (to be sorted)

Antora solves the problem of writing AsciiDoc distributed over multiple repositories by introducing a component concept and providing a generator that merges the multiple sources automatically.

We might not end up using Antora for this paper, but worth studying some ideas from it, especially because Antora is apparently written by Dan Allen who also started the Ruby-based Asciidoctor (if Anthony is not mistaken).

Links (To be sorted)

• antora vs hugo - Google Search
• Antora 101: The Three Core Concepts You Need To Know To Use It Fully - Matthew Setter
• Antora vs Hugo | Static Site Generator Comparisons
• What static site generator do you use? | Lobsters
• Zola
• Get Hugo to render (nice) Asciidocs | Andreas' Blog
• Converting existing AsciiDoc into an Antora project | Andreas' Blog
• arc42 - arc42

More Antora stuff:

• asciidoc-docs/docs/modules/directives/pages at main · asciidoctor/asciidoc-docs
• docs.asciidoctor.org/antora-playbook.yml at main · asciidoctor/docs.asciidoctor.org
• Documentation as code (explained to my dad) by Hubert Sablonnière - YouTube
• Slice & Dice your Monolith with Domain Driven Design by Edson Yanaga - YouTube
• Hands on - Multi-repository docs with Antora - YouTube