{{< details >}}
- Tier: 基础版, 专业版, 旗舰版
- Offering: JihuLab.com, 私有化部署
{{< /details >}}
议题交叉链接
议题交叉链接在极狐 GitLab 中创建议题之间的关系。议题交叉链接:
- 连接相关议题以获得更好的跟踪和可见性。
- 将议题链接到它们相关的提交和合并请求。
- 通过提交消息、分支名称和描述创建引用。
- 在项目和群组之间工作。
- 在每个议题的 链接项 部分显示关系。
您可以通过以下方式创建交叉链接:
从提交消息中
每次您在提交消息中提到一个议题时,您就在开发工作流程的两个阶段之间创建了关系:议题本身和与该议题相关的第一个提交。
如果议题和您提交的代码都在同一个项目中,请在提交消息中添加 #xxx
,其中 xxx
是议题编号。
git commit -m "this is my commit message. Ref #xxx"
由于提交消息通常不能以 #
字符开头,您也可以使用替代的 GL-xxx
表示法:
git commit -m "GL-xxx: this is my commit message"
如果它们在不同的项目中,但在同一个群组中,请在提交消息中添加 projectname#xxx
。
git commit -m "this is my commit message. Ref projectname#xxx"
如果它们不在同一个群组中,您可以添加议题的完整 URL (https://jihulab.com/<username>/<projectname>/-/issues/<xxx>
)。
git commit -m "this is my commit message. Related to https://jihulab.com/<username>/<projectname>/-/issues/<xxx>"
当然,您可以将 gitlab.com
替换为您自己的极狐 GitLab 实例的 URL。
从链接议题中
在合并请求和其他议题中提到链接议题有助于您的团队成员和协作伙伴知道有关于同一主题的打开议题。
您可以按照上面所述进行操作,当在 提交消息中提到议题 时。
当在议题 #111
中提到议题 #222
时,议题 #111
也会在其 活动 提要中显示通知。也就是说,您只需提到一次关系即可在两个议题中显示。当在 合并请求中提到议题 时也是如此。
当议题的活动提要被过滤为 仅显示历史记录 或 显示所有活动 时,交叉链接显示为 (Username) mentioned in issue #(number) (time ago)
。
从合并请求中
在合并请求评论中提到议题的工作方式与在 链接议题 中的工作方式完全相同。
当您在合并请求描述中提到议题时,它会 将议题和合并请求链接在一起。此外,您还可以 设置议题自动关闭,一旦合并请求被合并。
当议题的活动提要被过滤为 仅显示历史记录 或 显示所有活动 时,交叉链接显示为 (Username) mentioned in merge request !(number) (time ago)
。
从分支名称中
当您在与议题相同的项目中创建一个分支并以议题编号开头,然后是一个连字符时,您创建的议题和 MR 会被链接。有关更多信息,请参阅 用议题编号前缀分支名称。