From 3a15352101dbbee7ba96941dc0ed7fb50cc054fa Mon Sep 17 00:00:00 2001
From: nanjirenwahaha <1731995580@qq.com>
Date: Sun, 25 May 2025 16:19:36 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=94=B9=E5=9B=BE=E7=89=87=E6=A0=BC?=
=?UTF-8?q?=E5=BC=8F=EF=BC=8C=E5=8E=BB=E6=8E=89=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/合并请求/创建合并请求.md | 6 ++--
docs/合并请求/合并模式简介.md | 28 ++++++++---------
docs/合并请求/合并请求简介.md | 2 +-
.../创建第一个开源项目.md | 6 ++--
.../导入GitHub等第三方Git项目.md | 10 +++----
docs/快速开始/提交第一行代码.md | 6 ++--
docs/快速开始/搜索开源项目.md | 8 ++---
docs/疑修/标记管理.md | 4 +--
docs/疑修/疑修列表.md | 2 +-
docs/疑修/疑修创建.md | 8 ++---
docs/疑修/疑修状态变更.md | 2 +-
docs/疑修/疑修简介.md | 2 +-
docs/疑修/评论及操作记录.md | 6 ++--
docs/疑修/里程碑管理.md | 10 +++----
docs/第三方服务/WebIDE.md | 30 +++++++++----------
docs/组织管理/组织创建及设置.md | 10 +++----
docs/组织管理/组织团队管理.md | 10 +++----
docs/组织管理/组织成员管理.md | 6 ++--
docs/组织管理/组织简介.md | 4 +--
docs/组织管理/组织项目管理.md | 2 +-
docs/维基/模板导入及导出.md | 2 +-
docs/维基/维基页面管理.md | 6 ++--
docs/通知/通知简介.md | 6 ++--
docs/通知/通知设置.md | 5 ++--
24 files changed, 90 insertions(+), 91 deletions(-)
diff --git a/docs/合并请求/创建合并请求.md b/docs/合并请求/创建合并请求.md
index 9d20169..e1dfda3 100644
--- a/docs/合并请求/创建合并请求.md
+++ b/docs/合并请求/创建合并请求.md
@@ -7,10 +7,10 @@ sidebar_position: 2
1. 进入需要发起合并请求的项目的“**合并请求(PR)**”界面,点击上方的“**新建合并请求**”按钮后,进入合并请求发布界面,如下所示:
-
+

-
+

2. 选择需要合并的**源分支**和**目标分支**,其中源分支为已完成代码开发、需要合并其代码变更的分支,目标分支为要并入代码变更的分支,既可以是同一仓库下的其他分支(branch),也可以是被复刻的源仓库下的分支;
@@ -21,5 +21,5 @@ sidebar_position: 2
5. 最后信息填写完毕后,点击底部的“**创建**”按钮即可提交您的第一个合并请求了🎉🎉🎉!
-
+

\ No newline at end of file
diff --git a/docs/合并请求/合并模式简介.md b/docs/合并请求/合并模式简介.md
index fd27002..6513d32 100644
--- a/docs/合并请求/合并模式简介.md
+++ b/docs/合并请求/合并模式简介.md
@@ -9,7 +9,7 @@ sidebar_position: 4
然而,对于不同分支间的提交合并,存在多种合并模式,下图为GitLink中支持的合并模式,包括**合并请求**、**变基并合并**、**变基合并 --no-ff**以及**压缩提交并合并**四种。
-
+

1. **合并请求**
@@ -18,12 +18,12 @@ sidebar_position: 4
快进合并前:
-
+

快进合并后:
-
+

**注意**:可以看到,合并的过程就是直接把`master`指针移动到了`dev`指针处,这种合并被称为**快进(fast-forward)**,之所以出现这种情形是因为在提交3之后,`master`分支上没有新的提交,所以通过直接快进`master`指针就可以完成合并;但如果在`master`分支上也有新的提交,就需要进行实质性的合并了,如下面两幅图所示:
@@ -32,7 +32,7 @@ sidebar_position: 4
非快进合并前:
-
+

@@ -40,12 +40,12 @@ sidebar_position: 4
非快进合并后:
-
+
)
为了方便理解,可以以线性方式查看合并后的`master`分支上的提交记录
-
+

**总结**:在**合并请求**模式下,默认采用**非快进**合并开发分支到`master`分支上,而**非快进**方式会生成一个特殊的提交用于记录此次合并事件!
@@ -58,12 +58,12 @@ sidebar_position: 4
变基前:
-
+

变基后、合并前:
-
+

@@ -71,7 +71,7 @@ sidebar_position: 4
合并后:
-
+

**总结**:在**变基并合并**模式下,开发分支`dev`可以先进行变基操作,使其上的提交看起来都是在`master`分支最新的提交基础上进行的,然后再通过**快进**方式合并回`master`分支,从而起到整理提交记录的作用!
@@ -82,12 +82,12 @@ sidebar_position: 4
`--no-ff`合并前:
-
+

`--no-ff`合并后:
-
+

**总结**:通过`--no-ff`选项,可以显式声明在合并时采用**非快进**方式,这样就可以在`master`分支中添加一个记录合并事件的提交!
@@ -98,17 +98,17 @@ sidebar_position: 4
压缩前:
-
+

压缩后、提交前:
-
+

提交后:
-
+

**总结**:在合并前,先对开发分支上的琐碎提交进行压缩,可以使`master`分支上的提交信息更简洁,但是要注意,这种合并模式本质上是`master`分支一次性保存`dev`上的变更,并创建新的提交记录这些变更,所以提交者发生了变化!
\ No newline at end of file
diff --git a/docs/合并请求/合并请求简介.md b/docs/合并请求/合并请求简介.md
index f770c58..f233ff8 100644
--- a/docs/合并请求/合并请求简介.md
+++ b/docs/合并请求/合并请求简介.md
@@ -15,5 +15,5 @@ GitLink中的 **合并请求(PR)** 模块提供合并请求创建和管理两方
如下图所示为合并请求(PR)管理模块:
-
+

\ No newline at end of file
diff --git a/docs/快速开始/创建第一个开源项目.md b/docs/快速开始/创建第一个开源项目.md
index 086cef8..ab27240 100644
--- a/docs/快速开始/创建第一个开源项目.md
+++ b/docs/快速开始/创建第一个开源项目.md
@@ -9,19 +9,19 @@ sidebar_position: 2
平台提供了“新建”按钮,用户可以通过点击快速从零开始创建新的公开或者私有项目。
-
+

## 2. 填写项目信息
填写项目基本信息。
-
+

## 3. 创建成功
点击创建项目,创建成功后进入项目主页。
-
+

\ No newline at end of file
diff --git a/docs/快速开始/导入GitHub等第三方Git项目.md b/docs/快速开始/导入GitHub等第三方Git项目.md
index e1bf03f..dae9fb6 100644
--- a/docs/快速开始/导入GitHub等第三方Git项目.md
+++ b/docs/快速开始/导入GitHub等第三方Git项目.md
@@ -9,21 +9,21 @@ sidebar_position: 5
在首页选择**导入项目**
-
+

## 2. 填写信息
填写需要导入的第三方Git项目地址和项目信息,如果导入项目为私有仓库,则需输入目标平台用户token进行授权。
-
+

## 3. 授权验证
在使用GitLink平台导入其他平台(如GitHub、Gitee)的开源项目时,如果项目为私有,则无法通过正常途径导入,需要输入对应平台有权限的token值进行校验。
-
+

下面将列举一些典型开源平台的token获取方式。
@@ -89,10 +89,10 @@ sidebar_position: 5
提示正在从第三方Git项目地址迁移
-
+

迁移成功则导入项目成功
-
+

\ No newline at end of file
diff --git a/docs/快速开始/提交第一行代码.md b/docs/快速开始/提交第一行代码.md
index 3efe6e2..f20c242 100644
--- a/docs/快速开始/提交第一行代码.md
+++ b/docs/快速开始/提交第一行代码.md
@@ -9,17 +9,17 @@ sidebar_position: 3
点击编辑按钮,开始编辑代码。
-
+

# 2. 提交代码
在编辑框中编写代码,编写完成后填写变更信息后提交变更。
-
+

## 3. 代码更新成功
-提交成功后代码代码更新成功。
+提交成功后代码代码更新成功。

\ No newline at end of file
diff --git a/docs/快速开始/搜索开源项目.md b/docs/快速开始/搜索开源项目.md
index 559ba32..8b24dfa 100644
--- a/docs/快速开始/搜索开源项目.md
+++ b/docs/快速开始/搜索开源项目.md
@@ -7,25 +7,25 @@ sidebar_position: 1
## 1. 点击**立即注册**按钮
-
+

## 2. 填写注册信息
- 手机号注册
-
+

- 邮箱注册
-
+

## 3. 注册完成
填写完所需信息后点击注册,注册成功后则进入个人主页
-
+

diff --git a/docs/疑修/标记管理.md b/docs/疑修/标记管理.md
index 147b8e5..8dcc121 100644
--- a/docs/疑修/标记管理.md
+++ b/docs/疑修/标记管理.md
@@ -18,9 +18,9 @@ GitLink默认疑修共有缺陷、功能、疑问、支持、任务、协助、
- **文档:** 表示文档材料补充;
- **测试:** 表示需要测试的需求;
- **重复:** 表示已存在类似的疑修。
-
+

另外,**项目成员**可以根据需求或习惯,进行标记含义或颜色标志的修改、新建标记和删除标记操作。
-
+

\ No newline at end of file
diff --git a/docs/疑修/疑修列表.md b/docs/疑修/疑修列表.md
index c495f77..e8011ab 100644
--- a/docs/疑修/疑修列表.md
+++ b/docs/疑修/疑修列表.md
@@ -6,7 +6,7 @@ sidebar_position: 4
对于项目开发过程中创建的所有疑修,可以在**疑修(Issue)** 界面统一查看,如下图所示为[确实开源](https://www.gitlink.org.cn/Gitlink/forgeplus)项目下的疑修列表。
-
+

+ **创建疑修**:在疑修列表界面下,点击“**创建疑修**”按钮,同样可以创建疑修,具体见 ***疑修创建*** 一节;
diff --git a/docs/疑修/疑修创建.md b/docs/疑修/疑修创建.md
index 4d14df8..f51223a 100644
--- a/docs/疑修/疑修创建.md
+++ b/docs/疑修/疑修创建.md
@@ -6,19 +6,19 @@ sidebar_position: 2
1. 进入需要发布疑修的项目的“**代码库**”界面,点击上方的“**+疑修**”按钮即可进入疑修发布界面,如下图所示:
-
+

2. 开始创建疑修,包括疑修标题、内容,输入疑修内容时既可以采用简单灵活的[Markdown语法](https://markdown.com.cn/),同时可以点击上方的功能按钮;然后上传需要的附件内容;最后点击“**创建**”按钮提交你的第一个疑修🎉🎉🎉
-
+

3. 此外,在创建疑修时,可以通过符号 **`#`** 快速添加需要引用的疑修,进而为当前疑修提供辅助的信息;如下图所示,键入 **`#`** 后会弹出可引用的疑修列表,通过鼠标下滑或者键盘输入疑修编号选择需要引用的疑修后,会自动添加引用疑修的链接🔗
-
+

-
+

diff --git a/docs/疑修/疑修状态变更.md b/docs/疑修/疑修状态变更.md
index 262342f..8e53c5d 100644
--- a/docs/疑修/疑修状态变更.md
+++ b/docs/疑修/疑修状态变更.md
@@ -6,7 +6,7 @@ sidebar_position: 3
**疑修**本质上是开发任务,而开发任务随着开发活动的进行,其状态也会发生改变,而“**状态**”便是用于跟踪记录开发活动的变更。如图所示,GitLink中疑修的**状态**包括“新增”、“正在解决”、“已解决”、“关闭”和“拒绝“五类,用于表示开发任务的处理进度。
-
+

+ **新增**:新创建的疑修默认状态为“新增”;
diff --git a/docs/疑修/疑修简介.md b/docs/疑修/疑修简介.md
index 041ed8c..795d1ca 100644
--- a/docs/疑修/疑修简介.md
+++ b/docs/疑修/疑修简介.md
@@ -6,7 +6,7 @@ sidebar_position: 1
**疑修(Issue)** 管理模块主要为项目组成员提供**开发任务**发布、指派、跟踪等功能服务。
-
+

**说明事项**
diff --git a/docs/疑修/评论及操作记录.md b/docs/疑修/评论及操作记录.md
index a17ea16..282209e 100644
--- a/docs/疑修/评论及操作记录.md
+++ b/docs/疑修/评论及操作记录.md
@@ -6,16 +6,16 @@ sidebar_position: 5
# 评论及操作记录
### 评论
每个疑修都相当于一个可以进度追踪的帖子,因此支持评论和回复,不仅仅是项目成员,所有人都可以在某个疑修下进行评论和回复,发表疑问或是见解,进行交流。
-
+

### 疑修声明
用户可以对任意疑修发布“疑修声明”,留言自己对于该疑修的解决思路。点击疑修详情右侧的“声明”后,可以编辑留言,编辑完成后点击“确认”即可发布声明,如下图所示:
-
+

### 操作记录
所有人都可以创建疑修,但是要注意,非项目成员仅可以修改自己创建的疑修,而项目成员有权限修改所有的疑修。
对于某个疑修的所有编辑操作,包括**创建疑修、添加负责人、移除负责人、更改状态、更改优先级、添加标记、移除标记、添加里程碑、移除里程碑、设置关联分支、移除关联分支、设置开始日期和设置结束日期**,均被记录在操作记录中。
-
+

\ No newline at end of file
diff --git a/docs/疑修/里程碑管理.md b/docs/疑修/里程碑管理.md
index fe7a4fc..f612c00 100644
--- a/docs/疑修/里程碑管理.md
+++ b/docs/疑修/里程碑管理.md
@@ -12,18 +12,18 @@ sidebar_position: 7
项目成员可以基于以下步骤创建里程碑:
1. 进入目标项目的 **“里程碑”** 界面,此时界面所示为已创建的里程碑的列表,所有已创建里程碑分为 **“已关闭”** 和 **“开启中”** 两类;
2. 点击上方的 **“+创建里程碑”** 按钮即可进入里程碑创建界面;
-
+

3. 填写标题(必填)、描述(必填)、截止日期(选填)后,点击右下角的 **“创建里程碑”** 即可以完成一个新的里程碑的创建。
-
+

### 关联里程碑
项目成员可以将疑修关联到里程碑,从而使里程碑包含明确的疑修列表,主要步骤如下:
1. 在疑修列表中点击目标疑修;
2. 编辑“里程碑”属性,选择需要关联的里程碑。
-
+

### 其他操作
@@ -33,8 +33,8 @@ sidebar_position: 7
- **删除里程碑**
上述操作均可以在里程碑列表中,对目标里程碑进行处理实现,如下图所示:
-
+

-
+

\ No newline at end of file
diff --git a/docs/第三方服务/WebIDE.md b/docs/第三方服务/WebIDE.md
index 03f58f8..93ee280 100644
--- a/docs/第三方服务/WebIDE.md
+++ b/docs/第三方服务/WebIDE.md
@@ -29,13 +29,13 @@ sidebar_position: 9
## 代码阅读
在代码托管平台上进行代码阅读时经常需要查看当前方法在哪里被引用、当前接口在哪里被实现,极速版 Web IDE 提供编辑器 + 插件的能力,解决了上述用户需求:
-
+
