fix(docs): resolve Git Pages compatibility issues after Jekyll migration

- Add `layout: home` to en/zh index pages so VitePress renders them
  with the homepage layout instead of the doc layout (sidebar + TOC)
- Define 6 missing CSS classes (.home-shell, .home-hero-grid, etc.)
  used by homepage HTML but never declared in style.css
- Fix button contrast: brand buttons now use solid #76B900 + white
  text instead of dark gradient + black text; alt/outline buttons
  use #5A8F00 for WCAG AA compliance
- Replace window.location.href with VitePress router.go() for SPA
  navigation and remove hardcoded /sgemm-optimization/ base path
- Use actions/configure-pages@v5 to dynamically resolve base path
  in GitHub Actions instead of hardcoding it
- Delete stale Jekyll files at repo root (index.md, zh/docs/, zh/)

Author: LessUp

.github/workflows/pages.yml

@@ -41,10 +41,27 @@ jobs:
         working-directory: docs
         run: npm ci
 
+      - name: Configure GitHub Pages
+        id: pages
+        uses: actions/configure-pages@v5
+
+      - name: Set VitePress base
+        shell: bash
+        env:
+          BASE_PATH: ${{ steps.pages.outputs.base_path }}
+        run: |
+          set -euo pipefail
+          if [[ -z "${BASE_PATH}" ]]; then
+            base="/"
+          else
+            base="${BASE_PATH%/}/"
+          fi
+          echo "VITEPRESS_BASE=${base}" >> "$GITHUB_ENV"
+
       - name: Build with VitePress
         working-directory: docs
         env:
-          VITEPRESS_BASE: /sgemm-optimization/
+          VITEPRESS_BASE: ${{ env.VITEPRESS_BASE }}
         run: npm run build
 
       - name: Add .nojekyll

docs/.vitepress/theme/style.css

@@ -142,20 +142,20 @@
 }
 
 .VPHero .VPButton.medium.brand {
-  background: linear-gradient(135deg, #76B900, #5A8F00);
+  background: #76B900;
   border: none;
-  color: #000;
+  color: #fff;
 }
 
 .VPHero .VPButton.medium.brand:hover {
-  background: linear-gradient(135deg, #8FD917, #76B900);
+  background: #8FD917;
   box-shadow: 0 4px 12px rgba(118, 185, 0, 0.3);
 }
 
 .VPHero .VPButton.medium.alt {
-  border: 2px solid #76B900;
+  border: 2px solid #5A8F00;
   background: transparent;
-  color: #76B900;
+  color: #5A8F00;
 }
 
 .VPHero .VPButton.medium.alt:hover {
@@ -448,6 +448,57 @@ div[class*='language-'] {
 
 /* === Homepage Custom Components === */
 
+/* Homepage Layout Shell */
+.home-shell {
+  max-width: 1152px;
+  margin: 0 auto;
+  padding: calc(var(--vp-nav-height) + 48px) var(--spacing-lg) 48px;
+}
+
+.home-hero-grid {
+  display: grid;
+  grid-template-columns: 1fr 320px;
+  gap: var(--spacing-2xl);
+  align-items: start;
+}
+
+.home-eyebrow {
+  font-size: 0.78rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  color: #76B900;
+  margin-bottom: var(--spacing-md);
+}
+
+.home-main-title {
+  font-size: 2.8rem;
+  font-weight: 800;
+  line-height: 1.1;
+  letter-spacing: -1px;
+  color: var(--vp-c-text-1);
+  margin: 0 0 var(--spacing-lg);
+  background: linear-gradient(135deg, #76B900, #00D4AA);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+.home-main-subtitle {
+  font-size: 1.05rem;
+  line-height: 1.7;
+  color: var(--vp-c-text-2);
+  margin-bottom: var(--spacing-xl);
+  max-width: 560px;
+}
+
+.home-action-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--spacing-sm);
+  margin-bottom: var(--spacing-lg);
+}
+
 /* Performance Cards Grid */
 .perf-grid {
   display: grid;
@@ -586,8 +637,8 @@ div[class*='language-'] {
 .btn {
   display: inline-block;
   padding: 0.75rem 1.5rem;
-  background: linear-gradient(135deg, #76B900, #5A8F00);
-  color: #000;
+  background: #76B900;
+  color: #fff;
   font-weight: 600;
   border-radius: var(--radius-md);
   text-decoration: none;
@@ -599,18 +650,18 @@ div[class*='language-'] {
 .btn:hover {
   transform: translateY(-1px);
   box-shadow: 0 4px 12px rgba(118, 185, 0, 0.3);
-  color: #000;
+  color: #fff;
 }
 
 .btn-outline {
   background: transparent;
   border: 2px solid #76B900;
-  color: #76B900;
+  color: #5A8F00;
 }
 
 .btn-outline:hover {
   background: #76B900;
-  color: #000;
+  color: #fff;
 }
 
 /* === Responsive Design === */
@@ -642,6 +693,18 @@ div[class*='language-'] {
   .knowledge-grid {
     grid-template-columns: 1fr;
   }
+
+  .home-hero-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .home-main-title {
+    font-size: 2rem;
+  }
+
+  .home-main-subtitle {
+    font-size: 0.95rem;
+  }
 }
 
 @media (max-width: 640px) {
@@ -657,4 +720,16 @@ div[class*='language-'] {
   .VPFeatures .VPFeature {
     padding: var(--spacing-lg);
   }
+
+  .home-shell {
+    padding: calc(var(--vp-nav-height) + 24px) var(--spacing-md) 24px;
+  }
+
+  .home-main-title {
+    font-size: 1.6rem;
+  }
+
+  .signal-grid {
+    grid-template-columns: 1fr;
+  }
 }

docs/en/index.md

@@ -1,4 +1,5 @@
 ---
+layout: home
 title: SGEMM Optimization
 ---
 

docs/index.md

@@ -1,25 +1,34 @@
 ---
 layout: home
+hero:
+  name: SGEMM Optimization
+  text: ' '
+  actions:
+    - theme: brand
+      text: English
+      link: /en/
+    - theme: alt
+      text: 简体中文
+      link: /zh/
 ---
 
 <script setup>
 import { onMounted } from 'vue'
+import { useRouter } from 'vitepress'
 
 onMounted(() => {
-  // Auto-detect language and redirect
+  const router = useRouter()
   const savedLang = localStorage.getItem('vitepress-locale')
   const browserLang = navigator.language.toLowerCase()
-  
-  if (savedLang) {
-    window.location.href = savedLang === 'zh' ? '/sgemm-optimization/zh/' : '/sgemm-optimization/en/'
+
+  if (savedLang === 'zh') {
+    router.go('/zh/')
+  } else if (savedLang === 'en') {
+    router.go('/en/')
   } else if (browserLang.startsWith('zh')) {
-    window.location.href = '/sgemm-optimization/zh/'
+    router.go('/zh/')
   } else {
-    window.location.href = '/sgemm-optimization/en/'
+    router.go('/en/')
   }
 })
 </script>
-
-# SGEMM Optimization
-
-Redirecting to your preferred language...

docs/zh/index.md

@@ -1,4 +1,5 @@
 ---
+layout: home
 title: SGEMM 优化
 ---