diff --git a/docs/basic/create-project.md b/docs/basic/create-project.md index e600a13e5a1e22a303cafe2790015f06d95fd670..03076eb887859831c70ede747d501cc9385e8483 100644 --- a/docs/basic/create-project.md +++ b/docs/basic/create-project.md @@ -1,6 +1,6 @@ # 新建项目[](#create-a-project "Permalink") -开发中大多数工作都在一个[项目](../user/project/index.html)完成,文件和代码都保存在项目中,并且大多数功能都将在项目范围内使用。 +开发中大多数工作都在一个[项目](/../user/repo.md)完成,文件和代码都保存在项目中,并且大多数功能都将在项目范围内使用。 ## 新建一个项目[](#create-a-project "Permalink") diff --git a/docs/img/find-the-merge-request-that-introduced-a-change.png b/docs/img/find-the-merge-request-that-introduced-a-change.png new file mode 100644 index 0000000000000000000000000000000000000000..546cdf92ea0b056e51db1e603e17dad874128120 Binary files /dev/null and b/docs/img/find-the-merge-request-that-introduced-a-change.png differ diff --git a/docs/img/versions.png b/docs/img/versions.png new file mode 100644 index 0000000000000000000000000000000000000000..f2e66db28348475461c3c801bd7c896fcc91317e Binary files /dev/null and b/docs/img/versions.png differ diff --git a/docs/img/versions_compare_head_v12_10.png b/docs/img/versions_compare_head_v12_10.png new file mode 100644 index 0000000000000000000000000000000000000000..2816709fe9f50f63c72a2897f9ac13c605ccdce7 Binary files /dev/null and b/docs/img/versions_compare_head_v12_10.png differ diff --git a/docs/img/versions_dropdown.png b/docs/img/versions_dropdown.png new file mode 100644 index 0000000000000000000000000000000000000000..691178d019d50e887ec2fa5f5afaf1724d1f6f68 Binary files /dev/null and b/docs/img/versions_dropdown.png differ diff --git a/docs/user/project/merge-request/versions.md b/docs/user/project/merge-request/versions.md index 50b0e54993cf9e7e0431e80fbab2345d1bbe86df..ab2d232d28f5c8367cc4f7de6f81c04a8d5bd233 100644 --- a/docs/user/project/merge-request/versions.md +++ b/docs/user/project/merge-request/versions.md @@ -1,41 +1,33 @@ -# 合并请求版本[](#合并请求版本 "Permalink") +# 合并请求版本[](#versions "Permalink") 每次您推送到与合并请求绑定的分支时,都会创建新版本的合并请求 diff. 当您访问包含多个推送的合并请求时,可以选择并比较那些合并请求差异的版本. -[![Merge request versions](img/0d2f752f5d8c7352da5333f4f0d27835.png)](img/versions.png) +[![Merge request versions](/docs/img/versions.png)](/docs/img/versions.png) -## Selecting a version[](#selecting-a-version "Permalink") +## 选择版本[](#selecting-a-version "Permalink") -默认情况下,显示更改的最新版本. 但是,您可以从版本下拉列表中选择一个较旧的版本. +默认情况下,显示更改的最新版本。 但是,您可以从版本下拉列表中选择一个较旧的版本: -[![Merge request versions dropdown](img/1864a1996bbb1636d65648dd8b0857df.png)](img/versions_dropdown.png) +[![Merge request versions dropdown](/docs/img/versions_dropdown.png)](/docs/img/versions_dropdown.png) -合并请求版本基于推送而不是提交. 因此,如果您单次推送了 5 次提交,那么下拉菜单中的选项就是一个. 如果您按了 5 次,则算上 5 个选项. +合并请求版本基于推送而不是提交,因此,如果您单次推送了5次提交,那么下拉菜单中的选项就是一个;如果您推送了5次,则会有5个选项。 -您还可以将合并请求版本与旧版本进行比较,以查看此后发生了什么变化. +您还可以将合并请求版本与旧版本进行比较,以查看此后发生了什么变化。在查看过时的合并版本或与基本版本以外的版本进行比较时,将禁用注释。 -[![Merge request versions compare](img/f0a8b71ac0a74f03724937e45e8782b9.png)](img/versions_compare.png) +每次将新更改推送到分支时,系统都会显示一个用于比较最后更改的链接。 -在查看过时的合并版本或与基本版本以外的版本进行比较时,将禁用注释. +## 查找合并请求引入的更改[](#find-the-merge-request-that-introduced-a-change "Permalink") -每次将新更改推送到分支时,系统都会显示一个用于比较最后更改的链接. +在查看提交详情页面时,会链接到包含该提交的合并请求(或多个合并请求)。 -[![Merge request versions system note](img/8201105b83669750c4d60036b41f6c6d.png)](img/versions_system_note.png) +这仅适用于最新版本的合并请求中的提交,如果某个提交位于合并请求中,然后根据该合并请求 rebase 的,则不会链接它们。 -## Find the merge request that introduced a change[](#find-the-merge-request-that-introduced-a-change "Permalink") +[![Find the merge request that introduced a change](/docs/img/find-the-merge-request-that-introduced-a-change.png)](/docs/img/find-the-merge-request-that-introduced-a-change.png) -在 GitLab 10.5 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/2383) . +## `HEAD` 对比模式[](#head-comparison-mode-for-merge-requests "Permalink") -在查看提交详细信息页面时,GitLab 将链接到包含该提交的合并请求(或合并请求,如果存在多个). +合并请求(尤其是 **更改**选项卡)是查看和讨论源代码的地方,在目标分支被合并到合并请求的源分支的情况下,源分支和目标分支中的更改可以显示为混合在一起,这使得很难理解目标分支中正在添加哪些更改以及已经存在哪些更改。 -这仅适用于最新版本的合并请求中的提交-如果某个提交位于合并请求中,然后根据该合并请求重新建立基础,则不会链接它们. +为此我们添加了一个比较模式,该模式显示了通过模拟合并后的差异计算出的差异可以更准确地表示更改,而不是使用两个分支的基础。 通过选择**master(HEAD),**可以从比较目标下拉列表中使用新模式。 -## `HEAD` comparison mode for Merge Requests[](#head-comparison-mode-for-merge-requests "Permalink") - -在 GitLab 12.10 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/27008) . - -合并请求(尤其是" **更改"**选项卡)是查看和讨论源代码的地方. 在目标分支被合并到合并请求的源分支的情况下,源分支和目标分支中的更改可以显示为混合在一起,这使得很难理解目标分支中正在添加哪些更改以及已经存在哪些更改. - -在 GitLab 12.10 中,我们添加了一个比较模式,该模式显示了通过模拟合并后的差异计算出的差异-更准确地表示更改,而不是使用两个分支的基础. 通过选择**master(HEAD),**可以从比较目标下拉列表中使用新模式. 将来它将[替换](https://gitlab.com/gitlab-org/gitlab/-/issues/198458)当前的默认比较. - -[![Merge request versions compare HEAD](img/3478cae6da4e529f7c9cf2f4e71dd462.png)](img/versions_compare_head_v12_10.png) \ No newline at end of file +[![Merge request versions compare HEAD](/docs/img/versions_compare_head_v12_10.png)](/docs/img/versions_compare_head_v12_10.png) \ No newline at end of file