From 466b57cd449d311ce356434fe5ef34ec2b985d52 Mon Sep 17 00:00:00 2001
From: Hendrig Sellik <sellikhendrig@gmail.com>
Date: Mon, 25 Mar 2019 14:46:22 +0100
Subject: [PATCH 1/2] Add Spring-specific styling to Gradle Plugin's
 documentation

This commit replaces the default Asciidoctor styling with
Spring specific styling.

First, we need to unzip the contents of the Spring Asciidoctor
documentation resources provided by the
`io.spring.docsresources:spring-docs-resources` distribution zip. This
is done in a `/target/refdocs` folder. We then copy all files from
`src/main/asciidoc` to the same location, and then launch the generation
process.

See gh-16327
---
 .../spring-boot-gradle-plugin/pom.xml         | 70 +++++++++++++++----
 .../src/main/asciidoc/css/style.css           | 20 ++++++
 .../src/main/asciidoc/index.adoc              |  3 +-
 3 files changed, 79 insertions(+), 14 deletions(-)
 create mode 100644 spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/css/style.css

diff --git a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/pom.xml b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/pom.xml
index 92e1b49ecc..0ad50a1a79 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/pom.xml
+++ b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/pom.xml
@@ -16,6 +16,7 @@
 		<gradle.executable>./gradlew</gradle.executable>
 		<gradle.task>build</gradle.task>
 		<skip.gradle.build>false</skip.gradle.build>
+		<refdocs.build.directory>${project.build.directory}/refdocs/</refdocs.build.directory>
 	</properties>
 	<dependencies>
 		<dependency>
@@ -39,6 +40,24 @@
 	</dependencies>
 	<build>
 		<plugins>
+			<plugin>
+				<groupId>com.googlecode.maven-download-plugin</groupId>
+				<artifactId>download-maven-plugin</artifactId>
+				<executions>
+					<execution>
+						<id>unpack-doc-resources</id>
+						<phase>generate-resources</phase>
+						<goals>
+							<goal>wget</goal>
+						</goals>
+						<configuration>
+							<url>https://repo.spring.io/release/io/spring/docresources/spring-doc-resources/${spring-doc-resources.version}/spring-doc-resources-${spring-doc-resources.version}.zip</url>
+							<unpack>true</unpack>
+							<outputDirectory>${refdocs.build.directory}</outputDirectory>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-dependency-plugin</artifactId>
@@ -69,6 +88,28 @@
 					</execution>
 				</executions>
 			</plugin>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-resources-plugin</artifactId>
+				<executions>
+					<execution>
+						<id>copy-asciidoc-resources</id>
+						<phase>generate-resources</phase>
+						<goals>
+							<goal>copy-resources</goal>
+						</goals>
+						<configuration>
+							<outputDirectory>${refdocs.build.directory}</outputDirectory>
+							<resources>
+								<resource>
+									<directory>src/main/asciidoc</directory>
+									<filtering>false</filtering>
+								</resource>
+							</resources>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
 			<plugin>
 				<groupId>org.codehaus.mojo</groupId>
 				<artifactId>exec-maven-plugin</artifactId>
@@ -233,17 +274,7 @@
 									<target>
 										<zip
 											destfile="${project.build.directory}/${project.artifactId}-${project.version}-docs.zip">
-											<zipfileset
-												src="build/libs/${project.artifactId}-${project.version}-javadoc.jar"
-												prefix="api" />
-											<zipfileset dir="${project.build.directory}/generated-docs"
-												includes="index.html" prefix="reference/html" />
-											<mappedresources>
-												<fileset dir="${project.build.directory}/generated-docs"
-													includes="index.pdf" />
-												<globmapper from="index.pdf"
-													to="reference/pdf/spring-boot-gradle-plugin-reference.pdf" />
-											</mappedresources>
+											<fileset dir="${project.build.directory}/generated-docs" />
 										</zip>
 									</target>
 								</configuration>
@@ -261,7 +292,19 @@
 									<goal>process-asciidoc</goal>
 								</goals>
 								<configuration>
-									<backend>html</backend>
+									<backend>html5</backend>
+									<outputDirectory>${project.build.directory}/generated-docs/reference/html</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>style.css</stylesheet>
+									</attributes>
 								</configuration>
 							</execution>
 							<execution>
@@ -272,11 +315,12 @@
 								</goals>
 								<configuration>
 									<backend>pdf</backend>
+									<outputDirectory>${project.build.directory}/generated-docs/reference/pdf</outputDirectory>
 								</configuration>
 							</execution>
 						</executions>
 						<configuration>
-							<sourceDocumentName>index.adoc</sourceDocumentName>
+							<sourceDirectory>${refdocs.build.directory}</sourceDirectory>
 							<attributes>
 								<github-tag>${github-tag}</github-tag>
 								<version-type>${version-type}</version-type>
diff --git a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/css/style.css b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/css/style.css
new file mode 100644
index 0000000000..edaad0a410
--- /dev/null
+++ b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/css/style.css
@@ -0,0 +1,20 @@
+@import url("spring.css");
+
+div .switch {
+    margin-left: 8px;
+    border-color: #406A2A;
+    border-radius: 4px 4px 0 0;
+}
+
+div .switch--item {
+    color: #406A2A;
+    background-color: transparent;
+}
+
+div .switch--item.selected {
+    background-color: #406A2A;
+}
+
+div .switch--item:not(:first-child) {
+    border-color: #406A2A;
+}
\ No newline at end of file
diff --git a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/index.adoc b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/index.adoc
index c1c8bba267..f43fc0c673 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/index.adoc
+++ b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/index.adoc
@@ -7,6 +7,8 @@ Andy Wilkinson
 :numbered:
 :icons: font
 :hide-uri-scheme:
+:docinfo: shared,private
+
 :dependency-management-plugin: https://github.com/spring-gradle-plugins/dependency-management-plugin
 :dependency-management-plugin-documentation: {dependency-management-plugin}/blob/master/README.md
 :gradle-userguide: https://docs.gradle.org/current/userguide
@@ -30,7 +32,6 @@ Andy Wilkinson
 :github-code: https://github.com/spring-projects/spring-boot/tree/{github-tag}
 
 
-
 [[introduction]]
 == Introduction
 

From c4b1a22e89a6f3f7fc8177ed08f712b6372e2ea6 Mon Sep 17 00:00:00 2001
From: Stephane Nicoll <snicoll@pivotal.io>
Date: Tue, 2 Apr 2019 16:22:13 +0200
Subject: [PATCH 2/2] Polish "Add Spring-specific styling to Gradle Plugin's
 documentation"

Closes gh-16327
---
 .../spring-boot-gradle-plugin/pom.xml               | 13 ++++++++++++-
 .../src/main/asciidoc/index.adoc                    |  1 +
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/pom.xml b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/pom.xml
index 0ad50a1a79..a43f9b423d 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/pom.xml
+++ b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/pom.xml
@@ -274,7 +274,17 @@
 									<target>
 										<zip
 											destfile="${project.build.directory}/${project.artifactId}-${project.version}-docs.zip">
-											<fileset dir="${project.build.directory}/generated-docs" />
+											<zipfileset
+												src="build/libs/${project.artifactId}-${project.version}-javadoc.jar"
+												prefix="api" />
+											<zipfileset dir="${project.build.directory}/generated-docs/reference/html"
+												prefix="reference/html" />
+											<mappedresources>
+												<fileset dir="${project.build.directory}/generated-docs/reference/pdf"
+													includes="index.pdf" />
+												<globmapper from="index.pdf"
+													to="reference/pdf/spring-boot-gradle-plugin-reference.pdf" />
+											</mappedresources>
 										</zip>
 									</target>
 								</configuration>
@@ -321,6 +331,7 @@
 						</executions>
 						<configuration>
 							<sourceDirectory>${refdocs.build.directory}</sourceDirectory>
+							<sourceDocumentName>index.adoc</sourceDocumentName>
 							<attributes>
 								<github-tag>${github-tag}</github-tag>
 								<version-type>${version-type}</version-type>
diff --git a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/index.adoc b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/index.adoc
index f43fc0c673..f8da6b914f 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/index.adoc
+++ b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/asciidoc/index.adoc
@@ -32,6 +32,7 @@ Andy Wilkinson
 :github-code: https://github.com/spring-projects/spring-boot/tree/{github-tag}
 
 
+
 [[introduction]]
 == Introduction