科技船长 · projects

Static Blog Starter

311 words 1 min read #Template#Blog#Astro

一个最小化的静态博客 starter,专注于内容写作而非框架配置。开箱即用的功能包括:全文搜索、评论系统、RSS feed 和站点地图。

快速开始

Terminal window
# 克隆仓库
git clone https://github.com/example/static-blog-starter.git my-blog
cd my-blog
# 安装依赖并启动
bun install
bun 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 PagesCDN 分发和 Workers 集成

许可

MIT License - 可自由使用和修改。