laoyang/wordpress-kratos-yang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
53 Commits 1 Branch 0 Tags
6f51d50a58db25f669263154fa1620249c028e6b
Commit Graph
18 Commits
Author SHA1 Message Date
laoyang 6f51d50a58 3.2.30: 文章目录进后台（新增「自动目录」标签页）—— 位置/插入点/默认展开可配，手写 [TOC] 永远优先 
后台「主题设置」新增第 5 个标签页「自动目录」，7 个选项：
  目录位置   正文中间 / 页面左侧（浮动）/ 页面右侧（浮动）
  添加方式   手动（只认 [TOC]）/ 自动
  自动插入位置  文章开头 / 第一个 H1、H2 之前 / 文章结尾
  默认状态   默认显示 / 默认隐藏
  另外：目录标题、收录层级（H1~H4）、是否显示序号

设计要点：
- 插入方式拆成 toc_mode(manual/auto) x toc_anchor(start/first/end) 两个正交
  字段，不合成一个四值下拉：侧栏模式下插入位置毫无意义，合并会产生歧义。
- 手写 [TOC] 绝对优先：yang_toc_plan() 里 $has_marker 最先返回，inline_at
  ='marker' 且 rail=false —— 否则同一篇会出现两份目录，老文章升级后突然多
  出一个目录。这条是刻意守住的。
- 纯函数 + 薄壳分层：normalize_settings / plan / inject / build_list 全部不查库，
  单进程可喂几十种组合；settings() 只负责读库 + 调纯函数 + static 缓存。
- <details open> 是唯一可靠的「默认收起」手段：展开态不接受 CSS 覆盖，只能
  由 open 属性决定，所以隐藏时必须不输出该属性。
- 侧栏收起态必须 translateX(±100%) 完全移出视口：只做 opacity 会让透明面板
  留在原位吃掉正文点击（探针 elementFromPoint 才抓得到）。
- yang_toc_rail_ready() 开关：侧栏在 wp_footer 输出，那时正文可能没走
  the_content（缓存插件/OEmbed），标题没 id ⇒ 侧栏链接全跳不动却看起来正常。
  宁可不出侧栏。
- 后台联动隐藏「插入位置」不用 jQuery show()/hide()：会把 .section 的行内
  display 写成 block，悄悄回退 3.2.28 的 display:flow-root BFC 修复。改用
  class + display:none!important。

验证（全部在本轮重跑）：
  _test_toc.php       53/0   旧 TOC 行为回归
  _toc330_logic.php   88/0   逻辑判据
  _toc330_falsify     13/13  注入全变红且红对地方
  _geo330_rail.js     73/0   侧栏真实几何（左/右 x 展开/收起 x 宽窄屏）
  _geo330_falsify     8/8
  _guard330.php       46/0   后台控件与运行时默认值双向一致
  _guard330_falsify   8/8
  _admin330_tab_check 36/0   新标签页几何 + 联动 + 载入态
  _admin330_falsify   8/8
  _admin328_check     13/0   3.2.28 布局回归

发布：只发 zip + readme + update.json 到 theme-update/，不动服务器主题目录，
用户在 WP 后台自行升级（沿用 3.2.24 起的策略）。
 2026-10-25 12:18:52 +08:00
laoyang 677de0f24e 3.2.29: 把「自定义 CSS」里的站点样式并入主题公共样式 assets/css/site.css（段落缩进/h2 蓝条/列表缩进与行距），配置项默认置空并一次性清库迁移；自定义 CSS 内联输出改挂 kratos-site 以保持在最末 2026-10-25 10:36:29 +08:00
laoyang 0239cbeb2a 3.2.27: 评论嵌套引导线按层变色（1层浅蓝/2层深蓝/3层点赞色/更深扩展色轮换，深层线恢复绘制）；导航多级下拉修复（depth=2 截断改 0，深层父项 dropdown-submenu + hover 右侧弹出，移动端平铺） 2026-10-25 09:52:07 +08:00
laoyang 92ffced7cf 3.2.26: 评论布局重排（姓名/时间垂直居中于头像、正文全宽下移 10px，锚点黄底不再压作者徽章）；引导线与子块留 8px 空隙并与缩进同源（--yq-my-indent）；修深层缩进晚一层生效的存量 bug；后台设置页标题 margin 收编（项间空白 42→22px） 2026-10-24 23:58:55 +08:00
laoyang fb12d58067 3.2.25: 评论框改为所见即所得编辑器（B/I/颜色/表情可视化+序列化白名单+纯文本粘贴）；后台资源 enqueue 版本号改跟 THEME_VERSION（修设置页重排被浏览器缓存挡住的问题） 2026-10-24 22:38:10 +08:00
laoyang fd27b4d218 3.2.24: 评论富文本工具条（B/I/颜色/表情移入）+ kses 放行 span+style + 后台设置页标签左列竖排重排 2026-10-24 21:59:06 +08:00
laoyang 78fce2d87d 3.2.23 评论区：引导线和输入框聚焦统一成主色 
用户对 3.2.22 的反馈：
「这蓝色有点奇怪啊，应该用主题颜色，就是评论的那个按钮背景色。
  把评论回复左侧那个竖着的小蓝条，改成这个颜色，下面输入框被选中的
  时候，周边的颜色，也变成这个颜色。」

1. 引导线 #cfe6fb → var(--yq-primary)
   浅蓝和「发布评论」按钮的背景色（#00a2ff）不是一个蓝，
   页面上两蓝并存反而显乱。改成引用主色变量，以后改主色线自动跟。

2. 输入框聚焦变主色 —— 顺带翻出一个藏了三版的老问题
   实测发现正文输入框聚焦后边框仍是灰色：kratos.css 里
     .k-main .details .comments .comment-respond .comment-textarea
       { border: 1px solid #eee; ... }
   特异性 0,6,0，把 comments.css 的静态边框（0,1,0）、hover 变深
   （0,2,0）、focus 变主色（0,2,0）全部压死。也就是说 3.2.20 重做
   以来，正文框的边框色、圆角、浅底、悬停变色、聚焦变色**全部
   从未真正上线**，用户看到的一直是基础主题的 #eee / 3px / 灰底，
   聚焦时只有一圈很淡的外环是主色的。

   修法：textarea 的静态 / hover / focus 三态都改用同样的
   0,6,0 选择器收编（本表依赖 kratos 后加载，每条稳定压过）。
   不去改 kratos.css —— 那是基础主题，改它等于放弃覆盖层架构。

   姓名/邮箱/网址那排 input 不受影响（kratos.css 没对它们写边框），
   聚焦本来就是主色。

3. 新增线上判据并先证明它能红
   ④ 引导线颜色 = 主色（动态取 .comment-submit 背景色做参照，
      不写死 RGB，主色一改判据自动跟）；
   ⑧ 真实点击姓名框与正文框、等 0.16s 过渡结束后量边框色。
   部署前在 3.2.22 线上跑：④⑧ 正确变红、几何项依旧全绿——
   判据有效，不是空转。

只改样式表与版本号，评论的取数、分页、回复、加载更多逻辑未动。
 2026-10-24 20:49:41 +08:00
laoyang 420605f462 3.2.22 评论区：引导线跟着右移到正文左边缘，锚点高亮改回黄色 
用户对 3.2.21 的反馈：
「回复的内容和上面评论的正文是对齐了，但是回复内容左侧有一条蓝色的线
  还是没有对齐。那条蓝色的线也要向右移，让那条线和上面评论的内容正文对齐。
  如果是为了突出显示打开文章时的锚点，那还是用黄色吧。」

1. 引导线右移
   原来线写在容器的 border-left 上。边框只能贴在盒子外沿，也就是父评论的
   最左边（父头像那一列），而子回复整块已经右移到父正文的位置了，中间
   空出 55px，线与内容脱节。

   现在改成绝对定位的 ::before，位置由缩进算出：
       left: calc(var(--yq-indent) - var(--yq-guide-w))
   线的右边缘正好压住正文左边缘。断点里改缩进，线自动跟着走，
   不需要另写一遍。三档屏幕实测误差 0px。

   取右边缘对齐而不是左边缘，是因为线宽 2px：若左边缘对齐，线会压住
   子头像左侧（头像有一圈 1px 描边，压上去发脏）。

2. 缩进值 53 → 55（连带 44→46、40→42）
   旧值扣掉了 2px，因为那时线是 border，而 padding 从边框内侧算起。
   线不再占布局后，那 2px 不该再扣，否则子回复整体左移 2px。
   缩进回到最朴素的形式：头像宽 + 列间距。以后改这一个数，
   线和内容一起动，不会再出现「只对一半」。

3. 锚点高亮改回暖黄 #fffbe8
   3.2.21 改成浅蓝的理由是「全站只有待审核用暖色」。但用户指出它
   是用于突出显示锚点，该用黄色。这个判断是对的：锚点高亮需要在一整片
   蓝白里「跳出来」，浅蓝与引导线、按钮描边同色系，反而被当成背景噪音。

   与「刚提交」的分工因此清楚：
     :target → 暖黄（一次性，指路）
     is-new  → 浅蓝（即时反馈，我刚发的）
   同页出现也能分辨。

深层（第三个 children 容器起）仍然不画线，改用 content: none 关掉，
而不是以前的 border-left-color: transparent —— 伪元素没有"透明的线"
这种语义，直接不生成更干净。

只改样式表与版本号，评论的取数、分页、回复、加载更多逻辑未动。
 2026-10-24 20:12:23 +08:00
laoyang 5cb42f1716 3.2.21 评论区：去掉多余的装饰，把回复对齐到正文 
用户在 3.2.20 上线后提了 5 条，逐条对应：

1. 去掉「评论」左侧的蓝色竖条。它本身是多余的视觉噪音，
   而且逼着标题让出 12px 左内边距，让标题和下方评论正文对不齐。
   连带断点里为它让路的 11px 一起删掉。

2. 去掉标题下方的灰色横线。它和评论容器自己的上边框只隔十几像素，
   两条平行线挨得太近，像是重复画了一次。

3. 回复内容对齐到父评论正文的左边缘。上一版缩进 18px 是拍脑袋定的，
   结果子回复正文比父正文又右偏 20px，左边缘错开一小截。
   这一版按布局算：父评论一行是「头像 42 + 列间距 13 + 正文」，
   子容器是父 li 的直接子元素、从父 li 左边缘起算，自身还有 2px 引导线，
   而 padding-left 从边框内侧算起，所以
       缩进 = 42 + 13 − 2 = 53px
   窄屏同步为 36+10−2=44、32+10−2=40。实测四个视口误差均为 0。
   缩进改存成 CSS 变量，在 .comments 作用域定义、断点里重新赋值，
   避免三处写死改一漏二。

   同时收住深层累加：padding-left 逐层叠加，53×3=159px 会把
   390px 屏的正文切成竖条。第三层起换用更小的缩进并去掉引导线，
   三层累计 136px 仍有递进感。

4. 回复左侧的引导线换成主题浅蓝 #cfe6fb，与「写下你的评论」
   按钮的描边同一个色系；原来的灰蓝在一片灰白里发闷。

5. 统一高亮底色。原来「有些回复有黄色背景、有些没有」并不是随机：
   暖黄只出现在 :target 命中的那一条，也就是链接末尾带了
   #comment-1234 锚点的时候（从评论通知邮件点进来就是这种）。
   正常打开文章一条都不黄。加上刚发出的 is-new 原本也是暖黄，
   两个黄叠在同一页面上更难分辨。
   现在两者统一为 --yq-primary-soft（#eaf6ff）。徽标里的
   「待审核」暖色保留 —— 那是状态色，需要区分度。

只改样式表与版本号，评论的取数、分页、回复、加载更多逻辑未动。
 2026-10-24 19:38:08 +08:00
laoyang b97f265142 feat(comments): 评论区样式重做，修掉三处可读性不达标与窄屏头像溢出（3.2.20） 
用无头浏览器把评论区的计算样式逐条量出来之后，确认「不好看」里有三处
是硬指标不达标，不是主观审美：

  · 时间戳 #a4abb5  对白底对比度 2.32  → 4.83（WCAG AA 正文需 ≥4.5）
  · 回复按钮 #8a9099 对比度 3.22       → 6.0 （可点元素同样需 ≥4.5）
  · 顶层分隔线 #f5f6f8 对白底 ≈1.04    → 1.17（可见，此前等于没有分隔）

顺带修掉一个只在窄屏出现的真 bug：768px 断点里 avatar 的 width 组
只写了容器与占位符、漏了 img，容器缩到 36px 而图片仍是 42px，
溢出 6px 压在正文上。400px 断点同类问题一并补齐。
这个 bug 之所以能活过多个版本，是因为几何探针量的是容器宽度 ——
容器确实等于 36，98 条断言全绿。已在探针里新增 3 条直接量 img 的断言，
并在反向验证里加入对应的注入用例。

其余为层次与细节调整：
  · 新增 .comments 作用域内的局部设计变量层（--yq-*），信息性颜色带兜底
  · 标题加主色竖条；外框圆角 4→6、阴影对齐整站 .widget 的档位
  · 头像边框改外描边，不占布局，直径保持精确 42px
  · 缩进 20→18px、引导线加深；正文 14→14.5px、行高 1.8
  · 新增 :target 高亮与 prefers-reduced-motion 分支

保持不变的 DOM 契约（已在文件头注明）：.yang-comment 仍为 grid、
子容器缩进仍只加 padding-left、头像断点节奏仍为 42/36/32。

验证：verify_all.sh 30 组全通过；本地几何 107/0、反向注入 25/0、
AJAX 34/0；线上四视口几何 52/0；线上实测时间 4.83、按钮 6.0、分隔线 1.17。
 2026-10-24 12:16:30 +08:00
laoyang cbe0f2dc59 3.2.18: 清明按节气换算、主题内 [TOC] 目录、重建评论区替代 wpDiscuz 
三项功能：

1. 清明不再用固定 04-04
   清明是节气，日期在 4/4~4/6 之间浮动。硬编码 04-04 实测 1900-2100
   共 201 年里只有 76 年是对的（约 38%）。改为内嵌逐年表换算真实日期，
   超出 1900-2100 返回 null 明确放弃，不退化成近似值。
   兼容 3.2.17 及以前勾过的 '04-04' 键，升级后勾选不会被静默丢弃。

2. 主题内实现 [TOC]
   文章里写 [TOC]，该位置输出本文目录，点击跳到对应标题。
   在 the_content 优先级 9 处理（早于 wpautop 10 / do_shortcode 11），
   保证"补 id"与"扫目录"用的是同一份文本，href 与 id 必然对得上。
   嵌套用深度归一化，h1→h3 跳级不会算错层级。
   scroll-margin-top 声明式让位，原生锚点/外部 #hash/后退全都生效。

3. 重建评论区
   旧实现的问题：列表渲染与 AJAX 渲染各写一份 HTML，已经分叉
   （AJAX 返回的新评论没有回复按钮）；<li> 被 <div> 包着，嵌套回复错位。
   现在统一到 yang_comment_html() 单一渲染函数，列表与 AJAX 只差一个
   is-new 类。同时修掉三处真实缺陷：
     · 评论项用 flex 会把 <ol class="yang-children"> 当成第三个 flex 项，
       子评论跑到父评论右侧、正文被挤到 156px、页面横向溢出 75px —— 改 grid
     · 成功提示在 exitReplyMode() 之前设置，被其末尾的 setStatus('','')
       擦掉，用户提交成功却看不到反馈 —— 调整顺序
     · 窄屏媒体查询打不过深层选择器（媒体查询不增加特异性），
       嵌套头像反向变大 —— 补深层覆盖

   与 wpDiscuz 解耦：邮件模块不再无条件 return false（那等于永久关掉
   notify_postauthor 且不报错）；插件在场时不加载主题评论资源，
   避免双份表单互抢。

验证：PHP 语法 73/73；_static_qingming 36、_test_toc 53、
_test_comments 62、_test_comments_falsify 17、
_toc_geometry 121、_toc_geometry_falsify 9、
_comments_geometry 98、_comments_geometry_falsify 23，全部 0 失败。
线上端到端 29/0（真实文章渲染目录 + 真实评论数据渲染）。
 2026-10-24 01:03:36 +08:00
laoyang 0799268661 3.2.16: 删三项无用功能、选项重排为 10 组、修移动端提示条偏左 
删除
- 微信二维码：配置项 s_wechat / 隐藏上传 s_wechat_url、footer 浮动块、
  默认图注册表条目、CSS 规则、wechat.png
- Font Awesome：选项 g_fontawesome、theme-core 入队、58KB 样式、
  assets/fonts/webfonts 全套字体（2.8MB，CSS 删后零引用）
- 多人模式：选项 multiusers、page-content / page-toolbar 两处分支

选项重排（9 组 → 10 组）
全站配置 / 顶部导航 / 首页配置 / 文章配置 / 站长信息 /
页脚配置 / 哀悼模式 / 收录与统计 / 邮件通知 / 自定义代码
哀悼 5 个字段从「首页配置」独立成「哀悼模式」——它不是首页专属功能。
g_404/g_chrome/g_animate/g_gravatar 等归「全站配置」，s_copyright 归「页脚配置」。

修复
- footer.php 版权行此前无条件硬编码，后台 s_copyright 填了不生效
- 附加日期命中时 yang_mourning_today_name() 返回空串，提示条退化成
  只说「今天是纪念日」而不给名字
- 小屏哀悼提示条 padding 写成 `7px 40px 7px 12px`（右宽左窄给关闭按钮
  让位），内容盒中心 181 vs 视口中心 195，整体偏左 14px。关闭按钮本就
  absolute 不占内部流，改为左右等宽 + 缩小按钮。桌面端同类错误 3.2.14 已修，
  此处漏了同一个断点。

加载顺序
theme-options.php 可能早于 theme-mourning.php / theme-custom-code.php 加载，
新增 yang_opt_* 四个 function_exists 包装，避免裸调用导致后台白屏。

验证：静态断言 62/0 · 后台面板 14/0 · 反向验证 7/7 与 44/0 ·
提示条 4 视口几何 20/0（注入旧 bug 精确复现 -14px）· 线上 3 视口 33/0
 2026-10-23 22:56:10 +08:00
laoyang ef9a58dc51 v3.2.13 图片选项全部自带默认图，新装站点不再出现空洞/破图 
根本原因：kratos_option() 运行时只读数据库，`std` 仅在后台表单预填和
「恢复默认」时生效，前台根本读不到。因此新装站点所有图片项都是空值。
另外 isset() 挡不住「用户清空」——of_sanitize_upload() 对空输入返回 ''，
键存在且值为空串，调用方传的兜底值被绕过。

同时不能把绝对 URL 写进 std：它会随保存一起写库，主题目录改名/换 CDN/
迁站后永久 404。本站 s_wechat_url / g_donate_alipay / g_donate_wechat
三项就指向已删除的 kratos-master 目录，一直在破图（这三项是 hidden 字段，
后台界面上看不到，所以坏了很久没人发现）。

做法：
- 新增 inc/theme-option-defaults.php，图片默认值注册表（11 项），
  默认图一律运行时给出，不写数据库。
- yang_option_image() 三层判断：空/纯空白 → 默认图；指向已不存在的主题
  目录 → 默认图；文件不存在则不输出地址（避免换来一个 404）。
- 陈旧判断用 get_template()（主题 slug）而非 basename(目录名)，避免本地
  开发目录名与 slug 不一致时误伤当前主题自己的图。
- 模板统一走取值函数：header（logo/favicon/banner）、footer（微信码/国旗）、
  404、index、article 缩略图、widgets 头像、page-toolbar、theme-core 赞赏码。
- 国旗与 favicon 的渲染抽成 yang_flag_block() / yang_favicon_tag()，
  空值时不输出空 src / 空 href。
- 后台 9 处 std 改为 yang_options_default_img()，与前台默认图同源；
  该包装函数自带 function_exists 防护，单独加载 theme-options.php 不会 Fatal。

新增图片（本地生成，合计 291KB）：default-404 / default-share /
default-empty / default-avatar / default-banner / default-flag / favicon.ico。
favicon 为 WordPress 风格自绘（品牌蓝圆底 + 白色 W），非站长个人专用那张。

验证：run_tests 146 条（新增第 4 组图片默认值 22+ 条）；falsify 35 条注入
全部能被抓住（新增 10 条）；verify_all.sh 14 组全绿。
 2026-10-23 19:50:07 +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 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
杨永全 61d0111e0b 因chrome版本更新，导致其中.k-main .board .article-panel .a-post .header这个标签中的max-height: 25px;失效，因此注释掉。 2026-07-03 13:11:34 +00:00
laoyang a604cc28bd Update kratos.css 2022-07-21 11:03:26 +08:00
laoyang a826b26bee 从gitee代码库中初始化项目。 2022-01-07 11:15:42 +08:00