这里展示博主是如何搭建的,仅供参考~
技术栈
涉及到 github,各位科学上网即可
- 静态站点生成器 Hugo v0.157.0 (extended)下载地址
- PaperMod 主题,这里的主题有很多大家可自行搜索喜爱的,这里提供本博客搭建使用的主题 🎨 PaperMod 主题 下载地址
- 部署方式:GitHub Actions -> GitHub Pages,这种方式最为简单,免服务器配置,利用 GitHub 自带的工具即可,需要注册 GitHub,创建仓库/
- Git 清华大学镜像 Git 下载(更快)
创建站点
选择对应的版本进行下载

首先我们配置环境变量,复制你解压缩后的文件路径,搜索键入 env 进入系统环境的配置,在系统环境的 Path 路径下进入,这里以 E:\hugo 为例

命令行输入 hugo version,出现如下界面则配置成功

接下来输入 hugo new site 你的站点名称 ,之后 cd 你的站点名称进入文件夹,hugo server 启动站点,默认是 localhost:1313,到这一步你的 hugo 基础配置已经搭建完毕!
配置主题
按照你喜欢的主题去 GitHub 下载资源包,将资源包解压到 themes 文件夹中,修改 hugo.toml 中 theme 的配置即可,是不是很简单?

输入 hugo server,出现以下样式,说明配置已生效!

项目结构
E:\hugo\my-blog/
├── content/posts/ # 博客文章放这里
├── static/images/ # 图片等静态资源
├── hugo.toml # 站点配置
├── .github/workflows/
│ └── hugo.yml # GitHub Actions 部署配置
└── .gitignore # Git 忽略规则
创建你的文章
使用命令 hugo new content posts/你的文章名称

Hugo 提供了 archetypes 功能,可以初始化一些模板,你也可以通过 Hugo 使用手册来看一下个性化定制参数,比如描述、标签、分类等等

之后编写完你的 md 文档,使用 hugo 命令即可上传你的文章!
部署到 GitHub Pages
参考官网链接:Hugo 配置 GitHub,这里很详细,一共八个步骤,大家按照这里的 step 一个个点击去做就可以啦~
这里展示首次部署需要的命令,如下:
git init
git remote add origin git@github.com:your-github-username/your-github-project-name.git
git add .
git branch -M main
git commit -m "First commit"
git push origin main
之后上传完毕后,等待 1~2 分钟,GitHub Actions 会自动帮你部署好啦,这时候你只需访问你的博客地址,便可以欣赏你的杰作了!
未经作者禁止转载!
本文链接: https://hyuzz-nuc.github.io/posts/hugo-blog-setup-guide/
未经作者禁止转载!


