feat：resolve the missing parent title in the document title (#51)

* feat：resolve the missing parent title in the document title

* feat：modify tinyvue to use document routing

Author: wuyiping0628

.vitepress/config.mts

@@ -224,7 +224,7 @@ export default defineConfig({
             { text: '引入组件', link: 'import-components' },
             { text: '国际化', link: 'i18n' },
             { text: '主题配置', link: 'theme' },
-            { text: '暗黑模式', link: 'theme-dark' },
+            { text: '深色模式', link: 'theme-dark' },
             { text: '智能化', link: 'mcp' },
             { text: '表单校验配置', link: 'form-valid' },
             { text: '常见问题', link: 'faq' }

.vitepress/theme/Layout.vue

@@ -55,41 +55,96 @@ if (typeof window !== 'undefined') {
 // 获取 VitePress 默认布局组件
 const DefaultLayout = DefaultTheme.Layout
 
+// 将文档标题更新逻辑提取为独立函数，便于维护和测试
+const updateDocTitle = () => {
+  const base = site.value?.base || '/'
+  const path = route.path.replace(new RegExp(`^${base}`), '/')
+  const cfg = themeConfig.value || {}
+
+  // next-sdk / tiny-vue: 从对应 sidebar 的 guide 中寻找匹配项
+  if (path.includes('/next-sdk/') || path.includes('/tiny-vue/')) {
+    let sidebarConfig: any[] = []
+    if (path.includes('/next-sdk/')) {
+      sidebarConfig = cfg.sidebar?.['/next-sdk/guide/'] || []
+    } else if (path.includes('/tiny-vue/')) {
+      sidebarConfig = cfg.sidebar?.['/tiny-vue/guide/'] || []
+    }
+
+    if (!sidebarConfig || !sidebarConfig.length) {
+      docTitle.value = '指南'
+      return
+    }
+
+    const pathIndex = sidebarConfig.findIndex((child: any) =>
+      child.items?.some((item: any) => item?.link && path.includes(item.link))
+    )
+
+    docTitle.value = sidebarConfig[pathIndex >= 0 ? pathIndex : 0]?.text || '指南'
+    return
+  }
+
+  // tiny-robot: 从 nav 中匹配 activeMatch
+  if (path.includes('/tiny-robot/')) {
+    const navConfig = cfg.nav || []
+    if (!navConfig.length) {
+      docTitle.value = ''
+      return
+    }
+    const match = navConfig.find((item: any) => item?.activeMatch && path.includes(item.activeMatch))
+    docTitle.value = match?.text || ''
+    return
+  }
+
+  // tiny-engine: 需要先找到对应的 engineNav，然后查 sidebar 的二级或三级项
+  if (path.includes('/tiny-engine/')) {
+    const engineNavConfig = cfg.engineNav || []
+    if (!engineNavConfig.length) {
+      docTitle.value = ''
+      return
+    }
+
+    const activeNav = engineNavConfig.find((item: any) => item?.activeMatch && path.includes(item.activeMatch))
+    const engineSidebarConfig = cfg.sidebar?.[`/tiny-engine${activeNav?.activeMatch}`] || []
+    if (!engineSidebarConfig.length) {
+      docTitle.value = ''
+      return
+    }
+
+    let enginePathkey = 0
+    let engineDeepPathkey: number | null = null
+
+    engineSidebarConfig.forEach((child: any, key: number) => {
+      child.items?.forEach((item: any, deepKey: number) => {
+        if (item?.items?.length) {
+          const foundDeep = item.items.find((deepItem: any) => deepItem?.link && path.includes(deepItem.link))
+          if (foundDeep) {
+            enginePathkey = key
+            engineDeepPathkey = deepKey
+          }
+        } else if (item?.link && path.includes(item.link)) {
+          enginePathkey = key
+        }
+      })
+    })
+
+    if (engineDeepPathkey !== null) {
+      docTitle.value = engineSidebarConfig[enginePathkey].items?.[engineDeepPathkey]?.text || ''
+    } else {
+      docTitle.value = engineSidebarConfig[enginePathkey]?.text || ''
+    }
+
+    return
+  }
+
+  // 默认情况：清空标题
+  docTitle.value = ''
+}
+
+// 监听路由变更，初始化并同步标题
 watch(
   () => route.path,
-  () => {
-      const path = route.path.replace(new RegExp(`^${site.value.base}`), '/')
-      if(path.includes('/next-sdk/')){
-        let pathkey = 0;
-        const sidebarConfig = themeConfig.value.sidebar['/next-sdk/guide/'];
-        if(!sidebarConfig) {
-          docTitle.value = '指南'
-          return;
-        };
-        sidebarConfig.forEach((child,key) => {
-          child.items.forEach(item => {
-            if(path.includes(item.link)){
-              pathkey = key
-            }
-          });
-        });
-        docTitle.value =  sidebarConfig[pathkey]?.text || '指南'
-      }else if(path.includes('/tiny-robot/')){
-        const navConfig = themeConfig.value.nav;
-        if(!navConfig) {
-          docTitle.value = ''
-          return;
-        };
-        navConfig.forEach(item => {
-          if(path.includes(item.activeMatch)){
-            docTitle.value = item.text
-          }
-        });
-      }else{
-        docTitle.value = ''
-      }
-  },
-  { deep: true ,immediate:true},
+  updateDocTitle,
+  { deep: true, immediate: true }
 )
 </script>
 

.vitepress/theme/components/CustomHeader.vue

@@ -321,7 +321,7 @@ const navigationTabs = computed(() => {
     activeProductTab.value === "tiny-vue" &&
     route.path.includes("/tiny-vue/")
   ) {
-    return [{ key: "guide", name: "使用文档", link: "/tiny-vue/guide/" }];
+    return [{ key: "guide", name: "使用文档", link: "/tiny-vue/guide/introduce" }];
   } else {
     let configNav: configNavItem[] = [];
     if (

.vitepress/theme/style.css

@@ -537,6 +537,9 @@ info{
 .vp-doc .custom-block.tip::before {
   content: url("../../public/images/icon-success.svg");
 }
+.vp-doc :not(pre) > code{
+  padding:0 6px;
+}
 
 /* 暗色模式下全局样式 */
 .dark h1{