这篇文章用于记录平时更新博客的标准流程,按下面步骤执行即可。
1. 新建文章
在仓库根目录执行:
.\.hugo-bin\hugo.exe new content posts/你的文章名.md
然后打开 content/posts/你的文章名.md,把 draft = true 改为 draft = false,再填写标题和正文。
2. 本地预览
执行:
.\.hugo-bin\hugo.exe server -D
浏览器访问 http://localhost:1313/depthplusblog/ 预览效果,确认排版和链接正常。
3. 本地构建检查
执行:
.\.hugo-bin\hugo.exe --minify
若无报错,说明静态文件可正常生成。
4. 提交并推送
执行:
git add .
git commit -m "feat: 新增文章《你的标题》"
git push origin main
推送后,GitHub Actions 会自动构建并部署到 GitHub Pages。
5. 常见注意事项
- 文章不显示时,先检查 front matter 是否
draft = false - 资源路径尽量使用相对路径或 Hugo 的
relURL - 每次发布前都做一次本地构建,避免 CI 才发现问题