Create a workflow to deploy the Dokka documentation (#775)

.github/workflows/deploy_dokka_documentation.yml

@@ -0,0 +1,42 @@
+name: Deploy Dokka documentation
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  deploy-dokka-documentation:
+    name: Deploy Dokka documentation
+    runs-on: ubuntu-latest
+    env:
+      USERNAME: ${{ github.actor }}
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+      - uses: gradle/actions/setup-gradle@v4
+        with:
+          cache-encryption-key: ${{ secrets.GRADLE_CACHE_ENCRYPTION_KEY }}
+      - name: Copy CI gradle.properties
+        run: mkdir -p ~/.gradle; cp .github/gradle-ci.properties ~/.gradle/gradle.properties
+      - name: Build Dokka documentation
+        run: ./gradlew :dokkaGenerate
+      - name: Deploy Dokka documentation
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: build/dokka/html
+          single-commit: true
+          target-folder: api

build-logic/plugins/src/main/java/ch/srgssr/pillarbox/gradle/PillarboxAndroidLibraryPublishingPlugin.kt

@@ -103,7 +103,8 @@ class PillarboxAndroidLibraryPublishingPlugin : Plugin<Project> {
             pluginsConfiguration.getByName<DokkaHtmlPluginParameters>("html") {
                 customStyleSheets.from(rootProject.projectDir.resolve("dokka/styles/pillarbox.css"))
                 footerMessage.set("© SRG SSR")
-                homepageLink.set("https://srgssr.github.io/pillarbox-android")
+                // TODO Enable this once we have some content there
+                // homepageLink.set("https://srgssr.github.io/pillarbox-android")
                 templatesDir.set(rootProject.projectDir.resolve("dokka/templates"))
             }
         }

build.gradle.kts

@@ -31,7 +31,8 @@ dokka {
         customAssets.from("dokka/images/logo-icon.svg") // TODO Use Pillarbox logo
         customStyleSheets.from("dokka/styles/pillarbox.css")
         footerMessage.set("© SRG SSR")
-        homepageLink.set("https://srgssr.github.io/pillarbox-android")
+        // TODO Enable this once we have some content there
+        // homepageLink.set("https://srgssr.github.io/pillarbox-android")
         templatesDir.set(file("dokka/templates"))
     }
 }