Mominus 是一个基于 Astro 6 的静态博客主题,面向中文内容写作,内置:
- 文章、标签、归档、分页、笔记、About 页面
- RSS、Sitemap、OG 图片、Schema.org、Canonical SEO
- 代码高亮增强、目录、主题切换、图片灯箱、回顶按钮
- Fuse.js 搜索,覆盖博客文章、笔记和页面
- Decap CMS,覆盖博客、笔记和 About 页面
- Node.js 18+
- npm / pnpm / yarn
git clone <your-repo-url>
cd mominus
npm install
cp .env.example .env.local
npm run dev访问 http://localhost:4321。
| 命令 | 说明 |
|---|---|
npm run dev |
启动开发服务器 |
npm run build |
构建静态站点 |
npm run preview |
预览构建产物 |
npm run check |
运行 Astro 类型与模板检查 |
npm run typecheck |
运行 TypeScript 检查 |
站点元数据通过环境变量驱动,优先使用 .env.local、部署平台环境变量或 CI secrets。
复制模板:
cp .env.example .env.local核心变量:
| 变量 | 说明 |
|---|---|
SITE_URL |
生产环境推荐必填,用于 sitemap、canonical、绝对 RSS/OG URL |
SITE_TITLE |
站点标题 |
SITE_DESCRIPTION |
站点描述 |
SITE_AUTHOR |
作者名 |
GITHUB_URL |
GitHub 链接,可选 |
TWITTER_HANDLE |
Twitter/X 用户名,可选 |
CONTACT_EMAIL |
联系邮箱,可选 |
- 未设置
SITE_URL时,项目仍可构建。 - 但
sitemap不会生成,SEO 组件也只能输出相对 URL。 RSS会退回相对链接版本,适合本地预览,不适合作为正式生产订阅源。- 构建时会输出警告,提醒补齐
SITE_URL。
位置:src/content/blog/
支持 .md 和 .mdx。
---
title: "文章标题"
description: "文章摘要"
date: 2026-01-01
updatedDate: 2026-01-02
tags: ["Astro", "博客"]
author: "Your Name"
draft: false
pinned: false
cover: "../../assets/images/cover.png"
---位置:src/content/notes/
---
date: 2026-01-01T08:30:00Z
---
这是一条简短笔记。当前内置页面内容位于 src/content/pages/about.md,对应路由 /about。
搜索索引由 src/pages/search-index.json.ts 生成,当前覆盖:
- 博客文章:
/blog/* - 笔记:
/notes#<note-id> - 页面:当前内置
about
搜索结果会保留 q 参数,落地页会高亮命中关键词。
配置文件:public/admin/config.yml
当前 CMS 覆盖:
blog:博客文章notes:笔记pages/about:关于页
注意事项:
- CMS 当前统一写入 Markdown 文件。
- 现有 MDX 示例文章可以继续保留。
- 如果文章依赖 MDX 组件或复杂 JSX,建议直接在仓库里编辑,而不是通过 CMS。
本地调试:
npm run dev
npx decap-server然后访问 http://localhost:4321/admin/。
Mominus/
├── public/
│ ├── admin/ # Decap CMS
│ ├── fonts/ # OG 图片字体
│ ├── banner.png
│ ├── favicon.svg
│ └── logo.svg
├── src/
│ ├── components/
│ │ ├── common/
│ │ └── ui/
│ ├── content/
│ │ ├── blog/
│ │ ├── notes/
│ │ └── pages/
│ ├── layouts/
│ ├── pages/
│ │ ├── og/
│ │ └── search-index.json.ts
│ ├── styles/
│ ├── utils/
│ ├── config.ts
│ └── types.ts
├── docs/
│ ├── CODE_HIGHLIGHTING.md
│ └── SEO.md
├── astro.config.mjs
├── tailwind.config.mjs
├── .env.example
└── package.json
- 代码高亮文档:
docs/CODE_HIGHLIGHTING.md - SEO 与 OG 图片文档:
docs/SEO.md
| 类别 | 技术 |
|---|---|
| 框架 | Astro 6.x、React 19 |
| 样式 | Tailwind CSS 4.x、@tailwindcss/typography |
| 内容 | Astro Content Collections、Markdown、MDX |
| 搜索 | Fuse.js |
| SEO | @astrojs/rss、@astrojs/sitemap、Schema.org |
| OG 图片 | Satori、Sharp |
| 图标 | Lucide React |
| 代码高亮 | Shiki + @shikijs/transformers |
- 设置
SITE_URL - 更新
SITE_TITLE/SITE_DESCRIPTION/SITE_AUTHOR - 更新社交链接环境变量
- 删除或替换示例文章与示例笔记
- 如果启用 CMS,确认
public/admin/config.yml中的分支配置正确 - 运行
npm run check && npm run build
- Vercel
- Netlify
- Cloudflare Pages
- GitHub Pages
- 任意静态文件托管
本项目基于 MIT License 开源。