Reintroduce left-hand side navigation in ref docs

sbrannen · sbrannen · commit 9c0825629b71 · 2021-07-17T17:53:43.000+03:00
A side effect of 71995a9 caused the dynamic table of contents in the left-hand side navigation to no longer be displayed, likely due to the missing "details" DIV. This commit addresses this issue by applying the custom header only to index.adoc. Consequently, the TOC is now displayed again on all pages except the index page, but the customized header is no longer applied to those pages. We may revisit this issue if we decide that we want the custom header on all pages (and not just the index page). Closes gh-27177
diff --git a/gradle/docs.gradle b/gradle/docs.gradle
@@ -139,7 +139,7 @@ asciidoctorj {
 			icons: 'font',
 			idprefix: '',
 			idseparator: '-',
-			docinfo: 'shared',
+			docinfo: 'shared,private-header', // https://docs.asciidoctor.org/asciidoctor/latest/docinfo/
 			revnumber: project.version,
 			sectanchors: '',
 			sectnums: '',
@@ -163,9 +163,6 @@ asciidoctorj {
 asciidoctor {
 	baseDirFollowsSourceDir()
 	configurations 'asciidoctorExt'
-	attributes([
-			noheader: '' // custom header in docinfo-header.html
-	])
 	sources {
 		include '*.adoc'
 	}
diff --git a/src/docs/asciidoc/index-docinfo-header.html b/src/docs/asciidoc/index-docinfo-header.html
@@ -1,4 +1,9 @@
 <div id="header">
 <h1>Spring Framework Documentation</h1>
+<!--
+<div class="details">
+<span id="revnumber">{revnumber}</span>
+</div>
+-->
 <span><strong>{revnumber}</strong></span>
 </div>
diff --git a/src/docs/asciidoc/index.adoc b/src/docs/asciidoc/index.adoc
@@ -1,3 +1,4 @@
+:noheader:
 = Spring Framework Documentation
 
 [horizontal]

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+:noheader:`
`1`	`2`	`= Spring Framework Documentation`
`2`	`3`
`3`	`4`	`[horizontal]`