Blog

A blog about documentation technologies, architectures, processes, and methodologies.

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
Enabling the contact form
Mailboxes in Piskobu, Cyprus by Sarune Sedereviciute, Unsplash licence, cropped

Enabling the contact form

The Airspace theme comes with a contact page with a form. The layout file for this form includes this line:

Continue reading