Configure Assembler
When you configure Assembler, you’re configuring both the assembly process itself and the exporter. The optional Assembler configuration is defined in a file named antora-assembler.yml next to the Antora playbook file by default. An alternate file may be specified when registering the extension.
antora-assembler.yml
The Assembler configuration file is an optional YAML file that defines settings and AsciiDoc attributes that are only applied to exports. By default, the file is named antora-assembler.yml adjacent to your Antora playbook file in the playbook project.
📒 repository 📄 antora-assembler.yml 📄 antora-playbook.yml
You can specify an alternate configuration file using the config_file key when registering the extension.
If Assembler doesn’t find a configuration file at the path specified, or the default path if the config_file
key is not set, Assembler will use the default configuration.
No error is thrown if the configuration file is absent.
Going further
You can switch to programmatic configuration of Assembler if you want even more control over how Assembler works and what navigation it uses.