Convert python scripts to asciidoctor extensions

[philipwindecker]

The scripts currently used to realize the custom ASAM macros shall be converted into Asciidoctor extensions. However, it must be decided first if Antora-only features are required and, therefore, the extensions must rather be Antora extensions instead.

Since no cross-branch interaction seems to be required (and, in fact, may even be problematic), it looks like a direct Asciidoctor extension is most suitable. This would also have the added benefit of working in standardization projects without Antora as well.

List of functions:

• Create list of pages in each Antora component and version with specific attributes
• Create list of pages in each Antora component and version with specific macros
• Automatically create nav.adoc
• Create tree of pages in a folder, excluding the file where the macro is
• Replace macros with list of links
• Replace macros with attribute (effectively a link and a class)
• Create a page with all use keywords within a component/version
• Create a diagram for a component/version
• Find all pages without links to them (within a module/version)
• Find all pages without links from them (within a module/version)
• Identify links between pages (within a module/version)
• Find all unused pages/partials/images/attachments/... in any module folder

Requirements:

• Each macro creating links shall only link to pages within the same component and version
• Macros shall be replaced after pages/partials have been included
• Overviews shall be created after pages/partials have been included
• Macros shall only be replaced once their respective overview is ready
• Each overview/macro combination may be executed independently or in one bulk operation
• Macros shall take arguments and/or attributes

[philipwindecker]

Antora extensions have been developed in separate repo and will be added to the project shortly.

Features implemented:

• support for related macro
• support for reference macro
• support for pages macro
• support for role-related macro
• added macro for creating nav.adoc
• support for keyword page creation

[philipwindecker]

Open point: tools.adoc in compendium is not created correctly and other topics are then sorted under wrong page.