AIai-productivity
GitHub1 分钟阅读

GitHub Actions 内容站自动化:检查构建和内容质量

介绍如何用 GitHub Actions 为 Astro 内容站增加构建检查、链接检查和内容发布流程。

为什么需要自动化

内容站长期更新后,最常见的问题是链接失效、Frontmatter 写错、构建失败和页面遗漏。GitHub Actions 可以在合并前提前发现问题。

推荐检查项

  • 安装依赖
  • 运行 npm run build
  • 检查 Markdown 格式
  • 检查链接可用性
  • 检查 sitemap 是否生成

示例流程

name: CI
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm ci
      - run: npm run build

使用建议

先从构建检查开始,不要一开始加入太多复杂规则。等内容规模变大后,再增加链接检查和内容规范检查。

使用案例:为内容站添加构建检查

场景

你每次新增文章都担心 Frontmatter 写错或构建失败,希望 GitHub 在提交后自动检查。

示例流程

当你 push 到 GitHub 后,Actions 自动执行:安装依赖、运行 npm run build、报告构建结果。

价值

这可以在部署前发现 Markdown 格式错误、内容 schema 错误、动态路由错误和 TypeScript 问题。

后续扩展

构建检查稳定后,可以继续增加链接检查、拼写检查或内容长度检查。


延伸阅读

相关文章