From 5657379aa37d89e5f0fe3279995e547246538b4f Mon Sep 17 00:00:00 2001
From: Kai Moritz <kai@juplo.de>
Date: Tue, 3 Feb 2026 09:44:57 +0100
Subject: [PATCH] Only valid HTML is rendered into the generated pages

- The *page title* is rendered inside a `<h1>`-tag at the beginning of a
  generated page. This tag can be easily referenced from CSS and HTML by
  its `id`-attribute *sili-title*, or replaced with the help of `sed` in
  a post-processing script.
- The *page body* is rendered insied a `<div>`-tag with the `id`
  *sili-body*.
- The generated JSON, that captures the project meta-data and the site
  structure, is rendered insiede a `<script>`-tag with the `id`
  *sili-json*.
---
 src/main/resources/META-INF/maven/site.vm | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/main/resources/META-INF/maven/site.vm b/src/main/resources/META-INF/maven/site.vm
index 5884b2f..381defa 100644
--- a/src/main/resources/META-INF/maven/site.vm
+++ b/src/main/resources/META-INF/maven/site.vm
@@ -62,8 +62,8 @@
 #end
 #end
 #end
-<!-- HEAD -->
-<div class="maven-site">
+<h1 id="sili-title">$!{shortTitle}</h1>
+<div id="sili-body">
 $bodyContent
 </div>
 #if (!$alignedFilePath or $alignedFilePath == 'index.html')
@@ -88,8 +88,7 @@ $bodyContent
 #end
 #end
 #end
-<!--
-JSON-BEGIN
+<script id="sili-json" type="application/json">
 {
   "project": "$project.name",
 #if ( $project.description )
@@ -125,5 +124,5 @@ JSON-BEGIN
   ]
 }
 JSON-END
--->
+</script>
 #end
-- 
2.39.5