记录第一次用 Hugo 搭静态站的流程。

前期准备

1)安装 Go

从 All releases - The Go Programming Language 下载 .msi 安装包,安装到选定目录。

在终端输入:

go version

能输出版本号就说明安装成功。

2)安装 Hugo

从 gohugoio/hugo Releases 下载 Hugo,把 hugo.exe 所在目录加入系统环境变量 Path。

验证:

hugo version

网站部署

1)创建一个新网站

hugo new site page-name

2)配置主题

在 Hugo Themes 里挑一个主题,然后在网站目录中执行:

cd page-name
git init
git submodule add <主题仓库地址> themes/<主题名>

用 VS Code 打开网站目录,在配置文件 hugo.toml(旧版本是 config.toml)中写入:

theme = "theme-name"

现在 Hugo 默认生成 hugo.toml;如果主题文档写的是 config.toml,两者作用相同,选一个即可。

3)添加内容

hugo new posts/post-name.md

Markdown 语法可以看 Markdown 官方教程。

成果查看

启动本地服务器:

hugo server -D

访问 http://localhost:1313/。

此时修改文件会实时反映到页面上。

生成静态网页:

hugo

默认输出到 ./public/ 目录。加 -D 会把草稿(draft: true)也一起构建:

hugo -D

同步到 GitHub 远程库

1)在 GitHub 上建立远程库

新建仓库 username.github.io,其中 username 是 GitHub 用户名。

2)从本地上传到远程库

进入 public 目录,提交内容并推送:

cd public
git init
git add .
git commit -m "message"
git remote add origin https://github.com/user-name/user-name.github.io.git
git push -u origin main

GitHub 现在的默认分支是 main。如果你的仓库仍然是 master,把最后一行改成 git push -u origin master。

3)更新到 GitHub 远程库

每次改完内容后重新构建并推送:

hugo
cd public
git add .
git commit -m "message"
git push

这一步的前提是 public 目录本身已经是一个 Git 仓库,并且已经关联好 origin。