Maven site generation fails due to maven-fluido-skin version incompatibility

[sfloess]

Problem

The maven site command fails with the following error:

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-site-plugin:3.12.1:site (default-site) on project jcommons: 
RendererException while preparing context for skin: Cannot use skin: has 2.0.0-M18 Doxia Sitetools prerequisite, 
but current is 1.11.1

Root Cause

Incompatible versions:

• src/site/site.xml specifies maven-fluido-skin:2.0.0-M10
• pom.xml uses maven-site-plugin:3.12.1 (includes Doxia Sitetools 1.11.1)
• Fluido skin 2.0.0-M10 requires Doxia Sitetools 2.0.0-M18

This is a classic Maven skin/site plugin version mismatch.

Solution

Option 1: Upgrade maven-site-plugin (RECOMMENDED)

<maven-site-plugin>4.0.0-M16</maven-site-plugin>

Maven Site Plugin 4.x includes Doxia Sitetools 2.x and is compatible with fluido-skin 2.0.0-M10.

Option 2: Downgrade fluido-skin

<version>1.11.2</version>

Use the stable 1.x version that works with maven-site-plugin 3.12.1.

Impact

• Severity: Medium
• User impact: Cannot generate unified project site with mvn site
• Workaround: Individual reports work (mvn jacoco:report, mvn checkstyle:checkstyle, etc.)

Testing

After fix:

mvn clean site
# Should complete successfully
ls target/site/index.html
# Should exist

Related

• Issue Missing <reporting> section in pom.xml - cannot generate unified Maven site reports #197: Missing <reporting> section (RESOLVED - reporting section now exists)
• src/site/site.xml was created to define site structure