用 Astro 搭建支持暗色模式、MDX、数学公式、RSS/Sitemap 的极简博客主题
Astro 负责静态站点构建，MDX 支持组件化写作，KaTeX 渲染数学公式，RSS/Sitemap 提升 SEO 与订阅体验
✓ 极简美观且可定制✓ 开箱即用的博客功能齐全 ✕ 仅适用于博客类站点✕ 需使用 pnpm 管理
方案简介
Chiri 是一个基于 Astro 构建的极简博客主题，在保持简洁美学的同时提供丰富的定制选项。它面向希望快速搭建个人博客、追求干净排版与静态站点性能的写作者和开发者。
这套技术配方组合了 Astro 静态站点框架、MDX 增强写作、KaTeX 数学公式渲染，并内置 Sitemap、OpenGraph、RSS 等站点基础设施。项目通过 pnpm 管理依赖，支持一键 Fork 或模板创建仓库后即可本地开发，构建产物为静态 dist/ 目录，可部署到 Netlify、Vercel 等任意静态托管平台。
亮点与能力
- 基于 Astro 构建，静态站点输出
- 响应式布局，适配移动端
- 明色 / 暗色模式切换
- 支持 MDX 写作
- 支持 KaTeX 数学公式
- 自动生成 Sitemap
- 支持 OpenGraph 元数据
- 支持 RSS 订阅
- 自动抓取链接卡片元数据并以静态 HTML 渲染
- 提供创建文章、更新链接元数据、更新主题的命令行工具
组成与分工
- Astro：核心静态站点框架，负责页面渲染与构建
- MDX（@astrojs/mdx）：支持在 Markdown 中嵌入组件的写作格式
- KaTeX（katex / rehype-katex / remark-math）：渲染数学公式
- @astrojs/rss / feed：生成 RSS 订阅源
- @astrojs/sitemap：生成站点地图，利于 SEO
- astro-og-canvas / canvaskit-wasm：生成 OpenGraph 图像
- markdown-it / remark-directive / sanitize-html：Markdown 处理与安全过滤
- sharp：图像处理
- pnpm：包管理与开发/构建命令入口
- Netlify / Vercel：静态托管部署平台
前置要求
- 需要安装 pnpm 作为包管理器（项目命令均通过 pnpm 执行）
- 一个 GitHub 账号用于 Fork 或使用模板创建仓库
- Git 用于克隆仓库
实施步骤
1. 创建仓库
Fork 该仓库，或使用模板创建新仓库。
2. 克隆并安装依赖
bash
git clone
cd
pnpm install
pnpm dev
3. 个性化配置
编辑 src/config.ts 和 src/content/about/about.md，按自己的喜好修改站点配置与关于页内容。
4. 创建文章
使用命令创建新文章，或将文章文件直接放入 src/content/posts 目录：
bash
pnpm new
方案出处
the3ash/astro-chiri：Minimal blog theme built with Astro. 317 star Minimal blog theme built with Astro.
本方案由真实开源项目挖掘整理，实施命令均来自其 README 原文，安装使用请遵循项目开源协议。