缺失锚点
修复可以到达正确页面,却无法定位到预期标题或章节的链接。
确认片段#
# 后的部分称为片段,例如 /docs/setup#installation 中的 #installation。普通章节链接的片段应与目标页面上某个元素的 ID 一致。页面可以返回 HTTP 200,同时仍有缺失锚点。
打开完整网址,等待目标加载,检查是否定位到预期章节。将片段与实际 ID 比较,不要只看可见标题。大小写和编码字符可能影响结果。
- 阅读完整网址,包括 # 后的片段。
- 在浏览器标签页中打开。
- 找到引用承诺的标题或元素。
- 在编辑器或浏览器开发者工具中检查其 ID。
- 将该 ID 与片段比较。
修复#
如果章节有稳定 ID,更新来源链接使其匹配。如果其他文章仍使用旧片段,可考虑在预期位置保留该 ID,避免使现有引用失效。
发布修改,从来源页面测试完整链接。移除片段可以到达页面,却无法兑现让读者直接到达特定章节的承诺。
动态内容#
某些网站在 JavaScript 执行后,或用户展开内容后,才创建 ID。整站检查分析获取的 HTML,可能不同于渲染后的页面。当前页面扫描可以检查当前标签页中已经存在的 ID。
更改正常链接前,先加载相关内容,并在新标签页测试。如果只有特殊互动后才工作,应检查新访客能否完成该互动,以及来源是否需要更清楚的说明。
区分占位链接与章节链接#
空链接、单独的 # 或 javascript: 地址,可能是界面占位内容,而不是缺失章节。在“设置”中启用“检查占位链接”,单独列出这类链接。
导航应使用有意义的目标或片段。界面操作则应根据预期行为检查,不要将控件当作缺失的 HTTP 页面。