使用页面别名设置URL重定向

页面别名旨在解决页面重命名或移动问题，特别是在组件版本内。它们不是通用的URL路由器。虽然它们可以用于在组件或组件版本之间创建重定向，但您需要谨慎使用此功能，否则可能会变得非常混乱。

如果您删除大量页面，例如删除或重命名组件或组件版本，并且希望保留现有的URL，则不应尝试使用页面别名。页面别名不是为提供批量URL重定向而设计的。相反，我们强烈建议您在删除或重命名组件或组件版本时使用您的Web服务器或主机提供的路由器。您可以在发布过程中使用单独的步骤，或者使用Antora扩展来实现。

page-aliases属性设置在目标页面的页面头部中，使用一个属性条目。 目标页面指的是您要将源页面重定向到的页面。 源页面指的是您要从中重定向的已删除、重命名或移动的页面（即要声明的页面）。在目标页面中，将源页面的资源ID（在删除、重命名或移动之前的资源ID）分配给page-aliases属性。可以在属性中以逗号分隔的列表形式分配多个资源ID。

您可以使用行继续（在行末加上一个空格和反斜杠）将此列表拆分成多行：

Antora会计算源页面资源ID的URL，并生成重定向信息，使源页面URL重定向到目标页面URL。未在分配给page-aliases的资源ID中指定的任何坐标，例如版本或组件，将从目标页面的坐标中插值。重定向信息的生成输出格式由您选择的重定向设施确定。

分配给page-aliases属性的资源ID可以在xref中使用。因此，如果您删除、重命名或移动页面，您无需在源文件中更新任何对它的引用。

如果您将源页面的文件名从old-name.adoc更改为new-name.adoc，请在其头部将文件的先前资源ID分配给page-aliases。

这将导致https://base-url.com/component/version/module/old-name.html被重定向到https://base-url.com/component/version/module/new-name.html。未在old-name.adoc资源ID中指定的版本、组件和模块坐标将从目标页面的坐标中插值。或者，如果您在playbook中的html-extension-style键上分配了indexify，https://base-url.com/component/version/module/old-name/将重定向到https://base-url.com/component/version/module/new-name/。

当页面从一个模块移动到同一组件中的另一个模块时，别名的资源ID需要包含源页面的先前模块坐标。在示例4中，页面source-1.adoc已从module-1移动到module-z。 module-1和module-z都是component-1版本5.0中的模块。

现在，Antora将重定向URLhttps://base-url.com/component-1/5.0/module-1/source-1.html到URLhttps://base-url.com/component-1/5.0/module-z/source-1.html。

当页面从一个组件移动到另一个组件时，请将源页面的完全限定的先前资源ID分配给page-aliases。在示例5中，页面source-w.adoc已从component-8版本1.4的module-u移动到component-delta版本3.0的ROOT。

这将导致URLhttps://base-url.com/component-8/1.4/module-u/source-w.html被重定向到https://base-url.com/component-delta/3.0/source-w.html。

有时您只需删除一个页面。在将已删除页面的URL重定向到另一个页面之前，请考虑以下事项：

不应将重定向创建到与已删除页面没有太多共同点的目标页面，因为这通常会让访问者感到沮丧。

如果将已删除页面的URL重定向到另一个页面是合适的，请将已删除页面的ID分配给page-aliases属性，并确保指定必要的坐标。