Merge pull request 'james-patch-1' (#1) from james-patch-1 into main

Reviewed-on: #1

.vitepress/config.mjs

@@ -1,211 +1,219 @@
 import { defineConfig } from 'vitepress'
+import { withMermaid } from 'vitepress-plugin-mermaid'
+import mathjax3 from 'markdown-it-mathjax3'
 
-export default defineConfig({
-  title: 'HF-MES v5.0 使用手册',
-  description: 'HF-MES v5.0 制造执行系统完整使用指南',
-  lang: 'zh-CN',
-  themeConfig: {
-    logo: '/logo.svg',
-    siteTitle: 'HF-MES v5.0 使用手册',
+export default withMermaid(
+  defineConfig({
+    title: 'HF-MES v5.0 使用手册',
+    description: 'HF-MES v5.0 制造执行系统完整使用指南',
+    lang: 'zh-CN',
+    themeConfig: {
+      logo: '/logo.svg',
+      siteTitle: 'HF-MES v5.0 使用手册',
 
-    nav: [
-      { text: '首页', link: '/' },
-      {
-        text: '文档说明',
-        items: [
-          { text: '文档说明', link: '/guide/document-guide' },
-          { text: '系统概述', link: '/guide/system-overview' }
-        ]
-      },
-      {
-        text: '快速入门',
-        items: [
-          { text: '快速入门', link: '/getting-started/quick-start' }
-        ]
-      },
-      {
-        text: '基础配置',
-        items: [
-          { text: '基础数据管理', link: '/basic/data-management' },
-          { text: '设备管理', link: '/basic/equipment' }
-        ]
-      },
-      {
-        text: '业务模块',
-        items: [
-          { text: '生产管理', link: '/business/production' },
-          { text: '质量管理', link: '/business/quality' },
-          { text: '仓储物流', link: '/business/warehouse' },
-          { text: '设备仓储', link: '/business/equipment-warehouse' }
-        ]
-      },
-      {
-        text: '数据集成',
-        items: [
-          { text: '数据与集成', link: '/integration/data-integration' }
-        ]
-      },
-      {
-        text: '报表分析',
-        items: [
-          { text: '报表与分析', link: '/analysis/reports' }
-        ]
-      },
-      {
-        text: '系统运维',
-        items: [
-          { text: '系统运维', link: '/operation/system-operation' },
-          { text: '技术支持', link: '/operation/technical-support' }
-        ]
-      },
-      {
-        text: '附录',
-        items: [
-          { text: '术语表', link: '/appendix/glossary' }
-        ]
-      }
-    ],
-
-    sidebar: {
-      '/guide/': [
+      nav: [
+        { text: '首页', link: '/' },
         {
-          text: '文档管理篇',
+          text: '文档说明',
           items: [
-            { text: '文档说明', link: '/guide/document-guide' }
+            { text: '文档说明', link: '/guide/document-guide' },
+            { text: '系统概述', link: '/guide/system-overview' }
           ]
         },
         {
-          text: '系统认知篇',
-          items: [
-            { text: '系统概述', link: '/guide/system-overview' }
-          ]
-        }
-      ],
-      '/getting-started/': [
-        {
-          text: '快速入门篇',
+          text: '快速入门',
           items: [
             { text: '快速入门', link: '/getting-started/quick-start' }
           ]
-        }
-      ],
-      '/basic/': [
+        },
         {
-          text: '基础配置篇',
+          text: '基础配置',
           items: [
             { text: '基础数据管理', link: '/basic/data-management' },
-            { text: '设备基础信息', link: '/basic/equipment' }
-          ]
-        }
-      ],
-      '/business/': [
-        {
-          text: '生产管理篇',
-          items: [
-            { text: '生产管理', link: '/business/production' }
+            { text: '设备管理', link: '/basic/equipment' }
           ]
         },
         {
-          text: '质量管理篇',
+          text: '业务模块',
           items: [
-            { text: '质量与追溯', link: '/business/quality' }
+            { text: '生产管理', link: '/business/production' },
+            { text: '质量管理', link: '/business/quality' },
+            { text: '仓储物流', link: '/business/warehouse' },
+            { text: '设备仓储', link: '/business/equipment-warehouse' }
           ]
         },
         {
-          text: '仓储物流篇',
-          items: [
-            { text: '设备与仓储', link: '/business/equipment-warehouse' }
-          ]
-        }
-      ],
-      '/integration/': [
-        {
-          text: '数据集成篇',
+          text: '数据集成',
           items: [
             { text: '数据与集成', link: '/integration/data-integration' }
           ]
-        }
-      ],
-      '/analysis/': [
+        },
         {
-          text: '报表分析篇',
+          text: '报表分析',
           items: [
             { text: '报表与分析', link: '/analysis/reports' }
           ]
-        }
-      ],
-      '/operation/': [
+        },
         {
-          text: '系统运维篇',
+          text: '系统运维',
           items: [
-            { text: '系统运维', link: '/operation/system-operation' }
+            { text: '系统运维', link: '/operation/system-operation' },
+            { text: '技术支持', link: '/operation/technical-support' }
           ]
         },
         {
-          text: '技术支持篇',
-          items: [
-            { text: '异常处理与技术支持', link: '/operation/technical-support' }
-          ]
-        }
-      ],
-      '/appendix/': [
-        {
-          text: '附录篇',
+          text: '附录',
           items: [
             { text: '术语表', link: '/appendix/glossary' }
           ]
         }
-      ]
-    },
+      ],
 
-    socialLinks: [
-      { icon: 'github', link: 'https://github.com/vuejs/vitepress' }
-    ],
+      sidebar: {
+        '/guide/': [
+          {
+            text: '文档管理篇',
+            items: [
+              { text: '文档说明', link: '/guide/document-guide' }
+            ]
+          },
+          {
+            text: '系统认知篇',
+            items: [
+              { text: '系统概述', link: '/guide/system-overview' }
+            ]
+          }
+        ],
+        '/getting-started/': [
+          {
+            text: '快速入门篇',
+            items: [
+              { text: '快速入门', link: '/getting-started/quick-start' }
+            ]
+          }
+        ],
+        '/basic/': [
+          {
+            text: '基础配置篇',
+            items: [
+              { text: '基础数据管理', link: '/basic/data-management' },
+              { text: '设备基础信息', link: '/basic/equipment' }
+            ]
+          }
+        ],
+        '/business/': [
+          {
+            text: '生产管理篇',
+            items: [
+              { text: '生产管理', link: '/business/production' }
+            ]
+          },
+          {
+            text: '质量管理篇',
+            items: [
+              { text: '质量与追溯', link: '/business/quality' }
+            ]
+          },
+          {
+            text: '仓储物流篇',
+            items: [
+              { text: '设备与仓储', link: '/business/equipment-warehouse' }
+            ]
+          }
+        ],
+        '/integration/': [
+          {
+            text: '数据集成篇',
+            items: [
+              { text: '数据与集成', link: '/integration/data-integration' }
+            ]
+          }
+        ],
+        '/analysis/': [
+          {
+            text: '报表分析篇',
+            items: [
+              { text: '报表与分析', link: '/analysis/reports' }
+            ]
+          }
+        ],
+        '/operation/': [
+          {
+            text: '系统运维篇',
+            items: [
+              { text: '系统运维', link: '/operation/system-operation' }
+            ]
+          },
+          {
+            text: '技术支持篇',
+            items: [
+              { text: '异常处理与技术支持', link: '/operation/technical-support' }
+            ]
+          }
+        ],
+        '/appendix/': [
+          {
+            text: '附录篇',
+            items: [
+              { text: '术语表', link: '/appendix/glossary' }
+            ]
+          }
+        ]
+      },
 
-    footer: {
-      message: 'HF-MES v5.0 使用手册',
-      copyright: 'Copyright © 2026 All Rights Reserved'
-    },
+      socialLinks: [
+        { icon: 'github', link: 'https://github.com/vuejs/vitepress' }
+      ],
 
-    search: {
-      provider: 'local'
-    },
+      footer: {
+        message: 'HF-MES v5.0 使用手册',
+        copyright: 'Copyright © 2026 All Rights Reserved'
+      },
 
-    editLink: {
-      pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
-      text: '在 GitHub 上编辑此页'
-    },
+      search: {
+        provider: 'local'
+      },
 
-    lastUpdated: {
-      text: '最后更新于',
-      formatOptions: {
-        dateStyle: 'short',
-        timeStyle: 'short'
+      editLink: {
+        pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
+        text: '在 GitHub 上编辑此页'
+      },
+
+      lastUpdated: {
+        text: '最后更新于',
+        formatOptions: {
+          dateStyle: 'short',
+          timeStyle: 'short'
+        }
+      },
+
+      outline: {
+        level: [2, 3],
+        label: '目录'
+      },
+
+      docFooter: {
+        prev: '← 上一页',
+        next: '下一页 →'
       }
     },
 
-    outline: {
-      level: [2, 3],
-      label: '目录'
+    markdown: {
+      theme: {
+        light: 'github-light',
+        dark: 'github-dark'
+      },
+      lineNumbers: false,
+      config(md) {
+        md.use(mathjax3)
+      }
     },
 
-    docFooter: {
-      prev: '← 上一页',
-      next: '下一页 →'
-    }
-  },
+    head: [
+      ['link', { rel: 'icon', href: '/favicon.ico' }],
+      ['meta', { name: 'author', content: 'HF-MES' }],
+      ['meta', { name: 'viewport', content: 'width=device-width, initial-scale=1.0' }]
+    ]
+  })
 
-  markdown: {
-    theme: {
-      light: 'github-light',
-      dark: 'github-dark'
-    },
-    lineNumbers: false
-  },
-
-  head: [
-    ['link', { rel: 'icon', href: '/favicon.ico' }],
-    ['meta', { name: 'author', content: 'HF-MES' }],
-    ['meta', { name: 'viewport', content: 'width=device-width, initial-scale=1.0' }]
-  ]
-})
+)

.vitepress/theme/index.ts

@@ -1,6 +1,36 @@
 import DefaultTheme from 'vitepress/theme'
+import mediumZoom from 'medium-zoom'
+import { onMounted, watch, nextTick } from 'vue'
+import { useRoute } from 'vitepress'
+
 import './style/print.css'
+import './style/zoom.css'
 
 export default {
   ...DefaultTheme,
-}
+
+  setup() {
+    const route = useRoute()
+
+    const initZoom = () => {
+      mediumZoom('.main img', {
+        background: 'rgba(0,0,0,0.8)'
+      })
+    }
+
+    onMounted(() => {
+      nextTick(() => {
+        initZoom()
+      })
+    })
+
+    watch(
+      () => route.path,
+      () => {
+        nextTick(() => {
+          initZoom()
+        })
+      }
+    )
+  }
+}

.vitepress/theme/style/zoom.css

@@ -0,0 +1,7 @@
+.medium-zoom-overlay {
+  z-index: 9998;
+}
+
+.medium-zoom-image--opened {
+  z-index: 9999;
+}