(v2.5.x) Deprecate 'headerFooter' in favour of 'standalone'

[abelsromero]

Kind of change

• [ ] Bug fix
• [x] New non-breaking feature
• [ ] New breaking feature
• [X] Documentation update
• [ ] Build improvement

Description

What is the goal of this pull request?

Deprecate 'headerFooter' in favour of 'standalone'

• Replace headerFooter methods in OptionsBuild & Options
• Added 'standalone' description to docs Other changes included:
• Re-ordered options in docs to follow alphabetical order
• Remove some unnecessary throws from tests
• Add missing '@deprecated' to templateDir method

Related to https://github.com/asciidoctor/asciidoctorj/pull/1161

How does it achieve that?

Simply add new method and change the use of the header_footer option in the internal map by standalone. The old option is still accepted in the map, hence the check in AsciidoctorUtils.

Are there any alternative ways to implement this?

No

Are there any implications of this pull request? Anything a user must know?

No, no breaking change introduced.

Issue

If this PR fixes an open issue, please add a line of the form:

Fixes #1160

Release notes

Please add a corresponding entry to the file CHANGELOG.adoc

[abelsromero]

Any idea why CI is not running for this branch? :thinking: It's set in the config

[robertpanzer]

I have no idea as well unfortunately. I wanted to spend some more time digging into this, but recently I barely find any time. Do you have any idea?

[abelsromero]

I have no idea as well unfortunately. I wanted to spend some more time digging into this, but recently I barely find any time. Do you have any idea?

Nop, but should be easy 🤞 I'll check in my fork later.

[robertpanzer]

Thank you!