You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

32 lines
1.3 KiB

4 years ago
////
Included in:
- user-manual: Static website generators: Configuring attributes for Awestruct
////
Awestruct defines a set of default attributes that it passes to the API in its [.path]_/default-site.yml_ file.
One of the attributes in that configuration is `imagesdir`.
The value there is set to [.path]_/images_.
That means the value in your document is skipped due to the precedence rules.
Fortunately, there is one additional place you can override the attribute.
This gives you the opportunity to set your own default and to flip the precedence order so that the document wins out.
If an attribute value that is passed to the API ends with an `@` symbol, it makes that assignment have a lower precedence than an assignment in the document.
You can define attributes you want to pass to the API in the [.path]__config/site.yml_ file.
Here's an example entry for Asciidoctor:
```yaml
asciidoctor:
:safe: safe
:attributes:
imagesdir: /assets/images@
icons: font
...
```
NOTE: The second-level keys (safe and attributes, in this case) must have colons on both sides of the key name.
The rest of the keys only have a colon after the key.
With this configuration added, you should observe that the `imagesdir` attribute in your document is now respected.