docs(static-deploy): extract github workflow file for renovate (#730) (#1051)

Co-authored-by: Rush Ali <s0aPii.ra@googlemail.com>

closes #730 #1051

Author: mstelbrink

.github/renovate.json5

@@ -28,4 +28,13 @@
     // breaking changes
     "kill-port", // `kill-port:^2.0.0 has perf issues (#8392)
   ],
+  "github-actions": {
+    "fileMatch": [
+      // Standardwerte
+      "(^|/)(workflow-templates|\\.(?:github|gitea|forgejo)/(?:workflows|actions))/.+\\.ya?ml$",
+      "(^|/)action\\.ya?ml$",
+      // Benutzerdefinierter Wert
+      "(^|/)docs/guide/static-deploy-github-pages\\.yaml$",
+    ],
+  },
 }

docs/guide/static-deploy-github-pages.yaml

@@ -0,0 +1,56 @@
+# Importiert in static-deploy.md
+# Diese Datei wird als seperate Datei extrahiert, damit Renovate die Aktionsversionen aktualisieren kann
+#
+#Region Inhalt
+# Einfacher Arbeitsablauf zur Bereitstellung von statischem Inhalt auf GitHub Pages
+name: Deploy static content to Pages
+
+on:
+  # Läuft bei Pushes, die auf den Standardzweig abzielen  
+  push:
+    branches: ['main']
+
+  # Ermöglicht Ihnen diesen Workflow manuell vom Aktionstab auszuführen    
+  workflow_dispatch:
+
+# Setzt die GITHUB_TOKEN Berechtigung, um die Bereitstellung auf GitHub Pages zu ermöglichen
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Erlaubt eine gleichzeitige Bereitstellung
+concurrency:
+  group: 'pages'
+  cancel-in-progress: true
+
+jobs:
+  # Einzelner Bereitstellungsauftrag, da wir nur bereitstellen
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: 'npm'
+      - name: Install dependencies
+        run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          # Ordner "dist" hochladen
+          path: './dist'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+#Endregion Inhalt

docs/guide/static-deploy.md

@@ -63,59 +63,7 @@ Jetzt startet der `preview`-Befehl den Server unter `http://localhost:8080`.
 
 2. Gehen Sie zur GitHub Pages-Konfiguration in den Einstellungen des Repository und wählen Sie die Quelle für die Bereitstellung als "GitHub Actions" aus. Dadurch wird ein Workflow erstellt, der Ihr Projekt erstellt und bereitstellt. Ein Beispielworkflow, der Abhängigkeiten installiert und mit npm erstellt, ist bereitgestellt:
 
-   ```yml
-   # Einfacher Workflow zur Bereitstellung von statischem Inhalt auf GitHub Pages
-   name: Statischen Inhalt auf Pages bereitstellen
-
-   on:
-     # Wird bei Pushes auf den Standard-Zweig ausgeführt
-     push:
-       branches: ['main']
-
-     # Ermöglicht das manuelle Ausführen dieses Workflows über das Actions-Tab
-     workflow_dispatch:
-
-   # Setzt die GITHUB_TOKEN-Berechtigungen, um die Bereitstellung auf GitHub Pages zu ermöglichen
-   permissions:
-     contents: read
-     pages: write
-     id-token: write
-
-   # Ermöglicht eine gleichzeitige Bereitstellung
-   concurrency:
-     group: 'pages'
-     cancel-in-progress: true
-
-   jobs:
-     # Einzelne Bereitstellungs-Job, da wir nur bereitstellen
-     deploy:
-       environment:
-         name: github-pages
-         url: ${{ steps.deployment.outputs.page_url }}
-       runs-on: ubuntu-latest
-       steps:
-         - name: Checkout
-           uses: actions/checkout@v4
-         - name: Set up Node
-           uses: actions/setup-node@v4
-           with:
-             node-version: lts/*
-             cache: 'npm'
-         - name: Install dependencies
-           run: npm ci
-         - name: Build
-           run: npm run build
-         - name: Setup Pages
-           uses: actions/configure-pages@v4
-         - name: Upload artifact
-           uses: actions/upload-pages-artifact@v3
-           with:
-             # Upload des dist-Ordners
-             path: './dist'
-         - name: Deploy to GitHub Pages
-           id: deployment
-           uses: actions/deploy-pages@v4
-   ```
+<<< ./static-deploy-github-pages.yaml#content
 
 ## GitLab Pages und GitLab CI