Mastodawn

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

GitHub - freebsd/freebsd-doc at 0cff342f42461c5081b98bce7581f43df319e4f4

FreeBSD doc tree (read-only mirror). Contribute to freebsd/freebsd-doc development by creating an account on GitHub.

GitHub

Daniel Hinojosa

May 16

Blog entry: How I do Documentation and Learning with #Asciidoctor

Some thoughts on jotting things down and referencing them later. Hope it helps.

https://evolutionnext.com/article/how-i-do-documentation-and-learning-with-asciidoctor

Evolutionnext: How I do documentation and learning with Asciidoctor

My personal approach to documentation and learning using Asciidoctor and Git repositories. Instead of relying on large knowledge-management systems, I organize my learning into focused `*-study` repositories with a simple structure for notes, projects, references, and inbox material. The goal is to keep knowledge easy to capture, revisit, and evolve over time.

speedata Apr 20

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

https://doc.speedata.de/publisher/en/

#speedatapublisher #documentation #asciidoctor #markdown

speedata Publisher

Welcome to the speedata Publisher documentation. The speedata Publisher generates PDF files from XML data and XML layout instructions. Getting Started …

readbeanicecream Mar 14

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

Easy Online Profiles with Asciidoctor - ReadBeanIceCream

Jens Mar 5

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

</Agile> 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 Play…

</Agile>

Jens Feb 25

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

</Agile> 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.

</Agile>

Foojay.io Jan 19

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. As a developer, I appreciate good documentation, but…...
#asciidoctor #GitLab #GitLabCI #GitLabPages
https://foojay.io/today/documentation-as-code-with-asciidoctor-gitlab-ci-and-gitlab-pages/

foojay – Documentation as Code with AsciiDoctor, GitLab CI, and GitLab Pages

foojay

Morte por mil agulhas Nov 20, 2025

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.

#flatpak #ruby #flathub #asciidoc #asciidoctor

Jens Sep 27, 2025

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

Show thread

Oblomov Aug 26, 2025

#Jekyll with the #AsciiDoctor plugin looks pretty decent as an option (the plugin is also well-integrated), but Jekyll seems to be a bit restrictive on the site structure, and anybody who has perused my website

https://wok.oblomov.eu/

probably knows by now that aside from the crappy CSS it also fully leverages the power of #ikiwiki's inline directive for nested awesomeness*.

*debatable

So hm should I rewrite Ikiwiki in #Ruby?

2/2