本文的读者需要先设置一个本地运行的博客。如果没有搭建,可以查看我的文章:搭建网站指南
请注意,文中提到的所有 <username>
需要替换为你的 GitHub 用户名,不带尖括号。
在 GitHub 上设置仓库 链接到标题
首先,你需要创建一个名为 <username>.github.io
的仓库,并设置为公开仓库。(部分在线教程建议设置为私有仓库来存储 md 文件,但作者发现,Hugo 生成的公开文件本身就是 html 文件,不包含 md 文件上传,因此无需担心源代码泄露问题)
检查 baseURL
配置
链接到标题
需要修改 hugo.toml
文件的第一行:
baseURL = "https://<username>.github.io/"
然后在命令行中运行以下命令: 链接到标题
# 删除 public 文件夹并重新生成网站
#(如果没有 public 文件夹,则无需删除)
rm -rf public/
hugo
# 将更新推送到 GitHub
git remote add origin https://github.com/<username>/<username>.github.io.git
git add .
# 这相当于提交到 GitHub,可以自行修改提交信息
git commit -m "deploy"
# 如果你的推送分支不是 master,需要重命名为 main
git push --force origin master:main
如果在运行 git remote add...
时出现错误:error: remote origin already exists.
,意味着你之前已经添加过远程仓库。
你可以运行 git remote -v
来验证这个情况。
删除并重新添加远程仓库 链接到标题
删除命令:
git remote rm origin
然后重新运行 git remote add...
,接着执行 git add .
、git commit
和 git push
,耐心等待上传成功。然后在 GitHub 仓库中进行如下设置:
设置 GitHub Pages 链接到标题
在 GitHub 仓库中,进入 Settings
-> (Code and automation)
-> Pages
,在 Build and deployment
选项下选择 deploy from a branch
,并选择你的 main
分支。
稍等片刻,几分钟后你就可以在 GitHub Pages 上看到你的网站。