laoyang/wordpress-kratos-yang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
94 Commits 1 Branch 0 Tags
ba1245191c0aa06055b80a6c7954c2a8798ed529
Commit Graph
12 Commits
Author SHA1 Message Date
laoyang ba1245191c README.md 整体重写：讲功能与用法，删掉更新机制与一堆过期说法 #37 
用户要求「readme 需要全部重写，主要介绍功能用法，不要写更新机制」。
注意对象是**仓库的 README.md**，不是线上后台详情页那份 readme.html —
先前 #36 我理解错了对象，那是另一份文档。

删掉的更新机制内容：主题自动更新 / update.json 格式 / 发布新版本的顺序 /
自动升级会覆盖主题目录 / 换域名退役旧域名。

更要紧的是原文里有好几处**已经和代码不符**，重写时逐条对着代码核过：

- 「移动端侧边栏只在首页，文章页为减少数据传输仍没有」——
  这条其实**一直是对的**，我一度把它当成过期说法，是因为只 grep 了
  PHP 里有没有 dynamic_sidebar()，没看它外面那个 div 的 class。
  实际 single.php:121 是 `d-none d-lg-block`（小屏 CSS 隐藏），
  index.php:40 是 `d-lg-block`（小屏可见）；且文章页侧栏另受
  「文章配置 → 页面布局」g_article_widgets 控制，选单栏时整段不输出。
  真相比"过期"复杂，按实况写清两层。
- 「文章聚合 widget 将最新文章优先显示」——已反转，现在是热点文章
  （widget_posts 内部换成 yang_hot_posts()）。
- 「这些代码库都和源库保持一致和同步」——实测不成立：gitlab 镜像
  style.css 还是 3.2.0（源库 4.2.0）。改成"手动同步、不保证最新"。
- 阿里云 Code 镜像：该平台已下线，死链，删除。
- 旧 README 的七条「主要修改」里只有三条半还成立，且这种
  「相对上游做了啥」的写法本身不可持续，整段不要。

新增的主体是后台 16 个分组逐项对照代码写：真实键名、真实默认值
（std）、以及几处方向容易记反的开关（g_gutenberg 默认关=勾上才启用
区块编辑器；toc_float 默认关；a_lightbox_enable/a_highlight_enable/
stat_track_enable/toc_inline 默认开）。

两处刻意纠正的误解：
- 「Gravatar 加速」不是开/关替换，而是换哪个镜像——主题默认就把
  Gravatar 域名换成 cn.gravatar.com，勾选后换成 gravatar.loli.net。
- 自动头像是 PHP **服务端**生成（自实现 PRNG 与 DiceBear 逐字节一致），
  不是浏览器本地生成。

pages/ 那四个文件说清楚是 get_template_part()/require 引入的片段，
不是能在编辑器里选的页面模板（它们没有 Template Name 头）。

**版本号不写死数字**：#35 刚立了「版本号只留一份真源」的规矩，
README 再抄一份 4.2.0 等于自打脸，改成指向 style.css。
判据里专门有一条判这个，注入 `4.2.0` 会红。

只提交仓库、不重新发版：纯文档改动不该逼所有站点强制升级。

判据三层（都是对着代码写的，不是照着旧文案改字眼）：
- _readme37_check.py  45/0，且同一套跑旧 README 命中 15 条（有区分力）
- _readme37_falsify.py 13/13
- _readme37_meta.py   10/10

判据自身在写反证时被改坏过三次，都是「判词出现过」冒充「判结构」：
E 组（删参数表格一行仍绿，因为示例行自带那些词）、
I 组（改错一处套数仍绿，因为另一处还对）、
K 组（### 降级成 #### 仍绿，因为"不跳级"抓不到差 1 的降级）。
三条全部改成判一致性/表格行。
 2026-10-28 20:54:09 +08:00
laoyang 4f0d19fb91 版本号 3.2.4 -> 3.2.5（修 Prism 报错，项目地址改为自建 Git） 
## 修 Prism is not defined

首页控制台报 `Uncaught ReferenceError: Prism is not defined`，来源是
wp-editormd 插件（不是本主题）：它在 Prism 脚本加载之前就无条件执行了
`Prism.plugins.autoloader.languages_path = "..."`。

线上页面里的真实顺序：
    第 668 行  该赋值语句
    第 695 行  prism-core.min.js
    第 696 行  prism-autoloader.min.js

在 `wp_head` 优先级 0 垫一个最小空壳 `window.Prism`（含 plugins.autoloader
这条访问链路），让那句赋值有地方可写。已核对 prism-core.min.js 源码：它开头
只读 `u.Prism.manual` 与 `u.Prism.disableWorkerMessageHandler`，结尾
`global.Prism = Prism` 整体覆盖 —— 空壳必定被真实对象替换，不承担持久职责，
只为吸收那条过早的赋值。已用 jsdom 验证：去掉空壳重现原始报错，加上后消失，
且之后 `Prism.highlightAll` 仍可正常调用。

## 项目地址统一到 code.yangyq.net

原作者署名、原主题地址、README、语言包、JS 里的控制台横幅全部换成自建仓库地址。
LICENSE 文件保持原样不动（MIT 要求保留原始版权声明）。

## CDN 分支改成拿不到就回退本地

原来的 `g_cdn` 分支指向 `cdn.jsdelivr.net/gh/vtrois/kratos`，本仓库在自建
Gitea 上，jsDelivr 只认 github/npm/wordpress，实测该地址 404。现改为仅在
`YANG_THEME_CDN_REPO` 常量存在时才走 CDN，否则一律用
`get_template_directory_uri()`。留一个 404 的地址比留空更危险：页面能开、
样式全丢，极难排查。

## 顺带

- `.gitattributes` 补 `*.mo binary`：原来是靠"含 NUL"启发式判定，不是契约
- `update.json` 的版本号跟进到 3.2.5
- `kratos.min.js` / `kratos.min.css` 用压缩器重新生成，不手工改产物
 2026-10-23 12:55:41 +08:00
laoyang eaabc7717f 把自定义样式从主题目录搬到主题选项，升级不再丢 
原来主题里有个 custom/ 目录（custom.css / custom.js / custom.php），
是给用户随手加样式的入口。问题是它位于主题目录内，而 WordPress 升级
主题的做法是把整个主题目录删掉再解压（class-theme-upgrader.php 里
clear_destination = true，随后 delete_old_theme() 递归删除），
所以每次升级这些文件都会丢。custom.php 还会被 require，
等于在主题里留了一个执行任意 PHP 的口子。

改成后台选项：
- 主题选项新增「自定义代码」组，含自定义 CSS / 自定义 JS 两个输入框
- 内容存在数据库的 kratos 选项里，与主题文件解耦，升级、重装都不影响
- 分别在主题样式和主题脚本之后加载，优先级最高

为此新增了 code 字段类型，没有复用 textarea：textarea 的 sanitizer
走 wp_kses()，CSS 的子选择器 > 和 JS 的 < 会被当成 HTML 标签剥掉，
样式会静默失效。code 类型只去掉 PHP 标签、打断 </style> 和 </script>，
其余原样保留。渲染时也不走公共的 stripslashes —— options.php 已经
wp_unslash 过，再剥一层会把 CSS 的 \f101、JS 的 \n 啃坏。

自定义 CSS 的默认值就是原来 custom.css 的内容，逐字节一致（354 字节），
所以升级瞬间站点外观没有任何变化。清空输入框保存即可彻底去掉。

验证：真实 WP 7.1.3 / PHP 8.5.12 环境 20 条断言全过（含 DB 往返、
子选择器 / 反斜杠保真、危险内容过滤），生产选项指纹前后一致；
反向注入「默认值改空」能立刻被抓到。
 2026-10-23 10:35:56 +08:00
laoyang ffbe1b9b73 修复压缩产物丢失的代码块样式，并把主题更新源收进主站 
1. kratos.min.css 补回 6 条代码块样式
   上次为了注释掉 max-height 把单行压缩版手工展开，展开时整组丢了
   .content 下的 pre / code / kbd / pre code / pre ol / pre li，
   而未压缩的 kratos.css 里它们都在，源与产物从此不一致。
   表现是行内 code 与 kbd 没有样式（代码块因插件主题覆盖才没露馅）。
   改为用 clean-css 从 kratos.css 重新生成，不再手工维护产物。

2. 删掉 max-height / text-overflow 两条声明，而不是注释掉
   注释会被压缩器剥掉，产物里等于没改过。

3. 补上 Prism 代码高亮兜底（此前只存在于线上，仓库里没有）
   语言包路径改用 plugins_url() 动态生成，换域名或加 CDN 不会静默 404。

4. 主题更新元数据从独立子域名迁到主站 /theme-update/
   地址可用 wp-config.php 的 YANG_THEME_UPDATE_URL 覆盖，换域名不必改主题代码。

5. footer 的主题链接指向自建源库；补文档说明自动升级会覆盖主题目录、
   以及发布新版本必须"先打包再改版本号"的顺序。

6. 顺带去掉 .a-post .header .label 里重复声明的 position。
 2026-10-23 09:06:16 +08:00
laoyang 316661e595 添加了和wpdiscuz冲突的解决方法说明 2022-06-29 13:09:08 +08:00
laoyang dd6f9bc85e 修改了说明文件。 2022-05-14 18:38:57 +08:00
laoyang 8aac62115a 修改了说明文件。 2022-05-14 18:36:38 +08:00
laoyang e04b253429 修改了说明。加入了预览网址。 2022-05-14 17:53:21 +08:00
laoyang 8aba7d7cc3 发现之前的代码，好像和原主题的代码混合在一起，因此，重新提交一份纯净的代码，这样也不再和之前的主题进行关联了。完全由我自己来维护。 2022-05-14 17:50:47 +08:00
杨永全 56a190e082 Update README.md 2022-05-14 08:45:36 +00:00
laoyang a826b26bee 从gitee代码库中初始化项目。 2022-01-07 11:15:42 +08:00
杨永全 b46e3d988f Initial commit 2022-01-07 03:11:56 +00:00