docs(site): Organize menu, add build badge

jeffjensen · jeffjensen · commit 5f375bd35a70 · 2026-06-10T06:11:02.000-05:00
* Organize the site menu into Using and Developing.
* Add main branch build badge.  Adjust site url rewriting in pom.
* Fix the site.xml root element.
* Rename developing.adoc to building.adoc.
diff --git a/pom.xml b/pom.xml
@@ -113,6 +113,9 @@
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-site-plugin</artifactId>
           <version>${maven-site-plugin.version}</version>
+          <configuration>
+            <relativizeSiteLinks>false</relativizeSiteLinks>
+          </configuration>
           <dependencies>
             <dependency>
               <groupId>org.asciidoctor</groupId>
diff --git a/src/site/asciidoc/building.adoc b/src/site/asciidoc/building.adoc
@@ -1,4 +1,4 @@
-= Developing
+= Building
 :toc: left
 :toc-title: Contents
 :toclevels: 2
diff --git a/src/site/site.xml b/src/site/site.xml
@@ -1,9 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/DECORATION/1.8.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/DECORATION/1.8.0
-         https://maven.apache.org/xsd/decoration-1.8.0.xsd"
-         name="Java Service Archetype">
+<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">
 
   <skin>
     <groupId>org.apache.maven.skins</groupId>
@@ -13,17 +11,21 @@
 
   <body>
     <links>
-      <item name="GitHub" href="https://github.com/jeffjensen/java-service-archetype"/>
+      <item name="main" href="https://github.com/jeffjensen/java-service-archetype/actions/workflows/build-any-branch.yml?query=branch%3Amain">
+        <image src="https://github.com/jeffjensen/java-service-archetype/actions/workflows/build-any-branch.yml/badge.svg?branch=main" />
+      </item>
+      <item name="GitHub" href="https://github.com/jeffjensen/java-service-archetype" />
     </links>
 
-    <menu name="Documentation">
-      <item name="Overview"     href="index.html"/>
-      <item name="Usage"        href="usage.html"/>
-      <item name="Modules"      href="modules.html"/>
-      <item name="Developing"   href="developing.html"/>
-      <item name="Releasing"    href="releasing.html"/>
-      <item name="Requirements" href="requirements.html"/>
+    <menu name="Using">
+      <item name="Overview" href="index.html" />
+      <item name="Usage" href="usage.html" />
     </menu>
-    <menu ref="reports"/>
+    <menu name="Developing">
+      <item name="Building" href="building.html" />
+      <item name="Releasing" href="releasing.html" />
+      <item name="Requirements" href="requirements.html" />
+    </menu>
+    <menu ref="reports" />
   </body>
-</project>
+</site>

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-= Developing`
	`1`	`+= Building`
`2`	`2`	`:toc: left`
`3`	`3`	`:toc-title: Contents`
`4`	`4`	`:toclevels: 2`