基于hugo+github搭建个人博客
{{% admonition tip "note" %}}
作者所有的操作都是基于win系统,若读者用的是其他系统,可以不用浪费时间了
hugo的安装#
网上有两种方法
包管理器安装(方法一)#
进入chocolatet官网、scool官网或直接复制以下代码Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
键入命令行,完成安装。命令行键入choco --version
,若显示版本号则证明chocolatey已经安装成功
然后直接使用命令安装hugo:
choco install hugo-extended -confirm
hugo version
检查是否安装成功
直接安装(方法二)#
直接到源代码处下载hugo,下载后解压缩至指定路径下[1],并将该路径添加至环境变量
建站及选择主题#
- 首先,在指定路径下启动命令窗口,键入
hugo new site mysite
,这里的mysite可自行修改。此时cd mysite
进入新站根目录 - 到主题官网上选择合适的主题,在这里我以huho-theme-even为例。
{{% admonition note "注意" %}}
以下操作都是在根目录下进行,除非另外强调
git init
git clone https://github.com/olOwOlo/hugo-theme-even themes/even #克隆到本地
cp themes/even/exampleSite/config.toml ./ #使用even主题自带的全局配置config.toml覆盖Hugo初始安装的config.toml
cp themes/even/archetypes/default.md ./archetypes/ #使用even主题自带的博客文章默认配置themes/even/archetypes/default.md覆盖Hugo初始安装的archetypes/default.md
cp themes/even/exampleSite/ ./content/ # 配置默认文章
hugo server #部署本地网址(http://localhost:1314/),点击查看效果
{{% admonition note "注意" %}}
highlightInClient配置项和pygments开头的配置项不能都启用,都启用会导致markdown里插入代码块的时候样式错误。highlightInClient使用默认的false即可,不用修改。
修改archetypes/default.md里的默认配置项,把comment和toc都设置为true,用于开启文章评论功能和文章自动生成目录功能。
Github Page#
这一步是将新站目录下的public文件夹上传到你的github或gitee(以github为例)
建立新的仓库,注意仓库名为你的用户名.github.io
部署到github page#
因为现在github分支默认是main
,而git默认是master
,所以对于github,因此推送时会在仓库中新增一个分支。我只推荐将自己的仓库克隆进本站,合并到public
文件夹中,然后将该文件夹push同步即可
{{% admonition tip "建议" %}}
另外,不推荐gitee,由于我们这的严格审核正策导致了从注册到申请非常麻烦,有这时间吧倒不如去阿里云申请免费域名挂接你的网址链接
更新文章->提交更新#
hugo -D
hugo #这两步仍然是在站点根目录,目的是将文章由.md格式转换为.html格式
cd public
git init
git add .
git commit -m "提交"
git push -u origin main #首次使用这个命令,后面直接用git push即可
到这里,你的博客已经更新完毕。
hugo的缺点#
虽然hugo是基于Go语言设计的,但是麻烦的命令仍然是个问题,建议大家写一份批处理文件,一步到位。
还有就是,当你将文章hugo成html后,你之后的增删都不会改变public/post/
文件夹里的文件,我的做法是直接删除public/post/
内的所有文件和文件夹,重新hugo即可
REF.#
- http://t.csdn.cn/Yb6wW
- https://segmentfault.com/a/1190000041156732
- https://zhuanlan.zhihu.com/p/396669087
路径最好全是英文组成 ↩︎
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· [翻译] 为什么 Tracebit 用 C# 开发
· 腾讯ima接入deepseek-r1,借用别人脑子用用成真了~
· Deepseek官网太卡,教你白嫖阿里云的Deepseek-R1满血版
· DeepSeek崛起:程序员“饭碗”被抢,还是职业进化新起点?
· RFID实践——.NET IoT程序读取高频RFID卡/标签