feat: add withBase support for taxonomy items

Author: klocke-io

.github/workflows/deploy-github-pages.yaml

@@ -42,12 +42,20 @@ jobs:
       - name: Postprocessing Content
         run: |
           npm run post-processing-all
+      - name: Set Base Path
+        id: set-base-path
+        run: |
+          if [ "${{ github.repository }}" != "gardener/documentation" ]; then
+            echo "VITE_PUBLIC_BASE_PATH=/documentation/" >> $GITHUB_ENV
+            echo "Base path set to: /documentation/ (fork deployment)"
+          else
+            echo "VITE_PUBLIC_BASE_PATH=" >> $GITHUB_ENV
+            echo "Base path set to: (empty) (main repo deployment to gardener.cloud)"
+          fi
       - name: Build with VitePress
-        run: npm run docs:build
-        env:
-          # Set base path only for forks. Main repo (gardener/documentation) deploys to gardener.cloud without base path.
-          # Forks deploy to GitHub Pages (username.github.io/documentation/) and need the /documentation/ base path.
-          VITE_PUBLIC_BASE_PATH: ${{ github.repository != 'gardener/documentation' && '/documentation/' || '' }}
+        run: |
+          echo "Building with VITE_PUBLIC_BASE_PATH: '$VITE_PUBLIC_BASE_PATH'"
+          npm run docs:build
       - name: Deploy to gh-pages
         uses: peaceiris/actions-gh-pages@v4
         if: github.event_name != 'pull_request' && github.ref == 'refs/heads/master' || github.event_name != 'pull_request' && github.ref == 'refs/heads/pr-preview' # ToDo adapt before merging to only use master

.vitepress/theme/layouts/EmptyIndexLayout.vue

@@ -8,7 +8,7 @@
 
           <ul v-if="currentDirItems.length > 0">
             <li v-for="item in currentDirItems" :key="getConsistentLink(item.link)">
-              <a @click="taxonomyItemClicked(getConsistentLink(item.link))" :href="getConsistentLink(item.link)">{{ item.text }}</a>
+              <a @click="taxonomyItemClicked(getConsistentLink(item.link))" :href="getConsistentLink(withBase(item.link))">{{ item.text }}</a>
             </li>
           </ul>
 
@@ -23,7 +23,7 @@
 </template>
 
 <script setup>
-import { useData, useRouter } from 'vitepress'
+import {useData, useRouter, withBase} from 'vitepress'
 import { ref, computed, onMounted, nextTick, watch } from 'vue'
 import DefaultTheme from 'vitepress/theme'
 import { data as sidebars } from '@data/sidebar.data'
@@ -181,6 +181,8 @@ const getConsistentLink = (link) => {
   if (consistentLink && !consistentLink.startsWith('/docs')) {
     return '/docs' + (consistentLink.startsWith('/') ? consistentLink : '/' + consistentLink)
   }
+
+
   return consistentLink
 }