Website

Setting up Asciidoctor-Diagram for Hugo
Kiev Children’s Railway Museum by Marjan Blan, Unsplash licence, cropped

Setting up Asciidoctor-Diagram for Hugo

AsciiDoctor-Diagram is an extension of Asciidoctor that enables you to create diagrams using plaintext directly in your AsciiDoc files. Asciidoctor-Diagram supports a number of formats, including:

Continue reading
Enabling blog comments
Graffiti, Amsterdam, Netherlands by Max van den Oetelaar, Unsplash licence, cropped

Enabling blog comments

There is considerable debate about the relative worth of enabling blog comments versus relying on social media channels, such as LinkedIn.

Continue reading
Adding a caption to blog images
Tags, Kyoto, Japan by D J, Unsplash licence, cropped

Adding a caption to blog images

The Airspace blog template includes an image at the top of the blog. I like to make use of Creative Commons images but these usually require an attribution.

Continue reading
Update and deployment workflow
Float by conner bowe, Unsplash licence, cropped

Update and deployment workflow

Initially Netlify was configured to build off the main branch, and I also made edits directly to the main branch on my local Git.

Continue reading
Adding syntax highlighting
Red neon from the 30s by Erwan Hesry, Unsplash licence, cropped

Adding syntax highlighting

Hugo has its own syntax highlighting using Chroma, but I wanted to keep things consistent with typical AsciiDoc. The use of AsciiDoc markup in Hugo depends on AsciiDoctor, which supports a number of syntax highlighters:

Continue reading
Going live
Spitting Cave, Hawaii by Kekai AhSam, Unsplash licence, cropped

Going live

Today I registered allthingsdocs.com through Netlify. The registration process is remarkably simple: Log in to Netlify. Choose the site for which you wish to register a domain.

Continue reading