Docs 2.0 (gardener#677)

* feat: add vitepress in a parallel solution to build and serve documentation

* fix: base path

* fix: add missing code block

* feat: add post-processing for youtube element

* fix: img tag

* feat: add blog index.md

* feat: fix path

* feat: fix path

* chore: cleanup

* feat: handle numeric titles in blog folders and remove _index entries

* fix: reduced greediness in title generation

* chore: refactored sidebar

* feat: add post processing for hugo alerts

* style: Improve look and feel of persona filter

* style: Adjust bottom padding of level 0 sidebar item

* chore: add persona test

* feat: add second post processing step to Dockerfile.dev

* feat: Include index files as folder links in sidebar

* feat: Include index files as folder links in community sidebar

* feat: improve sidebar generation

* chore: refactored dir structure

* fix: content check for make file

* feat: add GitHub workflow

* fix: race condition

* fix: exclusion

* feat: remove flatten single dirs, need to be handed at link level to avoid breaking links

* fix: add dirty fix for prefix on persona filtered sidebar

* feat: add alias for data

* feat: wip

* feat: enhance content for empty index pages

* chore: add a missing post-processing step

* fix: taxonomie

* feat: split security report

* Feat: enable security report

* Feat: enable api html rendering

* fix: taxonomie for nested dirs

* feat: add post-processing for docs/other-components/etcd-druid/

* fix: blog overview

* fix: taxonomie for nested dirs

* feat: improved footer

* chore: remove dead code

* chore: remove dead code

* feat: remove outline from adapoters

* fix: non persona sidebar

* feat: improve history handling

* feat: fixed white outline

* feat: fixed white outline

* feat: enable dedicated logos for darktheme

* fix: syntax error

* fix: logos

* chore: color alicloud logo

* fix: Use correct links in footer

* feat: improve sidebar

* fix: only apply persona sidebar to docs sections

* style: Refresh GCP and Azure logos

* fix: Restore search functionality

* style: Remove aside on adopters page

* style: Add active match for navbar items

* fix: editlink

* feat: remove prev and next except for blog entries

* chore: Remove community bio page

* feat: add missing title for index pages

* chore: Configure syntax lang alais for golang and code

* fix: excluded files

# Conflicts:
#	.vitepress/config.mts
#	package.json

* feat: enable pages deployment for new branch

* feat: refine title on index page

* feat: add colored social icons

* chore: refine demo button text

* feat: add hover effect to nav icons

* fix: title on landing page

* docs: Remove bio page section from community index

* feat: add dynamic community sidebar

* fix: Call useRoute outside of computed ref

* fix: hover effect on social icons

* chore: adapt references to master branch in prep of merge to master

* chore: remove concourse job

---------

Co-authored-by: Marc Vornetran <[email protected]>

Author: klocke-io

.ci/404.sh

@@ -25,9 +25,7 @@ structure:
         weight: 20
         aliases: ["/docs/guides/security-and-compliance/partial-disa-k8s-stig-shoot/"]
     - file: report.md
-      multiSource:
-      - /website/documentation/security-and-compliance/hardened-shoot-report/hardened_shoots_docu_report.md
-      - /website/documentation/security-and-compliance/hardened-shoot-report/hardened_shoots_report.md   
+      source: /website/documentation/security-and-compliance/hardened-shoot-report/hardened_shoots_docu_report.md
     - file: kubernetes-hardening.md
       source: /website/documentation/security-and-compliance/kubernetes-hardening.md
   - dir: gardener

.ci/build

@@ -18,3 +18,10 @@ structure:
 - dir: html
   structure:
   - file: /website/documentation/security-and-compliance/hardened-shoot-report/hardened_shoots_report.md
+
+- dir: public
+  structure:
+    - fileTree: ../website/public
+    - file: hardend_shoots_report.html
+      source: /website/documentation/security-and-compliance/hardened-shoot-report/hardened_shoots_report.md
+- file: ../website/index.md

.ci/pipeline_definitions

@@ -0,0 +1,22 @@
+# Ignore everything
+*
+
+# Allow only specific directories and files
+!.vitepress/
+!hugo/content/
+!package.json
+!package-lock.json
+!post-processing/**
+!tsconfig.json
+
+# Still ignore any node_modules in the allowed directories
+**/.DS_Store
+**/*.log
+.vitepress/.temp
+.vitepress/.cache
+.vitepress/dist
+
+
+# Ensure .env files are not included
+.env
+.env.*

.docforge/documentation/documentation.yaml

@@ -0,0 +1,77 @@
+name: Deploy VitePress site to Pages
+
+on:
+  # Runs on pushes targeting the `main` branch. Change this to `master` if you're
+  # using the `master` branch as the default branch.
+  push:
+    branches: [master]
+  pull_request:
+    types: [ assigned, opened, synchronize, reopened ]
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Not needed if lastUpdated is not enabled
+      # - uses: pnpm/action-setup@v3 # Uncomment this block if you're using pnpm
+      #   with:
+      #     version: 9 # Not needed if you've set "packageManager" in package.json
+      # - uses: oven-sh/setup-bun@v1 # Uncomment this if you're using Bun
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: npm # or pnpm / yarn
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Docforge
+        run: |
+          wget https://github.com/gardener/docforge/releases/download/v0.55.0/docforge-linux-amd64
+          mv docforge-linux-amd64 docforge
+          chmod +x docforge
+          DOCFORGE_CONFIG=.docforge/config.yaml GITHUB_OAUTH_TOKEN=${{ secrets.GITHUB_TOKEN }} ./docforge
+      - name: Install dependencies
+        run: npm ci # or pnpm install / yarn install / bun install
+      - name: Postprocessing Content
+        run: |
+          npm run post-processing-all
+
+      - name: Build with VitePress
+        run: npm run docs:build # or pnpm docs:build / yarn docs:build / bun run docs:build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: .vitepress/dist
+        if: github.event_name != 'pull_request' # Skip upload on PRs
+
+  # Deployment job
+  deploy:
+    if: github.event_name != 'pull_request' # Skip deployment on PRs
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    name: Deploy
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4