Simple Theme

Simple Theme 是一个面向个人博客的 WordPress 主题。前台使用 Vue 3 和 WordPress REST API，后台保留 WordPress 的管理流程，并提供独立的主题设置面板。

在线预览 · 下载主题 · 配置说明 · REST API

主要功能

• Vue 3 单页导航，文章、页面、分类、标签和日期归档统一处理
• 响应式布局，支持浅色/深色模式和自定义主题色
• 文章评论、嵌套回复、点赞、Markdown、表情和可选验证码
• 服务端输出基础 HTML，兼顾搜索引擎、无 JavaScript 环境和社交分享信息
• 适配 Gutenberg 常用区块，并兼容部分 Sakurairo 区块数据
• 可配置的侧边栏小工具、公告、Cookie 提示、站点统计和一言
• SMTP 邮件通知与异步发送队列
• Prism 代码高亮、头像代理和本地头像支持
• WordPress 后台主题设置页与登录页样式统一

安装

从 Releases 下载 Simple-Theme-vX.Y.Z.zip，然后在 WordPress 后台打开 外观 → 主题 → 添加新主题 → 上传主题，安装并启用即可。

运行环境：

• WordPress 6.0 或更高版本
• PHP 7.3 或更高版本

启用主题后，建议到 设置 → 固定链接 保存一次，确保文章和归档链接正常工作。

本地开发

npm install        # 安装依赖（Node.js ≥ 20.19）
npm run dev        # 启动 Vite 开发服务器，需要 WordPress 后端
npm run build      # 类型检查并构建到 dist/
npm run package    # 构建并生成主题 ZIP

项目使用 Vite 构建前台和后台资源。推送 v* 标签后，GitHub Actions 会自动构建并发布 Release。

项目结构

src/    Vue 3 前台、组件、组合式函数、样式和后台设置面板
inc/    PHP 集成代码：主题功能、REST API、SEO、后台选项和小工具
dist/   构建产物，由 WordPress 根据 Vite manifest 加载

前端通过 REST API 解析当前路径，再决定显示文章、页面、分类、标签或日期归档。/about、/archives、/links 和 /shuoshuo 是主题内置页面；其他路径仍按 WordPress 的固定链接规则解析。

致谢

• Sakurairo（GPL-2.0）：部分区块与数据兼容实现参考了其做法
• iEmo（MIT）：本项目的视觉设计灵感来源
• PrismJS（MIT）：代码高亮
• unDraw（开放许可）：插画素材
• Tabler Icons（MIT）：界面图标

许可证

MIT

本项目在构建产物中分发若干第三方组件与素材，其版权与许可见 THIRD-PARTY-NOTICES.md。