` 里直接放 * `wp_list_comments()` 输出的 `

`，标签层级非法。浏览器会 * 自行"修复"结构，而嵌套回复（`

* @license MIT License */ if (isset($_SERVER['SCRIPT_FILENAME']) && 'comments.php' == basename($_SERVER['SCRIPT_FILENAME'])) { die(); } /* ── 3.2.46 评论关闭时整块不输出 ────────────────────────────── * * 以前这里会渲染一个 `.comments` 容器，并在里面打一句 * 「评论已关闭。」/「评论已关闭，但你可以阅读上面的讨论。」 * —— 用户明确要求：**评论一关，这一块整个消失**， * 不留提示文字、不留空容器、已有评论也不再显示。 * 正文结束之后直接就是页脚。 * * 🔴 为什么是 `return` 而不是把内容包进 `if (comments_open())`： * 包起来的话，容器 `

` 仍会被输出（一个空盒子）， * 而主题给 `.comments` 有 margin/padding，页面上会留下一道空白 —— * 看起来像"有个东西没加载出来"。`return` 是**一个字节都不输出**， * 这才是需求要的"什么都没有"。 * * 🔴 必须放在**任何输出之前**：这个位置在文件里还没有 echo 过任何东西， * 所以 return 是干净的。一旦挪到后面，前面的 HTML 已经发出去了， * 再加 return 只会得到一个残疾的残块。 * * ⚠️ `comments.php` 是被 `comments_template()` include 的， * 在它里面 `return` 只会结束这个模板文件的执行， * 不会中断 single.php / page.php 的后续渲染。 */ if (!comments_open()) { return; } require get_template_directory() . '/pages/page-smilies.php'; $yang_post_id = get_the_ID(); $yang_comment_count = (int) get_comments_number($yang_post_id); $yang_max_depth = (int) get_option('thread_comments_depth', 5); if ($yang_max_depth <= 0) { $yang_max_depth = 5; } $yang_threaded = (bool) get_option('thread_comments'); $yang_has_comments = ($yang_comment_count > 0); /* 评论是否分页：分页时首屏只给「加载更多」，不一次性铺全部 */ $yang_paged = (bool) get_option('page_comments'); $yang_per_page = (int) get_option('comments_per_page', 20); if ($yang_per_page <= 0) { $yang_per_page = 20; } ?>

0) { printf( /* translators: %s: 评论条数 */ esc_html__('评论（%s）', 'kratos'), esc_html(number_format_i18n($yang_comment_count)) ); } else { esc_html_e('评论', 'kratos'); } ?>

而不是

：

的父元素必须是列表容器。加 reversed/start 会打乱视觉顺序，所以只用普通

'comment', 'callback' => 'comment_callbacks', 'walker' => new Yang_Walker_Comment(), 'style' => 'ol', 'max_depth' => $yang_threaded ? $yang_max_depth : 1, 'avatar_size' => 48, 'per_page' => 0, 'page' => 0, ), $yang_page_comments); ?>

依赖 JS 拦截，没 JS 时会跳到 ?replytocom= 的地址，行为很怪。这里用 button。 */ ?>

//），后端由 * theme-comments.php 里的 kses 白名单放行这三种标签， * style 属性由 WP 核心的 safecss_filter_attr 二次消毒， * 只放行 color 这类安全属性。改动面最小、无 XSS 面。 * * 表情按钮原来在底栏左侧，3.2.24 起并入 * 工具条；id（yang-smile-btn / yang-smile-panel）不变， * comments.js 的面板开合逻辑不用改。 */ ?>
] * 加粗和斜体挤在同一组、中间没线，于是用户看到 * 「有些中间有细线，有些没有」。 * * 现在：**5 个按钮、4 条线，每两个相邻按钮之间一条， * 首尾都不画**。 * [B] │ [I] │ [A] │ [😊] │ [<>] * 判据在 _comments_geometry.js：sep 数量必须恒等于 * 「.comment-tool-btn 数量 - 1」，且每条 sep 左右两侧 * 都紧邻一个按钮（不是贴在容器边上）。 * * ⚠️ 别把它写成"每个按钮后面跟一条"：那样最后会多出 * 一条贴到容器右边缘的孤线，看起来像个掉队的竖线。 */ ?>

` 不在 kses 白名单里 → 整条被剥掉 * · `` 在，但任何属性都会被剥，包括 class → * 语言标记保不住 * · 没有 pre 兜着时 wpautop 会套， * 而的 white-space:normal 把行首缩进折叠掉 * · wptexturize 把 ' 变成弯引号、-- 变成破折号， * make_clickable 把 URL 包成 —— 代码直接跑不了 * 现在 pre 已进白名单，后两条会被 pre 自动挡住 * （实测 11 条判据全通过）。 * * 语言必须让访客**自己选**：不选就没法可靠地上色， * 而自动识别在站内实测只有 22% 准确率，不能替访客决定。 */ $yang_hl_choices = function_exists('yang_hl_themes') ? array( 'text' => __('纯文本', 'kratos'), 'bash' => 'Bash', 'shell' => 'Shell', 'python' => 'Python', 'java' => 'Java', 'javascript' => 'JavaScript', 'typescript' => 'TypeScript', 'php' => 'PHP', 'c' => 'C', 'cpp' => 'C++', 'csharp' => 'C#', 'go' => 'Go', 'rust' => 'Rust', 'ruby' => 'Ruby', 'kotlin' => 'Kotlin', 'swift' => 'Swift', 'sql' => 'SQL', 'json' => 'JSON', 'yaml' => 'YAML', 'xml' => 'HTML/XML', 'css' => 'CSS', 'diff' => 'Diff', 'markdown' => 'Markdown', 'makefile' => 'Makefile', 'powershell' => 'PowerShell', 'dos' => 'Batch', 'ini' => 'INI', 'dockerfile' => 'Dockerfile', 'nginx' => 'Nginx', ) : array('text' => __('纯文本', 'kratos')); ?> $yang_n) : ?>
这类源码。真实内容提交前由 comments.js 序列化进上面隐藏的 #comment。 required 不能放隐藏 textarea 上（display:none 的控件无法聚焦，原生校验会报错），空值检查在 JS 做。 */ ?>