页面链接文本

使用目标页面的默认链接文本

当 xref 没有指定任何链接文本时，Antora 使用目标页面的 reftext 值作为链接文本。让我们为资源id创建一个 xref 。在 Antora 自己的文档中的引用 resource-id.adoc 页面。

See xref:resource-id.adoc[].

注意，xref 没有指定任何链接文本。在下面的示例输出中可以看到，Antora 使用目标页面的标题自动填充链接文本。

如果单击链接，您将看到可单击的文本和目标页面的标题是相同的。默认情况下，页面标题被分配给内置的 AsciiDoc reftext 属性。您还可以为 reftext 属性分配一个自定义值。

CAUTION

当目标页面的资源ID附加了 片段 （深度链接）并且在方括号之间未指定链接文本，例如 xref:page.adoc#fragment[] 时，链接文本不会自动填充。当使用片段时，您需要在 xref 宏中指定链接文本。

TIP

导航文件中的 xref 的行为与此相同，但有一个额外的特性。导航文件使用 navtitle 值 填充缺失的链接文本。如果没有设置 navtitle ，那么它们使用页面的 reftext 值。