内容源中的Refname匹配

本页涵盖的键接受两种值：

字符串值将被拆分为逗号，最好后跟空格，如果存在的话。例如，字符串v1.0.x, v2.0.x将变成一个包含两个字符串v1.0.x和v2.0.x的数组。

通常最好将字符串值用单引号括起来，以避免值中的字符与YAML（或您选择的配置语言）中的特殊语法发生冲突。

匹配refnames的最简单方法是将它们指定为精确名称。例如，您可以如下匹配名为main的单个分支：

如果您还想为旧版本的发布线添加分支名称，可以用逗号分隔它们：

您还可以将值表示为数组以明确说明：

当我们说“精确匹配”时，我们指的是与引用的shortname匹配。例如，您不是匹配remotes/origin/v1.0.x或heads/v1.0.x，而是v1.0.x。这样做的原因是Antora会查找远程和本地引用，优先选择本地引用，并且每个唯一shortname只选择一个。

虽然看起来精确匹配是一个字面值，但实际上它是一个模式。模式总是从refname的开头匹配到结尾。但是，大多数refnames不包含在模式匹配语法中具有意义的任何字符（甚至不包括.）。因此，它就像一个寻找完全匹配的refname的字面值。但是，如果发现它没有匹配您期望匹配的refname，请记住它实际上是一个模式。

在playbook中维护一系列精确refnames可能会很繁琐和混乱。这就是为什么Antora允许您使用模式匹配来批量匹配refnames。

最基本的模式匹配工具是通配符（*）。使用此模式通常被称为globbing，因为您使用它来捕获一组项目。

您可以使用单个通配符来匹配所有存在的refnames：

但是很少有您会想要这样做。假设，相反，我们想匹配所有以v开头的refnames。我们可以通过在字母后面放置一个星号来实现这一点。

*表示“任意数量的字符”。在这种情况下，它匹配在重命名开头跟随v的任意数量的字符。

您还可以在字符串的两个部分之间使用通配符来匹配两部分之间的任意数量的字符。让我们使用它来更精确地匹配版本号。

此模式将匹配v1.0.x、v2.0.x甚至v20.10.x。但是，只有当refnames本身只包含数字时，它才会匹配数字。这意味着它也可以匹配very.last.x。当我们进入更高级的模式时，我们将能够解决这个问题，但这也带来了过度匹配的问题和排除的需求。

到目前为止，我们已经讨论了我们想要匹配的refnames，或者说是包含。当您开始使用模式时，您可能会遇到匹配太多项的问题。您可以使用一个或多个排除项从先前匹配的项中减去。排除条目始终以!开头。

假设您想匹配所有类似版本的refnames，但要排除在您开始使用Antora之前的版本。

请注意，我们已经将值更改为数组语法，如建议。还有必要将排除项用单引号括起来，以免混淆YAML解析器。如果有疑问，请将字符串值用单引号括起来。这样做永远不会有坏处。

让我们丢弃我们无意中匹配的非版本refname：

您还可以在排除模式中使用通配符来批量匹配您已经匹配的内容并删除这些匹配项。

通配符是一个有用的工具，但它对匹配的字符非常宽松。您可能会发现需要更精确。这就是大括号的用武之地。

大括号，也称为大括号表达式，是用花括号（{}）括起来的模式。Antora支持三种类型的大括号表达式：