Hugo Static Site Setup Guide

Why Hugo

Hugo is one of the fastest static site generators available. Written in Go, it compiles sites in milliseconds. Ideal for blogs, documentation, and personal note sites.

Key advantages:

• Blazing fast builds — millisecond compilation, even with thousands of posts
• Zero-dependency deployment — output is pure static files, host anywhere
• Native multilingual support — no plugins needed, just configuration
• Rich theme ecosystem — hundreds of open-source themes from the community

Project Structure

doc-tools-cms/
├── hugo.toml          # Site config
├── justfile           # Command runner
├── content/
│   ├── zh/post/       # Chinese content
│   └── en/post/       # English content
└── themes/xmin/       # Theme

Common Commands

Managed via justfile:

Creating a New Post

hugo new content post/my-new-post.md

Hugo auto-generates front matter from archetypes/default.md.

Next Steps

• Choose a theme and customize styles
• Set up deployment (GitHub Pages / Vercel / self-hosted)
• Add a comment system (Giscus / Utterances)