Updated CI for automated publications (#373)

Author: Mr3zee

.github/workflows/docs.yml

@@ -7,13 +7,19 @@ on:
       - '.github/workflows/**'
   workflow_dispatch:
     inputs:
-      version:
-        description: 'Version of library that is being documented'
+      asset_id:
+        description: 'Id of Dokka artifact.'
+        required: true
+      dry_run:
+        type: boolean
+        description: "Dry run. If set to true, the action will not actually publish the pages, but will assemble the artifact."
+        default: true
         required: true
 
 permissions:
   id-token: write
   pages: write
+  contents: read
 
 env:
   INSTANCE: 'kotlinx-rpc/rpc'
@@ -90,10 +96,22 @@ jobs:
         run: unzip -O UTF-8 -qq '${{ env.ARTIFACT }}' -d ${{ env.ASSEMBLE_DIR }}
 
       - name: Download Dokka
-        uses: actions/download-artifact@v4
-        with:
-          name: dokka-${{ inputs.version }}
-          path: ${{ env.DOKKA_ARTIFACT }}
+        run: |
+          if [ -z "${{ inputs.asset_id }}" ]; then
+            echo "'asset_id' is not set"
+            exit 1
+          fi
+
+           curl -v -s -f -L \                                                                                                                                                                                              ─╯
+             -H "Accept: application/octet-stream" \
+             -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \
+             -H "X-GitHub-Api-Version: 2022-11-28" \
+             "https://api.github.com/repos/Kotlin/kotlinx-rpc/releases/assets/${{ inputs.asset_id }}" -o ${{ env.DOKKA_ARTIFACT }}
+          
+          if [ -z "$(ls | grep -x ${{ env.DOKKA_ARTIFACT }})" ]; then
+            echo "Failed to download Dokka artifact, asset id: ${{ inputs.asset_id }}"
+            exit 1
+          fi
 
       - name: Unzip Dokka
         run: unzip -O UTF-8 -qq '${{ env.DOKKA_ARTIFACT }}' -d ${{ env.ASSEMBLE_DIR }}/api
@@ -110,7 +128,7 @@ jobs:
           retention-days: 7
 
   deploy:
-    if: github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main'
+    if: github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main' && !inputs.dry_run
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
@@ -138,7 +156,7 @@ jobs:
         uses: actions/deploy-pages@v4
 
   publish-indexes:
-    if: github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main'
+    if: github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main' && !inputs.dry_run
     needs: [ build, test, assemble, deploy ]
     runs-on: ubuntu-latest
     container:

.github/workflows/dokka.yml

@@ -32,7 +32,7 @@ current_date=$(date +%Y-%m-%d)
 temp_file=$(mktemp)
 
 # Extract the first line from sitemap file (XML header), removing closing urlset tag if present
-head -n 1 "$sitemap_file" | sed -En 's/<\/urlset>//' > "$temp_file"
+head -n 1 "$sitemap_file" | sed -En 's/<\/urlset>//p' > "$temp_file"
 
 # Find all HTML files in the API docs directory recursively
 find "$api_docs_dir" -type f -name "*.html" | while read -r html_file; do