 laoyang
|
492d8e11a6
|
3.2.48: 归档倒序/字号/底边对齐/共N篇 + 评论标题线等长 + 工具条分隔线统一 #18
工单 #18 八条诉求逐条落地：
1. 月份、日期、年份全部倒序（最近的在最上面）
- PHP 侧 `krsort($years[$y]['months'])`（原来是 ksort）
- JS 侧 `Object.keys(...).sort((a,b)=>b-a)` —— 对象键序对纯数字整数键
会强制升序，服务端顺序传不过来，必须前端自己再排一次
- 年份本来就是 krsort，日期本来就是倒序，本次只补月份
2. 年份字体再大一点
- 原来 CSS 写的 22px **从来没有生效过**：`.yang-archives .ar-year` 是
(0,2,0)，被 `.k-main .details .article .content h3` 的 (0,4,1) 压死，
线上实际是 18px
- 改为带 `.k-main` 前缀（提到 (0,5,0)）+ 26px + 700
- `.ar-month-title` 同一个坑，一并修（写 14px/600，线上实际 16px/500）
3. 「共 N 篇」太高、比年份还高 → 下移与年份底边对齐
- `.ar-head` 的 `align-items: center` → `flex-end`
- `.ar-year` 的 margin 显式清零（kratos 的 `h1..h6 { margin: 0 0 30px 0 }`）
- 窄屏媒体查询同步改，否则手机上又回到居中
- 注意 `flex-end` 对的是 margin box，所以 margin 不清零等于没改
4. 每月后面的裸数字 → 「共 N 篇」
- PHP：`sprintf(esc_html__('共 %s 篇'), number_format_i18n(...))`
- JS：同一个文案键 `i18n.monthCount`，服务端输出到 `yangArchivesData`
- 新增 `monthCount` 键，**没有复用** `totalFmt`（两处语义不同，
以后要分别改文案时不至于互相牵连）
5. 上一年/下一年按钮看不清 → 与「写下你的评论」同款观感
- 平时：`1px solid #cfe6fb` 浅蓝框 + 透明底 + `--yq-primary-dark` 蓝字
- 悬停：主色实底 + 白字（`.ar-nav-year` / `.ar-nav-arrow` 也要跟白，
否则图标还是蓝的在蓝底上看不见）
- 禁用态保持灰（`is-disabled` + opacity .42），不能跟可用态一个样
6. 评论「评论者」下面的灰线太短 → 延长到与评论分隔线等长、右侧到头
- 🔴 这里改过一次方案：一开始以为把 h3 `flex: 1 1 auto` 撑宽就行，
实测发现 `.comments-head` 是 flex 行，右边还有「写下你的评论」按钮
（flex: 0 0 auto），h3 撑满也只能长到按钮左边缘 —— 原理上到不了右端
（实测 h3 110.5px / li 561.98px，差的 451px 就是按钮 + gap）
- 最终方案：**线从 h3 搬到 `.comments-head` 容器上**，
h3 显式 `border-bottom: none` 干掉 kratos 的 #f0f0f0，
否则会出现一短一长两条线，比原来更难看
- 容器那条规则**还必须带 `.k-main` 前缀**（(0,5,0)），否则压不过
kratos 的 `.comments .title`。发布判据当场抓到这一条：注释里写了
「带 .k-main 前缀」，代码里漏了 —— 注释不能当证据
7. 工具条分隔细线不统一 → 5 个按钮 4 条线
- 原来 B/I 之间没有线，其余有 ⇒ 现在统一
- 写成「每条后面跟一条」会在末尾多出贴容器边缘的孤线，所以是 5 按钮 4 线
8. 清理无用 JS/CSS
- 四轮查证结论：**没有可安全删除的**，代码一行未动
- 排查过程已作为评论发到工单
测试：归档单测 113/0（反向 13 真红）、归档 e2e 112/0（反向 24 真红）、
评论几何 157/0（反向含新增 5 条，覆盖"线搬回标题""两处都画"两种错误形态）。
线上真实页面几何探针发布前 17 通过/16 失败（每条都对应上面某一条诉求），
发布后要求全绿。
|
2026-10-26 18:42:40 +08:00 |
|
|
laoyang
|
7047ab3ece
|
3.2.46: 新增 [Archives] 归档短代码 + 评论关闭时整块零输出 #15
需求一：[Archives] 短代码 —— 归档式全站文章列表
· 在文章/页面正文写一行 [Archives]，该位置渲染全站文章的年月归档
· 默认显示今年，按月份归类；每篇带浏览/评论/点赞三个数
· 上下两排各有一组「上一年 / 下一年」按钮（四角），JS 切换不刷新页面
· 地址栏同步 ?arc_year=，刷新与分享链接都能保持同一年
· 只在用到短代码的页面才加载 assets/js|css/archives.js|css
· 参数：year="2025" 指定首年；month="0" 不按月分组
需求二：评论关闭时评论区整块消失
· comments.php 在**任何输出之前** `if (!comments_open()) return;`
—— 零字节，不是空容器、不是 display:none、不留提示文字
· 已有评论的老文章关评论后也不再显示（需求原话：正文之外什么都没有）
· inc/theme-comments.php 的资源守卫与之同口径：关评论时不加载
约 10KB 的 comments.css / comments.js
· 删掉 .comments-closed 样式与两处「评论已关闭」提示分支
开发中实测抓到并修掉的三个真实 bug（都是"测试把期望值写对之后"才显形）：
· 年份标题 / 导航年份过了 number_format_i18n() ⇒ 输出「2,025」，
而 JS 侧 String(year) 输出「2025」⇒ 首屏与切年后不一致
· 月份标题同样过 number_format_i18n()，与 JS 侧 String(m) 口径不一致
· yang_archives_render_nav() 把 ar-nav-top 写死，而下排也调它生成
⇒ 下排被叫成 top（视觉上被更高特异性规则压住，看不出问题）
验证：
归档 _archives_unit.php 94 通过 / 0 失败
_archives_e2e.js 109 通过 / 0 失败
_archives_e2e_falsify.js 反证 25 真红 / 0 无效
_archives_unit_falsify.py 反证 6 真红 / 0 无效
评论 _comments_closed_test.php 54 通过 / 0 失败
_comments_closed_falsify.py 反证 13 真红 / 0 无效
回归 _test_comments.php 64 通过 / 0 失败
_hl_unit_run.py 24 通过 / 0 失败
全量 96 个 PHP 文件语法检查通过；包内 lint 通过
发布 已推 3.2.46 到 /theme-update/，update.json 已落 3.2.46；
服务器 wp-content/themes/kratos_yang/ 仍为 3.2.45（未覆盖）
另：把 _archives_unit.php 从 `__DIR__` 定位改为接受根目录参数，
否则它无法登记进 verify_all.sh，只能手动跑（手动跑 = 长期不跑）。
5 个新套件已登记进 verify_all.sh（2j ~ 2o）。
|
2026-10-26 13:25:51 +08:00 |
|