Fix Vulkan-Site repository reference and filter build errors (Khronos…

…Group#1222)

* Fix Vulkan-Site repository reference and filter build errors

Updated the workflow to reference the KhronosGroup/Vulkan-Site repository. Also improved the build script to filter out known missing document errors, preventing unnecessary build failures. This ensures a smoother build process and correct error reporting.

* revert this part of the change for now.  Will need to investigate what needs to happen to allow this to not point to my repo.

* Fix syntax error in Antora build script

Correct missing space around the assignment operator in the Antora build workflow. This ensures the build output is correctly captured and processed.

* Assume that KhronosGroup#1221 will be accepted before this one.

* enforce the log-format of JSON.

* Improve error filtering in Antora build workflow

Replaced 'jq' with 'grep' and 'jq -R' for better JSON handling. Updated filter conditions to exclude specific error messages from the Antora build output.

* Update build workflow to filter out JSON output

This change adds a `-r` option to the `jq` command in the Antora build workflow. The `-r` flag ensures the JSON output is properly processed, improving clarity and function of JSON filtering.

* Update Antora build log level to error and format output

Changed Antora build command to use `--log-level=error` for cleaner logs. Enhanced JSON output handling with `pino-pretty` for more readable error messages. This should help in better identifying and troubleshooting errors in the build process.

* Refine logging in build-Antora-doc workflow

Removed unnecessary JSON formatting step with pino-pretty in the Antora documentation build workflow. This change simplifies the log output by directly parsing it with jq.

* Enhance log readability with pino-pretty

Replace `jq -r .` with `jq -r | npx pino-pretty` to format JSON logs for better readability. This change helps in diagnosing issues by making log outputs more user-friendly and easier to interpret.

* Remove unnecessary pino-pretty from JSON processing

The pino-pretty step was removed from the JSON processing pipeline in the GitHub workflow `build-Antora-doc.yml`. This change simplifies the workflow and ensures that the JSON output is handled as raw data.

* Fix syntax error in Jenkins JSON processing

Corrected the JSON processing command in the Jenkins build workflow by adding a period after jq -r. This ensures the command runs without syntax errors and filters log messages as intended.

* Simplify Antora log filtering in build workflow

Removed redundant flag '-r' from the jq command in the Antora log filtering process. This change streamlines the command sequence, making it easier to read and maintain without altering its functionality.

* try it without the raw input?

* Update jq syntax for better error filtering

Modified the jq syntax in the Antora build workflow to correct the usage of string contains function. This ensures more accurate filtering of specific document not found errors while running the Antora build process.

* Suppress grep errors in build-Antora-doc.yml

Redirect stderr to /dev/null in the grep command to suppress error messages. This ensures cleaner log outputs by preventing grep-related errors from being displayed.

* Fix syntax error in jq filter statements

Corrected the jq filter syntax to properly handle and parse Antora log messages, ensuring the message keys are correctly referenced within the select function. This prevents missing guide and tutorial documents from being incorrectly reported.

* try raw output

* Refine Antora log processing in CI workflow

Removed irrelevant fields from Antora log output and streamlined error filtering. This enhances the clarity of log messages, making it easier to diagnose issues.

* opps

* Improve Antora workflow log filtering

Refactor the jq command to enhance readability and maintainability. The changes ensure all log entries containing specific 'not found' messages are excluded efficiently.

* Fix missing closing parenthesis in jq command

The jq command was missing a closing parenthesis leading to potential syntax errors. This fix ensures proper filtering of error messages related to missing documentation files.

.github/workflows/build-Antora-doc.yml

@@ -80,11 +80,24 @@ jobs:
       - name: "prepare samples"
         run: cmake -H"." -B"build/unix" -DVKB_GENERATE_ANTORA_SITE=ON
 
-      - name: "build (npx) with stacktrmainace"
+      - name: "build (npx) with stacktrace"
         working-directory: ./Vulkan-Site/docs-site
         run: |
-          npx antora --log-failure-level=error antora-parent-ci-playbook.yml --stacktrace
-          touch build/site/.nojekyll
+          output="$(npx antora --log-level=error --log-format=json antora-parent-ci-playbook.yml --stacktrace | \
+            grep -Pzo '\{(?>[^\{\}]|(?R))*\}' 2>/dev/null | \
+            jq 'del(."time",."file",."source",."name")' | \
+            jq 'select(."msg" | contains(" not found: guide:ROOT:INDEX.adoc")| not)' | \
+            jq 'select(."msg" | contains(" not found: guide:ROOT:index.adoc") | not)' | \
+            jq 'select(."msg" | contains(" not found: tutorial:ROOT:00_Introduction.adoc") | not)' | \
+            jq 'select(."msg" | contains(" not found: guide::hlsl.adoc") | not)' | \
+            jq 'select(."msg" | contains(" not found: guide::high_level_shader_language_comparison.adoc") | not)' \
+          )"
+          if [[ -n $output ]]
+          then
+            printf -- "%s\n" "$output"
+            exit 1
+          fi
+#          touch build/site/.nojekyll
 
 # Deployment job
   # deploy: