执行摘要
本 PR 为 MiniMax-H3 文档页修复质量对比表表头文字重叠问题,改动仅 1 行,通过插入显式 <br /> 换行解决 Mintlify 主题 white-space: nowrap 导致的窄列溢出。经实测溢出从 4 处降为 0,文档可读性显著改善,无任何运行时影响。
功能与动机
PR body 明确指出根因:"the Mintlify theme sets white-space: nowrap on th",导致在 512px 内容列宽度下,每列仅约 79px,而 Mean inference latency 等 4 个表头需要 126-172px,从而溢出到相邻单元格。目标是在不改变表头文本(保持 Ctrl+F 可查)的前提下修复渲染。
实现拆解
- 定位问题: 在文档页
docs_new/cookbook/diffusion/MiniMax/MiniMax-H3.mdx 中,质量对比表有 6 列,其中 4 个表头为多词组合,Mintlify 主题的 th 设置 white-space: nowrap 禁止自动换行。
- 修改方案: 在表头单元格内插入
<br /> 显式换行,例如 Mean <br />inference <br />latency。由于 nowrap 仅抑制自动换行,手动换行仍生效,使得每个表头可以折行,列宽降至可用宽度以内。
- 细节处理: 每个
<br /> 前保留一个空格,确保 DOM 的 textContent 仍为原始短语(如 Mean inference latency),不影响页面内搜索(Ctrl+F)与复制。
- 验证: 作者在线上页面以失败宽度(512px)注入新标记测量,表头溢出从 4 处降为 0,行高从 119px 降至 57px;本地
mint dev 确认 <br /> 编译为真实 br 元素,且在 512/600/760/960px 宽度均无溢出,数字列右对齐不变;mint validate 通过。
- 测试配套: 文档变更不涉及模型与代码逻辑,无需单元测试或性能测试。
关键源码片段
修改后的表格头部与数据行(完整表格前 3 行)如下,注释说明了修改意图与前后行为差异:
{/* 修复前: Mean inference latency 与 Speedup 等表头因 Mintlify 主题的 white-space: nowrap 在窄列中溢出到相邻单元格,渲染为相互碰撞的文本 */}
{/* 修复后: 在每个多词表头中插入显式 <br /> 换行,并保留空格使 textContent 仍是原始短语,既解决溢出又不破坏 Ctrl+F 查找与复制 */}
| `quality` | Mean <br />inference <br />latency | Speedup | SSIM vs <br />lossless | PSNR vs <br />lossless | Expected <br />trade-off |
| --- | ---: | ---: | ---: | ---: | --- |
| `lossless` | 75.10 s | 1.00× | 1.000 | exact | Native reference path |
| `high` | 53.70 s | 1.40× | 0.931 | 28.16 dB | Smallest same-seed visual change |
评论区精华
该 PR 无实质 review 评论,仅包含 Mintlify 预览部署 bot 的自动通知与 Gemini Code Assist 停止服务的提示。reviewer wisclmy0611 直接批准(APPROVED),未提出疑问或修改建议。
风险与影响
- 风险: 极低。改动仅涉及表头文本,不影响数据行、链接或页面脚本;作者已实测 4 档常用宽度无溢出,且
mint validate 通过。唯一潜在细微影响是 <br /> 前的空格会使 textContent 中包含多余空格,但该空格在原始文本中本就存在,无实际影响。
- 影响: 仅改善 MiniMax-H3 文档页在中等宽度视口下的可读性,对用户阅读体验有正向作用;不影响任何代码、API 或性能。
关联脉络
本 PR 与 #33282(docs(diffusion): update skills for MiniMax-H3)同属 MiniMax-H3 文档完善工作线,后者更新了 diffusion 相关技能与基准脚本,本 PR 则修复了该页面表格的显示问题。此类文档微调与前期 cookbook 建设相互补充,体现文档质量持续打磨。
参与讨论