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