Lmst

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.

@cypher2020

kommt drauf an. BookStack ist schon ganz schön umgesetzt, aber so sehr buchorientiert. Für Dokumentationen oder Notizen finde ich ein Wiki eigentlich besser. Für Teams würde ich die Kombination #git mit #mkdocs, #asciidoctor oder #sphinx verwenden.
https://git-scm.com
https://www.mkdocs.org
https://asciidoctor.org
https://www.sphinx-doc.org

@hastur that sucks, I hate $m word with a passion, I changed over to using markdown language for all content now known as #asciidoctor and use templates to create letters that work with $m crap.

Multimedia Walls with Asciidoctor

Ever wanted to create a photo wall, video wall, or audio wall for your site? Well, if you can make a list, you can build a wall... with Asciidoctor.

https://readbeanicecream.surge.sh/2025/03/02/multimedia-walls-with-asciidoctor/

#technology #tech #asciidoctor #blog #blogs #blogging #personalweb #smallweb #indieweb #opensource

Quick Decks with Asciidoctor

Ever needed to create a quick slide deck to share with someone in a non-editable format? Asciidoctor-pdf may be the quickest way to create nice looking PDF slide decks.

https://readbeanicecream.surge.sh/2025/02/26/quick-decks-with-asciidoctor/

#technology #tech #asciidoctor #asciidoctor-pdf #slides #decks #presentation #indieweb #smallweb #opensource

Possibly the Easiest Blog Flow You Could Ever Have

Ever wanted to blog, but thought, "I don't want build a website or be a web master. I just want to write." Well, good news. With Asciidoctor and Surge. You can worry less about the "technical stuff" and focus on publishing your writing.

https://readbeanicecream.surge.sh/2025/02/19/possibly-the-easiest-blog-flow-you-could-ever-have/

#technology #tech #opensource #blog #blogging #indieweb #smallweb #asciidoctor #surge #news #blogs #socialmedia #rss #rssfeeds

#release #asciidoctor-go v0.6.2 (2025-02-01)

The asciidoctor-go is the #golang module to parse the #AsciiDoc markup and convert it into HTML5.

Changes,

* Fix section detected as paragraph after list and comment.
* Replace the fieldalignment and shadow using our internal gocheck command.

https://git.sr.ht/~shulhan/asciidoctor-go/refs/v0.6.2

The next @hackergarten in #Dortmund just has ben announced for Feb, 13th on #meetup: https://www.meetup.com/hackergarten-dortmund/events/305627465/
Looking forward to #hack with you and contribute to #opensource #java #web #ai #python #typescript #asciidoctor

Guess my weekend just got "upgraded" to migrating some templates from Asciidoc to Typst. No escaping this one!

#typst #asciidoc #asciidoctor

Big thanks to whoever recommended Typst a few weeks ago! I usually work with Asciidoctor, but regrettably, "traditional footnotes" are *not* available|implemented, and for some documents, I simply can't use endnotes.
https://typst.app

#typst #asciidoc #asciidoctor

A screenshot of the bottom of a PDF page showing three test footnotes.

Proposal for a new DSL for asciidoctor-gradle 5.x

https://github.com/asciidoctor/asciidoctor-gradle-plugin/issues/742

Please boost and provide your feedback.

#asciidoctor #gradle

In the end, I needed to upgrade to asciidoctor 2.0.23 🤷‍♂️

$ asciidoctor -v
Asciidoctor 2.0.23 [https://asciidoctor.org]
Runtime Environment (ruby 3.3.5 (2024-09-03 revision ef084cc8f4) [x86_64-openbsd7.6]) (lc:US-ASCII fs:US-ASCII in:US-ASCII ex:US-ASCII)

#asciidoc #asciidoctor

From my recent conversation with @trwnh (<https://mastodon.social/@trwnh/113377796235320764>) I'm getting the impression that if I managed to create a well-integrated #AsciiDoctor-centered blogging system to replace my #Ikiwiki setup I wouldn't be the only one using it. And I don't even mind #Ruby as a programming language. Now if I only had a few extra 24 hours in the day, I could even get to it.

#fedihelp & #fediask

Hello #fedifriends, I've just realized that #asciidoc & #asciidoctor aren't the same thing, so I was using the documentation of asciidoctor and processing the my document with asciidoc… 🤦‍♂️

I don't know who came late, but the choice of the name is very confused, so now I'd like to know what the #fediversians like to use if asciidoc or asciidoctor, or at least you recommend.

The point is some stuff aren't working because perhaps aren't for ascidoc on the other end asciidoctor is very aggressive on the web search, so unless you don't exclude it from the search it completely eclipses the other one.

Thanks! 🙏

#opensource #markup

I started with VSCodium, which worked reasonably well, until it started crashing due to the diagramming extensions we were trying to use.

In the screenshot you can see me using #NeoVim with the official Ruby-based #Asciidoctor CLI and plugins

A screenshot of a text editor and console, rendering to a web browser preview of code documentation

I've just tagged and released a new minor release (v2.3) of my #Asciidoctor extension for #LiterateProgramming

https://github.com/Oblomov/asciidoctor-litprog

I was actually in doubt if it should be considered a minor or major release, since there are some rather extensive changes and some new features, such as the possibility to output a graph of the chunk inclusion/dependency tree in #DOT format.