Goodbye WordPress, hello Hugo

A new platform for this blog.

2 minute read

After nine years on a self-hosted WordPress platform, I’m now running this site on Hugo, an open-source static site generator. I’ve migrated the blog posts and static pages, removed obsolete material along the way, and updated the post categories.

I dropped featured images from blog posts, mainly to save time in the content migration, so the site does look, well, minimal. Colour and imagery may return in the future but I’m happy with the stark feel for now. The off-black/off-white palette is a deliberate aesthetic but also the result of a deliberate choice to remove as much extraneous visual clutter and functionality as possible.

The theme is Future Imperfect, ported to Hugo by Julio Pescador. I added a custom stylesheet to:

  • increase the colour contrast and font size for accessibility (a Lighthouse audit reports an increase in the accessibility score from 89 to 94)
  • constrain the main content on screen widths between 980-1280 pixels to maintain a readable line length

One reason why I left WordPress was the amount of time I spent keeping the lights on when I should have been writing instead. Even after rationalising plugins, caching content and reducing backups to one per week rather than daily, I often hit my shared hosting plan’s process watcher, which caused the site to time out.

Positively though, I wanted to move to another platform to learn something new and to practice maintaining a site through modern processes. At work this year, I’ve started contributing user interface copy to a web app via a Git workflow. I’ve also been reading articles by other technical writers in the Write the Docs community, particularly the docs as code movement.

This personal Hugo site gives me the opportunity to:

  • get in the habit of writing and editing with the Markdown syntax
  • practice making changes to this site via version control (I use the Sourcetree app and a private Bitbucket repository)

Also, the act of writing in a text editor is a welcome return to a more deliberate approach; I’m more in control of the tools, the published output and the visual form. It feels like cultivating a craft, which is a happy state to be in.

comments powered by Disqus