From 6b3638c71aea2870170ad2a2bc59fb26b3245e3e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=AD=9F=E5=AE=81?= Date: Sun, 16 Nov 2025 06:29:10 +0000 Subject: [PATCH] =?UTF-8?q?=E9=87=8D=E6=96=B0=E7=BB=84=E7=BB=87=E9=A1=B9?= =?UTF-8?q?=E7=9B=AE=E6=96=87=E4=BB=B6=E7=9B=AE=E5=BD=95=E7=BB=93=E6=9E=84?= =?UTF-8?q?=EF=BC=8C=E5=9C=A8=E4=BB=93=E5=BA=93=E4=B8=AD=E5=8F=AF=E4=BB=A5?= =?UTF-8?q?=E7=9B=B4=E6=8E=A5=E6=9F=A5=E7=9C=8B=E6=96=87=E6=A1=A3=E4=B8=AD?= =?UTF-8?q?=E7=9A=84=E5=9B=BE=E7=89=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .devcontainer/devcontainer.json | 48 ++++---- .../mengningsoftware-docs-ci-cd.yaml | 104 +++++++++--------- .gitignore | 32 +++--- {docs/.vitepress => .vitepress}/config.mts | 57 +++++----- .../.vitepress => .vitepress}/theme/index.js | 0 .../.vitepress => .vitepress}/theme/style.css | 0 Dockerfile | 42 +++---- README.md | 62 +++++------ docs/utils/auto_sidebar.js | 65 ----------- docs/index.md => index.md | 2 +- package.json | 28 ++--- {docs/public => public}/DevStar.png | Bin {docs/public => public}/QR-code.jpg | Bin .../compile/CPU-utilization-16.png | Bin .../compile/CPU-utilization-4.png | Bin .../compile/CPU-utilization-8.png | Bin .../compile/architecture.png | Bin .../cloudbuild-distributed-compilation.png | Bin .../compile/cloudbuild-installation.png | Bin .../compile/compiler-principles.png | Bin .../compile/layered-system-architecture.png | Bin .../promotional-graphic-cloudbuild.jpg | Bin .../compile/system-diagram.png | Bin {docs/public => public}/compile/table1.png | Bin {docs/public => public}/compile/table2.png | Bin {docs/public => public}/devstar-logo.png | Bin .../intellectual-property-images1.png | Bin .../intellectual-property-images2.png | Bin .../intellectual-property-images3.png | Bin .../intellectual-property-images4.png | Bin {docs/public => public}/mengninglogo.png | Bin {docs/public => public}/mengningsoftware.png | Bin {docs/public => public}/mnsoftware.png | Bin .../promotional-graphic-cloudbuild.jpg | Bin .../promotional-graphic-devstar.png | Bin .../promotional-graphic-simulator.jpg | Bin {docs/public => public}/simulator/image-1.png | Bin {docs/public => public}/simulator/image-2.png | Bin {docs/public => public}/simulator/image-3.png | Bin {docs/public => public}/simulator/image.png | Bin {docs/public => public}/slider1.png | Bin {docs => src}/compile/cloudbuild.md | 0 {docs => src}/compile/index.md | 0 {docs => src}/compile/sharebuild.md | 0 .../compile/why-distributed-compiling.md | 0 {docs => src}/copyright/index.md | 0 {docs => src}/devstar/ai-devops.md | 0 {docs => src}/devstar/index.md | 0 .../installation/install-via-shell-script.md | 0 .../devstar/usage/quick-start-with-ai.md | 0 {docs => src}/devstar/快速开始.md | 0 {docs => src}/enterprise/faq.md | 2 +- {docs => src}/enterprise/index.md | 2 +- {docs => src}/index.vue | 8 +- {docs => src}/simulator/index.md | 0 {docs => src}/simulator/vECU.md | 0 {docs => src}/simulator/vehicle-simulator.md | 0 57 files changed, 193 insertions(+), 259 deletions(-) rename {docs/.vitepress => .vitepress}/config.mts (89%) rename {docs/.vitepress => .vitepress}/theme/index.js (100%) rename {docs/.vitepress => .vitepress}/theme/style.css (100%) delete mode 100644 docs/utils/auto_sidebar.js rename docs/index.md => index.md (92%) rename {docs/public => public}/DevStar.png (100%) rename {docs/public => public}/QR-code.jpg (100%) rename {docs/public => public}/compile/CPU-utilization-16.png (100%) rename {docs/public => public}/compile/CPU-utilization-4.png (100%) rename {docs/public => public}/compile/CPU-utilization-8.png (100%) rename {docs/public => public}/compile/architecture.png (100%) rename {docs/public => public}/compile/cloudbuild-distributed-compilation.png (100%) rename {docs/public => public}/compile/cloudbuild-installation.png (100%) rename {docs/public => public}/compile/compiler-principles.png (100%) rename {docs/public => public}/compile/layered-system-architecture.png (100%) rename {docs/public => public}/compile/promotional-graphic-cloudbuild.jpg (100%) rename {docs/public => public}/compile/system-diagram.png (100%) rename {docs/public => public}/compile/table1.png (100%) rename {docs/public => public}/compile/table2.png (100%) rename {docs/public => public}/devstar-logo.png (100%) rename {docs/public => public}/intellectual-property-images1.png (100%) rename {docs/public => public}/intellectual-property-images2.png (100%) rename {docs/public => public}/intellectual-property-images3.png (100%) rename {docs/public => public}/intellectual-property-images4.png (100%) rename {docs/public => public}/mengninglogo.png (100%) rename {docs/public => public}/mengningsoftware.png (100%) rename {docs/public => public}/mnsoftware.png (100%) rename {docs/public => public}/promotional-graphic-cloudbuild.jpg (100%) rename {docs/public => public}/promotional-graphic-devstar.png (100%) rename {docs/public => public}/promotional-graphic-simulator.jpg (100%) rename {docs/public => public}/simulator/image-1.png (100%) rename {docs/public => public}/simulator/image-2.png (100%) rename {docs/public => public}/simulator/image-3.png (100%) rename {docs/public => public}/simulator/image.png (100%) rename {docs/public => public}/slider1.png (100%) rename {docs => src}/compile/cloudbuild.md (100%) rename {docs => src}/compile/index.md (100%) rename {docs => src}/compile/sharebuild.md (100%) rename {docs => src}/compile/why-distributed-compiling.md (100%) rename {docs => src}/copyright/index.md (100%) rename {docs => src}/devstar/ai-devops.md (100%) rename {docs => src}/devstar/index.md (100%) rename {docs => src}/devstar/installation/install-via-shell-script.md (100%) rename {docs => src}/devstar/usage/quick-start-with-ai.md (100%) rename {docs => src}/devstar/快速开始.md (100%) rename {docs => src}/enterprise/faq.md (91%) rename {docs => src}/enterprise/index.md (91%) rename {docs => src}/index.vue (92%) rename {docs => src}/simulator/index.md (100%) rename {docs => src}/simulator/vECU.md (100%) rename {docs => src}/simulator/vehicle-simulator.md (100%) diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json index 091d861..0cc595e 100644 --- a/.devcontainer/devcontainer.json +++ b/.devcontainer/devcontainer.json @@ -1,25 +1,25 @@ -{ - "name": "dev-vitepress", - "image": "node:20-alpine", - - "customizations": { - "vscode": { - "settings": {}, - "extensions": [ - "vue.volar", - "vue.vscode-typescript-vue-plugin", - "bradlc.vscode-tailwindcss", - "esbenp.prettier-vscode" - ] - } - }, - - "portsAttributes": { - "5173": { - "label": "vitepress debug", - "onAutoForward": "notify" - } - }, - "postCreateCommand": "apk add git && npm install && npm add -D vitepress", - "postAttachCommand": "npm run docs:dev" +{ + "name": "dev-vitepress", + "image": "node:20-alpine", + + "customizations": { + "vscode": { + "settings": {}, + "extensions": [ + "vue.volar", + "vue.vscode-typescript-vue-plugin", + "bradlc.vscode-tailwindcss", + "esbenp.prettier-vscode" + ] + } + }, + + "portsAttributes": { + "5173": { + "label": "vitepress debug", + "onAutoForward": "notify" + } + }, + "postCreateCommand": "apk add git && npm install && npm add -D vitepress", + "postAttachCommand": "npm run dev" } \ No newline at end of file diff --git a/.gitea/workflows/mengningsoftware-docs-ci-cd.yaml b/.gitea/workflows/mengningsoftware-docs-ci-cd.yaml index 120f633..f79a529 100644 --- a/.gitea/workflows/mengningsoftware-docs-ci-cd.yaml +++ b/.gitea/workflows/mengningsoftware-docs-ci-cd.yaml @@ -1,53 +1,53 @@ -name: CI/CD Pipeline for mengning.com.cn -on: - push: - branches: - - main - pull_request: - branches: - - main - -jobs: - build: - runs-on: ubuntu-latest - container: - image: gitea/runner-images:ubuntu-latest - steps: - - name: 拉取代码 - uses: https://devstar.cn/actions/checkout@v4 - with: - fetch-depth: 0 - - - name: 安装依赖 - working-directory: - run: | - npm install - npm add -D vitepress - - - name: 构建项目 - working-directory: - run: | - chmod +x node_modules/.bin/vitepress - npm run docs:build - - - name: 构建 Docker 镜像 - run: | - docker build -t devstar-docs:${{ gitea.sha }} . - - - name: 登录 Docker Registry 并推送镜像 - run: | - echo "${{ secrets.DOCKER_REGISTRY_PASSWORD }}" | docker login -u ${{ secrets.DOCKER_REGISTRY_USERNAME }} ${{ vars.DOCKER_REGISTRY_ADDRESS }} --password-stdin - docker tag devstar-docs:${{ gitea.sha }} ${{ vars.DOCKER_REGISTRY_ADDRESS }}/devstar/devstar-studio-docs:${{ gitea.sha }} - docker tag devstar-docs:${{ gitea.sha }} ${{ vars.DOCKER_REGISTRY_ADDRESS }}/devstar/devstar-studio-docs:latest - docker push ${{ vars.DOCKER_REGISTRY_ADDRESS }}/devstar/devstar-studio-docs:${{ gitea.sha }} - docker push ${{ vars.DOCKER_REGISTRY_ADDRESS }}/devstar/devstar-studio-docs:latest - - - name: 📝 Update mengning.com.cn - run: | - curl -LO https://mirrors.ustc.edu.cn/kubernetes/core%3A/stable%3A/v1.28/deb/amd64/kubectl_1.28.0-1.1_amd64.deb - sudo dpkg -i kubectl_1.28.0-1.1_amd64.deb - kubectl config set-cluster remote-cluster --server=${{ secrets.K8S_URL }} --insecure-skip-tls-verify=true - kubectl config set-credentials token-user --token=${{ secrets.K8S_TOKEN }} - kubectl config set-context remote-context --cluster=remote-cluster --user=token-user - kubectl config use-context remote-context +name: CI/CD Pipeline for mengning.com.cn +on: + push: + branches: + - main + pull_request: + branches: + - main + +jobs: + build: + runs-on: ubuntu-latest + container: + image: gitea/runner-images:ubuntu-latest + steps: + - name: 拉取代码 + uses: https://devstar.cn/actions/checkout@v4 + with: + fetch-depth: 0 + + - name: 安装依赖 + working-directory: + run: | + npm install + npm add -D vitepress + + - name: 构建项目 + working-directory: + run: | + chmod +x node_modules/.bin/vitepress + npm run build + + - name: 构建 Docker 镜像 + run: | + docker build -t devstar-docs:${{ gitea.sha }} . + + - name: 登录 Docker Registry 并推送镜像 + run: | + echo "${{ secrets.DOCKER_REGISTRY_PASSWORD }}" | docker login -u ${{ secrets.DOCKER_REGISTRY_USERNAME }} ${{ vars.DOCKER_REGISTRY_ADDRESS }} --password-stdin + docker tag devstar-docs:${{ gitea.sha }} ${{ vars.DOCKER_REGISTRY_ADDRESS }}/devstar/devstar-studio-docs:${{ gitea.sha }} + docker tag devstar-docs:${{ gitea.sha }} ${{ vars.DOCKER_REGISTRY_ADDRESS }}/devstar/devstar-studio-docs:latest + docker push ${{ vars.DOCKER_REGISTRY_ADDRESS }}/devstar/devstar-studio-docs:${{ gitea.sha }} + docker push ${{ vars.DOCKER_REGISTRY_ADDRESS }}/devstar/devstar-studio-docs:latest + + - name: 📝 Update mengning.com.cn + run: | + curl -LO https://mirrors.ustc.edu.cn/kubernetes/core%3A/stable%3A/v1.28/deb/amd64/kubectl_1.28.0-1.1_amd64.deb + sudo dpkg -i kubectl_1.28.0-1.1_amd64.deb + kubectl config set-cluster remote-cluster --server=${{ secrets.K8S_URL }} --insecure-skip-tls-verify=true + kubectl config set-credentials token-user --token=${{ secrets.K8S_TOKEN }} + kubectl config set-context remote-context --cluster=remote-cluster --user=token-user + kubectl config use-context remote-context kubectl set image deployment/devstar-docs-app devstar-docs=${{ vars.DOCKER_REGISTRY_ADDRESS }}/devstar/devstar-studio-docs:latest -n app \ No newline at end of file diff --git a/.gitignore b/.gitignore index 271c078..4ca90f6 100644 --- a/.gitignore +++ b/.gitignore @@ -1,17 +1,17 @@ -# VitePress -docs/.vitepress/dist/ -docs/.vitepress/cache/ -docs/.vitepress/.temp/ - -# Node.js -node_modules/ -npm-debug.log* -yarn-debug.log* -yarn-error.log* - -# Environment -.env -.env.local -.env.development.local -.env.test.local +# VitePress +.vitepress/dist/ +.vitepress/cache/ +.vitepress/.temp/ + +# Node.js +node_modules/ +npm-debug.log* +yarn-debug.log* +yarn-error.log* + +# Environment +.env +.env.local +.env.development.local +.env.test.local .env.production.local \ No newline at end of file diff --git a/docs/.vitepress/config.mts b/.vitepress/config.mts similarity index 89% rename from docs/.vitepress/config.mts rename to .vitepress/config.mts index d36410a..ab3c5e2 100644 --- a/docs/.vitepress/config.mts +++ b/.vitepress/config.mts @@ -1,6 +1,5 @@ import { defineConfig } from 'vitepress' import type { DefaultTheme } from 'vitepress' -import { set_sidebar } from "../utils/auto_sidebar.js"; // https://vitepress.dev/reference/site-config export default defineConfig({ @@ -18,18 +17,18 @@ export default defineConfig({ src: '/mnsoftware.png', }, nav: [ - // { text: '文档', link: '/document/index' }, + // { text: '文档', link: '/src/document/index' }, // - { text: 'DevStar', link: '/devstar' }, - { text: '编译加速', link: '/compile' }, - { text: '虚拟仿真', link: '/simulator' }, - { text: 'Enterprise', link: '/enterprise' }, + { text: 'DevStar', link: '/src/devstar' }, + { text: '编译加速', link: '/src/compile' }, + { text: '虚拟仿真', link: '/src/simulator' }, + { text: 'Enterprise', link: '/src/enterprise' }, ], sidebar: { - '/devstar/': sidebarDevStar(), // 直接返回 SidebarItem[] - '/compile/': sidebarCompiling(), - '/simulator/': sidebarSimulator(), - '/enterprise/': sidebarEnterprise() + '/src/devstar/': sidebarDevStar(), // 直接返回 SidebarItem[] + '/src/compile/': sidebarCompiling(), + '/src/simulator/': sidebarSimulator(), + '/src/enterprise/': sidebarEnterprise() }, socialLinks: [ { icon: 'github', link: ' https://github.com/mengning/DevStar' } @@ -70,11 +69,11 @@ function sidebarDevStar(): DefaultTheme.SidebarItem[] { return [ { text: 'DevStar Studio', - link: '/devstar/index', + link: '/src/devstar/index', collapsible: true, // 使整个组可折叠 collapsed: false, // 默认展开 items: [ - { text: 'AI+ DevOps', link: '/devstar/ai-devops' }, + { text: 'AI+ DevOps', link: '/src/devstar/ai-devops' }, ] } as any, { @@ -84,8 +83,8 @@ function sidebarDevStar(): DefaultTheme.SidebarItem[] { items: [ { text: '对比Gitea与其它Git托管工具', link: 'https://docs.gitea.com/zh-cn/installation/comparison' }, { text: '数据库准备', link: 'https://docs.gitea.com/zh-cn/installation/database-prep' }, - // { text: '数据库准备', link: '/document/installation/from-source' }, - { text: '使用shell脚本安装', link: '/devstar/installation/install-via-shell-script' }, + // { text: '数据库准备', link: '/src/document/installation/from-source' }, + { text: '使用shell脚本安装', link: '/src/devstar/installation/install-via-shell-script' }, { text: '使用二进制文件安装', link: 'https://docs.gitea.com/zh-cn/installation/install-from-binary' }, { text: '包管理器安装', link: 'https://docs.gitea.com/zh-cn/installation/install-from-package' }, { text: '使用源代码安装', link: 'https://docs.gitea.com/zh-cn/installation/install-from-source' }, @@ -239,19 +238,19 @@ function sidebarSimulator(): DefaultTheme.SidebarItem[] { return [ { text: '虚拟仿真技术', - link: '/simulator/index', + link: '/src/simulator/index', items: [ ] }, { text: '虚拟ECU', - link: '/simulator/vECU', + link: '/src/simulator/vECU', items: [ ] } as any, { text: '整车系统级软硬件联合仿真', - link: '/simulator/vehicle-simulator', + link: '/src/simulator/vehicle-simulator', items: [] }, ] @@ -261,7 +260,7 @@ function sidebarCompiling(): DefaultTheme.SidebarItem[] { return [ { text: '编译加速', - link: '/compile/index', + link: '/src/compile/index', items: [ ] @@ -273,15 +272,15 @@ function sidebarCompiling(): DefaultTheme.SidebarItem[] { items: [ { text: '为什么需要分布式编译?', - link: '/compile/why-distributed-compiling' + link: '/src/compile/why-distributed-compiling' }, { text: 'CloudBuild', - link: '/compile/cloudbuild' + link: '/src/compile/cloudbuild' }, { text: 'ShareBuild', - link: '/compile/sharebuild' + link: '/src/compile/sharebuild' }, ] } as any, @@ -292,15 +291,15 @@ function sidebarCompiling(): DefaultTheme.SidebarItem[] { items: [ { text: 'AI Compiler简介', - link: '/compile/why-distributed-compiling' + link: '/src/compile/why-distributed-compiling' }, { text: 'CloudBuild', - link: '/compile/cloudbuild' + link: '/src/compile/cloudbuild' }, { text: 'ShareBuild', - link: '/compile/sharebuild' + link: '/src/compile/sharebuild' }, ] } as any, @@ -311,15 +310,15 @@ function sidebarCompiling(): DefaultTheme.SidebarItem[] { items: [ { text: 'PGO/LTO简介', - link: '/compile/why-distributed-compiling' + link: '/src/compile/why-distributed-compiling' }, { text: 'CloudBuild', - link: '/compile/cloudbuild' + link: '/src/compile/cloudbuild' }, { text: 'ShareBuild', - link: '/compile/sharebuild' + link: '/src/compile/sharebuild' }, ] }, @@ -330,14 +329,14 @@ function sidebarEnterprise(): DefaultTheme.SidebarItem[] { return [ { text: 'DevStar Enterprise', - link: '/enterprise/index', + link: '/src/enterprise/index', items: [ ] }, { text: '常见问题FAQ', - link: '/enterprise/faq', + link: '/src/enterprise/faq', items: [] }, ] diff --git a/docs/.vitepress/theme/index.js b/.vitepress/theme/index.js similarity index 100% rename from docs/.vitepress/theme/index.js rename to .vitepress/theme/index.js diff --git a/docs/.vitepress/theme/style.css b/.vitepress/theme/style.css similarity index 100% rename from docs/.vitepress/theme/style.css rename to .vitepress/theme/style.css diff --git a/Dockerfile b/Dockerfile index 06903bf..12b9e0a 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,21 +1,21 @@ -# 第一阶段:node镜像打包 -FROM node:20-alpine AS frontend-builder -WORKDIR /build-app -COPY . . -RUN npm install -RUN npm add -D vitepress -RUN npm run docs:build - -# 第二阶段:nginx打包 -FROM nginx:1.25-alpine -EXPOSE 80 -WORKDIR /app -# 替换nginx配置 -COPY nginx.conf /etc/nginx/conf.d/default.conf -# 将第一阶段的静态文件复制到nginx中 -RUN rm -rf /usr/share/nginx/html -RUN mkdir /usr/share/nginx/html -COPY --from=frontend-builder /build-app/docs/.vitepress/dist /usr/share/nginx/html - -# 运行 -CMD ["nginx", "-g", "daemon off;"] +# 第一阶段:node镜像打包 +FROM node:20-alpine AS frontend-builder +WORKDIR /build-app +COPY . . +RUN npm install +RUN npm add -D vitepress +RUN npm run build + +# 第二阶段:nginx打包 +FROM nginx:1.25-alpine +EXPOSE 80 +WORKDIR /app +# 替换nginx配置 +COPY nginx.conf /etc/nginx/conf.d/default.conf +# 将第一阶段的静态文件复制到nginx中 +RUN rm -rf /usr/share/nginx/html +RUN mkdir /usr/share/nginx/html +COPY --from=frontend-builder /build-app/.vitepress/dist /usr/share/nginx/html + +# 运行 +CMD ["nginx", "-g", "daemon off;"] diff --git a/README.md b/README.md index 1d36037..73d0d0f 100644 --- a/README.md +++ b/README.md @@ -1,31 +1,31 @@ -# 梦宁软件官网及DevStar文档 - -## 配置开发环境 - -```md -npm install -npm add -D vitepress -``` - -## 如何启动调试项目 -```md -npm run docs:dev -``` -## 如何打包项目 -```md -npm run docs:build -``` -## 如何预览打包的项目 -```md -npm run docs:preview -``` -## 如何添加或修改侧边栏 -在docs/.vitepress/config.mts中的sidebar进行修改,对于不同路径下的侧边栏,分别使用不同函数得到,text为侧边栏的描述内容,link为点击侧边栏后加载的内容的链接,如果有子目录,在items进行修改 - -link链接的内容既可以是网页链接,也可以是本地文档 -## 如何自定义网站样式 -在docs/.vitepress/theme/style.css中自定义网站样式 - -## 如何添加或修改导航栏 -在docs/.vitepress/config.mts中的nav进行修改 - +# 梦宁软件官网及DevStar文档 + +## 配置开发环境 + +```md +npm install +npm add -D vitepress +``` + +## 如何启动调试项目 +```md +npm run dev +``` +## 如何打包项目 +```md +npm run build +``` +## 如何预览打包的项目 +```md +npm run preview +``` +## 如何添加或修改侧边栏 +在docs/.vitepress/config.mts中的sidebar进行修改,对于不同路径下的侧边栏,分别使用不同函数得到,text为侧边栏的描述内容,link为点击侧边栏后加载的内容的链接,如果有子目录,在items进行修改 + +link链接的内容既可以是网页链接,也可以是本地文档 +## 如何自定义网站样式 +在docs/.vitepress/theme/style.css中自定义网站样式 + +## 如何添加或修改导航栏 +在docs/.vitepress/config.mts中的nav进行修改 + diff --git a/docs/utils/auto_sidebar.js b/docs/utils/auto_sidebar.js deleted file mode 100644 index d5dea4c..0000000 --- a/docs/utils/auto_sidebar.js +++ /dev/null @@ -1,65 +0,0 @@ -import path from "node:path"; -import fs from "node:fs"; - -const DIR_PATH = path.resolve("docs"); -const WHITE_LIST = ["index.md", ".vitepress", "node_modules", ".idea", "assets", "public"]; - -const isDirectory = (path) => fs.lstatSync(path).isDirectory(); -const intersections = (arr1, arr2) => - Array.from(new Set(arr1.filter((item) => !new Set(arr2).has(item)))); - -// 新增:按文件系统原始顺序排序 -const keepOriginalOrder = (files, dirPath) => { - return files - .map(file => ({ - name: file, - time: fs.statSync(path.join(dirPath, file)).birthtimeMs // 获取创建时间戳 - })) - .sort((a, b) => a.time - b.time) // 按创建时间排序 - .map(item => item.name); -}; - -function getList(params, path1, pathname) { - const res = []; - - // 修改点1:使用 keepOriginalOrder 保持原始顺序 - const orderedParams = keepOriginalOrder(params, path1); - - for (let file of orderedParams) { // 修改点2:改用 for...of 遍历 - const dir = path.join(path1, file); - const isDir = isDirectory(dir); - - if (isDir) { - const files = fs.readdirSync(dir); - res.push({ - text: file, - collapsible: true, - items: getList(files, dir, `${pathname}/${file}`), - }); - } else { - const suffix = path.extname(file); - if (suffix !== ".md") continue; - - const name = path.basename(file, '.md'); - res.push({ - text: name, - link: `${pathname}/${name}`, - }); - } - } - - // 修改点3:完全移除 sort() 调用 - return res; -} - -export const set_sidebar = (pathname) => { - try { - const dirPath = path.join(DIR_PATH, pathname); - const files = fs.readdirSync(dirPath); - const items = intersections(files, WHITE_LIST); - return getList(items, dirPath, pathname); - } catch (error) { - console.error(`Error generating sidebar for ${pathname}:`, error); - return []; - } -}; \ No newline at end of file diff --git a/docs/index.md b/index.md similarity index 92% rename from docs/index.md rename to index.md index e94b56c..733c184 100644 --- a/docs/index.md +++ b/index.md @@ -30,7 +30,7 @@ hero: # details: 安装和使用体验良好的详细描述 --- diff --git a/package.json b/package.json index 0fc19b8..b58d724 100644 --- a/package.json +++ b/package.json @@ -1,14 +1,14 @@ -{ - "devDependencies": { - "vitepress": "^1.6.4" - }, - "scripts": { - "docs:dev": "vitepress dev docs", - "docs:build": "vitepress build docs", - "docs:preview": "vitepress preview docs" - }, - "dependencies": { - "@vitejs/plugin-vue": "^6.0.1", - "prismjs": "^1.30.0" - } -} +{ + "devDependencies": { + "vitepress": "^1.6.4" + }, + "scripts": { + "dev": "vitepress dev", + "build": "vitepress build", + "preview": "vitepress preview" + }, + "dependencies": { + "@vitejs/plugin-vue": "^6.0.1", + "prismjs": "^1.30.0" + } +} diff --git a/docs/public/DevStar.png b/public/DevStar.png similarity index 100% rename from docs/public/DevStar.png rename to public/DevStar.png diff --git a/docs/public/QR-code.jpg b/public/QR-code.jpg similarity index 100% rename from docs/public/QR-code.jpg rename to public/QR-code.jpg diff --git a/docs/public/compile/CPU-utilization-16.png b/public/compile/CPU-utilization-16.png similarity index 100% rename from docs/public/compile/CPU-utilization-16.png rename to public/compile/CPU-utilization-16.png diff --git a/docs/public/compile/CPU-utilization-4.png b/public/compile/CPU-utilization-4.png similarity index 100% rename from docs/public/compile/CPU-utilization-4.png rename to public/compile/CPU-utilization-4.png diff --git a/docs/public/compile/CPU-utilization-8.png b/public/compile/CPU-utilization-8.png similarity index 100% rename from docs/public/compile/CPU-utilization-8.png rename to public/compile/CPU-utilization-8.png diff --git a/docs/public/compile/architecture.png b/public/compile/architecture.png similarity index 100% rename from docs/public/compile/architecture.png rename to public/compile/architecture.png diff --git a/docs/public/compile/cloudbuild-distributed-compilation.png b/public/compile/cloudbuild-distributed-compilation.png similarity index 100% rename from docs/public/compile/cloudbuild-distributed-compilation.png rename to public/compile/cloudbuild-distributed-compilation.png diff --git a/docs/public/compile/cloudbuild-installation.png b/public/compile/cloudbuild-installation.png similarity index 100% rename from docs/public/compile/cloudbuild-installation.png rename to public/compile/cloudbuild-installation.png diff --git a/docs/public/compile/compiler-principles.png b/public/compile/compiler-principles.png similarity index 100% rename from docs/public/compile/compiler-principles.png rename to public/compile/compiler-principles.png diff --git a/docs/public/compile/layered-system-architecture.png b/public/compile/layered-system-architecture.png similarity index 100% rename from docs/public/compile/layered-system-architecture.png rename to public/compile/layered-system-architecture.png diff --git a/docs/public/compile/promotional-graphic-cloudbuild.jpg b/public/compile/promotional-graphic-cloudbuild.jpg similarity index 100% rename from docs/public/compile/promotional-graphic-cloudbuild.jpg rename to public/compile/promotional-graphic-cloudbuild.jpg diff --git a/docs/public/compile/system-diagram.png b/public/compile/system-diagram.png similarity index 100% rename from docs/public/compile/system-diagram.png rename to public/compile/system-diagram.png diff --git a/docs/public/compile/table1.png b/public/compile/table1.png similarity index 100% rename from docs/public/compile/table1.png rename to public/compile/table1.png diff --git a/docs/public/compile/table2.png b/public/compile/table2.png similarity index 100% rename from docs/public/compile/table2.png rename to public/compile/table2.png diff --git a/docs/public/devstar-logo.png b/public/devstar-logo.png similarity index 100% rename from docs/public/devstar-logo.png rename to public/devstar-logo.png diff --git a/docs/public/intellectual-property-images1.png b/public/intellectual-property-images1.png similarity index 100% rename from docs/public/intellectual-property-images1.png rename to public/intellectual-property-images1.png diff --git a/docs/public/intellectual-property-images2.png b/public/intellectual-property-images2.png similarity index 100% rename from docs/public/intellectual-property-images2.png rename to public/intellectual-property-images2.png diff --git a/docs/public/intellectual-property-images3.png b/public/intellectual-property-images3.png similarity index 100% rename from docs/public/intellectual-property-images3.png rename to public/intellectual-property-images3.png diff --git a/docs/public/intellectual-property-images4.png b/public/intellectual-property-images4.png similarity index 100% rename from docs/public/intellectual-property-images4.png rename to public/intellectual-property-images4.png diff --git a/docs/public/mengninglogo.png b/public/mengninglogo.png similarity index 100% rename from docs/public/mengninglogo.png rename to public/mengninglogo.png diff --git a/docs/public/mengningsoftware.png b/public/mengningsoftware.png similarity index 100% rename from docs/public/mengningsoftware.png rename to public/mengningsoftware.png diff --git a/docs/public/mnsoftware.png b/public/mnsoftware.png similarity index 100% rename from docs/public/mnsoftware.png rename to public/mnsoftware.png diff --git a/docs/public/promotional-graphic-cloudbuild.jpg b/public/promotional-graphic-cloudbuild.jpg similarity index 100% rename from docs/public/promotional-graphic-cloudbuild.jpg rename to public/promotional-graphic-cloudbuild.jpg diff --git a/docs/public/promotional-graphic-devstar.png b/public/promotional-graphic-devstar.png similarity index 100% rename from docs/public/promotional-graphic-devstar.png rename to public/promotional-graphic-devstar.png diff --git a/docs/public/promotional-graphic-simulator.jpg b/public/promotional-graphic-simulator.jpg similarity index 100% rename from docs/public/promotional-graphic-simulator.jpg rename to public/promotional-graphic-simulator.jpg diff --git a/docs/public/simulator/image-1.png b/public/simulator/image-1.png similarity index 100% rename from docs/public/simulator/image-1.png rename to public/simulator/image-1.png diff --git a/docs/public/simulator/image-2.png b/public/simulator/image-2.png similarity index 100% rename from docs/public/simulator/image-2.png rename to public/simulator/image-2.png diff --git a/docs/public/simulator/image-3.png b/public/simulator/image-3.png similarity index 100% rename from docs/public/simulator/image-3.png rename to public/simulator/image-3.png diff --git a/docs/public/simulator/image.png b/public/simulator/image.png similarity index 100% rename from docs/public/simulator/image.png rename to public/simulator/image.png diff --git a/docs/public/slider1.png b/public/slider1.png similarity index 100% rename from docs/public/slider1.png rename to public/slider1.png diff --git a/docs/compile/cloudbuild.md b/src/compile/cloudbuild.md similarity index 100% rename from docs/compile/cloudbuild.md rename to src/compile/cloudbuild.md diff --git a/docs/compile/index.md b/src/compile/index.md similarity index 100% rename from docs/compile/index.md rename to src/compile/index.md diff --git a/docs/compile/sharebuild.md b/src/compile/sharebuild.md similarity index 100% rename from docs/compile/sharebuild.md rename to src/compile/sharebuild.md diff --git a/docs/compile/why-distributed-compiling.md b/src/compile/why-distributed-compiling.md similarity index 100% rename from docs/compile/why-distributed-compiling.md rename to src/compile/why-distributed-compiling.md diff --git a/docs/copyright/index.md b/src/copyright/index.md similarity index 100% rename from docs/copyright/index.md rename to src/copyright/index.md diff --git a/docs/devstar/ai-devops.md b/src/devstar/ai-devops.md similarity index 100% rename from docs/devstar/ai-devops.md rename to src/devstar/ai-devops.md diff --git a/docs/devstar/index.md b/src/devstar/index.md similarity index 100% rename from docs/devstar/index.md rename to src/devstar/index.md diff --git a/docs/devstar/installation/install-via-shell-script.md b/src/devstar/installation/install-via-shell-script.md similarity index 100% rename from docs/devstar/installation/install-via-shell-script.md rename to src/devstar/installation/install-via-shell-script.md diff --git a/docs/devstar/usage/quick-start-with-ai.md b/src/devstar/usage/quick-start-with-ai.md similarity index 100% rename from docs/devstar/usage/quick-start-with-ai.md rename to src/devstar/usage/quick-start-with-ai.md diff --git a/docs/devstar/快速开始.md b/src/devstar/快速开始.md similarity index 100% rename from docs/devstar/快速开始.md rename to src/devstar/快速开始.md diff --git a/docs/enterprise/faq.md b/src/enterprise/faq.md similarity index 91% rename from docs/enterprise/faq.md rename to src/enterprise/faq.md index 2770f7f..87364ef 100644 --- a/docs/enterprise/faq.md +++ b/src/enterprise/faq.md @@ -47,6 +47,6 @@ DevStar Enterprise 与 Gitea 项目的版本号不同但相互对应: ## 问题反馈 -大多数问题已在 [FAQ](/enterprise/faq) 中解答,如需进一步帮助请联系: +大多数问题已在 [FAQ](/src/enterprise/faq) 中解答,如需进一步帮助请联系: **邮箱**: [contact@mengning.com.cn](mailto:contact@mengning.com.cn) \ No newline at end of file diff --git a/docs/enterprise/index.md b/src/enterprise/index.md similarity index 91% rename from docs/enterprise/index.md rename to src/enterprise/index.md index ff21e88..553a739 100644 --- a/docs/enterprise/index.md +++ b/src/enterprise/index.md @@ -47,6 +47,6 @@ DevStar Enterprise 与 Gitea 项目的版本号不同但相互对应: ## 问题反馈 -大多数问题已在 [FAQ](/enterprise/faq) 中解答,如需进一步帮助请联系: +大多数问题已在 [FAQ](/src/enterprise/faq) 中解答,如需进一步帮助请联系: **邮箱**: [contact@mengning.com.cn](mailto:contact@mengning.com.cn) \ No newline at end of file diff --git a/docs/index.vue b/src/index.vue similarity index 92% rename from docs/index.vue rename to src/index.vue index f4f0bc9..1220688 100644 --- a/docs/index.vue +++ b/src/index.vue @@ -3,7 +3,7 @@
diff --git a/docs/simulator/index.md b/src/simulator/index.md similarity index 100% rename from docs/simulator/index.md rename to src/simulator/index.md diff --git a/docs/simulator/vECU.md b/src/simulator/vECU.md similarity index 100% rename from docs/simulator/vECU.md rename to src/simulator/vECU.md diff --git a/docs/simulator/vehicle-simulator.md b/src/simulator/vehicle-simulator.md similarity index 100% rename from docs/simulator/vehicle-simulator.md rename to src/simulator/vehicle-simulator.md