8000 GitHub - ww51wake/Mominus: 一款简约、优雅、高性能的Astro博客主题。 · GitHub
[go: up one dir, main page]

Skip to content
ww51wakePublic

About

一款简约、优雅、高性能的Astro博客主题。

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Mominus

Mominus Banner

捕捉灵感的瞬间,照亮思想的深度。

A minimal, elegant, and high-performance Astro blog theme.

Version Astro React Tailwind CSS TypeScript License: MIT


概览

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 参数,落地页会高亮命中关键词。

Decap CMS

配置文件: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

代码高亮与 SEO

技术栈

类别 技术
框架 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 开源。

About

一款简约、优雅、高性能的Astro博客主题。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0