Hugo Blog Setup

A static blog built with Hugo and the PaperMod theme, deployed to GitHub Pages.

Setup

Install Hugo

brew install hugo

Create New Site

hugo new site cmsheehan.github.io --format yaml
cd cmsheehan.github.io

Initialize Git

git init
git remote add origin git@github.com:cmsheehan/cmsheehan.github.io.git

Add PaperMod Theme

git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
git submodule update --init --recursive

Configure Theme

echo 'theme: ["PaperMod"]' >> hugo.yaml

Customize Configuration

See PaperMod example site for configuration options.

Setup GitHub Actions

mkdir -p .github/workflows
touch .github/workflows/hugo.yaml

Add the GitHub Actions workflow for automated deployment (see Hugo documentation).

When Cloning the Repository

Update submodules after cloning:

git submodule update --init --recursive
git submodule update --remote --merge

References

• Create a Static Blog with Hugo
• PaperMod Example Site
• Hugo GitHub Pages Deployment