A Hugo static site on Netlify

A Hugo static site on Netlify

Introduction Download hugo-extended Find a theme hugo new site git sub module copy config.toml, and adjust settings. Commit Make Netlify aware We have these folders locally: And yet on GitHub, a shorter list: From burntfen, we read: Wait, so why weren’t the other folders - archetypes, content, data, layouts, static - added? Well, they’re empty. Hugo likes empty folders. Git doesn’t. If you want to keep them, you’ll need to add a file into each of them. [Read More]

Experiments with Terraform 0.12

A shared central folder consumed by multiple environment folders A common pattern I’ve used in recent projects is to use a shared folder to contain the Terraform files which: sets the provider (AzureRm) sets any tooling requirements (terraform.exe of at least a certain version) declares variables sets default values for variables at a global level uses the merge function for environment-specific variables creates resources (in this example, Azure Resource Groups) I combine this with separate folders per environment which contain: [Read More]

Experiments with static sites

Reviewing static site generators and choosing Hugo

I plan to write more fully on static sites, particularly covering:

  • exporting from WordPress
  • hosting with AWS S3, Azure Storage Accounts, and Netlify
  • adding in Content Delivery Networks
  • JAMStack sites like Gatsby
  • a CI/CD workflow
  • speed comparisons

Here’s my current journey:

[Read More]

Writing with Markdown and Git

In three recent roles (two paid, and one voluntary), I estimate that I’ve written 300 or so internal technical and procedural documents using Atlassian Confluence.

When I left a recent role, a colleague was kind enough to give me a book - How to Make a Living with Your Writing, which has prompted me to at least start writing in a more structured way.

I want to be able to make use of smaller snippets of time, so I’ve spent some time thinking about which tools will allow me to write quickly, without forcing me to use a different tool simply because I’m writing a blog post as opposed to a chapter of a technical book.

[Read More]