Hugo

2024-11-17

Hugo

Add Bluesky Links and Share Buttons to Hugo

Add Bluesky Links and Share Buttons to Hugo

  • 2024-11-17
  • 9 minutes to read

Talks through the changes I needed to make in order to set up social links and a share to bluesky button on my site.

How to Fix Hugo Live Reload Constantly Reloading the Browser

How to Fix Hugo Live Reload Constantly Reloading the Browser

  • 2024-05-18
  • 3 minutes to read

How to diagnose and fix the issue where Hugo's live reload feature reloads the browser page constantly and unexpectedly, making local development difficult.

Creating Mermaid diagrams in markdown using vscode

Creating Mermaid diagrams in markdown using vscode

  • 2024-05-17
  • 5 minutes to read

My blog theme supports Mermaid, a text-based diagramming language. This post covers my first steps creating and previewing Mermaid diagrams directly inside VSCode.

How to test the Mobile Version of your Hugo website

How to test the Mobile Version of your Hugo website

  • 2023-10-05
  • 3 minutes to read

How to test the layout of your Hugo site on a mobile device before pushing changes to the remote server, without relying on browser developer tools or emulators.

How to Fix Broken Giscus Discussion Links on a Hugo Blog

How to Fix Broken Giscus Discussion Links on a Hugo Blog

  • 2023-10-05
  • 3 minutes to read

I changed the titles of some blog posts and my Giscus discussion links broke. This post explains what caused the problem and how to fix broken Giscus discussion mappings.

Bypass blocking of embedded tweets using Hugo shortcodes

Bypass blocking of embedded tweets using Hugo shortcodes

  • 2023-08-23
  • 4 minutes to read

X (the site formerly known as Twitter) now blocks embedding tweets (xweets? exes?), now my Hugo build fails! Thanks to shortcodes this was easy to fix.

Setting Up 404 Redirect for Hugo Using Azure Static App

Setting Up 404 Redirect for Hugo Using Azure Static App

  • 2023-07-30
  • 3 minutes to read

Azure Static Web Apps ignore Hugo's built-in 404 redirect configuration. This post explains why this occurs and shows how to correctly configure custom 404 handling for your site.

Adding comments to Hugo using Giscus commenting system

Adding comments to Hugo using Giscus commenting system

  • 2023-05-14
  • 8 minutes to read

How to add comments and reactions to a Hugo site using Giscus, a GitHub Discussions-powered commenting system that is free, open source, and straightforward to configure.

Static Web App Maximum Number of Staging Environments

Static Web App Maximum Number of Staging Environments

  • 2023-05-14
  • 6 minutes to read

How to resolve the Azure Static Web Apps build failure about reaching the maximum staging environment limit, caused by having too many open pull requests at the same time.

Adding comments to Hugo using Gitalk commenting system

Adding comments to Hugo using Gitalk commenting system

  • 2021-11-02
  • 5 minutes to read

How to configure Hugo and GitHub to use the Gitalk commenting system, a modern comment component based on GitHub Issues and Preact, for adding community discussion.

Learning to Hugo Part 5: Hosting on an Azure Static Webapp

Learning to Hugo Part 5: Hosting on an Azure Static Webapp

  • 2021-05-10
  • 8 minutes to read

This is the fifth post in a series about the things I have learnt setting up my blog using Hugo, covering how to host your site using Azure Static Web Apps.

Learning to Hugo Part 4: Shortcodes and Archetypes

Learning to Hugo Part 4: Shortcodes and Archetypes

  • 2021-05-05
  • 5 minutes to read

The fourth post in my Learning to Hugo series, covering how to use shortcodes and archetypes to create repeatable, consistent content across your Hugo blog.

Learning to Hugo Part 3: Front Matter

Learning to Hugo Part 3: Front Matter

  • 2021-05-04
  • 2 minutes to read

How to use front matter to adjust my content.

Learning to Hugo Part 2: Structure and Content Organisation

Learning to Hugo Part 2: Structure and Content Organisation

  • 2021-05-02
  • 10 minutes to read

This is the second post in a series about the things I have learnt about Hugo, covering the fundamentals of directory structure and content organisation in detail.

Learning to Hugo Part 1: Setting up Hugo for the first time

Learning to Hugo Part 1: Setting up Hugo for the first time

  • 2021-05-01
  • 6 minutes to read

This is the first post in a series about the things I have learnt about setting up my blog using Hugo, covering installation, theme choice and writing your first post.

Learning to Hugo for the very first time through exploration

Learning to Hugo for the very first time through exploration

  • 2021-05-01
  • 4 minutes to read

Here is my write-up after setting up Hugo and exploring it for the first time, having migrated away from WordPress. I am really enjoying the experience and Hugo's speed.

Hello world! This is my first post on my Hugo blog!

Hello world! This is my first post on my Hugo blog!

  • 2020-01-01
  • 1 minute to read

This is the first post I created on my new Hugo blog, having migrated away from WordPress. A classic Helo Byd or Hello World post to mark the occasion.