From d756b9c2a386e54dbb81520dff09ebbb8f9f57f7 Mon Sep 17 00:00:00 2001
From: Nassim Boutekedjiret <nassim@sentrysoftware.com>
Date: Thu, 8 Oct 2026 17:24:04 +0200
Subject: [PATCH] Issue #69 - Build the site with Doxia 2

oss-parent configures maven-site-plugin 3.12.1 with maven-skin-tools
1.3.00, which puts Velocity 1.7 / velocity-tools 2.0 and Velocity 2.3 /
velocity-tools 3.1 on the plugin class path. Maven 3.10 orders that class
path differently from Maven 3.9 and mixes them, so the site fails with
an AbstractMethodError on org.apache.velocity.tools.ToolContext.

Use maven-site-plugin 4.0.0-M16 with maven-skin-tools 1.8.01 (Doxia 2,
one Velocity generation), and the SITE 2.0.0 descriptor with
sentry-maven-skin 8.0.00, as community-connectors does.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 pom.xml           | 13 +++++++++++++
 src/site/site.xml | 19 +++++++++++--------
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/pom.xml b/pom.xml
index 43bf9ea..87840b0 100644
--- a/pom.xml
+++ b/pom.xml
@@ -145,6 +145,19 @@
 	</reporting>
 	<build>
 		<plugins>
+			<!-- Site with Doxia 2: maven-site-plugin 3.12.1 (from oss-parent) mixes two Velocity generations, which -->
+			<!-- fails with Maven 3.10 (AbstractMethodError on org.apache.velocity.tools.ToolContext) -->
+			<plugin>
+				<artifactId>maven-site-plugin</artifactId>
+				<version>4.0.0-M16</version>
+				<dependencies>
+					<dependency>
+						<groupId>org.sentrysoftware.maven</groupId>
+						<artifactId>maven-skin-tools</artifactId>
+						<version>1.8.01</version>
+					</dependency>
+				</dependencies>
+			</plugin>
 			<!-- Prettier -->
 			<plugin>
 				<groupId>com.hubspot.maven.plugins</groupId>
diff --git a/src/site/site.xml b/src/site/site.xml
index e01ae9d..43c1755 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -1,10 +1,14 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<project name="${project.name}">
+<?xml version="1.0" encoding="UTF-8"?>
+<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"
+	name="${project.name}">
 
 	<skin>
 		<groupId>org.sentrysoftware.maven</groupId>
 		<artifactId>sentry-maven-skin</artifactId>
-		<version>6.4.01</version>
+		<version>8.0.00</version>
 	</skin>
 
 	<custom>
@@ -12,16 +16,15 @@
 		<keywords>jflat</keywords>
 	</custom>
 
-	<bannerLeft>
-		<src>images/metricshub-logo-only.png</src>
-		<href>https://metricshub.org</href>
+	<bannerLeft name="MetricsHub" href="https://metricshub.org">
+		<image src="images/metricshub-logo-only.png" />
 	</bannerLeft>
 
 	<body>
 
 		<links>
 			<item name="Fork on GitHub" href="${project.scm.url}" />
-			<item name="MetricsHub&reg;" href="https://metricshub.com" />
+			<item name="MetricsHub&#174;" href="https://metricshub.com" />
 		</links>
 
 		<menu name="User Documentation">
@@ -32,4 +35,4 @@
 		<menu ref="reports" />
 	</body>
 
-</project>
\ No newline at end of file
+</site>