【网站搭建】Hugo 配置
记录第一次用 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
此时修改文件会实时反映到页面上。
生成静态网页:
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。
相关技能
- Hugo
- Git
- Linux