Updated CI for automated publications (#373)

Author: Mr3zee

.github/workflows/docs.yml

@@ -7,8 +7,13 @@ on:
       - '.github/workflows/**'
   workflow_dispatch:
     inputs:
-      version:
-        description: 'Version of library that is being documented'
+      build_id:
+        description: 'Id of TeamCity build that produced the 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:
@@ -90,10 +95,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.build_id }}" ]; then
+            echo "'build_id' is not set"
+            exit 1
+          fi
+          
+          echo "Downloading Dokka artifact, build id: ${{ inputs.build_id }}"
+
+          curl -v -s -f -L \                                                                                                                                                                                              ─╯
+            -H "Authorization: Bearer ${{ secrets.TEAMCITY_TOKEN }}" \
+            "https://krpc.teamcity.com/app/rest/builds/id:${{ inputs.build_id }}/artifacts/content/${{ env.DOKKA_ARTIFACT }}" -o ${{ env.DOKKA_ARTIFACT }}
+          
+          if [ -z "$(ls | grep -x ${{ env.DOKKA_ARTIFACT }})" ]; then
+            echo "Failed to download Dokka artifact, asset id: ${{ inputs.build_id }}"
+            exit 1
+          fi
 
       - name: Unzip Dokka
         run: unzip -O UTF-8 -qq '${{ env.DOKKA_ARTIFACT }}' -d ${{ env.ASSEMBLE_DIR }}/api
@@ -110,7 +127,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 +155,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