Linky 文档

缺失锚点

修复可以到达正确页面,却无法定位到预期标题或章节的链接。

确认片段#

# 后的部分称为片段,例如 /docs/setup#installation 中的 #installation。普通章节链接的片段应与目标页面上某个元素的 ID 一致。页面可以返回 HTTP 200,同时仍有缺失锚点。

打开完整网址,等待目标加载,检查是否定位到预期章节。将片段与实际 ID 比较,不要只看可见标题。大小写和编码字符可能影响结果。

  1. 阅读完整网址,包括 # 后的片段。
  2. 在浏览器标签页中打开。
  3. 找到引用承诺的标题或元素。
  4. 在编辑器或浏览器开发者工具中检查其 ID。
  5. 将该 ID 与片段比较。

修复#

如果章节有稳定 ID,更新来源链接使其匹配。如果其他文章仍使用旧片段,可考虑在预期位置保留该 ID,避免使现有引用失效。

发布修改,从来源页面测试完整链接。移除片段可以到达页面,却无法兑现让读者直接到达特定章节的承诺。

动态内容#

某些网站在 JavaScript 执行后,或用户展开内容后,才创建 ID。整站检查分析获取的 HTML,可能不同于渲染后的页面。当前页面扫描可以检查当前标签页中已经存在的 ID。

更改正常链接前,先加载相关内容,并在新标签页测试。如果只有特殊互动后才工作,应检查新访客能否完成该互动,以及来源是否需要更清楚的说明。

区分占位链接与章节链接#

空链接、单独的 # 或 javascript: 地址,可能是界面占位内容,而不是缺失章节。在“设置”中启用“检查占位链接”,单独列出这类链接。

导航应使用有意义的目标或片段。界面操作则应根据预期行为检查,不要将控件当作缺失的 HTTP 页面。

验证相关引用#

重命名标题后,查找其他指向旧片段的页面。整站来源信息有助于定位抓取范围内发现的引用。

发布后再次检查。现有报告仍是历史快照;重新打开它不能确认锚点如今存在。