自定义 reftext 和 navtitle

目标页面的 reftext 值用作源自页面或资源文件的 xref 中的链接文本。默认情况下，Antora 在运行时将页面的标题分配给 reftext 属性。在示例 1中，让我们引用 install-prerequisites.adoc 文件并将链接文本字段留空。

现在，让我们看一下 install-prerequisites.adoc 文件的头部。

请注意，在示例 2中，页面的头部未设置 reftext。这意味着其标题，安装和测试 Silver Leaf 的先决条件，将在运行时自动分配给 reftext 并在示例 1中用作 xref 的链接文本。

如果您不希望页面的标题用作其默认的 reftext，请使用属性条目为属性分配自定义值。在示例 3中，显示了将 reftext 属性分配为自定义值。

生成站点时，reftext 的值，安装 Silver Leaf 的先决条件，将用作示例 1中 xref 的链接文本。它还将用作页面的 navtitle 值。

目标页面的 navtitle 值用作源自导航文件的 xref 中的链接文本。默认情况下，Antora 将页面的 reftext 属性的值分配给 navtitle。一个页面的 reftext通常会自动分配页面的标题。

在示例 4中，让我们从导航文件引用 get-started.adoc 文件，并将链接文本字段留空。

现在，让我们看一下 get-started.adoc 文件的头部在示例 5中。

请注意，其头部既未设置 reftext 也未设置 navtitle。这意味着页面的标题，开始使用 Silver Leaf，将自动分配给 reftext，因此也分配给 navtitle，并用于填充导航文件中 xref 的链接文本。

如果您不希望页面的默认或自定义 reftext 值被分配为默认的 navtitle，请使用属性条目为属性分配自定义值。在示例 6中，显示了将 navtitle 属性分配为自定义值。

生成站点时，navtitle 的值，开始，将填充导航文件中的 xref 链接文本。