CAMEL-22861 - Auto-generated Jbang commands documentation: Add suppor…

[oscerd]

…t for adding examples

Description

Add examples support for auto-generated JBang command docs

Adds support for including examples in auto-generated JBang command documentation via separate AsciiDoc files.

The workflow is as follows:

• Create an examples file at docs/user-manual/modules/ROOT/pages/jbang-commands/examples/{command}.adoc
• The generator automatically detects and includes it in the generated command page
• File naming: run.adoc for camel run, catalog-component.adoc for camel catalog component

Target

• I checked that the commit is targeting the correct branch (Camel 4 uses the main branch)

Tracking

• If this is a large change, bug fix, or code improvement, I checked there is a JIRA issue filed for the change (usually before you start working on it).

Apache Camel coding standards and style

• I checked that each commit in the pull request has a meaningful subject line and body.

• I have run mvn clean install -DskipTests locally from root folder and I have committed all auto-generated changes.

[oscerd]

This is for a first review, but I need to understand the reason for new line in asciidoc