Deploy Hugo site to Pages

Summary

This is the code for my website, generated by the static site generator, Hugo, and using the PaperMod theme.

The deployed website can be found here: https://www.wrenhold.com

Setting up this site

handle the Hugo installation and its dependencies, I've used a dev container setup here to handle the Hugo installation and its dependencies, so you'll need to have Docker installed and running on your machine. You can then open the repo in Vscode or start it using the Dev Container CLI.

After cloning the repo the first time, it is best to update the theme submodule by running this command in the root directory:

git submodule update --init themes/PaperMod
git submodule update --init themes/Stack

Alternatively, you can update all of the submodules (should any more be added in the future) by running:

git submodule update --init --recursive

Running the site locally

To run the site locally, you can either use the vscode default test task, or run the following command:

hugo server -D

Note: the -D flag is used to include draft posts in the local build.

Updating the website

The website itself is setup to be deployed to Github Pages using the hugo.yml script, and the workflow is setup to run on every push to the main branch, so nothing special is required to do this so long as that is configured.