本文记录了使用 Hugo + PaperMod 主题搭建本站的过程。
为什么选择 Hugo
Hugo 是用 Go 编写的静态站点生成器,核心优势:
- 速度极快:数百页的站点毫秒级构建
- 单二进制:无运行时依赖,安装即用
- 灵活性高:支持自定义模板、短代码、分类系统
- 部署简单:输出纯静态文件,可部署到任何平台
安装 Hugo
# macOS (Homebrew)
brew install hugo
# 验证安装
hugo version
# hugo v0.162.1+extended ...
创建站点
hugo new site wiki --force
cd wiki
安装 PaperMod 主题
git init
git submodule add --depth=1 \
https://github.com/adityatelange/hugo-PaperMod themes/PaperMod
站点配置
hugo.toml 核心配置:
baseURL = 'https://nucle.cc/'
locale = 'zh-CN'
title = 'Nucle Wiki'
theme = 'PaperMod'
编写内容
文章放在 content/posts/ 目录下,使用 Markdown 编写:
---
title: '我的第一篇文章'
date: 2025-06-01
tags: ['hugo']
draft: false
---
文章内容...
构建与预览
# 本地开发(含热重载)
hugo server
# 生产构建
hugo
# 输出在 public/ 目录
部署
Hugo 生成的 public/ 目录是纯静态文件,可以部署到:
| 平台 | 特点 |
|---|---|
| Netlify | 免费,自动部署,支持表单 |
| Vercel | 免费,全球 CDN,Serverless |
| GitHub Pages | 免费,与 GitHub 集成 |
| 自建 Nginx | 完全控制 |
整个搭建过程不到 10 分钟,Hugo 的体验确实名不虚传。