安装前置
前置软件包括：
- Git
- Hugo
在本地部署Hugo
先验证hugo是否安装成功：
1hugo version
然后正式开始，建议新建一个文件夹作为博客的工作区。在这个文件夹下新建项目：
1hugo new site <blog>
这样就建立了一个文件夹。进入这个文件夹：
1cd <blog>
然后初始化当前目录中的空 Git 存储库：
1git init
下一步就是安装主题，在https://themes.gohugo.io/ 里可以找一个你喜欢的，在主题的页面里一般都可以找到安装方法，一般格式是：
1git submodule add <https> themes/<themename>
然后一般能在<themename>文件夹内找到exampleSite文件夹，把里面的文件复制到<blog>文件夹里。
注意！现在的<blog>文件夹里的默认配置文件是hugo.toml，而一般的exampleSite里的配置文件一般是config.toml和config.yaml，而一个网站只能有一个配置文件，且这三种文件名都是可以的。所以复制的时候记得把原来的hugo.toml配置文件删掉。
然后就可以开始本地部署了：
1hugo server
从返回的信息里可以看到本地网址：http://localhost:<port>/，复制到浏览器里，就可以看到这个主题的示例了。
把Hugo部署到github上
这一部分是本教程与其他所有中文教程都不同地方，其他的教程都不知道是哪个时代的方法了，废话少说，正式开始。
先创建新存储库。只需要填上Repository name那一栏，格式为<name>.github.io。如果你想让你的博客网址就是.github.io，则<name>不能是任意名字，必须是你的github用户名。
其他都不需要动，点击Create repository就行了。
然后返回<blog>文件夹里，把这个本地库连接到远端库：
1git remote add origin git@github.com:<name>.github.io.git
把这些修改后的文件添加到本地库，并标记上“提交信息”：
1git add .
2git commit -m "commit message"
“commit message"填啥都可以，这个是用来标记这次更新的内容。
把“主干”设置为“main”：
1git branch -M main
最后把本地库的内容推送到远端库：
1git push -u origin main
下一步是进入<https://github.com/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就可以访问博客网站了。
后续写博客
后续更新只需要在content文件夹加入md文件，然后执行
1git add .
2git commit -m "commit message"
3git push -u origin main
这三句指令就可以了。
各种问题
参考链接
最后修改于 2024-08-30 13:48