Reinstate single page HTML and PDF docs

Closes gh-16854

spring-boot-project/spring-boot-docs/pom.xml

@@ -1442,7 +1442,14 @@
 						<artifactId>asciidoctor-maven-plugin</artifactId>
 						<configuration>
 							<sourceDirectory>${refdocs.build.directory}</sourceDirectory>
-							<outputDirectory>${project.build.directory}/generated-docs/reference/html</outputDirectory>
+							<resources>
+								<resource>
+									<directory>${refdocs.build.directory}</directory>
+									<excludes>
+										<exclude>**/*.*adoc</exclude>
+									</excludes>
+								</resource>
+							</resources>
 							<attributes>
 								<spring-boot-docs-version>${revision}</spring-boot-docs-version>
 								<spring-boot-repo>${spring-boot-repo}</spring-boot-repo>
@@ -1465,6 +1472,11 @@
 								</goals>
 								<configuration>
 									<backend>html5</backend>
+									<sourceDocumentExtensions>
+										<sourceDocumentExtension>adoc</sourceDocumentExtension>
+										<sourceDocumentExtension>htmladoc</sourceDocumentExtension>
+									</sourceDocumentExtensions>
+									<outputDirectory>${project.build.directory}/generated-docs/reference/html</outputDirectory>
 									<sourceHighlighter>highlight.js</sourceHighlighter>
 									<doctype>book</doctype>
 									<attributes>
@@ -1478,6 +1490,53 @@
 									</attributes>
 								</configuration>
 							</execution>
+							<execution>
+								<id>generate-htmlsingle-documentation</id>
+								<phase>prepare-package</phase>
+								<goals>
+									<goal>process-asciidoc</goal>
+								</goals>
+								<configuration>
+									<backend>html5</backend>
+									<sourceDocumentExtensions>
+										<sourceDocumentExtension>htmlsingleadoc</sourceDocumentExtension>
+									</sourceDocumentExtensions>
+									<outputDirectory>${project.build.directory}/generated-docs/reference/htmlsingle</outputDirectory>
+									<sourceHighlighter>highlight.js</sourceHighlighter>
+									<doctype>book</doctype>
+									<attributes>
+										<highlightjsdir>js/highlight</highlightjsdir>
+										<highlightjs-theme>atom-one-dark-reasonable</highlightjs-theme>
+										<linkcss>true</linkcss>
+										<imagesdir>./images</imagesdir>
+										<icons>font</icons>
+										<stylesdir>css/</stylesdir>
+										<stylesheet>spring.css</stylesheet>
+									</attributes>
+								</configuration>
+							</execution>
+							<execution>
+								<id>generate-pdf-documentation</id>
+								<phase>prepare-package</phase>
+								<goals>
+									<goal>process-asciidoc</goal>
+								</goals>
+								<configuration>
+									<backend>pdf</backend>
+									<sourceDocumentExtensions>
+										<sourceDocumentExtension>pdfadoc</sourceDocumentExtension>
+									</sourceDocumentExtensions>
+									<outputDirectory>${project.build.directory}/generated-docs/reference/pdf</outputDirectory>
+									<resources>
+										<resource>
+											<directory>${refdocs.build.directory}</directory>
+											<excludes>
+												<exclude>**/*</exclude>
+											</excludes>
+										</resource>
+									</resources>
+								</configuration>
+							</execution>
 						</executions>
 					</plugin>
 					<plugin>

spring-boot-project/spring-boot-docs/src/main/asciidoc/documentation-overview.adoc

@@ -13,10 +13,12 @@ as a map for the rest of the document.
 [[boot-documentation-about]]
 == About the Documentation
 The Spring Boot reference guide is available as
-<<single-index.adoc#spring-boot-reference-documentation, single page>> or
-<<index.adoc#spring-boot-reference-documentation, multi-page>> documentation.
-The latest copy
-of the reference documentation is available at {spring-boot-docs-current}.
+
+* {spring-boot-docs}/html[Multi-page HTML]
+* {spring-boot-docs}/htmlsingle[Single page HTML]
+* {spring-boot-docs}/pdf/spring-boot-reference.pdf[PDF]
+
+The latest copy is available at {spring-boot-docs-current}.
 
 Copies of this document may be made for your own use and for distribution to others,
 provided that you do not charge any fee for such copies and further provided that each

spring-boot-project/spring-boot-docs/src/main/asciidoc/spring-boot-reference.pdfadoc

@@ -0,0 +1,17 @@
+[[spring-boot-reference-documentation]]
+= Spring Boot Reference Documentation
+Phillip Webb, Dave Syer, Josh Long, Stéphane Nicoll, Rob Winch, Andy Wilkinson, Marcel Overdijk, Christian Dupuis, Sébastien Deleuze, Michael Simons, Vedran Pavić, Jay Bryant, Madhura Bhave
+:docinfo: shared
+include::attributes.adoc[]
+
+include::legal.adoc[leveloffset=+1]
+include::documentation-overview.adoc[leveloffset=+1]
+include::getting-started.adoc[leveloffset=+1]
+include::using-spring-boot.adoc[leveloffset=+1]
+include::spring-boot-features.adoc[leveloffset=+1]
+include::production-ready-features.adoc[leveloffset=+1]
+include::deployment.adoc[leveloffset=+1]
+include::spring-boot-cli.adoc[leveloffset=+1]
+include::build-tool-plugins.adoc[leveloffset=+1]
+include::howto.adoc[leveloffset=+1]
+include::appendix.adoc[leveloffset=+1]

spring-boot-project/spring-boot-parent/pom.xml

@@ -306,6 +306,11 @@
 							<artifactId>asciidoctorj</artifactId>
 							<version>1.5.8</version>
 						</dependency>
+						<dependency>
+							<groupId>org.asciidoctor</groupId>
+							<artifactId>asciidoctorj-pdf</artifactId>
+							<version>1.5.0-alpha.11</version>
+						</dependency>
 					</dependencies>
 				</plugin>
 				<plugin>

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/pom.xml

@@ -356,11 +356,6 @@
 							</attributes>
 						</configuration>
 						<dependencies>
-							<dependency>
-								<groupId>org.asciidoctor</groupId>
-								<artifactId>asciidoctorj-pdf</artifactId>
-								<version>1.5.0-alpha.11</version>
-							</dependency>
 							<dependency>
 								<groupId>io.spring.asciidoctor</groupId>
 								<artifactId>spring-asciidoctor-extensions</artifactId>