From 8ad51a157348aad520bc559b0404c7e16188830a Mon Sep 17 00:00:00 2001
From: Kai Moritz <kai@juplo.de>
Date: Sat, 25 Oct 2025 09:46:33 +0200
Subject: [PATCH] Added a parameter "flat" to generate all links as canonical
 links

---
 src/main/resources/META-INF/maven/site.vm | 7 ++++++-
 src/site/xhtml/usage.xhtml                | 7 +++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/src/main/resources/META-INF/maven/site.vm b/src/main/resources/META-INF/maven/site.vm
index b4866d1..46d0a3a 100644
--- a/src/main/resources/META-INF/maven/site.vm
+++ b/src/main/resources/META-INF/maven/site.vm
@@ -127,7 +127,12 @@
   #set ( $canonicalPath = "" )
   <!-- WARNING: configuration parameter "path" is not set -->
 #end
-#set ( $sitePath = $pathPrefix + $canonicalPath + $project.version + "/" )
+#if ( $decoration.custom.getChild( 'thymeproxy' ).getChild( 'flat' ).getValue() )
+  <!-- Generating a flat link-structure (the configuration properties "path" and "prefix" are ignored -->
+  #set ( $sitePath = $canonicalPath )
+#else
+  #set ( $sitePath = $pathPrefix + $canonicalPath + $project.version + "/" )
+#end
 #set ( $siteCrumbs = $decoration.custom.getChild( 'thymeproxy' ).getChild( 'crumbs' ).getValue() )
 #set ( $command = $decoration.custom.getChild( 'thymeproxy' ).getChild( 'command' ).getValue() )
 #if ( !$command )
diff --git a/src/site/xhtml/usage.xhtml b/src/site/xhtml/usage.xhtml
index 48d4a82..0a208f1 100644
--- a/src/site/xhtml/usage.xhtml
+++ b/src/site/xhtml/usage.xhtml
@@ -27,6 +27,7 @@
   <ul>
   <li><strong>path</strong></li>
   <li><strong>prefix</strong></li>
+  <li><strong>flat</strong></li>
   <li><strong>crumbs</strong></li>
   <li><strong>command</strong></li>
   </ul>
@@ -49,6 +50,12 @@
   </ul>
   <h3>prefix</h3>
   <p>If set, the <code>path</code> is prefixed with the value, when generating the <code>site_uri</code>.</p>
+  <h3>flat</h3>
+  <p>
+    If set, the configuration properties <code>prefix</code> and <code>path</code> are ignored,
+    when generating the <code>site_uri</code>.
+    Thus, the generated <code>site_uri</code> is always equal to the generated <code>canonical_uri</code>.
+  </p>
   <h3>crumbs</h3>
   <p>Some crumbs, that should be prepended to the breadcrumbs that are computed for the pages.</p>
   <p>The crumbs have to be specified in double quotes and must be separated by commas. Example:</p>
-- 
2.39.5