Mansus

用 Markdown 写文章，为每篇文章选择准则与墨水颜色，再通过 GitHub Pages 发布。Mansus 基于 Firefly 和 Astro，提供 RSS、全文搜索和响应式布局。

在线示范 ｜ 快速部署 ｜ 内容与配置 ｜ 本地运行

Mansus 能做什么？

• 按文章选择颜色。 单个或多个准则共同生成文章主题色，也可自定义混色比例。
• 在仓库中管理内容。 文章、图片和站点配置分目录保存，使用 Markdown 写作。
• 推送后自动发布。 从模板创建仓库，启用 GitHub Pages 后由 Actions 构建并更新站点。

页面预览

Mansus 首页

核心能力

准则与墨水

• 支持单准则、多准则和自定义点数混色。
• 文章卡片、标题、徽标和正文强调色会随准则组合变化。
• 内置八个可见准则，并保留加密文章使用的隐藏准则约束。

写作与内容

• 使用 Astro 内容集合校验文章元数据。
• 支持 Markdown、MDX、文章封面、正文图片、标签、分类和置顶。
• 内置 RSS、归档、分类、标签、准则页面和 Pagefind 全文搜索。

部署与维护

• 自动识别 GitHub Pages 的仓库子路径。
• 支持自定义域名、Vercel 和 Cloudflare Workers。
• GitHub Actions 会执行内容校验、构建和静态站点部署。

快速部署

GitHub Pages

1. 点击 Use this template，从模板生成一个独立的公开仓库。
2. 仓库名使用 <用户名>.github.io 时会部署到根路径；使用其他名称时会部署到 /<仓库名>/。
3. 打开新仓库的 Settings > Pages，将 Source 设为 GitHub Actions。
4. 如果 Actions 页面要求确认，先点击 I understand my workflows, go ahead and enable them。
5. 在 Actions 中运行一次 Deploy to GitHub Pages。

首次部署需手动将 Pages Source 设为 GitHub Actions。如果工作流停在 Configure Pages 并提示 Pages 尚未启用，完成第 3 步后重新运行。

以后推送到 main 或 master 会自动更新站点。普通仓库的默认地址为：

https://<用户名>.github.io/<仓库名>/

自定义域名

在 Settings > Secrets and variables > Actions > Variables 中添加：

变量	用途	示例
SITE_URL	站点完整地址	https://blog.example.com
BASE_PATH	站点基础路径；自定义域名通常使用根路径	/

其他平台

• Vercel： 导入仓库，使用默认配置构建。
• Cloudflare Workers： 设置 CF_WORKERS=1 后执行构建，再通过 wrangler.jsonc 部署。

内容与配置

要修改的内容	文件或目录
站点标题、描述、页面开关	src/config/siteConfig.ts
头像、昵称和个人链接	src/config/profileConfig.ts
导航栏	src/config/navBarConfig.ts
主页背景与横幅文字	src/config/backgroundWallpaper.ts
文章	src/content/posts/
正文图片	public/assets/uploads/
文章封面	src/assets/images/mansus/
准则名称与颜色	src/data/aspects.ts

示例文章

示例	文件	说明
单准则	src/content/posts/01-single-aspect.md	只使用一个准则颜色
多准则	src/content/posts/02-multiple-aspects.md	主准则与相关准则自动混色
自定义混色	src/content/posts/03-custom-color-mix.md	使用高级点数控制颜色比例

本地运行

corepack enable
pnpm install
pnpm dev

生产构建：

pnpm build

构建产物位于 dist/。

来源与致谢

• 感谢 CuteLeaf/Firefly 提供原始主题与工程基础。
• 感谢 Astro 提供静态站点框架。
• 准则名称与相关美术源自《密教模拟器》世界观，权利归原权利方所有。

许可

MIT。公开部署前，请自行确认第三方美术素材的使用范围。