在github.io部署个人博客hugo，2023新教程_github .io

对其他教程的吐槽：你们的教程真的还能用吗？

1 安装前置

前置软件包括：

• Git
• Golang
• Hugo

这些都可以用choco安装，安装choco的方法见https://chocolatey.org/install 。

choco install git
1

choco install golang
1

choco install hugo-extended
1

2 在本地部署Hugo

先验证hugo是否安装成功：

hugo version
1

然后正式开始，建议新建一个文件夹作为博客的工作区。在这个文件夹下新建项目：hugo new site <blog>

hugo new site 
1

这样就建立了一个文件夹。进入这个文件夹：cd <blog>

然后初始化当前目录中的空 Git 存储库：

git init
1

下一步就是安装主题，在https://themes.gohugo.io/ 里可以找一个你喜欢的，在主题的页面里一般都可以找到安装方法，一般格式是：git submodule add <https> themes/<themename>

git submodule add
1

然后一般能在<themename>文件夹内找到exampleSite文件夹，把里面的文件复制到<blog>文件夹里。

注意！现在的<blog>文件夹里的默认配置文件是hugo.toml，而一般的exampleSite里的配置文件一般是config.toml和config.yaml，而一个网站只能有一个配置文件，且这三种文件名都是可以的。所以复制的时候记得把原来的hugo.toml配置文件删掉。

然后就可以开始本地部署了：

hugo server
1

从返回的信息里可以看到本地网址：http://localhost:<port>/，复制到浏览器里，就可以看到这个主题的示例了。

3 把Hugo部署到github上

这一部分是本教程与其他所有中文教程都不同地方，其他的教程都不知道是哪个时代的方法了，废话少说，正式开始。

先创建新存储库。只需要填上Repository name那一栏，格式为<name>.github.io。如果你想让你的博客网址就是.github.io，则<name>不能是任意名字，必须是你的github用户名。

其他都不需要动，点击Create repository就行了。

然后返回<blog>文件夹里，把这个本地库连接到远端库：git remote add origin git@github.com:<name>.github.io.git

git remote add origin 
1

把这些修改后的文件添加到本地库，并标记上“提交信息”：

git add .
1

git commit -m "commit message"
1

"commit message"填啥都可以，这个是用来标记这次更新的内容。

把“主干”设置为“main”：

git branch -M main
1

最后把本地库的内容推送到远端库：

git push -u origin main
1

下一步是进入https://github.com/<name>/<name>.github.io，点击上方栏的Settings，然后点击左方栏的Pages，在Build and deployment里的Source中选择Github Actions，在下面找到Hugo，点击Configure，在新界面点击右侧的绿色按钮的Commit changes...。

找不到Hugo就去browse all workflows里找。

然后hugo就开始在github上部署了，部署好后就可以在Pages页面看到Your site is live at ...，点击Visit site就可以访问博客网站了。

4 后续写博客

后续更新只需要在content文件夹加入md文件，然后执行

git add .
git commit -m "commit message"
git push -u origin main
1
2
3

这三句指令就可以了

5 补充

第一次用git的话记得设置名字和邮箱。

git config --global user.name "user.name"
1

git config --global user.email "user@email.com"
1

还有可能需要的设置代理：

git config --global http.proxy http://127.0.0.1:7890
1

git config --global https.proxy https://127.0.0.1:7890
1

还有取消代理：

git config --global --unset http.proxy
1

git config --global --unset https.proxy
1