On this page, you’ll learn:
The purpose of an Antora playbook.
The playbook file formats Antora accepts.
Where the playbook file is located.
A playbook is the configuration object for Antora. It tells an Antora pipeline what content to use, how the content should be processed, how the site should be generated, and where to publish the output. The playbook is populated using a combination of a playbook file, CLI options, and environment variables.
Playbooks can be written in YAML, JSON, and CSON.
YAML is a common configuration language for defining automated tasks. Most of the playbook examples in this documentation use YAML since it is less verbose than JSON and CSON.
Regardless of the format, a playbook contains structured key sets for specifying general site properties, content and UI input sources, and published output destinations and providers.
A playbook is usually located at the root of a playbook project.