document - 如何为不同的模块定义具有相同键的属性？

Question

我想在不同的模块中使用相同的键属性，但值不同。

我在 antora.yml 中定义了属性，但似乎没有办法区分模块。

我应该怎么办？

Answer 1

中的属性定义对于antora.yml包含antora.yml. 无法将这些属性定位到特定模块。但是它们很容易在使用它们的页面中被覆盖。

例如，如果您在 中定义一个属性antora.yml：

asciidoc:
  attributes:
    foo: bar

然后，无论您在组件页面中使用什么，都会在生成的 HTML 中{foo}看到。bar

要在特定页面中覆盖它：

:foo: FOO

当在{foo}同一页面上的任何地方遇到该属性时，在该定义之后，您将FOO在生成的 HTML 中看到。

如果模块中有多个页面需要共享相同的定义，则可以将这些定义放入单独的 Asciidoc 文件中，例如attributes.adoc. 如果将该文件放入模块的partials文件夹中，则可以将其包含在任何需要属性定义的模块页面中：

include::partial$attributes.adoc[]

您不必在 中定义所有属性attributes.adoc，只需为模块定义需要重新定义的属性。