体验地址
1. 起因, 目的:
-
其实6年前,我就写过这个。
项目代码
博客地址 -
最近想改写一下。
github 推荐的主题是 Jekyll, 我当时用的就是这个,感觉很麻烦。尤其是文章命名。 -
新的主题 hugo 用起来还行。
2.过程:
过程记录, 需要详细! 因为问题非常多!
3. 参考教程:
- 视频教程: https://www.youtube.com/watch?v=_QSr2_pxIJs
- 配置文件,参考来源: https://theplaybook.dev/docs/deploy-hugo-to-github-pages/
一句话介绍 hugo:
hugo 是一个静态博客渲染工具, go 语言写的。
安装:
choco install hugo-extended # 失败。 估计是权限
scoop install hugo-extended # ok!
运行的话, 最好是使用 wsl , cmd 也行!!
新 hugo 建项目
hugo new site my_hugo_blog -f yaml
cd my_hugo_blog
安装主题,
git init
git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1
git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
修改 “hugo.toml”, 增加一行
theme = “PaperMod”
新建文章
hugo new docs/test_file.md
!!! !!! !!! !!!
!!! 修改 draft = true, ----> draft = false 否则无法渲染。 直接删掉这一行也行。
!! !!! !!! !!!
查看文章: localhost:7897/docs/test_file
下面就 github 相关的操作了
- 创建github 项目,上传文件。
- 新建一个分支, gh-pages !!! 这里名称不能变。 必须是 gh! 一个字都不能变!
- 开启 github actions 读写权限 https://github.com/buxuele/my_hugo_blog/settings/actions
- mkdir -p .github/workflows, 新建+修改 deploy.yml
- 修改 “hugo.toml”, 增加 baseUrl
报错:
其实就是修改一个 hugo 的版本。