Halo Theme Joe3 · Next

🚧 Community-maintained continuation
This is a friendly fork of halo-theme-joe3.0 by Jiewenhuang. The original author's development has paused; this repo continues maintenance and adds new features under the same CC BY-NC-SA 4.0 license.

参考站点：blog.laoda.de（维护者博客，基于此主题 · 截图即实站）· 原作者预览：jiewen.run

📸 更多截图：暗色模式 · 文章页（点击展开）

暗色模式 · 自动跟随系统或手动切换

文章页 · 自动目录 · 温馨提示 · 侧边栏广告

---

安装

要求 Halo ≥ 2.22.2。

方式 A · 远程下载（推荐，快）

Halo Console → 外观 → 主题 → 安装 → 远程下载 Tab，粘贴最新 release 的 zip 直链：

https://github.com/Lau0x/halo-theme-joe-next/releases/download/vX.Y.Z/theme-Joe3-X.Y.Z.zip

⚠️ URL 必须以 .zip 结尾，注意 Halo Console 输入框可能视觉截断长 URL，paste 后按 End 键或拖到最右确认结尾是 .zip 再点下载。常见错误：粘贴 release 页面 URL (/releases/tag/...) 或截断到 /releases/download/vX.Y.Z/ 都会失败。

最新直链自动对应最近 release，在 releases 页面点 Assets 里的 .zip 右键 "复制链接地址"。

方式 B · 上传 zip

1. 在 releases 页面下载 theme-Joe3-X.Y.Z.zip
2. Halo Console → 外观 → 主题 → 安装 → 上传安装/升级 Tab → 选择 zip

22 MB zip 在浏览器 upload 偶尔卡死 timeout，首选方式 A。

启用与配置

1. 启用主题
2. 外观 → 主题 → 设置 中完成所有配置（首次使用建议每一项保存一遍）

📬 获取更新通知：本主题暂未登陆 Halo 官方应用市场，Halo 后台不会推送升级提示。 请点本仓库右上角 Watch → Custom → Releases，新版本发布时 GitHub 会邮件通知你， 然后在 Halo Console "升级"处上传新 zip 即可。配置不会丢。

功能清单

• ✅ 卡片化设计 · 响应式 · 深色模式 · 文章目录
• ✅ 代码块语言标签 + 复制
• ✅ 字数统计 · 相关文章 · 全文搜索
• ✅ Waline / Halo 原生 评论系统任选
• ✅ 友情链接、瞬时（moments）、图库（photos）插件适配
• ✅ 博主栏天气（心知天气）· 自定义 socials · 头像挂件

完整配置说明见 docs/configuration.md。
部署时如果用 Nginx Proxy Manager 反代，看 docs/deployment/npm-setup.md（含 gzip / 安全头 / securityheaders.com A 评级完整配置 + 坑点注释）。

本地开发

需要 Docker + Node ≥ 18。

# 1. 起本地 Halo（http://localhost:8090，admin/halo-dev-2026）
docker compose -f docker-compose.dev.yml up -d

# 2. 安装依赖 + 首次构建
corepack enable && corepack prepare pnpm@10.26.0 --activate
pnpm install
pnpm build-only

# 3. 同步主题到容器（docker cp + 自动重启让 Thymeleaf 重载）
./scripts/theme-sync.sh

开发循环：

• 改 templates/*.html → ./scripts/theme-sync.sh --templates
• 改 templates/assets/{js,css}/*.{js,less} → ./scripts/theme-sync.sh --build-first
• 改 theme.yaml / settings.yaml → ./scripts/theme-sync.sh --settings

首次使用本地 Halo 建议先做一次 Halo 线上实例的"备份与恢复"，用真实数据做调试基础（见 docs/configuration.md "本地数据"章节）。

路线图与版本

• 当前 Sprint 焦点：工程基建 + 上游已知 bug 修复。完整 roadmap 见 TODO.md
• 版本变更历史见 CHANGELOG.md

贡献

欢迎 issue / PR——完整流程、commit 规范、PR Checklist 见 CONTRIBUTING.md，社区行为准则见 CODE_OF_CONDUCT.md。

• Bug → 提交 issue
• Feature → 先开 issue 讨论，再 PR
• 所有修改遵循 CC BY-NC-SA 4.0，PR 合并视为同意该条款

只维护 main 一个分支，直接在 main 基础上开 feature branch。

感谢

此主题建立在许多前辈的工作之上：

• 🙏 Jiewenhuang / halo-theme-joe3.0 — 本 fork 的直接上游
• qinhua / halo-theme-joe2.0 — Halo 1.x 时代的 Joe2.0
• HaoOuBa / Joe — 最早的 Typecho Joe 主题
• Halo · theme-starter
• 配套插件：plugin-links · plugin-comment-widget · plugin-search-widget · plugin-moments · plugin-photos

License

CC BY-NC-SA 4.0 — © Jiewenhuang (original), fork maintained by Roy Leo.

允许自由使用、修改、分享；必须署名；不能商用；衍生作品需同协议。