一个最小化的静态博客 starter,专注于内容写作而非框架配置。开箱即用的功能包括:全文搜索、评论系统、RSS feed 和站点地图。
快速开始
# 克隆仓库git clone https://github.com/example/static-blog-starter.git my-blogcd my-blog
# 安装依赖并启动bun installbun run dev访问 http://localhost:4321 预览站点。
内置功能清单
- 内容管理 - Astro Content Collection + MDX 支持
- 全文搜索 - Pagefind 静态索引生成
- 评论系统 - 支持 Giscus、Utterances、Waline
- RSS Feed - 自动为博客文章生成 Atom feed
- Sitemap - 构建时自动生成 robots.txt 和 sitemap.xml
- 代码高亮 - Shiki 多语言语法着色
- 暗色模式 - 跟随系统偏好,支持手动切换
- SEO 优化 - Open Graph、Twitter Cards 元数据
自定义指南
修改主题色盘
在 src/config/site.toml 中:
[config.theme]palette = "purple-soft"可用选项:green-soft, rose-soft, pink-soft, purple-soft, blue-soft, orange-soft, brown-soft
添加新栏目
在 src/content/ 下创建新的内容集合目录,并在 astro.config.mjs 中注册。
部署推荐
| 平台 | 适用场景 |
|---|---|
| GitHub Pages | 个人项目页和文档站 |
| Vercel | 需要边缘函数的场景 |
| Netlify | 表单处理和身份验证 |
| Cloudflare Pages | CDN 分发和 Workers 集成 |
许可
MIT License - 可自由使用和修改。