feat: 介绍-api-新特性-运营规范调整

Author: mengjie0320

docs/.vuepress/config.js

@@ -1,5 +1,6 @@
 // 注意：需要在dev前初始化内网api文档
 const apiConfig = require('../develop/api/config');
+const apiConfig231017 = require('../develop/api-231017/config');
 const nodesdkConfig = require('../develop/nodesdk/config');
 const pythonsdkConfig = require('../develop/pythonsdk/config');
 const gosdkConfig = require('../develop/gosdk/config');
@@ -77,7 +78,7 @@ module.exports = ctx => ({
     [
       'vuepress-plugin-right-anchor',
       {
-        showDepth: 1,
+        showDepth: 6,
         expand: {
           trigger: 'hover',
           clickModeDefaultOpen: true,
@@ -110,6 +111,7 @@ module.exports = ctx => ({
   globalUIComponents: ['TuXiaoChao','Qrcode'],
   theme: require.resolve('./theme-qq'),
   themeConfig: {
+    // sidebarDepth: 0,
     sidebarDepth: 1,
     displayAllHeaders: false,
     lastUpdated: '上次更新',
@@ -118,17 +120,32 @@ module.exports = ctx => ({
         text: '介绍',
         link: '/',
       },
-      // {
-      //   text: 'API文档',
-      //   link: '/develop/api/',
-      // },
-      apiConfig.nav,
+      {
+        text: 'API文档',
+        link: '/develop/api-231017/',
+        items: [
+          apiConfig231017.nav,
+          {
+            text: 'API文档（旧版）',
+            link: '/develop/api/'
+          }
+        ]
+      },
       {
         text: 'SDK文档',
         items: [
-          nodesdkConfig.nav,
-          pythonsdkConfig.nav,
-          gosdkConfig.nav,
+          {
+            text: 'NodeSDK',
+            link: 'https://github.com/tencent-connect/bot-node-sdk',
+          },
+          {
+            text: 'PythonSDK',
+            link: 'https://github.com/tencent-connect/botpy',
+          },
+          {
+            text: 'GoSDK',
+            link: 'https://github.com/tencent-connect/botgo',
+          },
         ],
       },
       {
@@ -158,6 +175,7 @@ module.exports = ctx => ({
     docsBranch: 'main',
     sidebar: {
       // '/develop/api/': convertSummary('./docs/develop/api/SUMMARY-PUBLIC.md', hiddenApi, 1, true),
+      ...apiConfig231017.sidebar,
       ...apiConfig.sidebar,
       ...nodesdkConfig.sidebar,
       ...pythonsdkConfig.sidebar,

docs/.vuepress/enhanceApp.js

@@ -1,14 +1,38 @@
-import Element from 'element-ui';
-import 'element-ui/lib/theme-chalk/index.css';
-const commonConfig = require('./common');
-
-export default ({ Vue, options, router, siteData, isServer }) => {
-  Vue.use(Element);
-  const isProd = process.env.NODE_ENV === 'production';
-  Vue.prototype.$withBotBase = function (path) {
-    if (path.charAt(0) === '/') {
-      path = path.slice(1);
-    }
-    return (isProd ? commonConfig.cdnBase + commonConfig.cdnPath : siteData.base) + path;
-  };
-};
+import Element from 'element-ui';
+import 'element-ui/lib/theme-chalk/index.css';
+const commonConfig = require('./common');
+
+export default ({ Vue, options, router, siteData, isServer }) => {
+  Vue.use(Element);
+  const isProd = process.env.NODE_ENV === 'production';
+  // 中文跳转转码且英文大写转小写（元素的 ID 属性值是小写字母）
+  Vue.mixin({
+    methods: {
+      hashChange () {
+        router.onReady(() => {
+          setTimeout(() => {
+            const { hash } = document.location;
+              if (hash.length > 1) {
+                const id = decodeURIComponent(hash.substring(1)).replace(/[A-Z]/g, (match) => {
+                  return String.fromCharCode(match.charCodeAt(0) + 32)
+                });
+                const element = document.getElementById(id);
+                if (element) element.scrollIntoView();
+              }
+          }, 500);
+        });
+      }
+    },
+    mounted () {
+      this.hashChange();
+      window.addEventListener('hashchange', () => this.hashChange());
+    }
+  });
+
+  Vue.prototype.$withBotBase = function (path) {
+    if (path.charAt(0) === '/') {
+      path = path.slice(1);
+    }
+    return (isProd ? commonConfig.cdnBase + commonConfig.cdnPath : siteData.base) + path;
+  };
+};