Chapter 27. Document Attributes

A document attribute is comprised of a name and a textual value and is used for textual substitution in AsciiDoc documents and configuration files. An attribute reference (an attribute name enclosed in braces) is replaced by the corresponding attribute value. Attribute names are case insensitive and can only contain alphanumeric, dash and underscore characters.

There are four sources of document attributes (from highest to lowest precedence):

Command-line attributes.
AttributeEntry, AttributeList, Macro and BlockId elements.
Configuration file [attributes] sections.
Intrinsic attributes.

Within each of these divisions the last processed entry takes precedence.


	If an attribute is not defined then the line containing the attribute reference is dropped. This property is used extensively in AsciiDoc configuration files to facilitate conditional markup generation.