has anyone gotten #Antora with #asciidoctor #bibtex to work? I would really love to use Antora as a front end for some kind of paper with lots of citations.

All I get is an error about #opaque in #npm I cannot get fixed.

✨️ New blog post: "STF Milestone 10: Documentation improvements"

Modernizing #JUnit's documentation by adopting #Antora and hosting on @statichost

👉️ https://marcphilipp.de/blog/2026/01/25/stf-milestone-10-documentation-improvements/

Thanks to the @sovtechfund for their support!

STF Milestone 10: Documentation improvements • Marc Philipp

Personal website

I'm going to have to write my own #AsciiDoctor-based static site generator, right?

I still haven't found anything that fits my use case, coming from #ikiwiki, which I want to leave because it's slow, written in Perl (not my favorite language) and doesn't integrate well with AsciiDoctor.

#Antora manages to both be overengineered for my use case *and* miss essential features like feed generation. Also node.js, no thanks

1/2

#SSG

Für mein neues Projekt habe ich diesmal die Architekturdokumentation nach #arc42 mit #Antora aufgebaut. Documentation as Code in seiner Reinform.

@xwiki how about making documentation part of your source code? And on top of that, have an acceptance criteria for pull requests: documentation is updated.

Does not make perfect documentation, but at least it significantly reduces documentation rot.

And thanks to #antora, docs from several repositories can be aggregated into one single webpage.

Wile not an option for everything, this is a solution for when things are tracked in a version control system like git.

🛠️ Diagramm oder Doku? Warum nicht beides!

Unser CEO @madmas zeigt am 12. Mai auf der betterCode() ArchDoc, wie Architekturdiagramme und Dokumentation gemeinsam entstehen – mit PlantUML, AsciiDoc & Antora, automatisiert via GitLab CI.
Ideal für alle, die Architektur dokumentieren, ohne doppelte Arbeit zu machen. Oder Chaos. 😉
🔗 https://archdoc.bettercode.eu/veranstaltung-83492-se-0-diagramm-oder-doku-warum-nicht-beides.html

#DocsAsCode #SoftwareArchitecture #PlantUML #AsciiDoc #Antora

betterCode() ArchDoc 2025 - Online-Event für Softwarearchitekten

heise-Konferenz für Softwarearchitektinnen und -architekten: moderne und praktische Dokumentationsmethoden mit und ohne KI. Anerkannten Experten und Diskussion.

betterCode() ArchDoc 2025

Coming from #MkDocs on #ReadTheDocs , I think about migrating our projects user manual to #Asciidoc using #asciidoctor and/or #antora .

But I wonder if there is a service like #readthedocs for #asciidoc based manuals available for #OpenSource or #foss projects.

Important is that those platforms do support @Codeberg (#forgejo aka #gita ) code hosting, instead of Microsoft GitHub.

Switching to Antora for the OliveTin docs was the best thing ever for the docs. Now just added support for doc tabs with a simple extension :-) #asciidoc #antora thanks Dan Allen!
I've been spending a bunch of evenings migrating to a new documentation system for OliveTin - #antora, fixing dead links, improving formatting, and overall design of the docs: https://docs.olivetin.app/ #opensource #selfhosted #homelab
OliveTin Introduction :: OliveTin docs

Softwareprojekte konsistent mit Antora dokumentieren

Mit Antora können Sie ganze Dokumentationen für statische Websites auf Basis von AsciiDoc über mehrere Repositorys hinweg strukturieren und konsistent halten.

iX Magazin