 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 |
|
|
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
|
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 |
|