From 7ca330bb10a4e9306380dd1ae3dc3f3d36193e1e Mon Sep 17 00:00:00 2001
From: Sylwester Lachiewicz <slachiewicz@apache.org>
Date: Sat, 8 Aug 2026 22:16:43 +0200
Subject: [PATCH] Add the Publish Site workflow

Calls the shared workflow added in codehaus-plexus/.github#62, so the
site can be published from the Actions tab instead of from a
maintainer's laptop.

Multi-module project, so multi-module: true. That switches the shared
workflow from site-deploy to 'site site:stage scm-publish:publish-scm',
which is required here because the site has to be assembled across the
four modules before it is pushed. The plugin's default content is
target/staging, which is exactly what site:stage produces, so no
further configuration is needed.

Exposes dry-run so the first publish here can be verified without
committing to gh-pages.

Part of codehaus-plexus/.github#58
---
 .github/workflows/site.yml | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 .github/workflows/site.yml

diff --git a/.github/workflows/site.yml b/.github/workflows/site.yml
new file mode 100644
index 000000000..60fb5e0e9
--- /dev/null
+++ b/.github/workflows/site.yml
@@ -0,0 +1,37 @@
+# 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.
+
+name: Publish Site
+
+on:
+  workflow_dispatch:
+    inputs:
+      dry-run:
+        description: 'Build the site and check out gh-pages without committing'
+        required: false
+        default: false
+        type: boolean
+
+permissions:
+  contents: write
+
+jobs:
+  site:
+    uses: codehaus-plexus/.github/.github/workflows/site.yml@master
+    with:
+      multi-module: true
+      dry-run: ${{ inputs.dry-run }}