pfqgauxfb
/
gitlink_help_center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

修改疑修

Browse Source
double
zzzzzyh 2 months ago
parent 184d493fd4
commit bf4e36fd04
19 changed files with 99 additions and 84 deletions
Show Stats Download Patch File Download Diff File

11
Dockerfile
Unescape View File

@ -1,10 +1,15 @@
FROM node:18-alpine
LABEL maintainer="yuankaifneg <2894340009@qq.com>"
# 使用阿里云镜像
FROM registry.cn-guangzhou.aliyuncs.com/nudt_devops/node:18-alpine
LABEL maintainer="hejiayu <hejy47@nudt.edu.cn>"
WORKDIR /gitlink_help_center
# 设置 npm 和 yarn 使用淘宝镜像
RUN npm config set registry https://registry.npmmirror.com
RUN yarn config set registry https://registry.npmmirror.com
COPY ./ /gitlink_help_center/
RUN yarn install
RUN npm run build -- --locale zh-cn
CMD ["npm", "run", "serve"]
CMD ["npm", "run", "serve"]

2
README.md
Unescape View File

@ -4,7 +4,7 @@
#### 1.复刻主仓库
![](https://gitlink.org.cn/api/attachments/412462)
<br/>
//编辑实验
#### 2.进入复刻仓库编辑文档
![](https://gitlink.org.cn/api/attachments/412465)

12
docs/intro.md
Unescape View File

@ -6,17 +6,17 @@ slug: /
---
# 关于GitLink
GitLink（确实开源）是CCF官方指定的开源创新服务平台，旨在以“为开源创新服务”为使命，以“成为开源创新的汇聚地”为愿景，秉承“创新、开放、协作、共享”的价值观，致力于为大规模开源开放协同创新助力赋能，打造创新成果孵化和新工科人才培养的开源创新生态！
GitLink（确实开源）是CCF官方指定的开源创新服务平台，旨在以"为开源创新服务"为使命，以"成为开源创新的汇聚地"为愿景，秉承"创新、开放、协作、共享"的价值观，致力于为大规模开源开放协同创新助力赋能，打造创新成果孵化和新工科人才培养的开源创新生态！
![](/img/ccf_gitlink.png)
# 平台功能
- **分布式协作开发**：支持在线文件编辑、分支管理、贡献统计、仓库复刻、合并请求；
- **一站式过程管理**：支持疑修、里程碑、通知提醒、标签归档、Wiki文档、组织管理；
- **高效流水线运维**：提供轻量级工作流引擎，并支持自定义配置、静态扫描、制品构建；
- **多层次代码分析**：支持代码溯源分析、许可证风险分析、开源漏洞检测和加固建议；
- **多维度用户画像**：支持开发活动统计、贡献日历、能力建模、角色与专业定位分析。
- **分布式协作开发**：支持[在线文件编辑](/代码库管理/仓库创建)、[分支管理](/代码库管理/分支管理)、[贡献统计](/个人主页建站/建站流程)、[仓库复刻](/代码库管理/仓库复刻)、[合并请求](/合并请求/合并请求简介)；
- **一站式过程管理**：支持[疑修](/疑修/疑修简介)、[里程碑](/代码库管理/里程碑)、[通知提醒](/通知/通知简介)、[标签归档](/代码库管理/标签管理)、[Wiki文档](/维基/模板导入及导出)、[组织管理](/组织管理/组织简介)；
- **高效流水线运维**：提供[轻量级工作流引擎](/DevOps引擎/引擎简介)，并支持[自定义配置](/DevOps引擎/工作流配置)、[静态扫描](/DevOps引擎/静态扫描)、[制品构建](/DevOps引擎/制品构建)；
- **多层次代码分析**：支持[代码溯源分析](/代码库管理/代码分析)、[许可证风险分析](/代码库管理/许可证分析)、[开源漏洞检测](/代码库管理/漏洞检测)和[加固建议](/代码库管理/安全加固)；
- **多维度用户画像**：支持[开发活动统计](/个人主页建站/建站流程)、[贡献日历](/个人主页建站/建站流程)、[能力建模](/个人主页建站/建站流程)、[角色与专业定位分析](/个人主页建站/建站流程)。
# 帮助文档
帮助文档有助于您全面了解GitLink平台，让我们一起为开源创新贡献力量！

6
docs/合并请求/创建合并请求.md
Unescape View File

@ -7,9 +7,9 @@ sidebar_position: 2
1. 进入需要发起合并请求的项目的“**合并请求(PR)**”界面，点击上方的“**新建合并请求**”按钮后，进入合并请求发布界面，如下所示：
![合并请求模块](/img/PR/imagePR2.png)
![合并请求模块](../../static/img/PR/imagePR2.png)
![合并请求发布界面](/img/PR/imagePR3.png)
![合并请求发布界面](../../static/img/PR/imagePR3.png)
2. 选择需要合并的**源分支**和**目标分支**，其中源分支为已完成代码开发、需要合并其代码变更的分支，目标分支为要并入代码变更的分支，既可以是同一仓库下的其他分支（branch），也可以是被复刻的源仓库下的分支；
@ -19,4 +19,4 @@ sidebar_position: 2
5. 最后信息填写完毕后，点击底部的“**创建**”按钮即可提交您的第一个合并请求了🎉🎉🎉！
![创建合并请求](/img/PR/imagePR4.png)
![创建合并请求](../../static/img/PR/imagePR4.png)

4
docs/快速开始/提交第一行代码.md
Unescape View File

@ -5,13 +5,13 @@ sidebar_position: 3
# 提交第一行代码
# 1. 编辑代码
## 1. 编辑代码
点击编辑按钮，开始编辑代码。
![](/img/quickstart/first_edit.png)
# 2. 提交代码
## 2. 提交代码
在编辑框中编写代码，编写完成后填写变更信息后提交变更。

5
docs/组织管理/组织创建及设置.md
Unescape View File

@ -24,3 +24,8 @@ sidebar_position: 2
**注**：此处为必填项，不得为空
## 可见性
![](/img/Org/imageOrg3.png)
**注**：可见性预设三类组织：公开、受限（仅对登录用户可见）、私有（仅对组织成员可见）。

2
docs/组织管理/组织简介.md
Unescape View File

@ -3,7 +3,7 @@ sidebar_label: '组织简介'
sidebar_position: 1
---
# 组织简介
## 组织简介
组织是共享帐户，其中业务和开源项目可同时跨多个项目进行协作，具有复杂的安全性和管理功能。多个个人帐户可以通过加入同一组织帐户来协作处理共享项目。

28
versioned_docs/version-1.1.0/代码库管理/代码提交.md
Unescape View File

@ -3,24 +3,10 @@ sidebar_label: '代码提交'
sidebar_position: 3
---
# 代码提交
### **1. 代码提交入口**
在仓库主页，点击"代码"标签页，即可进入代码提交模块，如下图所示。
![](../../../static/img/代码库管理/代码提交/代码提交入口.png)<br/>
### **2. 编辑代码**
点击文件右侧的编辑按钮，开始编辑代码。
![](../../../static/img/代码库管理/代码提交/编辑代码.png)<br/>
### **3. 提交变更**
在编辑框中编写代码，编写完成后填写变更信息（包括提交说明和分支选择），点击"提交变更"按钮即可完成代码提交。
![](../../../static/img/代码库管理/代码提交/提交变更.png)<br/>
### **4. 提交成功**
提交成功后，代码将更新到选定的分支中，并显示最新的提交记录。
![](../../../static/img/代码库管理/代码提交/提交成功.png)<br/>
### **5. 提交历史**
在代码提交模块中，可以查看所有分支的提交历史记录，包括提交者、提交时间、提交说明等信息。
![](../../../static/img/代码库管理/代码提交/提交历史.png)<br/>
### **1. 代码提交入口**
用户可以通过项目代码库中间的文件下的“上传文件”按键来上传文件。
![](../../static/img/代码库管理/代码提交/上传文件入口.png)<br/>
### **2. 上传文件**
进入上传文件页面后，如下图所示，拖动文件，选择提交变更的分支的单击”创建项目“按键即可完成创建。
![](../../static/img/代码库管理/代码提交/上传文件.png)<br/>

11
versioned_docs/version-1.1.0/代码库管理/分支管理.md
Unescape View File

@ -1,4 +1,13 @@
---
sidebar_label: '分支管理'
sidebar_position: 5
---
---
### **1. 查看分支**
在代码库栏下，如下图所示，用户可以点击代码库分支从而查看当前项目的所有分支，并且选择对其进行操作。
![](../../static/img/代码库管理/分支管理/分支管理方式1.jpg)<br/>
### **2. 合并分支**
在“和并请求（PR）”下点击“新建合并请求”后，
![](../../static/img/代码库管理/分支管理/分支管理方式3.png)<br/>
如下图所示，用户可以选择源分支与目标分支以及填写分支信息后提交分支合并请求。
![](../../static/img/代码库管理/分支管理/分支管理方式2.png)<br/>

17
versioned_docs/version-1.1.0/代码库管理/文件管理.md
Unescape View File

@ -1,4 +1,19 @@
---
sidebar_label: '文件管理'
sidebar_position: 4
---
---
### **1. 文件管理位置**
在代码库界面，可直接对代码库中该分支下的文件进行操作，如下图所示。
![](../../static/img/代码库管理/文件管理/文件管理入口.png)<br/>
### **2. 进入目录**
点击进入相关目录，找到要编辑的文件，如下图所示。
![](../../static/img/代码库管理/文件管理/进入文件所在目录.png)<br/>
### **3. 进入文件编辑页面**
在线编辑文件，单击文件，即可进入编辑文件页面，如下图所示。
![](../../static/img/代码库管理/文件管理/进入文件编辑界面.png)<br/>
### **4. 编辑文件**
编辑界面右侧有三个按钮，分别是“下载”、“编辑”和“删除”，点击下载即可将文件下载到本地，编辑则可在线编辑文档，删除则将文件从代码库中删除，按钮位置如下图所示。
![](../../static/img/代码库管理/文件管理/文件编辑按钮.png)<br/>

6
versioned_docs/version-1.1.0/合并请求/创建合并请求.md
Unescape View File

@ -7,9 +7,9 @@ sidebar_position: 2
1. 进入需要发起合并请求的项目的“**合并请求(PR)**”界面，点击上方的“**新建合并请求**”按钮后，进入合并请求发布界面，如下所示：
![合并请求模块](/img/PR/imagePR2.png)
![合并请求模块](../../static/img/PR/imagePR2.png)
![合并请求发布界面](/img/PR/imagePR3.png)
![合并请求发布界面](../../static/img/PR/imagePR3.png)
2. 选择需要合并的**源分支**和**目标分支**，其中源分支为已完成代码开发、需要合并其代码变更的分支，目标分支为要并入代码变更的分支，既可以是同一仓库下的其他分支（branch），也可以是被复刻的源仓库下的分支；
@ -19,4 +19,4 @@ sidebar_position: 2
5. 最后信息填写完毕后，点击底部的“**创建**”按钮即可提交您的第一个合并请求了🎉🎉🎉！
![创建合并请求](/img/PR/imagePR4.png)
![创建合并请求](../../static/img/PR/imagePR4.png)

28
versioned_docs/version-1.1.0/合并请求/合并模式简介.md
Unescape View File

@ -9,7 +9,7 @@ sidebar_position: 4
然而，对于不同分支间的提交合并，存在多种合并模式，下图为GitLink中支持的合并模式，包括**合并请求**、**变基并合并**、**变基合并 --no-ff**以及**压缩提交并合并**四种。
![合并模式](/img/PR/imagePR5.png)
![合并模式](../../static/img/PR/imagePR5.png)
1. **合并请求**
@ -17,11 +17,11 @@ sidebar_position: 4
快进合并前：
![快进合并前](/img/PR/imagePR6.png)
![快进合并前](../../static/img/PR/imagePR6.png)
快进合并后：
![快进合并后](/img/PR/imagePR7.png)
![快进合并后](../../static/img/PR/imagePR7.png)
**注意**：可以看到，合并的过程就是直接把`master`指针移动到了`dev`指针处，这种合并被称为**快进（fast-forward）**，之所以出现这种情形是因为在提交3之后，`master`分支上没有新的提交，所以通过直接快进`master`指针就可以完成合并；但如果在`master`分支上也有新的提交，就需要进行实质性的合并了，如下面两幅图所示：
@ -29,18 +29,18 @@ sidebar_position: 4
非快进合并前：
![非快进合并前](/img/PR/imagePR8.png)
![非快进合并前](../../static/img/PR/imagePR8.png)
合并之后，提交A、B、C都会按时间线加入`master`的提交记录中，并且会生成一个新的提交D，用于记录合并这件事情；此外，如果合并过程中发生了冲突，即两个分支对同一个文件进行了修改，则需要手动处理冲突；这种合并方式就是**非快进（no fast-forward）**，这也是**合并请求**模式下的默认方式！
非快进合并后：
![非快进合并后](/img/PR/imagePR9.png)
![非快进合并后](../../static/img/PR/imagePR9.png)
为了方便理解，可以以线性方式查看合并后的`master`分支上的提交记录
![线性的提交记录](/img/PR/imagePR10.png)
![线性的提交记录](../../static/img/PR/imagePR10.png)
**总结**：在**合并请求**模式下，默认采用**非快进**合并开发分支到`master`分支上，而**非快进**方式会生成一个特殊的提交用于记录此次合并事件！
@ -52,18 +52,18 @@ sidebar_position: 4
变基前：
![变基前](/img/PR/imagePR8.png)
![变基前](../../static/img/PR/imagePR8.png)
变基后、合并前：
![变基后_合并前](/img/PR/imagePR11.png)
![变基后_合并前](../../static/img/PR/imagePR11.png)
`dev`分支变基之后，`master`分支就没有“更新”的提交了，所以此时进行合并，就得到了如下的结果
合并后：
![合并后](/img/PR/imagePR12.png)
![合并后](../../static/img/PR/imagePR12.png)
**总结**：在**变基并合并**模式下，开发分支`dev`可以先进行变基操作，使其上的提交看起来都是在`master`分支最新的提交基础上进行的，然后再通过**快进**方式合并回`master`分支，从而起到整理提交记录的作用！
@ -73,11 +73,11 @@ sidebar_position: 4
`--no-ff`合并前：
![--no-ff合并前](/img/PR/imagePR11.png)
![--no-ff合并前](../../static/img/PR/imagePR11.png)
`--no-ff`合并后：
![--no-ff合并后](/img/PR/imagePR13.png)
![--no-ff合并后](../../static/img/PR/imagePR13.png)
**总结**：通过`--no-ff`选项，可以显式声明在合并时采用**非快进**方式，这样就可以在`master`分支中添加一个记录合并事件的提交！
@ -87,14 +87,14 @@ sidebar_position: 4
压缩前：
![压缩前](/img/PR/imagePR8.png)
![压缩前](../../static/img/PR/imagePR8.png)
压缩后、提交前：
![压缩后_提交前](/img/PR/imagePR14.png)
![压缩后_提交前](../../static/img/PR/imagePR14.png)
提交后：
![提交后](/img/PR/imagePR15.png)
![提交后](../../static/img/PR/imagePR15.png)
**总结**：在合并前，先对开发分支上的琐碎提交进行压缩，可以使`master`分支上的提交信息更简洁，但是要注意，这种合并模式本质上是`master`分支一次性保存`dev`上的变更，并创建新的提交记录这些变更，所以提交者发生了变化！

2
versioned_docs/version-1.1.0/合并请求/合并请求简介.md
Unescape View File

@ -15,4 +15,4 @@ GitLink中的 **合并请求(PR)** 模块提供合并请求创建和管理两方
如下图所示为合并请求(PR)管理模块：
![合并请求管理模块](/img/PR/imagePR1.png)
![合并请求管理模块](../../static/img/PR/imagePR1.png)

6
versioned_docs/version-1.1.0/快速开始/创建第一个开源项目.md
Unescape View File

@ -9,16 +9,16 @@ sidebar_position: 2
平台提供了“新建”按钮，用户可以通过点击快速从零开始创建新的公开或者私有项目。
![创建首页](/img/quickstart/create_homepage.png)
![创建首页](../../static//img/quickstart/create_homepage.png)
## 2. 填写项目信息
填写项目基本信息。
![](/img/quickstart/create_info.png)
![](../../static//img/quickstart/create_info.png)
## 3. 创建成功
点击创建项目，创建成功后进入项目主页。
![](/img/quickstart/create_success.png)
![](../../static//img/quickstart/create_success.png)

10
versioned_docs/version-1.1.0/快速开始/导入GitHub等第三方Git项目.md
Unescape View File

@ -9,19 +9,19 @@ sidebar_position: 5
在首页选择**导入项目**
![](/img/quickstart/import_homepage.png)
![](../../static//img/quickstart/import_homepage.png)
## 2. 填写信息
填写需要导入的第三方Git项目地址和项目信息，如果导入项目为私有仓库，则需输入目标平台用户token进行授权。
![](/img/quickstart/import_info.png)
![](../../static//img/quickstart/import_info.png)
## 3. 授权验证
在使用GitLink平台导入其他平台（如GitHub、Gitee）的开源项目时，如果项目为私有，则无法通过正常途径导入，需要输入对应平台有权限的token值进行校验。
![](/img/quickstart/import_verify.png)
![](../../static//img/quickstart/import_verify.png)
下面将列举一些典型开源平台的token获取方式。
@ -85,8 +85,8 @@ sidebar_position: 5
提示正在从第三方Git项目地址迁移
![](/img/quickstart/import_wait.png)
![](../../static//img/quickstart/import_wait.png)
迁移成功则导入项目成功
![](/img/quickstart/import_success.png)
![](../../static//img/quickstart/import_success.png)

12
versioned_docs/version-1.1.0/快速开始/提交第一行代码.md
Unescape View File

@ -5,18 +5,12 @@ sidebar_position: 3
# 提交第一行代码
# 1. 编辑代码
点击编辑按钮，开始编辑代码。
![](/img/quickstart/first_edit.png)
# 2. 提交代码
## 2. 提交代码
在编辑框中编写代码，编写完成后填写变更信息后提交变更。
![](/img/quickstart/first_commit.png)
![](../../static//img/quickstart/first_commit.png)
## 3. 代码更新成功
提交成功后代码代码更新成功。![](/img/quickstart/first_success.png)
提交成功后代码代码更新成功。![](../../static//img/quickstart/first_success.png)

12
versioned_docs/version-1.1.0/快速开始/搜索开源项目.md
Unescape View File

@ -11,11 +11,11 @@ sidebar_position: 4
进入“项目”模块，左侧列出了项目类型和项目类别。其中，项目类型主要包括开源托管项目和开源镜像项目两类。项目类别主要包括：云计算、大数据、区块链、物联网、机器学习、人工智能、智慧医疗、其他。
![](/img/quickstart/search_homepage.png)
![](../../static//img/quickstart/search_homepage.png)
右侧展示了所有项目的基本信息，包括创建者、项目名、项目简介、浏览量、项目类别、更新时间、点赞数量、Fork 数量等信息，用户可以通过关键字搜索查找特定的项目，也可以按照更新时间、创建时间、Fork 数量、点赞数量等对项目进行排序。
![](/img/quickstart/search_list.png)
![](../../static//img/quickstart/search_list.png)
用户点击项目名称，即可进入到项目详情，查看和参与开源项目开发。
@ -27,18 +27,18 @@ sidebar_position: 4
搜索项目：
![](/img/quickstart/search_method1.png)
![](../../static//img/quickstart/search_method1.png)
搜索结果：
![](/img/quickstart/search_result1.png)
![](../../static//img/quickstart/search_result1.png)
### 菜单栏搜索框
搜索项目：
![](/img/quickstart/search_method2.png)
![](../../static//img/quickstart/search_method2.png)
搜索结果：
![](/img/quickstart/search_result2.png)
![](../../static//img/quickstart/search_result2.png)

8
versioned_docs/version-1.1.0/快速开始/注册GitLink账号.md
Unescape View File

@ -7,21 +7,21 @@ sidebar_position: 1
## 1. 点击**立即注册**按钮
![](/img/quickstart/register_homepage.png)
![](../../static//img/quickstart/register_homepage.png)
## 2. 填写注册信息
- 手机号注册
![](/img/quickstart/register_phone.png)
![](../../static//img/quickstart/register_phone.png)
- 邮箱注册
![](/img/quickstart/register_email.png)
![](../../static//img/quickstart/register_email.png)
## 3. 注册完成
填写完所需信息后点击注册，注册成功后则进入个人主页
![](/img/quickstart/register_ownpage.png)
![](../../static//img/quickstart/register_ownpage.png)

1
versioned_docs/version-1.1.0/通知/通知设置.md
Unescape View File

@ -12,6 +12,7 @@ sidebar_position: 2
![](/img/notice/home_notice.png)
<br/>
或在头像下拉列表中选择设置可以进入消息通知设置界面；
![](/img/notice/into_notice.png)
#### 2.进行通知设置

Write Preview
Loading…
Cancel
Save