Asciidoctor Windows

Created:
Last Update:
Author: Christoph Stoettner
Read in about 1 min · 127 words
Asciidoc Asciidoctor Windows Opensource

Fountain pen and a notebook

Photo by Aaron Burden | Unsplash

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.

Let’s test with an easy document:

test.adoc

= Test Asciidoctor on Windows
:icons: font

== Admonition

NOTE: Will this work?

TIP: Convert with `asciidoctor test.adoc`

windows adoc

Update

I had a typo in the conversion command, you can still see it in the screenshot. Sorry about that. You need to convert the source with asciidoctor test.adoc not .html!

To get the easy install into the documentation, I created a pull request at Github .

Author

Christoph Stoettner

I work at Vegard IT GmbH as a senior consultant with a focus on collaboration software, Kubernetes, security and automation. I mainly deal with HCL Connections, WebSphere Application Server, Kubernetes, Ansible, Terraform and Linux.

Sometimes my daily work results in technical talks and blog articles, which you can follow here more or less regularly. You can find the presentations in the main menu under public speaking .

I created a list of tools I use regularly, most of which have been released under an open source license.

In my spare time I read a lot, test all kinds of technical software and gadgets and try to follow about 200 RSS feeds.
Here you can find a collection of them.

This is my private blog, all opinions are my own.

           

Suggested Reading
Aaron Burden: Fountain pen and a notebook

Asciidoctor open links in new window

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.

Created:
Last Update: Read in about 1 min
Aaron Burden: Fountain pen and a notebook

Asciidoctor for Professional Looking Documentation

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

Created:
Last Update: Read in about 8 min
Card image cap

Monitor HCL Software Knowledgebase for changes

The HCL Software knowledge base is built with ServiceNow . You can register and subscribe for channels and documents. You receive mails for new documents and changed documents you have subscribed for.

Created: Read in about 5 min