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

Author: sapphi-red

.github/renovate.json5

@@ -32,6 +32,15 @@
     // breaking changes
     "kill-port", // `kill-port:^2.0.0 has perf issues (#8392)
   ],
+  "github-actions": {
+    "fileMatch": [
+      // default values
+      "(^|/)(workflow-templates|\\.(?:github|gitea|forgejo)/(?:workflows|actions))/.+\\.ya?ml$",
+      "(^|/)action\\.ya?ml$",
+      // custom value
+      "(^|/)docs/guide/static-deploy-github-pages\\.yaml$",
+    ],
+  },
   "customManagers": [
     {
       "customType": "regex",

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

@@ -0,0 +1,56 @@
+# Imported in static-deploy.md
+# This file is extracted as a separate file so that renovate can update the action versions
+#
+#region content
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy static content to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ['main']
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets the GITHUB_TOKEN permissions to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: 'pages'
+  cancel-in-progress: true
+
+jobs:
+  # Single deploy job since we're just deploying
+  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 dist folder
+          path: './dist'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+#endregion content

docs/guide/static-deploy.md

@@ -63,59 +63,7 @@ Now the `preview` command will launch the server at `http://localhost:8080`.
 
 2. Go to your GitHub Pages configuration in the repository settings page and choose the source of deployment as "GitHub Actions", this will lead you to create a workflow that builds and deploys your project, a sample workflow that installs dependencies and builds using npm is provided:
 
-   ```yml
-   # Simple workflow for deploying static content to GitHub Pages
-   name: Deploy static content to Pages
-
-   on:
-     # Runs on pushes targeting the default branch
-     push:
-       branches: ['main']
-
-     # Allows you to run this workflow manually from the Actions tab
-     workflow_dispatch:
-
-   # Sets the GITHUB_TOKEN permissions to allow deployment to GitHub Pages
-   permissions:
-     contents: read
-     pages: write
-     id-token: write
-
-   # Allow one concurrent deployment
-   concurrency:
-     group: 'pages'
-     cancel-in-progress: true
-
-   jobs:
-     # Single deploy job since we're just deploying
-     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 dist folder
-             path: './dist'
-         - name: Deploy to GitHub Pages
-           id: deployment
-           uses: actions/deploy-pages@v4
-   ```
+   <<< ./static-deploy-github-pages.yaml#content
 
 ## GitLab Pages and GitLab CI