这是什么
这是一个基于 Astro 的静态博客知识库。你可以在本地用 Markdown 写文章,然后把代码推送到 GitHub 或 Gitee,再通过 CI/CD 自动构建并部署到服务器。
这种方式通常叫:
- 静态站点生成器:SSG
- Git 自动部署:Git-based Deployment
- 自动化流水线:CI/CD
- 现代静态网站架构:JAMstack
如何写文章
在 src/content/posts/ 目录下新增一个 .md 文件,例如:
src/content/posts/my-first-post.md
文件开头需要写 frontmatter:
---
title: "文章标题"
description: "文章描述"
pubDate: 2026-05-27
category: "分类名称"
tags:
- 标签一
- 标签二
draft: false
---
然后在下面正常写 Markdown 正文。
本地预览
npm install
npm run dev
打开终端输出的本地地址即可预览。
构建静态页面
npm run build
构建完成后,静态文件会生成到 dist/ 目录。服务器只需要托管 dist/ 里的文件即可。
自动部署
项目已经内置 .github/workflows/deploy.yml。你把代码推送到 GitHub 的 main 分支后,GitHub Actions 会自动:
- 安装依赖。
- 构建 Astro 静态站点。
- 通过 SSH 把
dist/同步到你的服务器目录。
你只需要在 GitHub 仓库的 Secrets 里配置服务器信息。