wordpress-kratos-yang

Files

T

laoyang 4a2d62b1aa 3.2.31 目录「正文内显示」与「浮动显示」拆成两个独立开关（#1）

原来「目录位置」是一个三选一下拉：正文中间 / 页面左侧 / 页面右侧，
等于把「放进正文」和「浮在页边」当成互斥的一件事 —— 想同时在正文
开头放一份、又在边上浮一份，做不到。

改成两个独立勾选，各自带子选项：

  · 在正文中显示 → 正文中的对齐（靠左 / 靠右）+ 自动插入位置
  · 浮动显示     → 浮动方向（页面左侧 / 页面右侧）

两个都勾就同时出现两份，只勾一个就只出现一种。四种组合都在后台
联动里逐个验证过（探针 70/0）。

新增能力「正文内靠左 / 靠右」是本单的主要新需求。实现上两个要点：

  1. 必须给正文目录一个宽度上限（max-width: min(100%, 28em)）。
     块级盒子默认撑满正文栏，此时 margin:auto 没有剩余空间可分配，
     「靠左/靠右」会是一个属性正确、画面纹丝不动的空操作。
  2. 用 data-align 属性把方向带下去，CSS 只需两条规则，
     不随方向数量膨胀。属性在 yang_toc_slot_html() 里输出。

语义收窄：手写 [TOC] 以前会让整份自动处理全停（连带 rail=false），
现在只手管「正文那一份」—— 手写位置优先，浮动仍由 float 开关独立
决定。这样「精确定位正文位置」和「全站边上都有目录」可以并存。

顺手修掉一处默认值错配：checkbox 用 !empty() 判断会把「键不存在」
和「键明确为空」混成一件事，导致新装站点后台框显示勾上、页面却
不出目录。改用 array_key_exists() 区分的三态判断。

老配置不迁移：3.2.30 的 toc_place 直接作废，不做兼容。
默认 inline=1 / float=0，升级后页面与升级前一致。

重构：把内容过滤器拆成 yang_toc_apply()（纯执行层）+ 运行时壳，
使设置组合能在单进程单测里逐个喂进去（PHP 无法重置函数 static）。

验证
  逻辑 101/0 · 逻辑反向 15/15
  旧回归 53/0
  静态契约 58/0 · 反向 11/11
  后台几何+交互 70/0 · 反向 11/11
  侧栏几何 73/0 · 反向 8/8
  正文对齐几何 23/0 · 反向 5/5（含阴性对照）
  包内容契约 59/0 · 反向 9/9

正文对齐的几何探针量到真实的 Δleft = 348px（靠右比靠左），
而不是只断言 data-align 字符串存在。

2026-10-25 13:37:26 +08:00

options-framework

3.2.31 目录「正文内显示」与「浮动显示」拆成两个独立开关（#1）

2026-10-25 13:37:26 +08:00

update-checker

版本号 3.2.5 -> 3.2.6（统一邮件出口 + 邮件模板 + 纪念日自动哀悼 + 去掉广告位）

2026-10-23 13:55:23 +08:00

theme-article.php

3.2.18: 清明按节气换算、主题内 [TOC] 目录、重建评论区替代 wpDiscuz

2026-10-24 01:03:36 +08:00

theme-comments.php

3.2.27: 评论嵌套引导线按层变色（1层浅蓝/2层深蓝/3层点赞色/更深扩展色轮换，深层线恢复绘制）；导航多级下拉修复（depth=2 截断改 0，深层父项 dropdown-submenu + hover 右侧弹出，移动端平铺）