Awestruct 定义了一组默认属性,它会通过 /default-site.yml 文件传递给 API。其中一个属性是 imagesdir。那里的值被设置为 /images。这意味着由于优先级规则,你的文档中的值会被跳过。

幸运的是,还有一个额外的地方可以覆盖属性。这为您提供了设置自己的默认值的机会,并且可以改变优先级顺序,使文档获得更高的优先权。如果通过API传入的属性值以`@`符号结尾,它会使得该赋值的优先级低于文档中的赋值。

您可以在[.path]__config/site.yml_文件中定义要传递给API的属性。以下是Asciidoctor的一个示例条目:

yaml asciidoctor: :safe: safe :attributes: imagesdir: /assets/images@ icons: font …​

NOTE: 第二级键(在这个例子中是safe和attributes)必须在键名的两侧都有冒号。其余的键只在键后有一个冒号。

在添加了这个配置之后,你应该会观察到文档中的`imagesdir`属性现在得到了遵循。