This commit is contained in:
Zhao_Jiasheng 2021-04-28 22:23:36 +08:00
commit 13608fe19d
5 changed files with 181 additions and 4 deletions

View File

@ -33,7 +33,8 @@ module.exports = {
* refhttps://v1.vuepress.vuejs.org/theme/default-theme-config.html * refhttps://v1.vuepress.vuejs.org/theme/default-theme-config.html
*/ */
themeConfig: { themeConfig: {
repo: 'https://github.com/xuos/xuos', repo: 'https://git.trustie.net/xuos/xiuos',
repoLabel: '源码',
editLinks: false, editLinks: false,
docsDir: '', docsDir: '',
editLinkText: '', editLinkText: '',
@ -74,11 +75,20 @@ module.exports = {
}, },
{ {
text: '资源', text: '资源',
link: '/resource/', link: '/resource/'
}, },
{ {
text: '社区', text: '社区',
link: '/community/', items: [
{
text: '贡献代码',
link: '/community/contrib.html'
},
{
text: '报告Bug',
link: '/community/bugreport.html'
},
]
}, },
{ {
text: '关于', text: '关于',

Binary file not shown.

After

Width:  |  Height:  |  Size: 297 KiB

View File

@ -0,0 +1,20 @@
# 报告Bug
如果您发现了一个Bug我们欢迎您将之告知我们帮助我们将XiUOS变得更好
您可以访问XiUOS在Trustie平台的项目首页
[https://forgeplus.trustie.net/projects/xuos/xiuos](https://forgeplus.trustie.net/projects/xuos/xiuos),
点击 "+任务"按钮报告Bug。
或者直接[点击这里]( https://forgeplus.trustie.net/projects/xuos/xiuos/issues/new)
必填的内容有:
- 标题请简洁描述该bug如"无法从xx接口读取xx设备的数据"
- 描述请详细描述该bug在什么环境, 什么条件, 如何发生的, 发生时的系统行为
等信息, 以帮助开发人员及时准确定位错误并修复。
- 类型:请选择为 "缺陷"。
- 状态:请选择为 "新增"。

147
docs/community/contrib.md Normal file
View File

@ -0,0 +1,147 @@
# 为 XiUOS 贡献代码
热烈欢迎您加入XiUOS开发者社区贡献您的力量。
XiUOS采用git作为代码仓库开发流程如下图所示:
![git workflow](/images/workflow.png)
这里假定您对git已经有了一定的了解。
XiUOS的主代码库地址为 "https://git.trustie.net/xuos/xiuos.git"
XiUOS的项目首页为
[https://forgeplus.trustie.net/projects/xuos/xiuos](https://forgeplus.trustie.net/projects/xuos/xiuos)
## 准备阶段
首先, 从XiUOS主库中复刻一份到自己的个人空间。
假定您在Trustie的用户名为 "panda"
### 步骤1 : 复刻
在浏览器中打开 XiUOS的项目首页 [https://forgeplus.trustie.net/projects/xuos/xiuos](https://forgeplus.trustie.net/projects/xuos/xiuos), 点击右上角的"复刻" 按钮
这样您就在自己的个人空间中有了XiUOS的一个复刻代码库, 地址为
项目首页为 "https://forgeplus.trustie.net/projects/panda/xiuos"
代码库地址为 "https://git.trustie.net/panda/xiuos.git"
### 步骤2 : 下载到本地,并配置
* 从个人空间下载
```
git clone https://git.trustie.net/panda/xiuos.git
```
::: warning 警告
请务必记住将panda替换为您自己的用户名
:::
* 配置
```
# 设置 upstream
git remote add upstream https://git.trustie.net/xuos/xiuos.git
# 禁止直接向 upstream 推送代码
git remote set-url --push upstream no_push
```
## 工作阶段
### 步骤3 : fetch
**upstream(xuos/xiuos)** fetch 代码到本地
```
git fetch upstream
```
### 步骤4 : branch
为本次工作创建一个分支,命名为 `develop`
```
git checkout -b develop upstream/master
```
### 步骤5 : work, commit & commit
此时就可以在该分支下工作了, 不断修改代码,不断 commit
```
git add .
git commit -m "your commit message"
```
### 步骤6 : push & push
如果经过测试,您觉得在本地完成了代码工作,您就可以将代码推送到您自己的服
务器端的仓库中了。
```
git push origin develop
```
push到自己的服务器端库中后就可以准备创建`合并请求(Pull Request)`了。
### 步骤7 : fetch
从XiUOS的主库, 即 upstream 中, fetch 最新的代码
```
git fetch upstream
```
### 步骤8 : merge
将upstream 上最新的代码合并到你的当前工作分支
```
git merge upstream/master
```
此时请确保本地您位于工作分支。如果合并过程有冲突,您要负责解决冲突,并提交。
### 步骤9 : push
将消解了冲突的最新本地代码推送到个人服务器端仓库的develop分支。
```
git push origin develop
```
### 步骤10 : 合并请求(pull request)
到自己个人服务器端仓库的首页 https://forgeplus.trustie.net/projects/panda/xiuos, 点击 **合并请求** ,
设置源分支:
选择 设定的工作分支, 本文的例子是 **develop** 分支
设置目标分支:
目标仓库选择 upstream 库, 即: "泛在操作系统实验室/xiuos"
目标分支选择 `master`
提交即可。
如果您的"合并请求"被核心开发者拒绝, 这种情况在开源社区很常见,所以请不要灰心失望, 请按照返回的意见修改完善,再提交即可。
### 更新本地和个人服务器端仓库的主分支
```
git fetch upstream
git checkout master
git merge upstream/master
git push origin master
```

View File

@ -7,7 +7,7 @@
"name": "XUOS Lab", "name": "XUOS Lab",
"email": "caodg@pku.edu.cn" "email": "caodg@pku.edu.cn"
}, },
"repository": "https://github.com/xuos/xuos-web", "repository": "https://git.trustie.net/xuos/xiuos",
"scripts": { "scripts": {
"dev": "vuepress dev docs", "dev": "vuepress dev docs",
"build": "vuepress build docs" "build": "vuepress build docs"