链接检查器 the-link-checker
内容作者无需自行验证他们包含在内容页面中的每个链接。
Link Checker会自动运行以帮助内容作者使用其链接,包括:
- 在链接添加到内容时对其进行验证
- 显示内容中所有外部链接的列表
- 执行链接转换
Link Checker具有多个配置选项,例如定义验证内部、允许在验证中忽略某些链接或链接模式,以及重写链接重写规则。
内部链接检查 internal
内部链接是指向AEM存储库中其他内容的链接。 可以使用RTE中的路径选择器或使用自定义组件添加内部链接。 例如:
- 您的页面
/content/wknd/us/en/adventures/ski-touring.html
- 在文本组件中包含指向
/content/wknd/us/en/adventures/extreme-ironing.html
的链接。
内容作者向页面添加内部链接后,将立即验证内部链接。 如果链接无效:
- 已从发布器中将其删除。 链接的文本会保留,但链接本身会被删除。
- 在创作界面中,该链接显示为断开的链接。
创作页面时
外部链接检查 external
外部链接是指向AEM存储库外部内容的链接。 可以使用RTE或使用自定义组件添加外部链接。 例如:
- 您的页面
/content/wknd/us/en/adventures/ski-touring.html
- 在文本组件中包含指向
https://bunwarmerthermalunderwear.com
的链接。
验证外部链接的语法和检查其可用性。 此检查在可配置的内部异步完成。 如果Link Checker发现外部链接无效:
- 已从发布器中将其删除。 链接的文本会保留,但链接本身会被删除。
- 在创作界面中,该链接显示为断开的链接。
创作页面时
此外,外部链接检查器界面还提供了内容页面上所有外部链接的概述。
使用外部链接检查器 external-link-checker
要使用外部链接检查器,请执行以下操作:
- 使用 导航,选择 工具,然后选择 站点。
- 选择 外部链接检查器,将显示所有外部链接的列表。
将显示以下信息:
您可以使用链接列表顶部的两个按钮来处理窗口内容:
- 刷新 — 刷新列表的内容
- Check — 检查列表中选定的单个外部链接
外部链接检查器的工作方式 how-it-works
尽管易于使用,但External Link Checker依赖于多种服务,了解它们的工作方式有助于您了解如何配置Link Checker以满足您的需求。
- 每当内容作者保存指向页面的任何链接时,都会触发事件处理程序。
- 事件处理程序遍历
/content
下的所有内容,检查新链接或更新后的链接,并将它们添加到链接检查器的缓存中。 - 然后,Day CQ Link Checker Service 会定期执行以检查缓存中的条目是否为有效语法。
- 经过语法验证的链接随后显示在外部链接检查器窗口中。 但是,它们将处于 挂起 状态。
- 然后,Day CQ Link Checker任务 会定期执行,以通过进行GET调用来验证链接。
- 天CQ链接检查器任务 随后将外部链接检查器窗口中的条目更新为GET调用的结果。
配置链接检查器 configuring
链接检查器在AEM中自动开箱即用。 但是,可以修改几个OSGi配置以更改其行为:
- 天CQ链接检查器信息存储服务 — 此服务定义存储库中链接检查器缓存的大小。
- Day CQ Link Checker Service — 此服务对外部链接的语法执行异步检查。 除其他选项外,您还可以定义检查时段以及检查器跳过的链接类型。
- 天CQ链接检查器任务 — 此服务执行外部链接的GET验证。 它允许单独定义间隔,以检查其他选项中的坏链接和好链接。
- 天CQ链接检查器转换器 — 允许根据用户定义的规则集转换链接。
有关如何更改OSGi设置的更多详细信息,请参阅文档OSGi配置设置。
禁用链接检查器 disabling
您可以选择完全禁用Link Checker。 为此,请执行以下操作:
-
打开OSGi控制台。
-
编辑 天CQ链接检查器转换器
-
选中要禁用的选项:
- 禁用检查 — 禁用链接验证
- 禁用重写 — 禁用链接转换