I have moved the documentation from asciidoctor to markdown (using Hugo instead of a self-created static site generator). Also, reorganized the structure and fixed a lot of wording.
It now builds in less than a second and has live preview, which makes it much nicer to edit..
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
IntelliJ IDEA Integration for Playfair
As a developer, I work with the IntelliJ IDEA development environment, as do many other developers. I don't want to discuss its many advantages for developers here, but rather how to use Playfair with the AsciiDoc plugin.
https://schegge.de/2026/03/intellij-idea-integration-for-playfair/
#AusDemLeben #Java #AsciiDoc #Asciidoctor #BarChart #charts #DiagramAsCode #IntelliJIDEA #playfair
FYI: #asciidoc with #asciidoctor #bibtex stumbles upon slashes in bibtex #citation keys
it prints the citation key in the bibliography before the entry.
This happens with all the #IACR #eprint #cryptology paper citations generated on their site
Removing the slash from the citekey is a workaround
Playfair 1.0.0 Release
In the meantime, a lot has happened and the release of Playfair 1.0.0 was forgotten. We would like to make up for this omission and briefly present the highlights of the release.
https://schegge.de/2026/02/playfair-1-0-0-release/
#Bibliotheken #Java #Asciidoctor #BarChart #diagram #DiagramAsCode #DonutChart #EchoSVG #Maven #PieChart #RadarChart #SpiderChart #SVG
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.
Writing documentation should be as low-key as possible to remove the pain from the process. One way to achieve this is through Documentation as Code. Setting it up and configuring it may take some time, but once it's done, you can focus on creating the content itself.
Does anyone know how I could add Asciidoctor to a Flatpak manifest? I tried using the Flatpak RubyGems Module Generator, but I don't know if what it generates is correct; the script isn't actively maintained, and I suspect it's not working properly.
The idea here is to use Asciidoctor as a subprocess to convert content that will be displayed in the application.
Diagram As Code
I recently sat in a lecture about PlantUML and the advantages of Diagram As Code. Diagram As Code is a special variant of Documentation As Code. It is the possibility for software developers to create their documentation in the form of text files without the use of word processing systems.
https://schegge.de/2025/09/diagram-as-code/
#Algorithmen #AusDemLeben #FreshMarker #Java #Asciidoctor #Documentation #Dokumentation #FreshMarker #GnuPlot #Java #JFreeSVG #PlantUml
speedata
readbeanicecream
Jens
0xKaishakunin
Jorge
Foojay.io
Pato Zumbi