Prhub

#33345 [Docs] Fix overlapping quality-profile table headers on MiniMax-H3 page

原始 PR 作者 zijiexia 合并时间 2026-08-03 13:22 文件变更 1 提交数 1 评论 2 代码增减 +1 / -1

执行摘要

修复 MiniMax-H3 页面质量表表头重叠

PR body 指出:'The quality-profile table in the MiniMax-H3 cookbook page renders with colliding header text: Mean inference latency and Speedup run together, as do SSIM vs lossless and PSNR vs lossless. Root cause, measured on the live page: the Mintlify theme sets white-space: nowrap on th.' 在 512px 内容列宽度下,每列仅约 79px,四个多词表头需要 126-172px,因而溢出。目标是修复渲染而不改变表头文本,保证 Ctrl+F 可查。

该 PR 属于琐碎文档修复,不值得精读,但可快速浏览了解处理 Mintlify 主题 nowrap 溢出的技巧:显式 <br /> 配合保留空格以维持 textContent 不变,是一个可复用的小设计决策。

讨论亮点

该 PR 无实质 review 讨论,仅包含 mintlify[bot] 的部署预览通知与 gemini-code-assist[bot] 的停止服务提示。reviewer wisclmy0611 直接批准(APPROVED),未提出疑问或修改建议。

实现拆解

  1. 定位问题:在 docs_new/cookbook/diffusion/MiniMax/MiniMax-H3.mdx 的质量对比表中,Mintlify 主题对 th 设置 white-space: nowrap,导致多词表头在窄列中溢出。
  2. 修改方案:在表头单元格内插入 <br /> 显式换行,例如 Mean <br />inference <br />latency,利用 nowrap 不抑制手动换行的特性,使每列表头可折行至可用宽度内。
  3. 细节处理:每个 <br /> 前保留一个空格,确保 DOM 的 textContent 仍为原始短语(如 Mean inference latency),不影响页面内搜索与复制。
  4. 验证:作者在线上页面以失败宽度(512px)注入新标记测量,溢出从 4 处降为 0,行高从 119px 降至 57px;本地 mint dev 确认 <br /> 编译为真实 br 元素,且在 512/600/760/960px 宽度均无溢出,数字列右对齐不变;mint validate 通过。
  5. 测试配套:纯文档变更,无模型与代码逻辑,无需单元测试或性能测试。
文件 模块 状态 重要度
docs_new/cookbook/diffusion/MiniMax/MiniMax-H3.mdx 文档 modified 2.14

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

风险极低。改动仅涉及表头文本,不影响数据行、链接或页面脚本;作者已实测 512/600/760/960px 四档宽度无溢出,且 mint validate 通过。唯一潜在细微影响是 <br /> 前的空格会使 textContent 中包含多余空格,但该空格在原始文本中本就存在,无实际布局影响。

影响范围仅限 MiniMax-H3 文档页的表格展示,提升中等宽度视口下的可读性,对用户阅读体验有正向作用;不影响任何代码、API 或性能,对团队无新增维护负担。

纯文档变更 布局修复已验证 无运行时影响

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论