We had set the cockpit-version attribute from the antora file which is
used by playbooks. This makes the attribute become locked and can't be
modified beforehand (that easily).
Proper usage, for us at least, is to update the cockpit-version through
an extension in cockpit-docs repo instead. This is only really a hack we
have to do due to publishing through tags instead of branches.
Signed-off-by: Freya Gustavsson <freya@venefilyn.se>
Adds Antora configuration so that a dedicated Cockpit Doc repo can
access the various docs in Cockpit as well as an `antora-playbook.yml`
file for local development purposes (without relying on Cockpit Doc).
Partials in manpages were also renamed and restructured as Antora has a
dedicated partial import mechanism to allow for more functionality.
There were a few links in the nav files thar were not valid or pointed
to wrong files. Most of these were just naming mismatches and has been
changed to work with Antora. Nav files themselves also got the section
anchors removed as there is little reason to showcase specific
navigation items - instead section anchors should be used within pages
themselves.
Related-to: https://docs.antora.org/antora/latest/family-directories/
Signed-off-by: Freya Gustavsson <freya@venefilyn.se>