Merge pull request #5 from soliplex/docs/add-rebuild-trigger

Docs/add rebuild trigger

Author: bd-mkt

.github/workflows/trigger-docs-deploy.yml

@@ -0,0 +1,70 @@
+# Template workflow for submodule repositories
+# Copy this file to each submodule's .github/workflows/ directory
+#
+# Installation instructions:
+# 1. Create PAT with 'public_repo' scope at: https://github.com/settings/tokens
+# 2. Add secret 'DOCS_DEPLOY_TOKEN' to each submodule repository
+# 3. Copy this file to .github/workflows/trigger-docs-deploy.yml in each submodule
+# 4. Update the 'paths' section if needed for your project structure
+
+name: Trigger Documentation Rebuild
+
+on:
+  push:
+    branches: [main, master]  # Adjust branches as needed
+    paths:
+      # Trigger only when markdown documentation changes
+      - 'docs/**/*.md'
+      - 'docs/**/*.mdx'
+      - 'README.md'
+      - '.github/workflows/trigger-docs-deploy.yml'
+  workflow_dispatch:  # Allow manual triggering
+
+jobs:
+  trigger-docs-rebuild:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger soliplex.github.io documentation rebuild
+        run: |
+          echo "📚 Triggering documentation rebuild for ${{ github.repository }}"
+
+          # Properly escape JSON using jq
+          payload=$(jq -n \
+            --arg repo "${{ github.repository }}" \
+            --arg ref "${{ github.ref }}" \
+            --arg sha "${{ github.sha }}" \
+            --arg pusher "${{ github.actor }}" \
+            --arg message "${{ github.event.head_commit.message }}" \
+            '{
+              event_type: "docs_update",
+              client_payload: {
+                repository: $repo,
+                ref: $ref,
+                sha: $sha,
+                pusher: $pusher,
+                commit_message: $message
+              }
+            }')
+
+          response=$(curl -X POST \
+            -H "Accept: application/vnd.github.v3+json" \
+            -H "Authorization: token ${{ secrets.DOCS_DEPLOY_TOKEN }}" \
+            -w "\n%{http_code}" \
+            https://api.github.com/repos/soliplex/soliplex.github.io/dispatches \
+            -d "$payload")
+
+          http_code=$(echo "$response" | tail -n1)
+
+          if [ "$http_code" -eq 204 ]; then
+            echo "✅ Successfully triggered documentation rebuild"
+            echo "🔗 View workflow at: https://github.com/soliplex/soliplex.github.io/actions"
+          else
+            echo "❌ Failed to trigger documentation rebuild (HTTP $http_code)"
+            echo "$response"
+            exit 1
+          fi
+
+      - name: Notify on failure
+        if: failure()
+        run: |
+          echo "::warning::Failed to trigger documentation rebuild. Check DOCS_DEPLOY_TOKEN secret."