对样式进行了修改

This commit is contained in:
2025-08-05 19:18:04 +08:00
parent 631f3077f9
commit ab02d18701
10 changed files with 469 additions and 334 deletions

View File

@@ -12,6 +12,10 @@ npm run docs:build
```md ```md
npm run docs:preview npm run docs:preview
``` ```
## 如何添加或修改目录 ## 如何添加或修改侧边栏
在docs/.vitepress/config.mts中的sidebar进行修改text为目录的描述内容link为点击目录后加载的内容的链接如果有子目录在items进行修改 在docs/.vitepress/config.mts中的sidebar进行修改对于不同路径下的侧边栏,分别使用不同函数得到,text为侧边栏的描述内容link为点击侧边栏后加载的内容的链接如果有子目录在items进行修改
link链接的内容既可以是网页链接也可以是本地文档 link链接的内容既可以是网页链接也可以是本地文档
## 如何自定义网站样式
在docs/.vitepress/theme/style.css中自定义网站样式

View File

@@ -1,4 +1,5 @@
import { defineConfig } from 'vitepress' import { defineConfig } from 'vitepress'
import type { DefaultTheme } from 'vitepress'
import { set_sidebar } from "../utils/auto_sidebar.js"; import { set_sidebar } from "../utils/auto_sidebar.js";
// https://vitepress.dev/reference/site-config // https://vitepress.dev/reference/site-config
@@ -17,15 +18,59 @@ export default defineConfig({
src: '/mnsoftware.png', src: '/mnsoftware.png',
}, },
nav: [ nav: [
{ text: '文档', link: '/document/index' }, // { text: '文档', link: '/document/index' },
{ text: 'API', link: 'https://docs.gitea.com/zh-cn/api/1.24/' },
{ text: 'Runner', link: 'https://docs.gitea.com/zh-cn/runner/0.2.11/' },
{ text: 'Enterprise', link: 'https://docs.gitea.com/enterprise/' },
],
sidebar: [
{ {
text: 'devstar是什么', text: '文档',
items: [
{
text: 'Devstar介绍文档',
link: '/document/index'
},
]
},
{ text: 'API', link: 'https://docs.gitea.com/zh-cn/api/1.24/' },
{ text: 'Runner', link: 'runner/index' },
{ text: 'Enterprise', link: '/enterprise/index' },
],
sidebar: {
'/document/': sidebarDocument(), // 直接返回 SidebarItem[]
'/enterprise/': sidebarEnterprise()
},
socialLinks: [
{ icon: 'github', link: ' https://github.com/mengning/DevStar' }
],
footer: {
copyright: 'Copyright © 2025-present devstar contributors',
},
// 设置搜索框的样式
search: {
provider: "local",
options: {
translations: {
button: {
buttonText: "搜索文档",
buttonAriaLabel: "搜索文档",
},
modal: {
noResultsText: "无法找到相关结果",
resetButtonTitle: "清除查询条件",
footer: {
selectText: "选择",
navigateText: "切换",
},
},
},
},
},
}
})
function sidebarDocument(): DefaultTheme.SidebarItem[] {
return [
{
text: 'Devstar是什么',
link: '/document/index', link: '/document/index',
items: []
} as any, } as any,
{ {
text: '安装', text: '安装',
@@ -34,6 +79,8 @@ export default defineConfig({
items: [ items: [
{ text: '对比Gitea与其它Git托管工具', link: 'https://docs.gitea.com/zh-cn/installation/comparison' }, { 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: 'https://docs.gitea.com/zh-cn/installation/database-prep' },
// { text: '数据库准备', link: '/document/installation/from-source' },
{ text: '使用shell脚本安装', link: '/document/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-binary' },
{ text: '包管理器安装', link: 'https://docs.gitea.com/zh-cn/installation/install-from-package' }, { 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: '使用源代码安装', link: 'https://docs.gitea.com/zh-cn/installation/install-from-source' },
@@ -179,33 +226,75 @@ export default defineConfig({
{ text: '支持选项', link: 'https://docs.gitea.com/zh-cn/help/support' }, { text: '支持选项', link: 'https://docs.gitea.com/zh-cn/help/support' },
] ]
} as any, } as any,
], ]
}
socialLinks: [ function sidebarEnterprise(): DefaultTheme.SidebarItem[] {
{ icon: 'github', link: ' https://github.com/mengning/DevStar' } return [
], {
footer: { text: 'Gitea Enterprise 是什么',
copyright: 'Copyright © 2025-present devstar contributors', link: '/enterprise/index',
items: [
]
}, },
// 设置搜索框的样式 {
search: { text: '特征',
provider: "local", collapsible: true, // 使整个组可折叠
options: { collapsed: true, // 默认展开
translations: { items: [
button: { {
buttonText: "搜索文档", text: '可继承分支保护',
buttonAriaLabel: "搜索文档", link: 'https://docs.gitea.com/enterprise/features/inheritable-branch-protection'
}, },
modal: { {
noResultsText: "无法找到相关结果", text: '依赖关系扫描',
resetButtonTitle: "清除查询条件", link: 'https://docs.gitea.com/enterprise/features/dependency-scan'
footer: {
selectText: "选择",
navigateText: "切换",
}, },
{
text: 'IP 允许列表',
link: 'https://docs.gitea.com/enterprise/features/ip-allowlist'
}, },
{
text: '企业主题',
link: 'https://docs.gitea.com/enterprise/features/enterprise-theme'
}, },
{
text: '强制2FA身份验证',
link: 'https://docs.gitea.com/enterprise/features/mandatory-2fa'
}, },
{
text: '审计日志',
link: 'https://docs.gitea.com/enterprise/features/audit-log'
}, },
{
text: 'SAML',
link: 'https://docs.gitea.com/enterprise/features/saml-auth'
},
{
text: '发布节奏和版本控制',
link: 'https://docs.gitea.com/enterprise/features/release-cadence'
} }
}) ]
} as any,
{
text: '安装',
link: 'https://docs.gitea.com/enterprise/installation',
items: []
},
{
text: '常见问题',
link: 'https://docs.gitea.com/enterprise/faq',
items: []
},
]
}
function sidebarRunner(): DefaultTheme.SidebarItem[] {
return [
{
link: '/runner/index',
},
]
}

View File

@@ -1,22 +0,0 @@
<script setup>
import { useData } from 'vitepress'
import DefaultTheme from 'vitepress/theme'
import Index from '../components/Index.vue' // 你的组件
const { Layout } = DefaultTheme
const { frontmatter } = useData()
</script>
<template>
<Layout>
<!-- 保留默认主题的所有插槽 -->
<template #home-hero>
<VPHomeHero /> <!-- 默认Hero区域 -->
<Index /> <!-- 你的自定义组件 -->
</template>
<template #home-features>
<VPHomeFeatures /> <!-- 默认Features区域 -->
</template>
</Layout>
</template>

View File

@@ -1,3 +1,30 @@
/* .vitepress/theme/style.css */
:root {
--vp-sidebar-indent: 16px;
/* 基础缩进量 */
}
/* 侧边栏 */
.VPSidebar {
background-color: white !important;
}
.curtain {
background-color: #fff !important;
}
/* 首页图片 */
img.VPImage.image-src {
max-width: 500px !important;
height: 220px !important;
width: 380px !important;
}
.image-container {
/* height: 350px !important; */
transform: none !important;
}
/* 强制覆盖主题默认的Logo尺寸 */ /* 强制覆盖主题默认的Logo尺寸 */
.VPImage.logo { .VPImage.logo {
height: 150px !important; height: 150px !important;
@@ -9,6 +36,7 @@
margin-left: -40px !important; margin-left: -40px !important;
} }
/* home页面title部分 */
.VPNavBar .title { .VPNavBar .title {
margin-right: 20px !important; margin-right: 20px !important;
} }
@@ -20,21 +48,99 @@
/* 移除掉目录之间的分割线 */ /* 移除掉目录之间的分割线 */
.group { .group {
border-top: 0 !important; border-top: 0 !important;
line-height: 24px !important;
/* padding-bottom: 0 !important; */ padding: 4px 0 !important;
.items {
font-size: 20px !important;
}
} }
.group .items { .VPSidebarItem .level-1 .text {
font-size: 16px !important; color: #606770;
color: #3c3c43 !important; /* color: #333333 !important; */
font-weight: 700px !important; font-weight: 700 !important;
} }
/* .VPHero .image-container img {
width: 1000px !important; /* 一级菜单 */
height: 300px !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;
}

View File

@@ -1,49 +0,0 @@
---
outline: deep
---
# Runtime API Examples
This page demonstrates usage of some of the runtime APIs provided by VitePress.
The main `useData()` API can be used to access site, theme, and page data for the current page. It works in both `.md` and `.vue` files:
```md
<script setup>
import { useData } from 'vitepress'
const { theme, page, frontmatter } = useData()
</script>
## Results
### Theme Data
<pre>{{ theme }}</pre>
### Page Data
<pre>{{ page }}</pre>
### Page Frontmatter
<pre>{{ frontmatter }}</pre>
```
<script setup>
import { useData } from 'vitepress'
const { site, theme, page, frontmatter } = useData()
</script>
## Results
### Theme Data
<pre>{{ theme }}</pre>
### Page Data
<pre>{{ page }}</pre>
### Page Frontmatter
<pre>{{ frontmatter }}</pre>
## More
Check out the documentation for the [full list of runtime APIs](https://vitepress.dev/reference/runtime-api#usedata).

View File

@@ -58,6 +58,7 @@ export default {
<style scoped> <style scoped>
h2 { h2 {
border-top: 0; border-top: 0;
margin: 0 0 0 16px;
} }
.product-container { .product-container {
max-width: 1200px; max-width: 1200px;

View File

@@ -3,7 +3,7 @@ outline: deep
weight: 1 weight: 1
--- ---
# 关于devstar # 关于Devstar
DevStar Studio 是一个Gitea 发行版在Git代码仓库托管的基础上提供了开发环境DevEnv执行引擎与VS Code插件或自定义IDE深度融合形成灵活适配基础软件工具的生态平台从而为开发者用户提供智能代码大模型AI+、安全完全云原生、一站式开箱即用的CI/CD全生命周期研发平台。 DevStar Studio 是一个Gitea 发行版在Git代码仓库托管的基础上提供了开发环境DevEnv执行引擎与VS Code插件或自定义IDE深度融合形成灵活适配基础软件工具的生态平台从而为开发者用户提供智能代码大模型AI+、安全完全云原生、一站式开箱即用的CI/CD全生命周期研发平台。

View File

@@ -0,0 +1,39 @@
---
outline: deep
weight: 2
---
# 使用shell脚本安装
## 在Windows环境下
请在cmd命令行下先运行如下命令
```md
powershell wsl --install -d Ubuntu-20.04
```
如果以上命令无法自动完成安装WSL可以手动执行如下消耗完成命令安装
```md
dism.exe /Online /Enable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux /All /LimitAccess /All
dism.exe /Online /Enable-Feature /FeatureName:VirtualMachinePlatform /All /LimitAccess
```
## 在Ubuntu-20.04环境下
运行如下命令完成安装:
```md
wget -c https://devstar.cn/assets/install.sh && chmod +x install.sh && sudo ./install.sh
devstar help
------------------------------------------------------------------------
DevStar usage help:
help, -h, --help, Help information
start Start DevStar Studio
--port=<arg> Specify the port number (default port is 8080)
--version=<arg> Specify the DevStar Studio Image Version (default verson is latest)
stop Stop the running DevStar Studio
logs View the logs of the devstar-studio container
clean Clean up the running DevStar Studio, including deleting user data. Please use with caution.
------------------------------------------------------------------------
sudo devstar start
...
-------------------------------------------------------
DevStar started in http://localhost:8080 successfully!
-------------------------------------------------------
```
然后通过浏览器打开http://localhost:8080完成后配置安装默认第一个注册用户为管理员账户。

52
docs/enterprise/index.md Normal file
View File

@@ -0,0 +1,52 @@
---
title: Gitea Enterprise 介绍
sidebar: auto
---
# Gitea Enterprise
## 什么是 Gitea Enterprise
Gitea Enterprise 是基于开源 Gitea 项目开发的增强版,为企业级用户提供更可靠的体验。
## 与开源版的关系
- 基于开源 Gitea 项目开发,操作和配置方式几乎相同
- 熟悉 Gitea 的用户可以快速上手 Gitea Enterprise
- 企业版专为企业用例需求构建
- **注意**:企业版功能需要付费激活
> 如果您对价格有疑问可以申请30天免费试用试用期结束后可选择继续使用功能将恢复为开源版相同
## 定价方案
您可以在客户门户自主购买 Gitea Enterprise 许可证:
- 价格基于用户数量,可按实际需求购买
- 支持随时"调整"许可证规模(增减用户数或调整时长)
- 示例可将20人12个月许可调整为40人6个月或10人24个月
- 调整不产生额外费用
- 许可证到期前可选择续订延长有效期
- 随时续订可享受促销优惠
## 版本规则
Gitea Enterprise 与 Gitea 项目的版本号不同但相互对应:
- 企业版版本格式:`v21.6.*`
- `v21.6` 表示基于 Gitea 1.21.6 版本开发
- `.*` 包含企业版特有的补丁或功能更新
### 版本切换指南
1. **切换条件**:所有数据和配置完全兼容
2. **操作步骤**:只需替换可执行文件或 Docker 镜像
3. **版本对应规则**
- 从 Gitea v1.21.6 → 需选择 Gitea Enterprise v21+
- 从 Gitea Enterprise v23.1.0 → 需选择 Gitea v1.23+
## 问题反馈
大多数问题已在 [FAQ](/faq) 中解答,如需进一步帮助请联系:
**邮箱**: [support@example.com](mailto:support@example.com)

View File

@@ -1,85 +0,0 @@
# Markdown Extension Examples
This page demonstrates some of the built-in markdown extensions provided by VitePress.
## Syntax Highlighting
VitePress provides Syntax Highlighting powered by [Shiki](https://github.com/shikijs/shiki), with additional features like line-highlighting:
**Input**
````md
```js{4}
export default {
data () {
return {
msg: 'Highlighted!'
}
}
}
```
````
**Output**
```js{4}
export default {
data () {
return {
msg: 'Highlighted!'
}
}
}
```
## Custom Containers
**Input**
```md
::: info
This is an info box.
:::
::: tip
This is a tip.
:::
::: warning
This is a warning.
:::
::: danger
This is a dangerous warning.
:::
::: details
This is a details block.
:::
```
**Output**
::: info
This is an info box.
:::
::: tip
This is a tip.
:::
::: warning
This is a warning.
:::
::: danger
This is a dangerous warning.
:::
::: details
This is a details block.
:::
## More
Check out the documentation for the [full list of markdown extensions](https://vitepress.dev/guide/markdown).