From 591c7a5bde7c50a77481d3d816cb3d8eadeade1e Mon Sep 17 00:00:00 2001
From: luckyasme <807254037@qq.com>
Date: Mon, 17 Mar 2025 18:01:18 +0800
Subject: [PATCH 1/2] =?UTF-8?q?fix:=20=E5=AE=8C=E5=96=84=E9=83=A8=E5=88=86?=
 =?UTF-8?q?=E5=86=85=E5=AE=B9=E7=9A=84=E5=9B=BD=E9=99=85=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/components/DocBreadCrumb.vue          |  4 ++--
 docs/.vitepress/src/components/DocSearch.vue  |  4 +++-
 .../src/components/FloatingButtonDocs.vue     |  8 ++++---
 .../src/components/GiteeViewSource.vue        |  8 ++++---
 docs/.vitepress/src/i18n/common/common-en.ts  |  1 +
 docs/.vitepress/src/i18n/common/common-zh.ts  |  1 +
 docs/.vitepress/src/i18n/docs/docs-en.ts      |  7 +++++-
 docs/.vitepress/src/i18n/docs/docs-zh.ts      |  9 +++++--
 .../src/i18n/feedback/feedback-en.ts          |  3 +++
 .../src/i18n/feedback/feedback-zh.ts          |  3 +++
 docs/.vitepress/src/layouts/LayoutDoc.vue     | 14 +++++------
 .../src/views/docsNode/TheDocsNode.vue        |  2 +-
 .../src/views/search/TheSearchResult.vue      |  4 ++--
 scripts/build.js                              | 24 ++++++++++++-------
 14 files changed, 61 insertions(+), 31 deletions(-)

diff --git a/docs/.vitepress/src/components/DocBreadCrumb.vue b/docs/.vitepress/src/components/DocBreadCrumb.vue
index 0e682f8..cb82e61 100644
--- a/docs/.vitepress/src/components/DocBreadCrumb.vue
+++ b/docs/.vitepress/src/components/DocBreadCrumb.vue
@@ -69,12 +69,12 @@ const goToPage = (href: string) => {
         <OIcon> <IconChevronRight /> </OIcon>
       </template>
       <!-- 文档聚合页 -->
-      <OBreadcrumbItem @click="goToPage(`/${locale}/`)">文档中心</OBreadcrumbItem>
+      <OBreadcrumbItem @click="goToPage(`/${locale}/`)">{{ t('home.docCenter') }}</OBreadcrumbItem>
       <!-- 模块 -->
       <OBreadcrumbItem v-if="!nodeVisible && !isContribute" @click="goToPage(moduleNode.href || '')">{{ moduleNode?.label }}</OBreadcrumbItem>
       <OBreadcrumbItem v-if="nodeVisible && searchStore.isSearching" @click="goToPage(moduleNode.href || '')">{{ moduleNode?.label }}</OBreadcrumbItem>
       <!-- 当前节点 -->
-      <OBreadcrumbItem>{{ searchStore.isSearching ? '搜索结果' : currentTitle }}</OBreadcrumbItem>
+      <OBreadcrumbItem>{{ searchStore.isSearching ? t('docs.searchResult') : currentTitle }}</OBreadcrumbItem>
     </OBreadcrumb>
   </div>
 </template>
diff --git a/docs/.vitepress/src/components/DocSearch.vue b/docs/.vitepress/src/components/DocSearch.vue
index 58944c6..9f18c79 100644
--- a/docs/.vitepress/src/components/DocSearch.vue
+++ b/docs/.vitepress/src/components/DocSearch.vue
@@ -6,6 +6,7 @@ import IconSearch from '~icons/app/icon-search.svg';
 
 import { useSearchingStore } from '@/stores/common';
 import { useScreen } from '@/composables/useScreen';
+import { useLocale } from '@/composables/useLocale';
 
 import type { SearchRecommendT } from '@/@types/type-search';
 import { getSearchRecommend } from '@/api/api-search';
@@ -13,6 +14,7 @@ import { onClickOutside, useDebounceFn } from '@vueuse/core';
 
 const emit = defineEmits(['switchVisible']);
 
+const { t } = useLocale();
 const { size } = useScreen();
 // 搜索状态库
 const searchStore = useSearchingStore();
@@ -96,7 +98,7 @@ onClickOutside(
         :style="{ width: '100%' }"
         v-model="searchValue"
         size="large"
-        placeholder="在本文档内搜索"
+        :placeholder="t('docs.innerInputTip')"
         @keyup.enter="enterSearchDoc"
         @clear="clearSearchDoc"
         clearable
diff --git a/docs/.vitepress/src/components/FloatingButtonDocs.vue b/docs/.vitepress/src/components/FloatingButtonDocs.vue
index 8bff96a..ac4a659 100644
--- a/docs/.vitepress/src/components/FloatingButtonDocs.vue
+++ b/docs/.vitepress/src/components/FloatingButtonDocs.vue
@@ -18,7 +18,9 @@ import { scrollToTop } from '@/utils/common';
 import { useAppearance } from '@/stores/common';
 import { useThrottleFn } from '@vueuse/core';
 import { useScreen } from '@/composables/useScreen';
+import { useLocale } from '@/composables/useLocale';
 
+const { t } = useLocale();
 const { isPhone, gtPhone } = useScreen();
 
 const isDark = computed(() => {
@@ -275,7 +277,7 @@ onUnmounted(() => {
     @change="change"
   >
     <template #header>
-      <div class="title-header">我要评分</div>
+      <div class="title-header">{{ t('feedback.wantSubmitMark') }}</div>
     </template>
     <div class="score-content">
       <div v-for="(item, i) in multiRate" :key="i" class="railway-mb">
@@ -302,9 +304,9 @@ onUnmounted(() => {
       </div>
     </div>
     <div class="btn">
-      <OButton color="normal" variant="text" size="large" @click="cancelScore">取消</OButton>
+      <OButton color="normal" variant="text" size="large" @click="cancelScore">{{ t('feedback.cancel') }}</OButton>
       <ODivider class="divider-btn" direction="v" />
-      <OButton color="normal" variant="text" size="large" :disabled="multiRate.every(item => !item.isChange)" @click="submitScore">确定</OButton>
+      <OButton color="normal" variant="text" size="large" :disabled="multiRate.every(item => !item.isChange)" @click="submitScore">{{ t('feedback.confirmTitle') }}</OButton>
     </div>
   </ODialog>
 </template>
diff --git a/docs/.vitepress/src/components/GiteeViewSource.vue b/docs/.vitepress/src/components/GiteeViewSource.vue
index e2f6733..dff1357 100644
--- a/docs/.vitepress/src/components/GiteeViewSource.vue
+++ b/docs/.vitepress/src/components/GiteeViewSource.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { onMounted, ref, watch } from 'vue';
+import { useRoute } from 'vitepress';
 import { isClient, OIcon } from '@opensig/opendesign';
 
 import IconOutLink from '~icons/app/icon-outlink.svg';
@@ -7,8 +8,9 @@ import IconOutLink from '~icons/app/icon-outlink.svg';
 import { getGiteeUrl } from '@/utils/common';
 
 import { useScreen } from '@/composables/useScreen';
-import { useRoute } from 'vitepress';
+import { useLocale } from '@/composables/useLocale';
 
+const { t } = useLocale();
 const giteeUrl = ref('');
 const route = useRoute();
 
@@ -45,7 +47,7 @@ const insertGiteeBtn = () => {
       a.className = 'gitee';
       a.href = getGiteeUrl();
       a.target = '_blank';
-      a.textContent = '在Gitee上查看源文件';
+      a.textContent = t('docs.viewGiteeSource') || '';
       const svgString = `
         <svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 32 32">
           <path fill="currentColor" d="M14.123 3.2c0.442 0 0.8 0.358 0.8 0.8 0 0.398-0.29 0.728-0.67 0.79l-0.13 0.010h-8.523c-0.398 0-0.728 0.29-0.79 0.67l-0.010 0.13v20.8c0 0.398 0.29 0.728 0.67 0.79l0.13 0.010h20.8c0.398 0 0.728-0.29 0.79-0.67l0.010-0.13v-8.576c0-0.442 0.358-0.8 0.8-0.8 0.398 0 0.728 0.29 0.79 0.67l0.010 0.13v8.576c0 1.259-0.97 2.292-2.203 2.392l-0.197 0.008h-20.8c-1.259 0-2.292-0.97-2.392-2.203l-0.008-0.197v-20.8c0-1.259 0.97-2.292 2.203-2.392l0.197-0.008h8.523z"></path>
@@ -76,7 +78,7 @@ watch(isPhone, () => {
 <template>
   <div class="gitee-view-source">
     <a class="link" :href="giteeUrl" target="_blank" rel="noopener noreferrer">
-      <span class="title">在Gitee上查看源文件</span>
+      <span class="title">{{ t('docs.viewGiteeSource') }}</span>
       <OIcon><IconOutLink /></OIcon>
     </a>
   </div>
diff --git a/docs/.vitepress/src/i18n/common/common-en.ts b/docs/.vitepress/src/i18n/common/common-en.ts
index e038e68..c678af2 100644
--- a/docs/.vitepress/src/i18n/common/common-en.ts
+++ b/docs/.vitepress/src/i18n/common/common-en.ts
@@ -1,4 +1,5 @@
 export default {
+  docCenter: 'Document Center',
   returnHome: 'Back to Homepage',
   empty: 'No data available',
 };
diff --git a/docs/.vitepress/src/i18n/common/common-zh.ts b/docs/.vitepress/src/i18n/common/common-zh.ts
index c52b495..b1f7fcd 100644
--- a/docs/.vitepress/src/i18n/common/common-zh.ts
+++ b/docs/.vitepress/src/i18n/common/common-zh.ts
@@ -1,4 +1,5 @@
 export default {
+  docCenter: '文档中心',
   returnHome: '返回首页',
   empty: '暂无数据',
 };
diff --git a/docs/.vitepress/src/i18n/docs/docs-en.ts b/docs/.vitepress/src/i18n/docs/docs-en.ts
index 28b9e8d..bdef315 100644
--- a/docs/.vitepress/src/i18n/docs/docs-en.ts
+++ b/docs/.vitepress/src/i18n/docs/docs-en.ts
@@ -9,5 +9,10 @@ export default {
   document: 'Document',
   anchorTip: 'Content on This Page',
   innerInputTip: 'Search in this document.',
-  version: 'Document Issue:',
+  version: 'Version: ',
+  version1: 'Version',
+  viewGiteeSource: 'View source on Gitee',
+  confirmTitle: 'Confirm',
+  resetTitle: 'Reset',
+  versionFilter: '版本筛选',
 };
diff --git a/docs/.vitepress/src/i18n/docs/docs-zh.ts b/docs/.vitepress/src/i18n/docs/docs-zh.ts
index a499bec..e5da4ff 100644
--- a/docs/.vitepress/src/i18n/docs/docs-zh.ts
+++ b/docs/.vitepress/src/i18n/docs/docs-zh.ts
@@ -8,6 +8,11 @@ export default {
   copySuccess: '复制成功',
   document: '文档',
   anchorTip: '本页内容',
-  innerInputTip: '在本产品文档内搜索',
-  version: '文档版本：',
+  innerInputTip: '在本文档内搜索',
+  version: '版本：',
+  version1: '版本',
+  viewGiteeSource: '在Gitee上查看源文件',
+  confirmTitle: '确定',
+  resetTitle: '重置',
+  versionFilter: '版本筛选',
 };
diff --git a/docs/.vitepress/src/i18n/feedback/feedback-en.ts b/docs/.vitepress/src/i18n/feedback/feedback-en.ts
index 4a763ec..a153776 100644
--- a/docs/.vitepress/src/i18n/feedback/feedback-en.ts
+++ b/docs/.vitepress/src/i18n/feedback/feedback-en.ts
@@ -26,4 +26,7 @@ export default {
   submitAs: 'Submit As',
   bugType: 'Bug Type',
   bugDescriptionPlaceholder: 'Describe the bug so that we can quickly locate the problem.',
+
+  wantSubmitMark: '我要评分',
+  confirmTitle: 'Confirm',
 };
diff --git a/docs/.vitepress/src/i18n/feedback/feedback-zh.ts b/docs/.vitepress/src/i18n/feedback/feedback-zh.ts
index 3dc37fe..b033e7d 100644
--- a/docs/.vitepress/src/i18n/feedback/feedback-zh.ts
+++ b/docs/.vitepress/src/i18n/feedback/feedback-zh.ts
@@ -26,4 +26,7 @@ export default {
   submitAs: '提交类型',
   bugType: '问题类型',
   bugDescriptionPlaceholder: '点击输入详细问题描述，以帮助我们快速定位问题',
+
+  wantSubmitMark: '我要评分',
+  confirmTitle: '确定',
 };
diff --git a/docs/.vitepress/src/layouts/LayoutDoc.vue b/docs/.vitepress/src/layouts/LayoutDoc.vue
index 314909f..8512c90 100644
--- a/docs/.vitepress/src/layouts/LayoutDoc.vue
+++ b/docs/.vitepress/src/layouts/LayoutDoc.vue
@@ -382,7 +382,7 @@ onUnmounted(() => {
       <p class="doc-type">{{ moduleNode?.label }}</p>
       <ODropdown v-if="!isContribute" trigger="hover" optionPosition="bl">
         <div class="version-wrap hover-icon-rotate">
-          <span class="version-title">版本：</span>
+          <span class="version-title">{{ t('docs.version') }}</span>
           <span class="version-text">{{ version }}</span>
           <OIcon class="icon"><IconChevronDown /></OIcon>
         </div>
@@ -420,7 +420,7 @@ onUnmounted(() => {
           <p class="text">{{ moduleNode?.label }}</p>
         </div>
         <div v-if="!isContribute" class="version-wrap" @click="versionVisible = true">
-          <span class="version-title">版本：</span>
+          <span class="version-title">{{ t('docs.version') }}</span>
           <span class="version-text">{{ version }}</span>
           <OIcon class="icon"><IconChevronDown /></OIcon>
         </div>
@@ -475,7 +475,7 @@ onUnmounted(() => {
           class="select-feedback-placeholder"
         ></div>
       </template>
-      <ODropdownItem @click="docBugVisible = true"> 文档捉虫 </ODropdownItem>
+      <ODropdownItem @click="docBugVisible = true"> {{ t('feedback.bugCatching') }} </ODropdownItem>
     </OPopup>
 
     <!-- 文档捉虫弹窗 -->
@@ -485,11 +485,11 @@ onUnmounted(() => {
     <ODialog :visible="versionVisible" :phone-half-full="true" @change="change" class="docs-version-dialog">
       <template #header>
         <div class="title-header">
-          <p class="title">版本筛选</p>
+          <p class="title">{{ t('docs.versionFilter') }}</p>
         </div>
       </template>
       <div>
-        <p class="version-title-mb">版本</p>
+        <p class="version-title-mb">{{ t('docs.version1') }}</p>
         <ORadioGroup class="filter-options" v-model="radioVersionValue" :style="{ gap: '8px' }">
           <ORadio v-for="option in versions" :key="option.version" :value="option.version">
             <template #radio="{ checked }">
@@ -505,9 +505,9 @@ onUnmounted(() => {
         </ORadioGroup>
       </div>
       <div class="btn">
-        <OButton color="normal" variant="text" size="large" @click="resetVersion">重置</OButton>
+        <OButton color="normal" variant="text" size="large" @click="resetVersion">{{ t('docs.resetTitle') }}</OButton>
         <ODivider class="divider-btn" direction="v" />
-        <OButton color="normal" variant="text" size="large" @click="confirmVersion">确定</OButton>
+        <OButton color="normal" variant="text" size="large" @click="confirmVersion">{{ t('docs.confirmTitle') }}</OButton>
       </div>
     </ODialog>
   </div>
diff --git a/docs/.vitepress/src/views/docsNode/TheDocsNode.vue b/docs/.vitepress/src/views/docsNode/TheDocsNode.vue
index 14fb6fe..c350ca6 100644
--- a/docs/.vitepress/src/views/docsNode/TheDocsNode.vue
+++ b/docs/.vitepress/src/views/docsNode/TheDocsNode.vue
@@ -7,7 +7,7 @@ import { type PropType } from 'vue';
 
 import { useScreen } from '@/composables/useScreen';
 
-const { isLaptop, isPad, isPhone } = useScreen();
+const { isLaptop, isPhone } = useScreen();
 
 const props = defineProps({
   // 文档模块节点
diff --git a/docs/.vitepress/src/views/search/TheSearchResult.vue b/docs/.vitepress/src/views/search/TheSearchResult.vue
index 091d6a0..a500a9e 100644
--- a/docs/.vitepress/src/views/search/TheSearchResult.vue
+++ b/docs/.vitepress/src/views/search/TheSearchResult.vue
@@ -185,14 +185,14 @@ const goToPage = (href: string) => {
                 <template #separator>
                   <OIcon> <IconChevronRight /> </OIcon>
                 </template>
-                <OBreadcrumbItem @click="goToPage(`/${locale}/`)">文档中心</OBreadcrumbItem>
+                <OBreadcrumbItem @click="goToPage(`/${locale}/`)">{{ t('common.docCenter') }}</OBreadcrumbItem>
                 <!-- 模块 -->
                 <OBreadcrumbItem @click="goToPage(moduleNode.href as string)">{{ moduleNode.label }}</OBreadcrumbItem>
                 <OBreadcrumbItem v-for="node in item.sourceData" :key="node.id">{{ node.label }}</OBreadcrumbItem>
               </OBreadcrumb>
             </div>
             <div>
-              <span class="source-tip">版本：{{ item.version }}</span>
+              <span class="source-tip">{{ t('docs.version') }}{{ item.version }}</span>
             </div>
           </div>
         </div>
diff --git a/scripts/build.js b/scripts/build.js
index 5330dba..fe75614 100644
--- a/scripts/build.js
+++ b/scripts/build.js
@@ -266,7 +266,7 @@ async function mergeReferences(filePath) {
     }
 
     const currenDirName = path.dirname(filePath);
-    
+
     if (frontmatter.href) {
       // 处理当前文件的 href 字段
       frontmatter.href = frontmatter.href.startsWith('http')
@@ -323,20 +323,26 @@ overview: true
  * 处理文件
  */
 async function processMenuFile() {
-  const menuFilePath = path.join(__dirname, './docs/zh/_menu.md');
-  const outputPath = path.join(__dirname, './docs/.vitepress/public/menu/menu.json');
-
+  // 中文
+  const menuFileZhPath = path.join(__dirname, './docs/zh/_menu.md');
+  const outputZhPath = path.join(__dirname, './docs/.vitepress/public/menu/menu.json');
   createOverviewIndexMd(path.join(__dirname, './docs/zh'));
   createOverviewIndexMd(path.join(__dirname, './docs/zh/Tools'));
+  const updatedZhContent = await mergeReferences(menuFileZhPath);
+  fs.outputFileSync(outputZhPath, JSON.stringify(updatedZhContent.children, null, 2));
+
+  // 英文
+  const menuFileEnPath = path.join(__dirname, './docs/en/_menu.md');
+  const outputEnPath = path.join(__dirname, './docs/.vitepress/public/menu/menu-en.json');
+  createOverviewIndexMd(path.join(__dirname, './docs/en'));
+  createOverviewIndexMd(path.join(__dirname, './docs/en/Tools'));
+  const updatedEnContent = await mergeReferences(menuFileEnPath);
+  fs.outputFileSync(outputEnPath, JSON.stringify(updatedEnContent.children, null, 2));
 
-  const updatedContent = await mergeReferences(menuFilePath);
   if (errors.length > 0) {
     console.table(errors);
-    throw new Error('构建失败~请查看表格输出原因');
   }
-
-  fs.outputFileSync(outputPath, JSON.stringify(updatedContent.children, null, 2));
 }
 
 // 执行处理
-processMenuFile();
\ No newline at end of file
+processMenuFile();
-- 
Gitee


From 249f437ded4c6d2a3414d6af7cd90fcd547ffd48 Mon Sep 17 00:00:00 2001
From: luckyasme <807254037@qq.com>
Date: Mon, 17 Mar 2025 19:10:19 +0800
Subject: [PATCH 2/2] =?UTF-8?q?fix:=20=E4=BF=AE=E6=94=B9=E6=9E=84=E5=BB=BA?=
 =?UTF-8?q?=E8=84=9A=E6=9C=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/components/markdown/MarkdownTitle.vue |  4 +++
 scripts/build.js                              | 26 ++++++++++++-------
 2 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/docs/.vitepress/src/components/markdown/MarkdownTitle.vue b/docs/.vitepress/src/components/markdown/MarkdownTitle.vue
index 64d8dcc..9d986c4 100644
--- a/docs/.vitepress/src/components/markdown/MarkdownTitle.vue
+++ b/docs/.vitepress/src/components/markdown/MarkdownTitle.vue
@@ -118,6 +118,10 @@ const onClickCopyLink = (e: MouseEvent) => {
   .link {
     display: inline-flex;
     align-self: center;
+
+    @include hover {
+      color: var(--o-color-primary1);
+    }
   }
 
   .copy-link {
diff --git a/scripts/build.js b/scripts/build.js
index fe75614..9f128be 100644
--- a/scripts/build.js
+++ b/scripts/build.js
@@ -310,13 +310,21 @@ title
 overview: true
 ---`;
 
-  fs.readdirSync(targetPath).forEach((item) => {
-    if (item !== 'Tools' && fs.statSync(path.join(targetPath, item)).isDirectory() && fs.existsSync(path.join(targetPath, item, '_menu.md'))) {
-      const content = fs.readFileSync(path.join(targetPath, item, '_menu.md'), 'utf-8');
-      const { data: frontmatter } = matter(content);
-      fs.outputFileSync(path.join(targetPath, item, 'index.md'), indexMdContent.replace('title', `title: ${frontmatter.label}`));
-    }
-  });
+  try {
+    fs.readdirSync(targetPath).forEach((item) => {
+      if (item !== 'Tools' && fs.statSync(path.join(targetPath, item)).isDirectory() && fs.existsSync(path.join(targetPath, item, '_menu.md'))) {
+        const content = fs.readFileSync(path.join(targetPath, item, '_menu.md'), 'utf-8');
+        const { data: frontmatter } = matter(content);
+        fs.outputFileSync(path.join(targetPath, item, 'index.md'), indexMdContent.replace('title', `title: ${frontmatter.label}`));
+      }
+    });
+  } catch(err) {
+    errors.push({
+      file: targetPath.replace(__dirname, '').replace(/\\/g, '/'),
+      error: '构建异常 (Build Exception: createOverviewIndexMd)',
+      message: err.message,
+    });
+  }
 }
 
 /**
@@ -329,7 +337,7 @@ async function processMenuFile() {
   createOverviewIndexMd(path.join(__dirname, './docs/zh'));
   createOverviewIndexMd(path.join(__dirname, './docs/zh/Tools'));
   const updatedZhContent = await mergeReferences(menuFileZhPath);
-  fs.outputFileSync(outputZhPath, JSON.stringify(updatedZhContent.children, null, 2));
+  fs.outputFileSync(outputZhPath, JSON.stringify(updatedZhContent?.children || [], null, 2));
 
   // 英文
   const menuFileEnPath = path.join(__dirname, './docs/en/_menu.md');
@@ -337,7 +345,7 @@ async function processMenuFile() {
   createOverviewIndexMd(path.join(__dirname, './docs/en'));
   createOverviewIndexMd(path.join(__dirname, './docs/en/Tools'));
   const updatedEnContent = await mergeReferences(menuFileEnPath);
-  fs.outputFileSync(outputEnPath, JSON.stringify(updatedEnContent.children, null, 2));
+  fs.outputFileSync(outputEnPath, JSON.stringify(updatedEnContent?.children || [], null, 2));
 
   if (errors.length > 0) {
     console.table(errors);
-- 
Gitee