本文记录了使用 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 的体验确实名不虚传。