多个起始路径

start_path键只允许您在播放书中为给定内容源指定单个路径。相比之下，start_paths键允许您指定多个路径。这些多个路径甚至可以进一步使用通配符、排除、大括号、交替、范围和重复模式进行合并。Antora将模式解析为一个或多个固定路径。

start_paths键与start_path键是互斥的。如果内容源上同时存在start_path和start_paths键，则只使用start_paths键。

与单一起始路径一样，起始路径会按git引用（即分支、标签和工作树）进行搜索。这意味着每个引用的每个起始路径都必须找到一个组件版本描述符。

通常，在使用多个起始路径时，您可能只会使用单个引用（例如main）。如果在此场景中使用多个引用，假设是每个引用共享相同的布局。

您可以使用start_paths将组件的所有版本存储在单个存储库分支中，而不是使用多个分支。尽管您可能会错过版本控制系统的一些优势，但这种安排可以使频繁更新多个版本文档的撰写人员更容易。

在这种情况下，您将为branches键提供单个值，并使用start_paths键告诉Antora在分支中使用哪些目录作为内容根。如果版本文件夹的命名方式一致，那么使用模式进行匹配就变得容易。

以下是一个使用文件夹存储文档版本的存储库布局示例：

您可以进一步将所有组件存储在单个存储库分支中，而不是使用多个存储库。如果这些组件有版本，您可能会使用子文件夹来存储版本。如果所有文档由同一团队或个人维护，并且git的分布性成为障碍，那么这种安排效果最佳。这也可能用于单体存储库，其中多个产品的源代码存储在同一个存储库中。Antora可以在该结构中的任何位置发现文档。

在这种情况下，您再次为branches键提供单个值，并使用start_paths键告诉Antora在分支中使用哪些目录作为内容根。只是这一次，内容源根将匹配不同的组件（可能还包括版本），而不仅仅是单个组件的版本。

以下是一个使用文件夹存储组件的存储库布局示例：

当然，存储库可能还有许多与文档无关的其他文件和文件夹。

以下限制适用于Antora如何根据支持的基本和高级通配规则实现路径通配：

通配符匹配可减少您需要分配给start_paths键的值的数量。例如，如果您在一个分支中存储多个组件，您可以将它们全部列在一个逗号分隔的列表中，如示例2中所示。

或者，如示例3所示，您可以使用通配符段并减少您需要声明的值的数量。

通配符匹配提供了在添加新内容源根时注册的可能性，只要保持模式一致即可。

大括号表达式可以指定由逗号分隔的项目的显式列表以扩展（docs/product-{a,b,c,f}）或要扩展的项目范围（docs/product-{a..f}）。大括号表达式不能仅包含一个项目，即使该项目包含通配符（例如，docs/product-{a}和docs/product-{a*}都不是大括号表达式）。

大括号表达式可以嵌套（例如，docs-*/v{{1..9},{1..9}{0..9}匹配名称为docs-*的根文件夹中的v1到v99子文件夹）。在这种情况下，将测试每个嵌套大括号表达式的每个排列。

当您在start_paths值中使用大括号时，扩展时大括号内的所有条目必须存在（除非该段前面有通配符段）。

如果您将docs/product-{a,b}指定为start_paths值，则存储库中必须存在以下路径：

您可以在大括号表达式之前的文件路径中使用前缀，以简化Antora在表达式中检查的内容。

您还可以在大括号表达式中使用通配符来帮助扩展值。

示例5中的start_paths模式将匹配以下路径：

使用否定模式来排除先前匹配的模式。如果您想匹配除了符合特定模式的所有目录之外的所有目录，则此方法很有用。