Add AsciiDoc attribute configuration to playbook schema
Add a new category to the playbook schema named asciidoc
that can be used to pass options and global document attributes (and eventually extensions) to Asciidoctor. It should also be possible to set document attributes using the --attribute
CLI flag, which override attributes with the same name in the playbook file.
The document converter actually supports this configuration already, it's just absent from the playbook schema. However, we may find that we need to change how that information is passed once we're doing it for real.
Done criteria:
-
The playbook schema has a category named asciidoc
-
The site author can define global AsciiDoc document attributes in the playbook file ( asciidoc.attribute
) as a map The site author can define global AsciiDoc document attributes in the playbook file (asciidoc.attribute
) as an Array-
The site author can define global AsciiDoc document attributes (using --attribute
) from the CLI(for now, this would be a string of key/value pairs) The site author can set Asciidoctor options in the playbook file
One open question is whether these attributes should be passed to navigation files too. For now, I think they should, but we may have to revisit in the future.
Edited by Sarah White