Antora

Antora is a Static Site Generators that uses the markup language AsciiDoc. For information on AsciiDoc, see Markdown vs AsciiDoc vs reStructuredText.

Resources

• Antora Documentation
• AsciiDoc Syntax Quick Reference

Info

Run Antora using the following command: npx antora antora-playbook.yml

Features

• Playbooks instead of config files or build scripts that describe:
  • Which repos/branches to gather content from
  • Which UI/theme to apply
  • Where to publish the site
• Multi-repository documentation
• Reuse shared materials (DRY)
• Built-in versioning
• Extensions
• Source‑to‑source references using resource IDs instead of links based on paths/URLs

My Thoughts

• Harder to set up than most other Static Site Generators I’ve tested
• Very powerful

Example Sites

• Antora Documentation
• Antora Demo on ReadTheDocs
• Antora with Lightbend Theme