Use shell script for building docs

Author: mattco98

Dockerfile

@@ -1,10 +1,13 @@
-FROM gradle:8.13-jdk21 as build-docs
+#FROM gradle:8.13-jdk21 as build-docs
+#
+#WORKDIR /build/docs
+#
+#COPY . ./
+#
+#RUN ./gradlew dokkaHtml
 
-WORKDIR /build/docs
 
-COPY . ./
 
-RUN ./gradlew dokkaHtml
 
 #FROM node:lts-alpine AS serve-docs
 #
@@ -15,10 +18,16 @@ RUN ./gradlew dokkaHtml
 #EXPOSE 8081
 #CMD ["http-server", ".", "--proxy", "http://localhost:8081"]
 
-FROM busybox:1.37.0
+
+
+
+FROM busybox:1.37.0 as build
 ENV PORT=8000
 
-COPY --from=build-docs /build/docs/* /www/
+WORKDIR /app/javadocs
+
+COPY . ./
+COPY --from=build ./build/javadocs /app/javadocs
 EXPOSE $PORT
 
-CMD trap "exit 0;" TERM INT; httpd -v -p $PORT -h /www -f & wait
+CMD trap "exit 0;" TERM INT; httpd -v -p $PORT -h /www -f & wait

build.gradle.kts

@@ -129,7 +129,6 @@ tasks {
         val docVersionsDir = projectDir.resolve("build/javadocs")
         val currentVersion = project.version.toString()
         val currentDocsDir = docVersionsDir.resolve(currentVersion)
-        outputs.upToDateWhen { docVersionsDir.exists() }
 
         outputDirectory.set(file(currentDocsDir))
 
@@ -194,20 +193,18 @@ tasks {
             //         \-- older
             //
             // The "older" directory contains all old versions, so we want to
-            // delete the top-level older versions and move everything inside the
-            // latest directory to the top level so the GitHub actions workflow
-            // doesn't need to figure out the correct version name
+            // delete the top-level older versions.
 
             docVersionsDir.listFiles()?.forEach {
                 if (it.name != version)
                     it.deleteRecursively()
             }
 
-            val latestVersionDir = docVersionsDir.listFiles()!!.single()
-            latestVersionDir.listFiles()!!.forEach {
-                it.renameTo(File(it.parentFile.parentFile, it.name))
-            }
-            latestVersionDir.deleteRecursively()
+//            val latestVersionDir = docVersionsDir.listFiles()!!.single()
+//            latestVersionDir.listFiles()!!.forEach {
+//                it.renameTo(File(it.parentFile.parentFile, it.name))
+//            }
+//            latestVersionDir.deleteRecursively()
         }
     }
 }

scripts/buildDocs.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+
+#JAVADOCS_ARCHIVE_PATH="/apps/storage/javadocs-archive"
+JAVADOCS_ARCHIVE_PATH="../javadocs-archive"
+BUILD_DIR="./build/javadocs"
+
+if [[ -d "$JAVADOCS_ARCHIVE_PATH" ]]; then
+  cp -r "$JAVADOCS_ARCHIVE_PATH" .
+fi
+
+./gradlew dokkaHtml
+
+# Copy build docs back into archive folder
+output_dir=$(find "$BUILD_DIR" -mindepth 1 -maxdepth 1 -type d | head -n 1)
+cp -r "$output_dir" "$JAVADOCS_ARCHIVE_PATH"
+
+# Remove the version name from the hierarchy so the Dockerfile doesn't need to worry about it
+cp -r "$output_dir"/* "$BUILD_DIR"
+rm -rf "$output_dir"