fix: 修复构建错误和链接路径问题

1. 修复了中文侧边栏文件开头的空行问题
2. 修复了 index.md 文件中的导入路径问题（移除 .ts 扩展名）
3. 修复了英文侧边栏中的链接路径问题（添加 /en 前缀）
4. 安装了 markdown-it-mathjax3 依赖以支持数学公式

Author: overtrue

.vitepress/config.mts

@@ -1,14 +1,25 @@
-import { defineConfig } from 'vitepress';
+import { defineConfig, HeadConfig, resolveSiteDataByRoute } from 'vitepress';
+import {
+  groupIconMdPlugin
+} from 'vitepress-plugin-group-icons';
+
+const prod = !!process.env.VITEPRESS_PROD
 
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
   title: 'RustFS',
   description: 'RustFS is a high-performance distributed object storage software built using Rust',
+  rewrites: {
+    'en/:rest*': ':rest*'
+  },
+  lastUpdated: true,
+  cleanUrls: true,
+  metaChunk: true,
   themeConfig: {
     siteTitle: false,
     logo: { src: '/images/logo.svg', height: 24 },
     logoLink: { link: 'https://rustfs.com', target: '_blank' },
-    editLink: { pattern: 'https://github.com/rustfs/docs.rustfs.com/edit/main/docs/:path'},
+    editLink: { pattern: 'https://github.com/rustfs/docs.rustfs.com/edit/main/docs/:path' },
     socialLinks: [
       { icon: 'github', link: 'https://github.com/rustfs/rustfs' },
       { icon: 'twitter', link: 'https://twitter.com/rustfsofficial' },
@@ -66,10 +77,64 @@ export default defineConfig({
   ],
   srcDir: 'docs',
   locales: {
-    root: { label: 'English', link: '/en/', lang: 'en', dir: 'en' },
-    zh: { label: '简体中文', link: '/zh/', lang: 'zh', dir: 'zh' },
+    root: { label: 'English' },
+    zh: { label: '简体中文' },
   },
   sitemap: {
     hostname: 'https://docs.rustfs.com',
   },
+  markdown: {
+    math: true,
+    codeTransformers: [
+      // We use `[!!code` in demo to prevent transformation, here we revert it back.
+      {
+        postprocess(code) {
+          return code.replace(/\[\!\!code/g, '[!code')
+        }
+      }
+    ],
+    config(md) {
+      // TODO: remove when https://github.com/vuejs/vitepress/issues/4431 is fixed
+      const fence = md.renderer.rules.fence!
+      md.renderer.rules.fence = function (tokens, idx, options, env, self) {
+        const { localeIndex = 'root' } = env
+        const codeCopyButtonTitle = (() => {
+          switch (localeIndex) {
+            case 'es':
+              return 'Copiar código'
+            case 'fa':
+              return 'کپی کد'
+            case 'ko':
+              return '코드 복사'
+            case 'pt':
+              return 'Copiar código'
+            case 'ru':
+              return 'Скопировать код'
+            case 'zh':
+              return '复制代码'
+            default:
+              return 'Copy code'
+          }
+        })()
+        return fence(tokens, idx, options, env, self).replace(
+          '<button title="Copy Code" class="copy"></button>',
+          `<button title="${codeCopyButtonTitle}" class="copy"></button>`
+        )
+      }
+      md.use(groupIconMdPlugin)
+    }
+  },
+  transformPageData: prod
+    ? (pageData, ctx) => {
+      const site = resolveSiteDataByRoute(
+        ctx.siteConfig.site,
+        pageData.relativePath
+      )
+      const title = `${pageData.title || site.title} | ${pageData.description || site.description}`
+        ; ((pageData.frontmatter.head ??= []) as HeadConfig[]).push(
+          ['meta', { property: 'og:locale', content: site.lang }],
+          ['meta', { property: 'og:title', content: title }]
+        )
+    }
+    : undefined
 });

docs/config.ts

@@ -3,7 +3,7 @@ import { enSidebar } from './en/sidebar';
 
 export default defineAdditionalConfig({
   lang: 'en-US',
-  description: 'Vite & Vue powered static site generator.',
+  description: 'RustFS - MinIO alternative, high-performance distributed storage',
 
   themeConfig: {
     nav: [
@@ -16,7 +16,7 @@ export default defineAdditionalConfig({
     ],
 
     sidebar: {
-      '/en/': enSidebar,
+      '/': enSidebar,
     },
 
     editLink: {

docs/en/index.md

@@ -4,7 +4,7 @@ sidebar: false
 ---
 
 <script setup>
-import { enSidebar } from './sidebar.ts'
+import { enSidebar } from './sidebar';
 </script>
 
 <Home :sidebar="enSidebar" title="RustFS Documentation" />

docs/en/sidebar.ts

@@ -4,19 +4,19 @@ export const enSidebar = [
     collapsed: true,
     home: true,
     items: [
-      { text: 'What is RustFS', link: '/en/introduction' },
-      { text: 'Architecture', link: '/en/architecture' },
-      { text: 'Comparison with Other Storage', link: '/en/comparison' },
-      { text: 'Open Source License', link: '/en/license' },
+      { text: 'What is RustFS', link: '/introduction' },
+      { text: 'Architecture', link: '/architecture' },
+      { text: 'Comparison with Other Storage', link: '/comparison' },
+      { text: 'Open Source License', link: '/license' },
       {
-        text: 'Core Concepts', link: '/en/concepts/glossary',
+        text: 'Core Concepts', link: '/concepts/glossary',
         items: [
-          { text: 'Glossary', link: '/en/concepts/glossary' },
-          { text: 'Erasure Coding', link: '/en/concepts/erasure-coding' },
-          { text: 'Availability and Resiliency', link: '/en/concepts/availability-and-resiliency' },
-          { text: 'Object Healing and Auto Recovery', link: '/en/concepts/object-healing' },
-          { text: 'Object Scanner', link: '/en/concepts/object-scanner' },
-          { text: 'Usage Limits', link: '/en/concepts/limit' },
+          { text: 'Glossary', link: '/concepts/glossary' },
+          { text: 'Erasure Coding', link: '/concepts/erasure-coding' },
+          { text: 'Availability and Resiliency', link: '/concepts/availability-and-resiliency' },
+          { text: 'Object Healing and Auto Recovery', link: '/concepts/object-healing' },
+          { text: 'Object Scanner', link: '/concepts/object-scanner' },
+          { text: 'Usage Limits', link: '/concepts/limit' },
         ],
       },
     ],
@@ -71,27 +71,27 @@ export const enSidebar = [
     collapsed: true,
     home: true,
     items: [
-      { text: 'Startup Modes', link: '/en/installation/mode/' },
-      { text: 'Hardware Selection', link: '/en/installation/hardware-selection' },
+      { text: 'Startup Modes', link: '/installation/mode/' },
+      { text: 'Hardware Selection', link: '/installation/hardware-selection' },
       {
         text: 'Pre-installation Checks',
-        link: '/en/installation/checklists',
+        link: '/installation/checklists',
         items: [
-          { text: 'Checklists', link: '/en/installation/checklists' },
-          { text: 'Hardware Checklists', link: '/en/installation/hard-checklists' },
-          { text: 'Software Checklists', link: '/en/installation/software-checklists' },
-          { text: 'Network Checklists', link: '/en/installation/network-checklists' },
-          { text: 'Security Checklists', link: '/en/installation/security-checklists' },
+          { text: 'Checklists', link: '/installation/checklists' },
+          { text: 'Hardware Checklists', link: '/installation/hard-checklists' },
+          { text: 'Software Checklists', link: '/installation/software-checklists' },
+          { text: 'Network Checklists', link: '/installation/network-checklists' },
+          { text: 'Security Checklists', link: '/installation/security-checklists' },
         ]
       },
       {
         text: 'Installation Guides',
-        link: '/en/installation/linux',
+        link: '/installation/linux',
         items: [
-          { text: 'Linux Installation', link: '/en/installation/linux' },
-          { text: 'macOS Installation', link: '/en/installation/macos/' },
-          { text: 'Windows Installation', link: '/en/installation/windows/' },
-          { text: 'Docker Installation', link: '/en/installation/docker' },
+          { text: 'Linux Installation', link: '/installation/linux' },
+          { text: 'macOS Installation', link: '/installation/macos/' },
+          { text: 'Windows Installation', link: '/installation/windows/' },
+          { text: 'Docker Installation', link: '/installation/docker' },
         ]
       },
     ]
@@ -101,11 +101,11 @@ export const enSidebar = [
     collapsed: true,
     home: true,
     items: [
-      { text: 'SDK Overview', link: '/en/sdk/' },
-      { text: 'Java SDK', link: '/en/sdk/java' },
-      { text: 'Python SDK', link: '/en/sdk/python' },
-      { text: 'JavaScript SDK', link: '/en/sdk/js' },
-      { text: 'Other SDKs', link: '/en/sdk/other' },
+      { text: 'SDK Overview', link: '/sdk/' },
+      { text: 'Java SDK', link: '/sdk/java' },
+      { text: 'Python SDK', link: '/sdk/python' },
+      { text: 'JavaScript SDK', link: '/sdk/js' },
+      { text: 'Other SDKs', link: '/sdk/other' },
     ]
   }
 ]

docs/index.md

@@ -2,8 +2,8 @@ import { defineAdditionalConfig } from 'vitepress'
 import { zhSidebar } from './sidebar'
 
 export default defineAdditionalConfig({
-  lang: 'zh-CN',
-  description: 'Vite & Vue powered static site generator.',
+  lang: 'zh-Hans',
+  description: 'RustFS - MinIO 国产化替代方案, 高性能分布式存储',
 
   themeConfig: {
     nav: [

docs/zh/config.ts

@@ -4,7 +4,7 @@ sidebar: false
 ---
 
 <script setup>
-import { zhSidebar } from './sidebar.ts'
+import { zhSidebar } from './sidebar';
 </script>
 
 <Home :sidebar="zhSidebar" title="RustFS 文档中心" />

docs/zh/index.md

@@ -1,4 +1,3 @@
-
 export const zhSidebar = [
   {
     text: '介绍',