问题背景
冰叶小站基于 MetInfo 8.1 改造个人主题时,首页已经使用深色配色,但项目详情页底部的上一篇、下一篇仍沿用旧模板结构。第一次仅调整样式后,导航出现重复标签,冒号与标题还被拆成多行,和正文风格明显不一致。
排查过程
先检查浏览器实际生成的页面,而不是只看模板文件。旧导航包含分页列表、链接及其内部文本;链接还带有供前端脚本处理的属性。新增样式同时补充了方向标签,最终与原有输出叠加。
页面上同时出现两组“上一篇”和“下一篇”。
旧链接中的标签、冒号、文章标题被不同样式影响,产生异常换行。
问题集中在详情页底部,正文和相邻文章地址仍然正常。
原因分析
这次问题不是相邻文章查询重复,而是旧模板的渲染结构与新增展示逻辑同时生效。仅覆盖颜色、边框和间距,无法消除重复生成的文字。继续依赖旧分页链接的样式约定,还容易受到米拓通用前端脚本的影响。
处理方法
保留原生数据,独立组织展示
移除详情页原来的导航输出,改为读取米拓已经提供的相邻内容数据,由新主题统一渲染方向标签和标题。使用到的数据字段如下:
$data['preinfo']['url'] $data['preinfo']['title'] $data['nextinfo']['url'] $data['nextinfo']['title']
上述字段已在本站这次改造中核对;其他版本或主题应先检查实际数据结构,再决定是否采用相同写法。
让标签只有一个来源
新结构中,每个导航项只输出一个方向标签和一个标题,不再复用旧分页链接的标签生成方式。独立类名用于控制两列卡片、间距、边框和悬停效果,避免与旧分页样式混用。
处理边界情况和输出安全
存在相邻内容地址时输出链接;没有上一篇或下一篇时显示首篇、末篇提示,不生成空链接。标题作为纯文本输出,链接属性和标题在模板中进行 HTML 转义。
发布后刷新生成缓存
模板文件更新后,先备份再刷新对应的生成缓存,随后重新打开实际详情页检查。否则浏览器看到的仍可能是旧模板编译结果,容易误判修改没有生效。
验证结果
项目详情页中,上一篇和下一篇各保留一个方向标签。
旧版导航结构不再出现在本次检查的详情页中。
相邻项目的标题与链接对应正常,点击可进入各自介绍页。
桌面端卡片使用主题现有深色与冰蓝配色;窄屏通过较小间距和可换行标题适配。
本次修复已在本站项目详情页进行实际检查。它说明了本站主题中的处理方式,不代表所有 MetInfo 主题都存在同样问题。
总结
主题改造出现重复文字时,应先确认文字来自模板、脚本还是样式,再处理展示。对于已经换用新设计的组件,保留可靠的数据来源、重新组织必要的 HTML,通常比持续覆盖旧结构更容易维护。