Asciidoctor on

Makefile to process all Asciidoctor files in a directory

christoph.stoettner@stoeps.de (Christoph Stoettner) — Sun, 13 Dec 2020 14:00:00 +0200

I write most of my documents (blog posts, documentation, recipes and so on) with Asciidoctor. Everything is organized in Git repositories.

During GPN 19 (Gulaschprogrammiernacht) I showed how to build html and pdf with a Gitlab CI/CD pipeline. That’s quite handy, but lots of documents I build, I just need locally.

So today I played with WSL2 and a Makefile to build all Asciidoctor files in a directory.

Asciidoctor open links in new window

christoph.stoettner@stoeps.de (Christoph Stoettner) — Mon, 27 Apr 2020 11:49:13 +0200

I write most of my documentation with Asciidoctor, so saving some keystrokes is important.

You can add window=_blank to links in your Asciidoctor source.

Asciidoctor for Professional Looking Documentation

christoph.stoettner@stoeps.de (Christoph Stoettner) — Mon, 10 Jun 2019 18:20:11 +0200

For GPN19 I prepared a second talk on Documentation with any Editor. The talk was based on a previous one from Froscon 13, but the pipeline tooling changed.

This time there was a technical issue during the recording and so there are only the slides available, but you can still watch the video of the Froscon talk: Froscon 13: Documentation with any Editor

Gulasch Programmiernacht 2019 - #gpn19

christoph.stoettner@stoeps.de (Christoph Stoettner) — Sat, 01 Jun 2019 11:22:32 +0200

:icons: font

Since thursday the gpn19 (Gulasch Programmiernacht) is taking place in Karlsruhe at ZKM. I’m happy that I got the chance to give two talks:

Documentation with any editor

Automate your Infrastructure Deployment

Asciidoctor Windows

christoph.stoettner@stoeps.de (Christoph Stoettner) — Sat, 25 Aug 2018 21:39:18 +0200

During my talk at FrOSCon I wasn’t sure how to install Asciidoctor on Windows. So I tried on a Windows 10 VM.

When you want to use Asciidoctor on a Windows desktop, you need to download the Rubyinstaller and install it.

Now you can open a administrative command window and install with gem install asciidoctor.