 laoyang
|
76c69b31e8
|
正文标题自动编号，与目录编号共用同一份计算 #30
需求：目录里有编号、正文标题没有，读长文时要回头去目录找对应关系。
本版给 h1/h2/h3 加编号，样式为灰色小号（标题字号的 0.62 倍），
不抢标题视觉重心，与目录 .yang-toc-num 同风格。
编号规则（编号范围跟着后台 toc_levels 设置走，默认 1/2/3）：
- 按「实际出现的最外层」归一，没有 h1 时 h2 直接是一级（1/2/3），
不会编成 2/2.1。天然满足用户"h1 没有就是 h2 一级"的要求。
- 作者已手写编号的标题跳过并占位（1./1、/1)/1.2/一、/（一）/第一章
等写法），不叠加成"3.1 1. xxx"，但编号序列不错位。
实现要点：
- 抽出 yang_toc_pick / yang_toc_depths / yang_toc_number_map 三个纯函数，
目录与正文共用同一份编号计算，杜绝两边漂移（用户痛点正是"两边不一致"）。
- 插入按 id 回填：条目清单只来自 scan() 那一份，id 是唯一键。
- 用 preg_match_all + PREG_OFFSET_CAPTURE 拿字节偏移、从后往前拼接插入。
早期写成 preg_replace_callback('#<h([1-6])([^>]*)>(.{0,120})#is')，
那个 .{0,120} 贪婪跨过块边界，导致 5 个标题只有第 1 个拿到编号且不报错。
- 幂等用 strncmp(substr($html,$end), $needle, strlen($needle))，不手数字节
（写成固定 26 而实际 25 会让幂等静默失效、编号插两层）。
CSS 修一个自己造的问题：编号把标题撑高 3px。
line-height:inherit 无效——同行高下小字号半行距更大，盒底反而更往下探
（h2 46→49）。改为 display:inline-block + line-height:1 成为原子行内盒，
实测 46→46、37→37。八组隔离试验数据见 _tooling/_diag362b.js。
验证（全部本地/线上实跑，非推断）：
- 正向判据 43/0；反证 22/0（10 组注入均红在预期条目）
- 线上 4 篇真实文章 20/0（含"只有 h3"、"h1+h2"、"h2+h3"三种形态）
- 新旧两版目录 HTML 逐字节比对 7/0（4/4 篇相同，证明重构没改坏老行为）
- 几何判据 68/0，含两条反证：回到 inline+inherit ⇒ 高度差 3.00px；
编号 display:block 掉行 ⇒ G3 差 14.88px
- 打包自检 59/0 + 4 组注入反证全红
|
2026-10-28 08:27:53 +08:00 |
|
|
laoyang
|
d55667a394
|
自动目录两份默认状态分别设置，老配置平滑迁移 #27
正文那份与浮层那份的「默认状态」拆成两项，各管各的：
- theme-toc.php：toc_default 拆成 inline_default / float_default；
normalize 加四分支迁移段（新键合法→用它；新键非法→回落该键默认；
新键缺失 + 老键存在→用老键；都不存在→各键默认）；
读库键列表继续读老键 'default'，不读就拿不到迁移值，老站点会被静默重置；
正文的 open 与浮层的 is_open 各读自己的键，互不引用。
- theme-options.php：两个独立下拉分别落在「正文里的目录」「浮动目录」
分组末尾；共用分组里那句「对两份同时生效」已过时，改写。
- 新增 yang_toc_admin_legacy_values() 挂 option_kratos（仅 is_admin）：
后台读配置时把老键的值内存投影到缺失的新键上。不投影的话，
老站点会出现「页面按 hide 渲染、后台下拉框却显示 show」的错位。
只在读取时投影，库不动，降级回旧版仍有退路。
- style.css 版本号 3.2.59（本版未改前台 CSS，kratos.min.css 与 JS 均未动）。
验证：桩判据 61/0，反证 16 组 36/0，真实 WP 判据 30/0，
回归 _toc330_logic 101/0、_test_toc 53/0，打包自检 42/0。
|
2026-10-27 22:31:26 +08:00 |
|
|
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 |
|