Deploy sites by official actions (#1350)

* Move dokka step into .github/actions/deploy-site/action.yml

* Use `actions/upload-pages-artifact` and `actions/deploy-pages`

Refs https://github.com/squidfunk/mkdocs-material/blob/0e75aef9ea9028dc5a2dea34fb5da8afb14911ae/.github/workflows/documentation.yml#L92-L112

Author: Goooler

.github/actions/deploy-site/action.yml

@@ -4,12 +4,19 @@ description: 'Deploy site to GitHub Pages'
 runs:
   using: 'composite'
   steps:
-    - name: Deploy Site
+    - uses: gradle/actions/setup-gradle@v4
+      with:
+        cache-read-only: true
+    - name: Prepare API documentation
+      shell: bash
+      run: ./gradlew dokkaHtml --no-configuration-cache
+    - name: Build Site
       shell: bash
       run: |
-        git config --global user.name 'github-actions[bot]'
-        git config --global user.email 'github-actions[bot]@users.noreply.github.com'
         # Don't cache it to track updates.
         pip install mkdocs-material
-        # Incremental pushes, make sure gh-pages branch is fetched by checkout.
-        mkdocs gh-deploy
+        mkdocs build
+    - uses: actions/upload-pages-artifact@v3
+      with:
+        path: site
+    - uses: actions/deploy-pages@v4

.github/workflows/deploy.yml

@@ -14,9 +14,4 @@ jobs:
         with:
           # Fetch all tags and branches, so that MkDocs could push incremental updates.
           fetch-depth: 0
-      - uses: gradle/actions/setup-gradle@v4
-        with:
-          cache-read-only: true
-      # Prepare API documentations for MkDocs.
-      - run: ./gradlew dokkaHtml --no-configuration-cache
       - uses: ./.github/actions/deploy-site

.github/workflows/release.yml

@@ -24,7 +24,7 @@ jobs:
         with:
           cache-read-only: true
       # Disable CC due to https://github.com/gradle/gradle/issues/22779
-      - run: ./gradlew publish publishPlugins dokkaHtml --no-configuration-cache
+      - run: ./gradlew publish publishPlugins --no-configuration-cache
         env:
           GRADLE_PUBLISH_KEY: ${{ secrets.GRADLE_KEY }}
           GRADLE_PUBLISH_SECRET: ${{ secrets.GRADLE_SECRET }}