Building a Website with Hugo

This article outline was organized by Sheng, with content filled by ChatGPT.
Yes, you guessed it! Even the image was generated by ChatGPT.

These are the references and commands I used to get the site running. The official documentation covers the details better than a second copy of the same tutorial would.

1. Install Hugo

Follow the installation instructions for your operating system:

Installation | Hugo (gohugo.io)

2. Create the site

Once Hugo is installed, the Quick Start explains how to create a site and run the local development server:

Quick start | Hugo (gohugo.io)

3. Choose a theme

I used the Hugotex theme and adjusted a few details. Hugo’s theme directory is the easiest place to compare the available options.

Complete List | Hugo Themes (gohugo.io)

4. Deploy to GitHub Pages

GitHub Actions can build and deploy the site automatically. With that in place, merging a post into main publishes it without a separate manual deployment step. Deploying Hugo on GitHub Pages

Commands I use regularly

Create a new post: Create a Markdown file with the site’s default archetype:
```
hugo new post/your-awesome-title.md
```

Create your custom post template: Put a custom archetype in the archetypes/ directory when each new post needs the same frontmatter:

---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: true
author: "Sheng"
description: ""
tags: []
keywords: []
---

Use your custom template to create a new post: Create a post from that archetype with:
```
hugo new --kind ../posts post/test.md
```

Part of the 2026-06-13 blog renovation, paint still drying.