blob: 07762af37619d990f876217595b8b2a518a8756b (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
= Extends Category Key
:description: Reference list of the extends category key and its value types.
:navtitle: Extends
:source-language: yaml
A theme can extend another theme using the `extends` key.
The `extends` key should always be the first key in the theme file.
The key accepts either a single value or an array of values.
Each value is interpreted as a filename with an implicit `-theme.yml` suffix if not already present.
If the value is `default`, it resolves to the filename of the default (built-in) theme.
If the value is an absolute path, it's used as is.
If the value begins with `./`, it's always resolved to a theme file relative to the current theme file.
Otherwise, the filename is resolved relative to the value of the `pdf-themesdir` attribute.
Currently, the theme starts out empty.
Then, the files referenced by the extends key are loaded in order.
Finally, the keys in the current file are loaded.
Each time a theme is loaded, the flattened keys are overlaid onto the keys from the previous theme.
[cols="4,4,6a"]
|===
|Key |Value Type |Example
|extends
|String or Array +
(default: `[]`)
|[source]
extends:
- default
- ./brand-theme.yml
|===
|
