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.
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
@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.