文档AEM 6.5用户指南

链接检查器 the-link-checker

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined

内容作者无需自行验证他们包含在内容页面中的每个链接。

Link Checker会自动运行以帮助内容作者使用其链接，包括：

  • 在链接添加到内容时对其进行验证
  • 显示内容中所有外部链接的列表
  • 执行链接转换

Link Checker具有多个配置选项，例如定义验证内部、允许在验证中忽略某些链接或链接模式，以及重写链接重写规则。

链接检查器验证内部链接和外部链接。

NOTE
由于Link Checker会检查每个内容页面的链接，因此Link Checker可能会影响大型存储库的性能。 在这种情况下，您可能需要配置链接检查器运行的频率或禁用它。

内部链接检查 internal

内部链接是指向AEM存储库中其他内容的链接。 可以使用RTE中的路径选择器或使用自定义组件添加内部链接。 例如：

内容作者向页面添加内部链接后，将立即验证内部链接。 如果链接无效：

  • 已从发布器中将其删除。 链接的文本会保留，但链接本身会被删除。
  • 在创作界面中，该链接显示为断开的链接。

创作页面时 内部链接断开

外部链接检查 external

外部链接是指向AEM存储库外部内容的链接。 可以使用RTE或使用自定义组件添加外部链接。 例如：

验证外部链接的语法和检查其可用性。 此检查在可配置的内部异步完成。 如果Link Checker发现外部链接无效：

  • 已从发布器中将其删除。 链接的文本会保留，但链接本身会被删除。
  • 在创作界面中，该链接显示为断开的链接。

创作页面时 内部链接断开

此外，外部链接检查器界面还提供了内容页面上所有外部链接的概述。

要使用外部链接检查器，请执行以下操作：

  1. 使用​ 导航，选择​ 工具，然后选择​ 站点。
  2. 选择​ 外部链接检查器，将显示所有外部链接的列表。

外部链接检查器窗口

将显示以下信息：

  • 状态 — 链接的验证状态，可以是以下状态之一：

    • 有效 — 链接检查器可以访问外部链接
    • 挂起 — 外部链接已添加到站点内容，但尚未通过链接检查器验证
    • 无效 — 链接检查器无法访问外部链接

  • URL — 外部链接

  • 反向链接 — 包含外部链接的内容页面

    • 如果配置，则仅填充。

  • 上次检查时间 — 上次链接检查器验证外部链接的时间

    • 可配置检查链接的频率。

  • 上次状态 — 链接检查上次检查外部链接时返回的上次HTML状态代码

  • 上次可用时间 — 链接检查器上次使用该链接的时间

  • 上次访问时间 — 自上次在创作界面中访问带有外部链接的页面以来的时间

您可以使用链接列表顶部的两个按钮来处理窗口内容：

  • 刷新 — 刷新列表的内容
  • Check — 检查列表中选定的单个外部链接

外部链接检查器的工作方式 how-it-works

尽管易于使用，但External Link Checker依赖于多种服务，了解它们的工作方式有助于您了解如何配置Link Checker以满足您的需求。

  1. 每当内容作者保存指向页面的任何链接时，都会触发事件处理程序。
  2. 事件处理程序遍历/content下的所有内容，检查新链接或更新后的链接，并将它们添加到链接检查器的缓存中。
  3. 然后，Day CQ Link Checker Service ​会定期执行以检查缓存中的条目是否为有效语法。
  4. 经过语法验证的链接随后显示在外部链接检查器窗口中。 但是，它们将处于​ 挂起 ​状态。
  5. 然后，Day CQ Link Checker任务 ​会定期执行，以通过进行GET调用来验证链接。
  6. 天CQ链接检查器任务 ​随后将外部链接检查器窗口中的条目更新为GET调用的结果。

配置链接检查器 configuring

链接检查器在AEM中自动开箱即用。 但是，可以修改几个OSGi配置以更改其行为：

  • 天CQ链接检查器信息存储服务 — 此服务定义存储库中链接检查器缓存的大小。
  • Day CQ Link Checker Service — 此服务对外部链接的语法执行异步检查。 除其他选项外，您还可以定义检查时段以及检查器跳过的链接类型。
  • 天CQ链接检查器任务 — 此服务执行外部链接的GET验证。 它允许单独定义间隔，以检查其他选项中的坏链接和好链接。
  • 天CQ链接检查器转换器 — 允许根据用户定义的规则集转换链接。

有关如何更改OSGi设置的更多详细信息，请参阅文档OSGi配置设置。

禁用链接检查器 disabling

您可以选择完全禁用Link Checker。 为此，请执行以下操作：

  1. 打开OSGi控制台。

  2. 编辑​ 天CQ链接检查器转换器

  3. 选中要禁用的选项：

    • 禁用检查 — 禁用链接验证
    • 禁用重写 — 禁用链接转换
NOTE
如果在开始创建内容后禁用链接检查，则仍可能会在外部链接检查器窗口中看到条目，但不再更新。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2