[Docs] Generate kamelets pages using Antora (main)

README.md

@@ -31,7 +31,7 @@ $ go run . ../../kamelets/ ../../docs/modules/ROOT/
 and validate:
 ```bash
 $ cd script/validator
-$ go run go run . ../../kamelets/
+$ go run . ../../kamelets/
 ```
 be sure that there aren't reported ERRORS.
 

docs/README_local_build.adoc

@@ -0,0 +1,31 @@
+= Local/partial build of docs
+
+This should be explained soon at https://camel.apache.org/manual/improving-the-documentation.html.
+
+* (once, or occasionally)
+. In `../..` (next to this project's clone) run
+[source,sh]
+----
+git clone https://github.com/apache/camel-website.git
+----
+. In `../../camel-website/antora-ui-camel` run
+[source,sh]
+----
+yarn build
+----
+. In this directory run
+[source,sh]
+----
+./local-build.sh full
+----
+This will build the full Antora site on your machine in the camel-website project under /documentation, with any local changes you have made in this project.
+It will also do a full xref check for the entire site.
+* Thereafter
+. In this directory run
+[source,sh]
+----
+./local-build.sh
+----
+
+This will build just this project, with local changes, into the full build from the previous step.
+It will start a local webserver for the build site, rebuild when changes are detected, and sync your browser to the changes.

docs/antora.yml

@@ -24,7 +24,10 @@ display-version: Next (Pre-release)
 nav:
 - modules/ROOT/nav.adoc
 
-# Update to appropriate released camel-k version on release
 asciidoc:
   attributes:
+    requires: "'util=camel-website-util,kamelets=xref:js/kamelets.js'"
+    # Update to appropriate released camel-k version on release
     camel-k-version: next
+    jsonpath-trace: true
+    jsonpath-debug: true

docs/indexPages.yml

@@ -0,0 +1,33 @@
+indexPages:
+  - query:
+      module: ROOT
+      family: example
+      relative: yaml/*
+    requires: 'kamelets=xref:js/kamelets.js'
+    content-as: json
+    template-id:
+      family: example
+      relative: template/kamelet-options.adoc
+    extract:
+      - path: 'src.relative'
+        match: 'yaml/(?<basename>*).kamelet.yaml'
+    target:
+      match: 'yaml/(?<basename>*).kamelet.yaml'
+      format: '`${basename}.adoc`'
+
+  - query:
+      module: ROOT
+      family: example
+      relative: yaml/*
+    requires: 'kamelets=xref:js/kamelets.js'
+    content-as: json
+    template-id:
+      family: example
+      relative: template/kamelet-icon.svg
+    extract:
+      - path: 'src.relative'
+        match: 'yaml/(?<basename>*).kamelet.yaml'
+    target:
+      family: image
+      match: 'yaml/(?<basename>*).kamelet.yaml'
+      format: '`kamelets/${basename}.svg`'

docs/local-build.sh

@@ -0,0 +1,37 @@
+#!/bin/sh
+
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+CW=./../../camel-website
+LOCAL=./../camel-kamelets
+
+cd $CW || (echo 'camel-website not in expected location $CW' && exit)
+cp antora-playbook.yml local-antora-playbook-full.yml
+cat $LOCAL/docs/source-map.yml >> local-antora-playbook-full.yml
+cat playbook-patch-full.yml >> local-antora-playbook-full.yml
+
+cp antora-playbook.yml local-antora-playbook-partial.yml
+cat $LOCAL/docs/source-map.yml >> local-antora-playbook-partial.yml
+cat $LOCAL/docs/source-watch.yml >> local-antora-playbook-partial.yml
+
+if [ "$1" = "full" ] || [ "$1" = "1" ]
+then
+  yarn build:antora-local-full
+else
+  yarn build:antora-local-partial
+fi