From fb42d5986b0a69c7629b895e5ca399e9c3442a39 Mon Sep 17 00:00:00 2001
From: Grace Grimwood <ggrimwoo@redhat.com>
Date: Mon, 5 Jan 2026 14:14:46 +1300
Subject: [PATCH 1/3] WIP javadoc changes

Signed-off-by: Grace Grimwood <ggrimwoo@redhat.com>
---
 _layouts/javadoc-wrapper.html | 36 +++++++++++++++++++++++++++++++++++
 _layouts/javadoc.html         |  3 +++
 2 files changed, 39 insertions(+)
 create mode 100644 _layouts/javadoc-wrapper.html
 create mode 100644 _layouts/javadoc.html

diff --git a/_layouts/javadoc-wrapper.html b/_layouts/javadoc-wrapper.html
new file mode 100644
index 0000000..dbd7cf8
--- /dev/null
+++ b/_layouts/javadoc-wrapper.html
@@ -0,0 +1,36 @@
+---
+layout: default
+---
+<div class="container-fluid p-0">
+    <iframe id="javadoc-frame"
+            src="{{ page.raw_path | relative_url }}"
+            style="width: 100%; height: calc(100vh - 60px); border: none;"
+            title="Javadoc Content">
+    </iframe>
+</div>
+
+<script>
+    // This script forces links clicked inside the iframe to
+    // navigate the PARENT window to the correct Jekyll URI.
+    const iframe = document.getElementById('javadoc-frame');
+
+    iframe.onload = function() {
+        const iframeDoc = iframe.contentDocument || iframe.contentWindow.document;
+        const links = iframeDoc.getElementsByTagName('a');
+
+        for (let link of links) {
+            // Only intercept internal relative links
+            if (link.href && link.getAttribute('href').indexOf('http') !== 0) {
+                link.onclick = function(e) {
+                    e.preventDefault();
+                    const href = link.getAttribute('href');
+
+                    // Construct the new URL by removing the '.raw' part of the path
+                    const currentUrl = new URL(window.location.href);
+                    const newUrl = new URL(href, iframe.src);
+                    window.top.location.href = newUrl.href.replace('/{{ RAW_SUBDIR }}/', '/');
+                };
+            }
+        }
+    };
+</script>
\ No newline at end of file
diff --git a/_layouts/javadoc.html b/_layouts/javadoc.html
new file mode 100644
index 0000000..7f63ffd
--- /dev/null
+++ b/_layouts/javadoc.html
@@ -0,0 +1,3 @@
+---
+---
+{{ content }}
\ No newline at end of file

From b589d41cebffe33ab0a9054eda4f0af53dfe69d3 Mon Sep 17 00:00:00 2001
From: Grace Grimwood <ggrimwoo@redhat.com>
Date: Mon, 5 Jan 2026 14:43:27 +1300
Subject: [PATCH 2/3] got the javadoc rendering working finally

Signed-off-by: Grace Grimwood <ggrimwoo@redhat.com>
---
 _layouts/javadoc-wrapper.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_layouts/javadoc-wrapper.html b/_layouts/javadoc-wrapper.html
index dbd7cf8..cdcf9b0 100644
--- a/_layouts/javadoc-wrapper.html
+++ b/_layouts/javadoc-wrapper.html
@@ -28,7 +28,7 @@
                     // Construct the new URL by removing the '.raw' part of the path
                     const currentUrl = new URL(window.location.href);
                     const newUrl = new URL(href, iframe.src);
-                    window.top.location.href = newUrl.href.replace('/{{ RAW_SUBDIR }}/', '/');
+                    window.top.location.href = newUrl.href.replace('/raw/', '/');
                 };
             }
         }

From 6c9ab752278656a52eab97d002bb783c833fc2ff Mon Sep 17 00:00:00 2001
From: Grace Grimwood <ggrimwoo@redhat.com>
Date: Mon, 5 Jan 2026 16:56:07 +1300
Subject: [PATCH 3/3] make the raw file directory a sitewide variable

Signed-off-by: Grace Grimwood <ggrimwoo@redhat.com>
---
 _data/kroxylicious.yml        | 3 ++-
 _layouts/javadoc-wrapper.html | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/_data/kroxylicious.yml b/_data/kroxylicious.yml
index f3533f8..be14a9a 100644
--- a/_data/kroxylicious.yml
+++ b/_data/kroxylicious.yml
@@ -1,3 +1,4 @@
 # The version number of the latest release
 latestRelease: 0.18.0
-
+# The sub-path at which the raw Javadoc files can be found.
+javadocRawSubdir: raw
diff --git a/_layouts/javadoc-wrapper.html b/_layouts/javadoc-wrapper.html
index cdcf9b0..7d2307c 100644
--- a/_layouts/javadoc-wrapper.html
+++ b/_layouts/javadoc-wrapper.html
@@ -28,7 +28,7 @@
                     // Construct the new URL by removing the '.raw' part of the path
                     const currentUrl = new URL(window.location.href);
                     const newUrl = new URL(href, iframe.src);
-                    window.top.location.href = newUrl.href.replace('/raw/', '/');
+                    window.top.location.href = newUrl.href.replace('/{{ site.data.kroxylicious.javadocRawSubdir }}/', '/');
                 };
             }
         }