#asciidoc — Public Fediverse posts

We've updated our docs website to be based on Antora and is now published here! :cockpit:

This has the added benefit of showing us docs for different versions and allows us to be more flexible.

https://docs.cockpit-project.org/cockpit-guide/latest/guide/index.html

#asciidoc #antora

@david_chisnall I have only one minor criticism of GitHub's highlighting, and I don't know whether it is (or should be) fixable.

In cases such as the one pictured below, it's necessary to scroll/page down hugely to bring a tiny change into sight.

In other words, 'Show Diff' shows much, much more than the diff.

A wild guess: maybe specific to AsciiDoc in GitHub, or the FreeBSD Documentation Project's use of AsciiDoc in cases such as this.

@zev @bentolor

#GitHub #AsciiDoc #preview #diff

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!

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

@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

@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, https://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. 😉

What can the @fedora docs team do to make it easier for you to casually contribute to the community documentation using the new #GitLab web UI?

https://discussion.fedoraproject.org/t/please-let-us-know-how-to-improve-the-guide-for-casual-contributions-in-docs-which-possibilities-in-the-new-gitlab-suit-you-best/81227

#documentation #FOSS #Antora #Git #ASCIIdoc

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