From 77abbca55c037901278d15d3e32b67b118232a35 Mon Sep 17 00:00:00 2001
From: Manuel Polo <mrmx@users.noreply.github.com>
Date: Thu, 22 Oct 2026 22:38:34 +0000
Subject: [PATCH] ci: replace the Pages site with a redirect to the reference
 documentation on qtsurfer.com

The reference documentation of this project is published on www.qtsurfer.com
under /reference. The GitHub Pages site of this repository now only redirects
there, keeping the page path, the query and the fragment, so the links already
published in package metadata and release notes keep working.

The pages to serve are in pages-redirect/ and a new workflow deploys them when
they change. The release no longer builds the documentation for Pages: the
archive of the documentation attached to each release, which the website
publishes, is unchanged.
---
 .github/workflows/ci.yml             | 29 ----------------------
 .github/workflows/pages-redirect.yml | 36 ++++++++++++++++++++++++++++
 pages-redirect/404.html              | 26 ++++++++++++++++++++
 pages-redirect/index.html            | 26 ++++++++++++++++++++
 4 files changed, 88 insertions(+), 29 deletions(-)
 create mode 100644 .github/workflows/pages-redirect.yml
 create mode 100644 pages-redirect/404.html
 create mode 100644 pages-redirect/index.html

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 1b2d306..d1bf515 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -87,32 +87,3 @@ jobs:
     uses: ./.github/workflows/reference-docs.yml
     with:
       tag: ${{ github.ref_name }}
-
-  docs:
-    needs: unit
-    runs-on: ubuntu-latest
-    # Only tagged versions get published, so the site always describes a release
-    # rather than whatever main happens to be.
-    if: startsWith(github.ref, 'refs/tags/')
-    permissions:
-      contents: read
-      pages: write
-      id-token: write
-    environment:
-      name: github-pages
-      url: ${{ steps.deploy.outputs.page_url }}
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-java@v4
-        with:
-          java-version: '17'
-          distribution: 'temurin'
-          cache: 'maven'
-      - name: Generate javadoc
-        run: mvn -B javadoc:javadoc
-      - uses: actions/configure-pages@v5
-      - uses: actions/upload-pages-artifact@v3
-        with:
-          path: target/site/apidocs
-      - id: deploy
-        uses: actions/deploy-pages@v4
diff --git a/.github/workflows/pages-redirect.yml b/.github/workflows/pages-redirect.yml
new file mode 100644
index 0000000..1321d0e
--- /dev/null
+++ b/.github/workflows/pages-redirect.yml
@@ -0,0 +1,36 @@
+name: Pages redirect
+
+# The reference documentation of this project is published on www.qtsurfer.com. The GitHub Pages site of
+# this repository only redirects there, so that the links already published in package metadata and
+# release notes keep working. The pages to serve are in pages-redirect/.
+on:
+  push:
+    branches: [main]
+    paths:
+      - pages-redirect/**
+      - .github/workflows/pages-redirect.yml
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: pages-redirect
+      - id: deploy
+        uses: actions/deploy-pages@v4
diff --git a/pages-redirect/404.html b/pages-redirect/404.html
new file mode 100644
index 0000000..af87533
--- /dev/null
+++ b/pages-redirect/404.html
@@ -0,0 +1,26 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="robots" content="noindex">
+<title>QTSurfer reference documentation has moved</title>
+<link rel="canonical" href="https://www.qtsurfer.com/reference/sdk-java/latest/">
+<noscript><meta http-equiv="refresh" content="0; url=https://www.qtsurfer.com/reference/sdk-java/latest/"></noscript>
+<script>
+(function () {
+  var base = "https://www.qtsurfer.com/reference/sdk-java/latest/";
+  var prefix = "/sdk-java/";
+  var path = location.pathname;
+  var rest = path.indexOf(prefix) === 0 ? path.slice(prefix.length) : "";
+  rest = rest.replace(/^\/+/, "");
+  location.replace(base + rest + location.search + location.hash);
+})();
+</script>
+<style>body{font:16px/1.5 system-ui,sans-serif;margin:2rem auto;max-width:36rem;padding:0 1rem}</style>
+</head>
+<body>
+<p>The reference documentation of <code>sdk-java</code> now lives at
+<a href="https://www.qtsurfer.com/reference/sdk-java/latest/">www.qtsurfer.com/reference/sdk-java/latest/</a>.</p>
+</body>
+</html>
diff --git a/pages-redirect/index.html b/pages-redirect/index.html
new file mode 100644
index 0000000..af87533
--- /dev/null
+++ b/pages-redirect/index.html
@@ -0,0 +1,26 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="robots" content="noindex">
+<title>QTSurfer reference documentation has moved</title>
+<link rel="canonical" href="https://www.qtsurfer.com/reference/sdk-java/latest/">
+<noscript><meta http-equiv="refresh" content="0; url=https://www.qtsurfer.com/reference/sdk-java/latest/"></noscript>
+<script>
+(function () {
+  var base = "https://www.qtsurfer.com/reference/sdk-java/latest/";
+  var prefix = "/sdk-java/";
+  var path = location.pathname;
+  var rest = path.indexOf(prefix) === 0 ? path.slice(prefix.length) : "";
+  rest = rest.replace(/^\/+/, "");
+  location.replace(base + rest + location.search + location.hash);
+})();
+</script>
+<style>body{font:16px/1.5 system-ui,sans-serif;margin:2rem auto;max-width:36rem;padding:0 1rem}</style>
+</head>
+<body>
+<p>The reference documentation of <code>sdk-java</code> now lives at
+<a href="https://www.qtsurfer.com/reference/sdk-java/latest/">www.qtsurfer.com/reference/sdk-java/latest/</a>.</p>
+</body>
+</html>