From 27a4da80c7e603e2c06cb1062196d5502880d962 Mon Sep 17 00:00:00 2001
From: Slawomir Jaranowski <s.jaranowski@gmail.com>
Date: Tue, 11 Nov 2025 11:18:10 +0100
Subject: [PATCH] Render a GitHub ribbon on all sites

reference:
 - #494
 - #495
---
 docs/pom.xml                    |  2 ++
 docs/src/site/apt/index.apt.vm  |  9 +++++++++
 maven-plugins/src/site/site.xml | 10 ----------
 pom.xml                         |  2 ++
 src/site/site.xml               |  5 +++++
 5 files changed, 18 insertions(+), 10 deletions(-)
diff --git a/docs/pom.xml b/docs/pom.xml
index 6e63f8e7..7e75ba5b 100644
--- a/docs/pom.xml
+++ b/docs/pom.xml
@@ -66,6 +66,8 @@ under the License.
     <maven.site.path>pom-archives/maven-LATEST</maven.site.path>
     <rat.skip>true</rat.skip>
 
+    <maven.site.gitHubProjectId>maven-parent</maven.site.gitHubProjectId>
+
     <!-- modules with documentation not need to install and deploy -->
     <maven.install.skip>true</maven.install.skip>
     <maven.deploy.skip>true</maven.deploy.skip>
diff --git a/docs/src/site/apt/index.apt.vm b/docs/src/site/apt/index.apt.vm
index 9e38999f..0cf2deb9 100644
--- a/docs/src/site/apt/index.apt.vm
+++ b/docs/src/site/apt/index.apt.vm
@@ -118,6 +118,15 @@ mvn scm-publish:publish-scm
 
 * History
 
+** 46
+
+  A <<GitHub ribbon>> has been added to the generated site to provide a direct link to the project's GitHub repository.
+
+  A new configuration property <<<maven.site.gitHubProjectId>>> has been introduced.
+  By default, this property is set to <<<$\{project.artifactId\}>>>, is used to resolve the <<GitHub>> repository URL for the ribbon link.
+
+** 38
+
     As of version 38, this POM sets the Java source and target versions to 1.8. Thus, as any plugin (or other component)
     moved to version 38+ of this POM, it moves to requiring Java 1.8 (was Java 1.5 since version 21, Java 1.6 since
     version 27, and Java 1.7 since version 34).
diff --git a/maven-plugins/src/site/site.xml b/maven-plugins/src/site/site.xml
index d68e3769..da34bdae 100644
--- a/maven-plugins/src/site/site.xml
+++ b/maven-plugins/src/site/site.xml
@@ -21,16 +21,6 @@ under the License.
 <site xmlns="http://maven.apache.org/SITE/2.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://maven.apache.org/SITE/2.0.0 https://maven.apache.org/xsd/site-2.0.0.xsd">
 
-  <custom>
-    <fluidoSkin>
-      <gitHub>
-        <projectId>apache/${project.artifactId}</projectId>
-        <ribbonOrientation>right</ribbonOrientation>
-        <ribbonColor>gray</ribbonColor>
-      </gitHub>
-    </fluidoSkin>
-  </custom>
-
   <body>
     <breadcrumbs>
       <item name="Plugins" href="https://maven.apache.org/plugins/index.html" />
diff --git a/pom.xml b/pom.xml
index f9899a87..6a86857c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -971,6 +971,8 @@ under the License.
     <!-- to be overridden -->
     <maven.site.path>../..</maven.site.path>
     <maven.site.path.suffix>LATEST</maven.site.path.suffix>
+    <!-- used by fluido Skin GitHUb ribbon -->
+    <maven.site.gitHubProjectId>${project.artifactId}</maven.site.gitHubProjectId>
     <invoker.streamLogsOnFailures>true</invoker.streamLogsOnFailures>
     <version.sisu-maven-plugin>0.9.0.M4</version.sisu-maven-plugin>
     <version.plexus-utils>4.0.2</version.plexus-utils>
diff --git a/src/site/site.xml b/src/site/site.xml
index 229c70ba..3c89c8e1 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -50,6 +50,11 @@ under the License.
     </matomo>
     <fluidoSkin>
       <sourceLineNumbersEnabled>true</sourceLineNumbersEnabled>
+      <gitHub>
+        <projectId>apache/${maven.site.gitHubProjectId}</projectId>
+        <ribbonOrientation>right</ribbonOrientation>
+        <ribbonColor>gray</ribbonColor>
+      </gitHub>
     </fluidoSkin>
   </custom>
 
