#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

Writing a lot of content in #ASCIIDOC and discovered #livejs to hot load my edits for preview.

Just add the script to your docinfo file when building on desktop (using fswatch to detect changes and do the rebuild on edit save).

Changes get displayed in the browser a short while later.

https://docs.asciidoctor.org/asciidoc/latest/docinfo/

Putting it here in case it helps others with #DocsLikeCode workflow

Hey frendos. Does anyone have a good link / summary for how to add a new processor to #asciidoc ?

tl;dr There doesn't seem to be a good way to render #jvm #bytecode and I would like to fix that, if one doesn't already exist. #java #ruby

@schubisu Es geht mir darum, die Nicht-Fediverse-Bubble über Alternativen zu informieren. Das ist einfach der größte Teil der Bevölkerung. Daher auch die Ideen mit #shareitonlinkedin - also den Alternativen Lösungen auch in anderen Bubbles Reichweite geben.

WriteFreely schaue ich mir mal an. Wenn ich aktuell Blogge nutze ich #Jekyll zur Erstellung statischer Blogs mit #asciidoc und #git auf #gitlab (https://jekyll-theme-endless.gitlab.io/)

Kennt sich hier jemand mit #asciidoc aus? Ich würde gerne ein Sudoku basteln und muss daher in einer Tabelle an bestimmten Stellen dickere Linien zeichnen (jede dritte Spalte und Zeile).

Geht das mit #asciidoctor? Kann mir jemand einen Tipp geben? :BoostOK:

#Emacs loves #AsciiDoc https://batsov.com/articles/2026/06/11/emacs-loves-asciidoc/

I hope you'll enjoy all the recent improvements in adoc-mode and asciidoc-mode!

I agree with u/TerribleReason4195 in Reddit: the new site is much better.

@FreeBSDFoundation true: it's a stronger foundation for the future of the FreeBSD Project.

Too few people appreciate the amount of work that's required, collectively and individually, for a milestone such as this.

I believe that this year's transition would have been far more difficult without the migration that Sergio Carlavilla spearheaded five years ago. Before and after: <https://github.com/freebsd/freebsd-doc/tree/0cff342f42461c5081b98bce7581f43df319e4f4> | <https://github.com/freebsd/freebsd-doc/tree/989d921f5d4ac8d8b7c831c13b8954ad1901be24>.

#FreeBSD #website #Hugo #AsciiDoctor #AsciiDoc

Could anyone give me any pointers on the tooling for the #FreeBSD Documentation Project?

I really like its style (and its use of #AsciiDoc) and would like to do something similar for the #Psion Documentation Project.

EDIT: I might already have my answer here: https://docs.freebsd.org/en/books/fdp-primer/overview/

I published “Being the Change⁠🌍 (featuring my abandoned and ongoing changes)” at
https://www.ii.com/be-the-change/
#BeTheChange #BeingTheChange #BeKind #CarFree #Boycott #Shopping #FLOSS #Standards #Activism #Hacktivism #AsciiDoc #Markdown #Privacy #Security #Tech
#InfiniteInk
#Byℵ #ByNM

@federico3 As someone with a hat in this, it's because other formats are pretty arbitrary too. #Markdown was designed to still be readable as plaintext -- something it fails at, yes, with that awful link syntax -- but the same complaint can be levied against ReST, #AsciiDoc etc which all have arbitrary and unusual syntax patterns that work for a parser but don't necessarily work for plaintext.

And plaintext, unlike programming languages, depends more on aesthetic principles that are more personal. Programmer may argue about line-break before `{` but the code still compiles -- that's not the case with markup languages!

For my databaseless forum I invented a markup syntax where the output can be copied and pasted as valid input: just leave the `*` & `_`'s in and style with CSS, it works surprisingly well. For ReMarkable I hewed closer to plain-text aesthetics but it needs some revisions, and it's difficult to swap one bad syntax for a better one down the line when the format is already in wide use.

Markdown would have seen a decline, until GitHub took off. I think that really cemented its modern usage more than anything. You can stab it with your steely knives, but you just can't kill the beast 🤷

Why are we still using #markdown and, especially, why aren't we using #AsciiDoc? https://bgslabs.org/blog/why-are-we-using-markdown/

Has anyone any recommendations for tools / styling for #ebooks? I'm looking at #asciidoc to #epub but I'm wondering what the "right" way to style the epub should be

-- edit: A very good solution has been found, but Mastodon can't add images to retoots, so here we are, using URLs: https://oldbytes.space/@Kroc/116346357622698597

#worldglass #writersofmastodon #ebook #writing #writingcommunity

@nielsk Think of the Family Guy meme to remember it. Markdown is the weird one.

#markdown #orgmode #asciidoc #plaintext

Easy Online Profiles with Asciidoctor

Want an online presence, but you don't want to build a website, or blog, or self-host? With really basic terminal dabbling and asciidoctor you can quickly make a minimal, simple profile where you own your data.

https://readbeanicecream.surge.sh/2026/03/13/easy-online-profiles-with-asciidoctor/

#indieweb #smallweb #socialmedia #asciidoctor #plaintext #asciidoc

I start to leverage the true potential of #codingassistants only now. So far, I crossposted my blog posts by first transforming them from #Asciidoc to #Markdown by hand. Feasible, but boring.

I have created a #ClaudeCode command and my life is so much better.

I've converted some random dev notes I had lying around from working on clojure-ts-mode, neocaml and asciidoc-mode to a blog post with some general advice for building #Emacs major modes powered by #TreeSitter https://batsov.com/articles/2026/02/27/building-emacs-major-modes-with-treesitter-lessons-learned/

I hope some of you will find it useful! I certainly wish someone had written such an article a year ago when I started to get more serious about playing with TreeSitter.

#Clojure #OCaml #AsciiDoc

I've put together asciidoc-mode (https://github.com/bbatsov/asciidoc-mode) - a super lean major #Emacs mode for editing #AsciiDoc documents, powered by #TreeSitter

It's a lighter and simpler alternative to the more established adoc-mode (also maintained by yours truly), that has been sitting in the back of my mind for a while and became possible recently when a TS grammar for AsciiDoc was created.

I hope you'll find the new mode useful!

@sanityinc Can you help me get it in MELPA? (https://github.com/melpa/melpa/pull/9850)

**Stella & Finn (see above) is now available FOR FREE!**

For at least the following 24 months, you can read the whole story, in all its PDF or ePub glory, *without spending a penny.* *You are free to download and enjoy NOW*!

Or, if you want, set a voluntary payment, which I would appreciate very much and would help me a lot in making even better stuff for you all to enjoy, like, who knows... a new *drawing tablet* for upcoming comics! See my Ko-fi goal for more on that :) - https://ko-fi.com/wallabra

The context, before anyone asks, is that I'm about to enter a public office and I can't really engage in commercial activity, due to a strict anti-Conflict-of-Interest clause. To someone else, this might be a bit disheartening, but I never really wanted to see my art as a "job" in the first place anyway, so it's whatever :p

#FurryArt
#Furry
#Romance
#FurryErotica
#Writing
#Reading
#IndieWriting
#SelfPublish
#SliceOfLife
#Bookstodon
#AsciiDoc
#MadeWithFOSS
#IndiePub
#SelfPub
#ShortStory
#Erotica

@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

I just started sponsoring https://bsky.app/profile/nlopes.dev because of their the fantastic work on #AsciiDoc tooling: https://github.com/nlopes/acdc

Please support open source developers! https://github.com/sponsors/nlopes?sp=dflock

Docs-as-Code, Arc42, ASCIIDOC, Gradle & Co. im Einsatz

https://videos.ijug.eu/w/aH3XTzaqgvCYzemNjXzBYC

A rowdy jaguar can't keep herself off her roommate, a sweet Labrador gardener. Will he give in and sink into her fur, or will he manage to bribe her off with enough carrots?

Find out, in this sweet and heartwarming piece of furry romance / gentle erotica.

🐾*** *Stella & Finn is now also available FOR FREE on Itch.io, alongside Ko-fi!**

The main story spans about 4,000 words.

* Itch.io: https://wallabra.itch.io/stella-and-finn
* Ko-fi: https://ko-fi.com/s/b1e25eca7f

For fans of affectionate playfulness, gentle consensual eroticism, and emotional connections.

Written using AsciiDoc. Cover image made in Inkscape.

#FurryArt #Furry #Romance #FurryErotica #Writing #Reading #IndieWriting #SelfPublish #SliceOfLife #Bookstodon #AsciiDoc #MadeWithFOSS #IndiePub #SelfPub #ShortStory #Erotica

Math in Markdown and AsciiDoc

A blog by Ronald

#dev #softwaredevelopment #SoftwareDesign #AsciiDoc #Math #Markdowm #LaTeX

https://jdriven.com/blog/2025/12/Math-in-Markdown-and-AsciiDoc/

🆕 pandoc 3.8.3 🎉

This release adds three new input formats (#Asciidoc, #PPTX, and #XLSX) and one new output format (#BBCode + variants).

It also fixes a number of bugs (including some regressions in 3.8). See the changelog for full details.

Thanks to all who contributed!

https://github.com/jgm/pandoc/releases/tag/3.8.3

#pandoc #release

Top Laune wieder heute. Draußen ist es nass und bäh. Das wird eine super @nook

Aber falls ihr Lust habt, fragt mich was zu #AsciiDoc 😉

@melix @aalmiray What happened to JBake?

It, and the related Gradle plugin, seemed to have died a death.

#jbake #asciidoc

Writing an Asciidoc Parser in Rust: Asciidocr

https://www.bikesbooksandbullshit.com/bullshit/2025/01/08/writing-an-asciidoc-parser-in-rust.html

#HackerNews #Asciidoc #Rust #Parser #Programming #TechBlog