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!

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

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

heise+ | Softwareprojekte konsistent mit #Antora dokumentieren | iX Magazin https://www.heise.de/ratgeber/Softwareprojekte-konsistent-mit-Antora-dokumentieren-9992034.html #heiseplus #asciidoc

Just in case someone with some #Antora #AsciiDoc and maybe #PlantUML experience is around: I've a question: https://github.com/madmas/demo-antora-doc-A/issues/1 #plsretoot #retoot

@gutocarvalho dê uma olhada no antora, um agregador para documentos asciidoc! https://docs.antora.org... utilizo bastante, para quem precisa de recursos na formatação de documentos é uma solução bem sólida. #asciidoc #antora

Installing Antora in a Podman container for Pi server provisioned with Fedora IoT. I aim to set up my personal Docs site, also proof of concept for my work project.

Next step is to configure Antora Playbook and site properties.

#docs #antora #Podman #iot

@fedora

Documenting with Antora, AsciiDoc and GitLab pages

https://peertube.debian.social/w/fYZmuKtNDabeGJs7fQiX6d

Join a December 2023 Fedora Docs workshop!

https://communityblog.fedoraproject.org/december-2023-docs-workshop/

@fedora
@communityblog.fedoraproject.org

#Documentation #FOSS #Antora

For years I've been a big fan of #Asciidoc; I've used it for presentations, documentation, and training materials. #Markdown is usually fine for simpler use cases, but after working on the #JakartaEE tutorial with Asciidoc and #Antora, writing a README in Markdown is painful...

@Mela und deswegen mag ich #AsciiDoc lieber. Zusammen mit #Antora (Docs-as-Code) lassen sich so ganze Dokumentationen erstellen und mit #Pandoc kann man das auch in fast beliebige Ausgabeformate umwandeln...
P.S.: und es wird direkt von GitLab unterstützt...

@AstridSawatzky The IntelliJ AsciiDoc Plugin by @ahus1 can be configured to use custom stylesheets for the preview pane, so you see exactly what your output will look like:

https://intellij-asciidoc-plugin.ahus1.de

If you use https://antora.org, you can even point to the stylesheets from your custom #Antora UI.

#AsciiDoc #IntelliJ

OPS4J Documentation is moving from Confluence to Git. Initial setup is done: https://ops4j.github.io

#OPS4J #AsciiDoc #Antora #GitHub

@dgarcia360
We have several toolchains for several products, but the latest decision was
#antora (ie. AsciiDoc) with "default" search engine lunr.js and additionally po4a to manage translations.
Speaking of which: The support for multi-language documentation seems not very popular around the SSG community. Same for offline usage. Our products have both these requirements and we struggle quite a bit to find anything decent.