Upgrade VitePress to 1.6.4 and modernize build pipeline (#44)

* Add .worktrees to .gitignore

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Upgrade VitePress from beta to 1.6.4 and modernize build pipeline

- Upgrade vitepress from 1.0.0-beta.1 to 1.6.4
- Move vitepress to devDependencies, add "type": "module" for ESM
- Switch from Yarn to npm
- Replace deprecated "serve" script with "preview"
- Remove duplicate docs:* scripts
- Rewrite GitHub Actions to use official deploy-pages action
- Add .nvmrc for Node.js 20
- Fix .gitignore comment (vuepress → vitepress)
- Add Portainer (GUI) page to sidebar

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: MilesChou

.github/workflows/deploy.yml

@@ -1,23 +1,51 @@
-name: Deploy
+name: Deploy VitePress site to Pages
 
 on:
   push:
-    branches:
-      - master
+    branches: [master]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
 
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup Node
+        uses: actions/setup-node@v4
         with:
-          submodules: true
+          node-version: 20
+          cache: npm
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+      - name: Install dependencies
+        run: npm ci
+      - name: Build with VitePress
+        run: npm run build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: .vitepress/dist
 
-      - name: vuepress-deploy
-        uses: jenkey2011/vuepress-deploy@v1.8.1
-        env:
-          ACCESS_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TARGET_BRANCH: gh-pages
-          BUILD_SCRIPT: yarn && yarn build
-          BUILD_DIR: .vitepress/dist/
+  deploy:
+    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

.gitignore

@@ -30,7 +30,10 @@ Desktop.ini
 # Node files
 /node_modules
 
-# vuepress dist files
+# vitepress dist files
 /dist
 .vitepress/dist
-.vitepress/cache
+.vitepress/cache
+
+# Worktrees
+.worktrees

.nvmrc

@@ -0,0 +1 @@
+20

.vitepress/config.ts

@@ -18,6 +18,7 @@ export default defineConfig({
           { text: 'Docker Build', link: '/build' },
           { text: 'Multi-stage Build', link: '/multi-stage-build' },
           { text: 'Optimizing Dockerfile', link: '/optimizing-dockerfile' },
+          { text: 'Portainer (GUI)', link: '/GUI-portainer' },
         ]
       }
     ],