主页 / 归档 / 站点建设

AI 知识库 1.0 使用说明

介绍这个静态博客的写作方式、目录结构和部署流程。

这是什么

这是一个基于 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 会自动:

  1. 安装依赖。
  2. 构建 Astro 静态站点。
  3. 通过 SSH 把 dist/ 同步到你的服务器目录。

你只需要在 GitHub 仓库的 Secrets 里配置服务器信息。

许可协议

除特别说明外,本站文章采用 CC BY-NC-SA 4.0 协议。转载请注明来源。