home.social

#antora — Public Fediverse posts

Live and recent posts from across the Fediverse tagged #antora, aggregated by home.social.

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

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

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

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

    👉️ marcphilipp.de/blog/2026/01/25

    Thanks to the @sovtechfund for their support!

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

  5. Coming from on , I think about migrating our projects user manual to using and/or .

    But I wonder if there is a service like for based manuals available for or projects.

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

  6. 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!

  7. 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: docs.olivetin.app/ #opensource #selfhosted #homelab

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

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

    intellij-asciidoc-plugin.ahus1

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

    #AsciiDoc #IntelliJ

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

    #OPS4J #AsciiDoc #Antora #GitHub

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

  12. @meansofescape
    Well, free software is most affordable, so how about, e.g., writing your sources in #Markdown? Conversion to PDF (or anything else) can be done by one of the many free tools, github.com/jmaupetit/md2pdf, #Pandoc, ...
    Or this: I'm currently investigating #antora - pretty cool framework built around #AsciiDoc.
    Guess I'm biased toward software documentation and docs-as-code, though. 😉

  13. @taseroth Just to be sure, there is a vibrant #Antora community via antora.zulipchat.com/ where the core people are very responsive and helpful in either how it can be done, or why it doesn't fit the design concept 🙂

    I would write a page as `pages/topic-a.adoc` and put page-specific images under `images/topic-a/image1.png` etc.

    Also because so far the Intellij Asciidoc/Antora plugin I use does a great job at updating (refactoring) sources and references when renaming things.

  14. dear #documentation people: Is there a way in #Antora to keep #AsciiDoc and images together. I would like to have a subdir per page and in there a 'image' subdir containing only the images for that page

  15. I should work on debugging a complex graph algorithm I inherited.
    Instead I procrastinate by setting up a #knowledgebase for our org with #antora, #AsciiDoc and some custom plugins. So much more fun.