Publish Javadoc

Executes `gradle javadoc` in the junit-pioneer project and copies the
resulting files into `site/api` so they are available under
junit-pioneer.org/api.

Given that junit-pioneer.org might eventually host several projects
the question arises why not to include the project name in the URL.
This was a deliberate decision to allow code to move between projects
without breaking links. Once more projects show up, this makes it
necessary to find a way to combine their Javadoc.

Author: Nicolai Parlog

.travis.yml

@@ -10,7 +10,7 @@ install:
   - ./gradlew setup --no-daemon --stacktrace -Pon-travis=true
 
 script:
-  - ./gradlew buildSite --no-daemon --stacktrace
+  - ./gradlew buildAll --no-daemon --stacktrace
 
 deploy:
   provider: script

build.gradle

@@ -110,9 +110,9 @@ task create {
 	dependsOn copyProjectPage, copyDocsPage, copyDocs, insertDocNav
 }
 
-// ---------------
-// BUILD & PUBLISH
-// ---------------
+// -----
+// BUILD
+// -----
 
 task recreate {
 	dependsOn clean, create
@@ -125,6 +125,26 @@ task buildSite(type: Exec) {
 	commandLine 'bundle exec jekyll build --destination ../site'.split(' ')
 }
 
+task buildJavadoc(type: Exec) {
+	workingDir 'junit-pioneer'
+	commandLine './gradlew javadoc --no-daemon'.split(' ')
+}
+
+task includeJavadoc(type: Copy) {
+	dependsOn buildJavadoc, buildSite
+
+	from 'junit-pioneer/build/docs/javadoc'
+	into 'site/api'
+}
+
+task buildAll {
+	dependsOn buildSite, includeJavadoc
+}
+
+// -------
+// PUBLISH
+// -------
+
 task pushSite(type: Exec) {
 	if (onTravis)
 		commandLine './git-commit-push.sh launch-ssh'.split(' ')
@@ -133,6 +153,6 @@ task pushSite(type: Exec) {
 }
 
 task publishSite {
-	dependsOn buildSite, pushSite
-	pushSite.mustRunAfter(buildSite)
+	dependsOn buildAll, pushSite
+	pushSite.mustRunAfter buildAll
 }