此 GitHub Actions 工作流替代了原有的 inv pub 命令,实现了自动化构建和部署。
工作流在以下情况下触发:
- 推送到
master或main分支 - 修改了
content/目录下的文件 - 修改了主题或配置文件
- 手动触发(workflow_dispatch)
┌─────────────┐
│ Push 代码 │
└──────┬──────┘
▼
┌─────────────┐
│ 检出代码 │
└──────┬──────┘
▼
┌─────────────┐
│ 安装依赖 │
└──────┬──────┘
▼
┌─────────────┐ 有警告 ┌─────────────┐
│ 首次构建 │───────────────▶│ 修复图片alt │
└──────┬──────┘ └──────┬──────┘
│ 无警告 │
▼ ▼
┌─────────────┐ ┌─────────────┐
│ 检查完成 │◀───────────────│ 提交修复 │
└──────┬──────┘ └─────────────┘
▼
┌─────────────┐
│ 部署到Pages │
└─────────────┘
-
自动修复图片 alt 属性
- 检测缺少 alt 属性的图片
- 根据图片文件名自动生成 alt 文本
- 提交修复后重新构建
-
零配置部署
- 使用 GitHub Pages 官方部署机制
- 无需手动管理
output分支
-
并发控制
- 使用 concurrency 防止并发构建冲突
inv pub
# 执行:
# 1. git pull
# 2. pelican build
# 3. git commit content
# 4. git commit output
# 5. git push- 本地编辑 Markdown 文件
- 提交并推送:
git add . && git commit -m "..." && git push - GitHub Actions 自动完成构建和部署
# 安装依赖
pip install pelican markdown beautifulsoup4
# 本地构建
pelican content -o output -s pelicanconf.py
# 本地预览
cd output && python -m http.server查看 GitHub Actions 日志:
- 进入仓库的 Actions 标签页
- 点击失败的 workflow run
- 查看具体步骤的日志
如果收到图片 alt 警告,工作流会自动修复并重新提交。你可以在提交历史中看到这些自动修复。
如果需要手动触发部署:
- 进入 Actions 标签页
- 选择 "Build and Deploy Weekly"
- 点击 "Run workflow"