Joe · 双栏极致优化主题（joe） 主题 博客日记 ¥1.99

Joe（本地适配版）

一款基于 Typecho 博客的双栏极致优化主题，本目录为其本地适配版本。

• 原作者：HaoOuBa（上游仓库 https://github.com/HaoOuBa/Joe ）
• 主题宗旨：简洁、超强、开源、精华
• 适配目标：本项目 TypechoPlus（Typecho 1.3 命名空间版） + PHP 8.1
• 环境要求：PHP 7.4 ~ 8.3

重要提醒

如果首页列表一直加载中，超过十几秒都没有出来，表示加载失败了，可尝试：
「进入后台」-「设置」-「永久链接设置」-「是否使用地址重写功能」-「不启用」

本地适配说明（相对上游原版已做的改动）

本主题已被移植到本地 TypechoPlus 分支并做 PHP 8 适配，主要变更如下：

1. 头像改用源码默认头像：_getAvatarByMail() 不再写死 gravatar.helingqi.com 外部镜像，未配置「自定义头像源」时统一走 \TypechoPlus\Avatar::userUrl()（本地上传头像 > 站点默认头像 > Gravatar 镜像），离线也不会出现碎图。后台「设置 → 图片设置 → 头像源」仍可自定义。
2. 「最新公告」改为本地可配置：原主题后台「外观设置」的「最新公告」面板会向 https://78.al/api.php 拉取主题作者公告，离线/被墙时永远显示「请求失败」。已移除该外部请求，改为由主题配置项 JNotice（全局设置 → 站点公告，支持 HTML）服务端渲染，管理员可自行填写公告内容；后台 JS/CSS 引用追加 ?v=2 版本号击穿浏览器缓存。
3. 修复边栏「最新回复」显示陈旧评论：内核 WidgetCommentsRecent 的 ignoreAuthor 过滤条件 ownerId <> authorId 会把 ownerId=0 的脏数据（第三方导入、历史测试数据等）误判为「作者自评」而静默过滤，导致边栏退回显示古老评论。已改为 ownerId = 0 OR ownerId <> authorId，正常数据行为不变。
4. 主题信息更新：index.php 顶部主题描述改为「环境要求：PHP 7.4 ~ 8.3」，并移除指向已停用域名 78.al 的署名与 @link。
5. PHP 8 兼容：functions.php 的 themeConfig 中 ALTER 加 isarray 守卫（避免 arraykey_exists(null) 弃用警告）；core/function.php 修复 push() 后访问 permalink 魔术属性报 Undefined array key 的问题。

主题简介：

1. 整包紧凑，却实现超强功能，极其迅速的响应
2. 全站变量名、类名统一规范，方便参与二开与拓展
3. 主题开箱即用，无复杂操作，无需特意创建分类
4. 主题启用后，会置换 Typecho 的默认编辑器，采用 Joe 独家开发的编辑器
5. 主题响应式布局，不依赖任何响应式框架，采用 Joe 独家响应式
6. 主题在一切可能暴露的接口上，屏蔽 sql 注入、xss 攻击风险，提供安全保障
7. 内置超强视频功能、包含直播功能、全网影视功能、文章内插入视频功能
8. 主题 SEO 极致优化
9. 主题色彩全局公用、小白轻松直接修改整站自定义主题色
10. 主题内置代码高亮、无需借助任何插件、支持 200 种语言
11. 主题首发极强画图回复功能，为你的博客带来用户互动
12. 主题内置 sitemap、百度推送、友链、回复可见等，无需依赖任何插件

主题开发

1. 开发时请使用 VSCode编辑器 ，编辑器插件：scss-to-css（根据官方文档进行下载依赖库） 和 minify
2. css 代码由 scss 编译成 .min.css 文件
3. js 代码由 minify 压缩成 .min.js 文件

主题目录介绍

├── assets 主题静态资源（css / js / lib）

├── core 主题核心文件夹（头像、解析、备份等逻辑）

├── library 主题内集成第三方库

├── public 共用的一些模块文件（头部、侧栏、页脚等）

├── 404.php 404 页面

├── archive.php 搜索页面

├── census.php 统计/数据页（本地新增）

├── friends.php 友情链接页面

├── functions.php 主题的外观、功能设置

├── index.php 博客首页页面（含主题信息注释块）

├── leaving.php 留言板页面

├── live.php 虎牙直播页面

├── page.php 独立页面

├── post.php 文章页面

├── screenshot.png 主题截图图片

├── video.php 全网影视页面

├── wallpaper.php 壁纸页面

└── package.json 主题发布至 NPM 仓库使用（勿动）