laoyang
492d8e11a6
工单 #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 失败（每条都对应上面某一条诉求）， 发布后要求全绿。
该项目是原kratos的一个分支。
本项目仓库地址：
https://code.yangyq.net/laoyang/wordpress-kratos-yang
因为我需要一些定制的功能，就fork出来一个新的分支，自己用。如果你对原有的主题开发也有不满意的地方，欢迎使用我的这个版本。当然，版权仍然是属于原主题。
主题预览：老杨说话的地方。
该仓库已同步到多个git托管平台，包括Github、Gitee、 Gitlab和阿里云Code。这些代码库都和源库保持一致和同步，在任何平台上关注都可以。
Github因为网络原因，同步会出现失败情况，无法保证最新。
主要修改的地方主要包括：
- 为移动端增加了侧边栏显示。之前的版本，在移动端无法看到最近评论，这个版本加入了这个功能。当然只是在首页，在文章页面，为了减少数据传输，仍然没有侧边栏。
- 文章聚合widget，将最新文章优先显示。原来的版本，是显示最热门文章，但是不知道什么原因，热点文章总是没几个，而且我认为，大部分人上来，应该时主要为了看最新文章的吧。
- 删除了配置页面中的关于主题，精简、精简、精简。
- 删除了资源托管选项，删除了媒体托管选项。
- 文章配置中，删除了文章版权信息，删除了网易云音乐。
- 删除了社交相关配置选项。
- 增加了在页脚显示国旗的选项。
修复Bug
- 如果使用了插件，会改变comment的div名称，class="comments" 变成了comments-area，因此，评论的样式不好用了。
此时，在主题的额外CSS中添加：
.k-main .details .comments-area {
margin-top: 16px;
padding: 1.6px 16px 16px;
border-radius: 2px;
background-color: #fff;
-webkit-box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
-moz-box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
}
.k-main .details .post-2 .comments-area {
-webkit-box-shadow: none;
-moz-box-shadow: none;
box-shadow: none;
}
就可以了。该问题属于和插件的冲突问题，因此，在额外CSS中添加，不修改主题本身。
代码块样式
主题的 assets/css/kratos.css 里有一组 .k-main .details .article .content 下的
pre / code / kbd / pre code / pre ol / pre li 规则，负责代码块与行内代码的底色和间距。
这六条曾经在压缩产物里整组丢失过：某次改动把单行压缩版 kratos.min.css 手工展开成可读格式，
展开时漏掉了这一整段，而原始未压缩的 kratos.css 里它们是齐全的，导致源与产物对不上。
表现是行内 code 与 kbd 没有样式（代码块因为插件 Prism 主题的覆盖才没露馅）。
改完 CSS 后请用压缩器重新生成产物，不要手工维护 kratos.min.css：
npx clean-css-cli@5.6.3 -o assets/css/kratos.min.css assets/css/kratos.css
主题自动更新
更新走的是一份静态 JSON + 一个 zip 包，由 inc/update-checker/（Plugin Update Checker 4.9）消费。
- 元数据地址：
https://yangyq.net/theme-update/update.json（定义在inc/theme-core.php，可用wp-config.php里的YANG_THEME_UPDATE_URL覆盖） - 发布目录：站点根下的
theme-update/，内容只有三样：
theme-update/update.json # 版本元数据
theme-update/kratos_yang.zip # 主题包，解压后是 kratos_yang/ 目录
theme-update/readme.html # 「详情」页，可省
update.json 格式（version 与 details_url 必填）：
{
"version": "3.3.0",
"details_url": "https://yangyq.net/theme-update/readme.html",
"download_url": "https://yangyq.net/theme-update/kratos_yang.zip"
}
发布新版本的顺序
先改 style.css 里的 Version，再打包，否则 WordPress 认为没有新版本，不会提示升级。
- 改
style.css的Version（例如 3.2.2 → 3.3.0） - 打包：
zip -r kratos_yang.zip kratos_yang -x "*.DS_Store" "*/.git/*" - 传
kratos_yang.zip到theme-update/ - 最后才改
update.json里的version
第 4 步放最后，是因为 WordPress 见到新版本号就会立刻允许升级； 若此时 zip 还是旧的，等于发了个指向旧包的更新，装完版本号没变（或者直接坏掉）。
⚠️ 自动升级会覆盖主题目录
WordPress 升级主题的做法是删掉整个 kratos_yang/ 再解压新包
（wp-admin/includes/class-theme-upgrader.php 里 clear_destination => true，
随后 delete_old_theme() 递归删除）。所以任何直接改在服务器主题目录里的东西都会丢，
包括手工打的补丁（例如曾经直接在 footer.php 里加的 Prism 脚本）。
自定义样式不再放主题目录。 早期版本有一个 custom/ 目录（custom.css /
custom.js / custom.php），是给用户随手加样式的入口，但它位于主题目录内，
每次升级都会被清空 —— 而且 custom.php 会被 require，等于允许在主题里执行任意
PHP 代码。该模块已在 3.2.2 移除，改为后台选项：
后台 → 主题选项 → 自定义代码 → 自定义 CSS / 自定义 JS
这两段内容存在数据库的 kratos 选项里，升级、重装、改主题目录名都不受影响。
它们分别在主题样式表和主题脚本之后加载，优先级最高。
几个要点：
- 不需要写
<style>/<script>标签，直接写 CSS / JS 内容 - 内容不会被当作 HTML 处理，
>、<、~、反斜杠转义（如content: "\f101"）都原样保留 - 想彻底清空，把框里内容删掉保存即可（空值会覆盖内置默认值）
- 点“恢复默认”会把「自定义 CSS」还原成主题自带的默认样式
换域名 / 退役旧域名
以前更新元数据放在独立子域名上，现在收进主站，省掉一个站点、一套证书和一份备案。 切换时注意：
- 先把
theme-update/部署到主站并确认update.json能直接访问（返回 JSON，不是 404 或首页） - 再发布带新地址的主题版本
- 旧版本的主题仍会去老地址拉更新，所以旧域名的
update.json要在确认所有站点都升级完之后才能下线