beppeb/docs-test
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

重新组织项目文件目录结构，在仓库中可以直接查看文档中的图片

Browse Source
This commit is contained in:
孟宁
2025-11-16 06:29:10 +00:00
parent ff69c668c1
commit 6b3638c71a
57 changed files with 193 additions and 259 deletions
Download Patch File Download Diff File Expand all files Collapse all files

344
.vitepress/config.mts Normal file
View File

@@ -0,0 +1,344 @@
import { defineConfig } from 'vitepress'
import type { DefaultTheme } from 'vitepress'
// https://vitepress.dev/reference/site-config
export default defineConfig({
title: "梦宁软件",
head: [
['link', { rel: 'stylesheet', href: '/theme/style.css' }], // 引入CSS
['link', { rel: 'icon', href: '/mengninglogo.png' }] // 设置favicon
],
description: "梦宁软件",
themeConfig: {
// https://vitepress.dev/reference/default-theme-config
outlineTitle: '目录',
outline: [2, 6],
logo: {
src: '/mnsoftware.png',
},
nav: [
// { text: '文档', link: '/src/document/index' },
//
{ text: 'DevStar', link: '/src/devstar' },
{ text: '编译加速', link: '/src/compile' },
{ text: '虚拟仿真', link: '/src/simulator' },
{ text: 'Enterprise', link: '/src/enterprise' },
],
sidebar: {
'/src/devstar/': sidebarDevStar(), // 直接返回 SidebarItem[]
'/src/compile/': sidebarCompiling(),
'/src/simulator/': sidebarSimulator(),
'/src/enterprise/': sidebarEnterprise()
},
socialLinks: [
{ icon: 'github', link: ' https://github.com/mengning/DevStar' }
],
// footer: [
// copyright: 'Copyright © 2025-present devstar contributors',
// [Copyright © 2025-present DevStar Contributors](https://github.com/mengning/DevStar)
// { copyright: 'Copyright © 2025-present devstar contributors', link: 'https://github.com/mengning/DevStar' }
// ] as any,
// footer: {
// message: '<a href="/copyright/index">苏ICP备2024068144号-1 ©Mengning Software. 2025- All rights reserved.</a>',
// copyright: ''
// },
// 设置搜索框的样式
search: {
provider: "local",
options: {
translations: {
button: {
buttonText: "搜索文档",
buttonAriaLabel: "搜索文档",
},
modal: {
noResultsText: "无法找到相关结果",
resetButtonTitle: "清除查询条件",
footer: {
selectText: "选择",
navigateText: "切换",
},
},
},
},
},
}
})
function sidebarDevStar(): DefaultTheme.SidebarItem[] {
return [
{
text: 'DevStar Studio',
link: '/src/devstar/index',
collapsible: true, // 使整个组可折叠
collapsed: false, // 默认展开
items: [
{ text: 'AI+ DevOps', link: '/src/devstar/ai-devops' },
]
} as any,
{
text: '安装',
collapsible: true, // 使整个组可折叠
collapsed: true, // 默认展开
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: '/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' },
{ text: '在Linux中以service方式运行', link: 'https://docs.gitea.com/zh-cn/installation/linux-service' },//
{ text: '注册为Windows服务', link: 'https://docs.gitea.com/zh-cn/installation/windows-service' },
{ text: '使用Docker安装(rootless)', link: 'https://docs.gitea.com/zh-cn/installation/install-with-docker-rootless' },
{ text: '使用Docker安装', link: 'https://docs.gitea.com/zh-cn/installation/install-with-docker' },
{ text: '在Kubernetes中安装Gitea', link: 'https://docs.gitea.com/zh-cn/installation/install-on-kubernetes' },
{ text: '在云服务器上安装Gitea', link: 'https://docs.gitea.com/zh-cn/installation/install-on-cloud-provider' },
{ text: '从旧版Gitea升级', link: 'https://docs.gitea.com/zh-cn/installation/upgrade-from-gitea' },
]
} as any,
{
text: '管理',
collapsible: true, // 使整个组可折叠
collapsed: true, // 默认展开
items: [
{ text: '命令行', link: 'https://docs.gitea.com/zh-cn/administration/command-line' },
{ text: '认证', link: 'https://docs.gitea.com/zh-cn/administration/authentication' },
{ text: '环境变量清单', link: 'https://docs.gitea.com/zh-cn/administration/environment-variables' },
{ text: '备份与恢复', link: 'https://docs.gitea.com/zh-cn/administration/backup-and-restore' },
{ text: 'Email设置', link: 'https://docs.gitea.com/zh-cn/administration/email-setup' },
{ text: 'Git LFS设置', link: 'https://docs.gitea.com/zh-cn/administration/git-lfs-setup' },
{ text: 'HTTPS配置', link: 'https://docs.gitea.com/zh-cn/administration/https-setup' },
{ text: '设置Fail2ban', link: 'https://docs.gitea.com/zh-cn/administration/fail2ban-setup' },
{ text: '反向代理', link: 'https://docs.gitea.com/zh-cn/administration/reverse-proxies' },
{ text: '嵌入资源提取工具', link: 'https://docs.gitea.com/zh-cn/administration/cmd-embedded' },
{ text: '配置说明', link: 'https://docs.gitea.com/zh-cn/administration/config-cheat-sheet' },
{ text: '日志配置', link: 'https://docs.gitea.com/zh-cn/administration/logging-config' },
{ text: '邮件模板', link: 'https://docs.gitea.com/zh-cn/administration/mail-templates' },
{ text: '仓库索引器', link: 'https://docs.gitea.com/zh-cn/administration/repo-indexer' },
{ text: 'GPG提交签名', link: 'https://docs.gitea.com/zh-cn/administration/signing' },
{ text: '外部渲染器', link: 'https://docs.gitea.com/zh-cn/administration/external-renderers' },
{ text: '搜索引擎索引', link: 'https://docs.gitea.com/zh-cn/administration/search-engines-indexation' },
{ text: '自定义Gitea配置', link: 'https://docs.gitea.com/zh-cn/administration/customizing-gitea' },
{ text: '添加法律页面', link: 'https://docs.gitea.com/zh-cn/administration/adding-legal-pages' }
]
} as any,
{
text: '使用',
collapsible: true, // 使整个组可折叠
collapsed: true, // 默认展开
items: [
{ text: '结合AI快速开始', link: 'devstar/usage/quick-start-with-ai' },
{
text: 'Actions',
collapsible: true, // 使整个组可折叠
collapsed: false, // 默认展开
items: [
{ text: 'Overview', link: 'https://docs.gitea.com/zh-cn/usage/actions/overview' },
{ text: '快速入门', link: 'https://docs.gitea.com/zh-cn/usage/actions/quickstart' },
{ text: '与GitHub Actions的对比', link: 'https://docs.gitea.com/zh-cn/usage/actions/comparison' },
{ text: 'Act Runner', link: 'https://docs.gitea.com/zh-cn/usage/actions/act-runner' },
{ text: '变量', link: 'https://docs.gitea.com/zh-cn/usage/actions/actions-variables' },
{ text: 'Gitea Actions设计', link: 'https://docs.gitea.com/zh-cn/usage/actions/design' },
{ text: '密钥管理', link: 'https://docs.gitea.com/zh-cn/usage/actions/secrets' },
{ text: 'Gitea Actions常见问题解答', link: 'https://docs.gitea.com/zh-cn/usage/actions/faq' },
{ text: 'Badge', link: 'https://docs.gitea.com/zh-cn/usage/actions/badge' }
]
},
{
text: '软件包',
collapsible: true, // 使整个组可折叠
collapsed: true, // 默认展开
items: [
{ text: '软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/overview' },
{ text: 'Alpine 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/alpine' },
{ text: 'Arch package registry', link: 'https://docs.gitea.com/zh-cn/usage/packages/arch' },
{ text: 'Cargo 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/cargo' },
{ text: 'Chef 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/chef' },
{ text: '存储', link: 'https://docs.gitea.com/zh-cn/usage/packages/storage' },
{ text: 'Composer 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/composer' },
{ text: 'Conan 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/conan' },
{ text: 'Conda 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/conda' },
{ text: '容器注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/container' },
{ text: 'CRAN 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/cran' },
{ text: 'Go 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/go' },
{ text: 'Helm Chart 注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/helm' },
{ text: 'Maven 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/maven' },
{ text: 'NPM Package Registry', link: 'https://docs.gitea.com/zh-cn/usage/packages/npm' },
{ text: 'NuGet 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/nuget' },
{ text: 'Pub 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/pub' },
{ text: 'PyPI 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/pypi' },
{ text: 'RPM 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/packages/rpm' },
{ text: 'RubyGems 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/rubygems' },
{ text: 'Swift 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/swift' },
{ text: 'Vagrant 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/vagrant' },
{ text: '通用软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/generic' },
{ text: 'Debian 软件包注册表', link: 'https://docs.gitea.com/zh-cn/usage/packages/debian' }
]
},
{ text: 'AGit', link: 'https://docs.gitea.com/zh-cn/usage/agit' },
{ text: '个人资料 README', link: 'https://docs.gitea.com/zh-cn/usage/profile-readme' },
{ text: 'Blame File View', link: 'https://docs.gitea.com/zh-cn/usage/blame' },
{ text: '邮件接收', link: 'https://docs.gitea.com/zh-cn/usage/incoming-email' },
{ text: '标签', link: 'https://docs.gitea.com/zh-cn/usage/labels' },
{ text: '合并请求', link: 'https://docs.gitea.com/zh-cn/usage/pull-request' },
{ text: '权限', link: 'https://docs.gitea.com/zh-cn/usage/permissions' },
{ text: '模板仓库', link: 'https://docs.gitea.com/zh-cn/usage/template-repositories' },
{ text: '从模板创建工单与合并请求', link: 'https://docs.gitea.com/zh-cn/usage/issue-pull-request-templates' },
{ text: '自动链接引用', link: 'https://docs.gitea.com/zh-cn/usage/automatically-linked-references' },
{ text: '合并消息模板', link: 'https://docs.gitea.com/zh-cn/usage/merge-message-template' },
{ text: '推送', link: 'https://docs.gitea.com/zh-cn/usage/push' },
{ text: 'Blocking a user', link: 'https://docs.gitea.com/zh-cn/usage/blocking-user' },
{ text: '克隆过滤器 (部分克隆)', link: 'https://docs.gitea.com/zh-cn/usage/clone-filters' },
{ text: 'Code Owners', link: 'https://docs.gitea.com/zh-cn/usage/code-owners' },
{ text: 'Webhooks', link: 'https://docs.gitea.com/zh-cn/usage/webhooks' },
{ text: 'Migration', link: 'https://docs.gitea.com/zh-cn/usage/migration' },
{ text: '受保护的标签', link: 'https://docs.gitea.com/zh-cn/usage/protected-tags' },
{ text: '仓库镜像', link: 'https://docs.gitea.com/zh-cn/usage/repo-mirror' },
{ text: 'Markdown', link: 'https://docs.gitea.com/zh-cn/usage/markdown' },
{ text: 'Multi-factor Authentication (MFA)', link: 'https://docs.gitea.com/zh-cn/usage/multi-factor-authentication' }
]
} as any,
{
text: '开发',
collapsible: true, // 使整个组可折叠
collapsed: true, // 默认展开
items: [
{ text: '玩转 Gitea', link: 'https://docs.gitea.com/zh-cn/development/hacking-on-gitea' },
{ text: 'API 使用指南', link: 'https://docs.gitea.com/zh-cn/development/api-usage' },
{ text: 'OAuth2 提供者', link: 'https://docs.gitea.com/zh-cn/development/oauth2-provider' },
{ text: '迁移接口', link: 'https://docs.gitea.com/zh-cn/development/migrations-interfaces' },
{ text: '集成', link: 'https://docs.gitea.com/zh-cn/development/integrations' }
]
} as any,
{
text: '贡献',
collapsible: true, // 使整个组可折叠
collapsed: true, // 默认展开
items: [
{ text: '后端开发指南', link: 'https://docs.gitea.com/zh-cn/contributing/guidelines-backend' },
{ text: '前端开发指南', link: 'https://docs.gitea.com/zh-cn/contributing/guidelines-frontend' },
{ text: '重构指南', link: 'https://docs.gitea.com/zh-cn/contributing/guidelines-refactoring' },
{ text: '本地化', link: 'https://docs.gitea.com/zh-cn/contributing/localization' }
]
} as any,
{
text: '帮助',
collapsible: true, // 使整个组可折叠
collapsed: true, // 默认展开
items: [
{ text: '常见问题', link: 'https://docs.gitea.com/zh-cn/help/faq' },
{ text: '支持选项', link: 'https://docs.gitea.com/zh-cn/help/support' },
]
} as any,
]
}
function sidebarSimulator(): DefaultTheme.SidebarItem[] {
return [
{
text: '虚拟仿真技术',
link: '/src/simulator/index',
items: [
]
},
{
text: '虚拟ECU',
link: '/src/simulator/vECU',
items: [
]
} as any,
{
text: '整车系统级软硬件联合仿真',
link: '/src/simulator/vehicle-simulator',
items: []
},
]
}
function sidebarCompiling(): DefaultTheme.SidebarItem[] {
return [
{
text: '编译加速',
link: '/src/compile/index',
items: [
]
},
{
text: '分布式编译系统',
collapsible: true, // 使整个组可折叠
collapsed: false, // 默认展开
items: [
{
text: '为什么需要分布式编译？',
link: '/src/compile/why-distributed-compiling'
},
{
text: 'CloudBuild',
link: '/src/compile/cloudbuild'
},
{
text: 'ShareBuild',
link: '/src/compile/sharebuild'
},
]
} as any,
{
text: 'AI Compiler',
collapsible: true, // 使整个组可折叠
collapsed: false, // 默认展开
items: [
{
text: 'AI Compiler简介',
link: '/src/compile/why-distributed-compiling'
},
{
text: 'CloudBuild',
link: '/src/compile/cloudbuild'
},
{
text: 'ShareBuild',
link: '/src/compile/sharebuild'
},
]
} as any,
{
text: 'PGO/LTO',
collapsible: true, // 使整个组可折叠
collapsed: false, // 默认展开
items: [
{
text: 'PGO/LTO简介',
link: '/src/compile/why-distributed-compiling'
},
{
text: 'CloudBuild',
link: '/src/compile/cloudbuild'
},
{
text: 'ShareBuild',
link: '/src/compile/sharebuild'
},
]
},
]
}
function sidebarEnterprise(): DefaultTheme.SidebarItem[] {
return [
{
text: 'DevStar Enterprise',
link: '/src/enterprise/index',
items: [
]
},
{
text: '常见问题FAQ',
link: '/src/enterprise/faq',
items: []
},
]
}

5
.vitepress/theme/index.js Normal file
View File

@@ -0,0 +1,5 @@
// 正确写法：继承默认主题
import DefaultTheme from 'vitepress/theme'
import './style.css' // 可选：你的自定义样式
export default DefaultTheme // ✅ 必须导出 default

187
.vitepress/theme/style.css Normal file
View File

@@ -0,0 +1,187 @@
/* .vitepress/theme/style.css */
:root {
--vp-sidebar-indent: 16px;
/* 基础缩进量 */
}
/* 设置首页的高度 */
#VPContent.VPContent.is-home {
height: 980px !important;
}
/* 侧边栏 */
.VPSidebar {
background-color: white !important;
}
.curtain {
background-color: white !important;
}
/* 去除掉每个h2标题上面的线 */
.vp-doc h2 {
border-top: none;
}
/* 去除掉页面底部导航的横线 */
nav.prev-next {
border-top: none !important;
}
/* 首页图片 */
img.VPImage.image-src {
max-width: 500px !important;
height: 220px !important;
width: 380px !important;
}
.image-container {
/* height: 350px !important; */
transform: none !important;
}
/* 强制覆盖主题默认的Logo尺寸 */
.VPImage.logo {
height: 150px !important;
/* 必须用 !important 覆盖主题的 !important */
width: 200px !important;
/* 固定宽度，防止变形 */
/* margin-left: 100px !important; */
margin-right: -50px !important;
margin-left: -40px !important;
}
/* home页面title部分 */
.VPNavBar .title {
margin-right: 20px !important;
}
.VPHero .text {
font-size: 50px !important;
}
/* 移除掉目录之间的分割线 */
.group {
border-top: 0 !important;
line-height: 24px !important;
padding: 4px 0 !important;
}
.VPSidebarItem .level-1 .text {
/* color: #606770; */
/* color: #333333 !important; */
font-weight: 700 !important;
}
/* 一级菜单 */
.VPSidebarItem.level-0 {
padding-left: 0;
}
.VPSidebarItem.level-0.is-link {
padding-bottom: 0 !important;
}
/* 展开时 */
.VPSidebarItem.level-0.collapsible {
padding-bottom: 0 !important;
}
/* 二级菜单 */
.VPSidebarItem.level-1 {
padding-left: var(--vp-sidebar-indent);
}
/* 三级菜单 */
.VPSidebarItem.level-2 {
padding-left: calc(var(--vp-sidebar-indent) * 2);
}
/* 箭头图标对齐修正 */
.VPSidebarItem .indicator {
margin-left: auto;
}
.VPSidebarItem.collapsed.level-0.collapsible.collapsed {
padding-bottom: 0 !important;
}
.item {
padding: 0px 10px;
}
/* 侧边栏悬停效果 - 匹配图片风格 */
.item:hover {
background-color: #f5f5f7;
/* 浅灰内背景（与图中一致） */
color: #3451b2 !important;
/* 深蓝文字（#3451b2） */
border-radius: 8px;
/* 圆角增大（匹配图中圆角） */
transition: all 0.3s ease;
/* 增强阴影：横向偏移0，纵向偏移4px，模糊12px，扩散2px，透明度0.15 */
box-shadow: 10px 4px 12px 2px rgba(0, 0, 0, 0.15);
position: relative;
/* 确保阴影覆盖周围元素 */
z-index: 1;
/* 提升层级避免阴影被遮挡 */
}
h2.text:hover {
/* 浅灰内背景（与图中一致） */
color: #3451b2 !important;
}
/* 实现黑暗模式适配 */
/* 深色模式适配 */
.dark .VPSidebarItem.collapsed.level-0.collapsible.collapsed:hover {
background-color: #2d2d36;
/* 深灰内背景 */
color: #5a7eff;
/* 亮蓝文字 */
box-shadow: 0 4px 12px 2px rgba(0, 0, 0, 0.25);
/* 深色阴影更强 */
}
.dark .VPSidebar {
background-color: #1b1b1f !important;
}
.dark .curtain {
background-color: #1b1b1f !important;
}
/* 底下著作权部分 */
.VPFooter .message a {
/* 基础状态（非悬浮） */
text-decoration: none;
color: inherit;
/* 继承父级文字颜色（匹配第一张图的灰色） */
/* 悬浮状态 */
&:hover {
text-decoration: underline;
color: #2563eb;
/* 标准蓝色，色值可调整 */
transition: all 0.2s ease;
/* 平滑过渡效果 */
}
}
/* 实现知识产权部分居中 */
.vp-doc._copyright_ {
margin-left: 210px !important;
/* 强制右移 */
width: calc(100% - 120px);
/* 防止溢出 */
}