Allow value of content.sources playbook key to be overridden using environment variable or CLI
Replace the values assigned to the content.sources
key specified in a playbook using a command line flag (--content-sources
) or an environment variable (ANTORA_CONTENT_SOURCES
).
The flag and variable except YAML data.
$ npx antora --content-sources="[{ url: https://github.com/the-org/my-project.git, tags: 6.0.0, branches: ~ }]" --asciidoc-attribute primary-site-url=https://docs.example.com/service/reference antora-playbook.yml
By default, when content sources are assigned from the CLI or using ANTORA_CONTENT_SOURCES
, any content.sources
entries in the playbook are replaced.
If possible, we'll add the ability to expand the existing entries of content.sources
in the playbook using the syntax ...
or *
and add the values assigned to the CLI flag or environment variable to the playbook entries.
$ npx antora --content-sources="[..., { url: https://github.com/the-org/my-project.git, tags: 6.0.0, branches: ~ }]" antora-playbook.yml
Edited by Dan Allen