Windows 下使用 Hugo 搭建博客并部署到 Github 上

Contents
  1. 1. 准备
    1. 1.1. 下载并安装 Git 客户端
    2. 1.2. 下载 Hugo
    3. 1.3. Github 注册
    4. 1.4. 绑定密钥
  2. 2. 配置 Hugo 站点
  3. 3. 生成
  4. 4. 发布
    1. 4.1. 日常发布
  5. 5. References

准备

下载并安装 Git 客户端

https://git-scm.com/

下载 Hugo

在 C 盘根目录创建一个名为 Hugo 的文件夹,在其中再次创建一个名为 bin 的文件夹。于 Hugo 的 Github releases 页面上下载适用于 windows 系统的压缩包。将其中的 hugo 文件解压至最后创建的 bin 文件夹之中。将 C:\Hugo\bin 添加至 Windows 的环境变量中。

Github 注册

注册帐号,例如用户名为 test 。新建一个仓库,命名为: test.github.io

在任意空白处右键,选择 Git Bash Here ,在命令行窗口执行如下命令:

1
2
git config --global user.name "Your name"
git config --global user.email "Your email address"

绑定密钥

在 Git Bash 中:

1
ssh-keygen -t rsa -C "username@hostname"

生成的密钥对储存在: C:\Users\username.ssh 中。找到公钥,并添加到 Github 上。

配置 Hugo 站点

在 Hugo 文件夹下用 Git Bash 执行:

1
hugo new site yourblog

接下来进入 yourblog 文件夹进行自定义的修改。

生成

新建文章:

1
hugo new posts/first-post.md

即可编辑 first-post.md 文件。

保存后,执行命令:

1
hugo

静态文件将生成于 public 文件夹。

发布

1
2
3
4
5
git init
git remote add origin [email protected]:username/username.github.io.git
git add -A
git commit -m "first commit"
git push -u origin master

日常发布

1
2
3
git add -A
git commit -m "update"
git push -u origin master

References

Install Hugo

Difference between “git add -A” and “git add .”

用 Hugo 30 分钟搭建静态博客

使用 hugo 搭建个人博客站点

用 Hugo 搭建个人网站

手把手教你通过 Hugo 搭建个人博客

Mastodon