创建合并请求

1. 在合并请求页面，单击新建合并请求按钮。

2. 在描述区域下方，系统将展示可用的代码评审详情模板，包括内置模板和您的自定义模板。您也可以从描述区域的右上方的下拉菜单描述模板，选择您想要使用的代码评审详情模板。

   

3. 选择相应的模板后，模板内容将自动填充到合并请求的详细信息中，您可以根据需要进一步进行编辑。

   

浏览，编辑，创建模板文件

为了简化您的工作流程，Codeup提供了智能模板识别功能，在您与模板文件交互时自动提供帮助和指引。 当您在浏览文件时，如果系统检测到文件是一个模板文件，它将在浏览器界面上显示一个明显的提示。这样，您可以轻松地辨识出当前文件是否为模板，并按照模板格式进行相关操作。

当您在编辑文件时，如果系统检测到文件是一个模板文件，它将在浏览器界面上显示一个明显的提示，确保您在修改时可以遵循模板的规范。

当您在创建新文件时，如果您的文件命名和结构符合模板文件的规则，系统也将提示您该文件是模板文件。这有助于您在创建时即刻了解文件的模板性质，从而正确使用模板。此外，为了进一步提高您的效率，允许您在创建自定义模板时直接使用云效提供的五种内置代码评审详情模板。您可以选择一个内置模板作为起点，然后根据您的具体需求进行自定义和扩展。

创建代码库时选择合并请求模板

在创建新的代码库时，您现在可以轻松启用默认的合并请求模板。操作方法如下：

1. 在创建代码库过程中，勾选创建合并请求模板选项。

2. 从下拉菜单中选择一种云效提供的内置代码评审详情模板。

3. 系统会自动在默认分支的.aliyun文件夹下创建一个名为pull_request_template.md的模板文件。

依靠这些功能，您可以保证您的工作流程更加高效，并且与您的团队成员在提交和审查代码时保持一致性。

内置模板

Codeup提供了两种内置的合并模板，用于标准化合并请求信息：

Merge {{cr_id}} into {{cr_target}} from {{cr_source}}

{{cr_title}}

* {{cr_source}}: ({{cr_commits_count}} commits)
{{cr_commits_oneline}}

{{cr_author}}
{{cr_commentators}}
{{cr_reviewers}}
{{cr_submitter}}

{{cr_link}}

Merge {{cr_id}} into {{cr_target}} from {{cr_source}}

{{cr_title}}

* {{cr_source}}: ({{cr_commits_count}} commits)
{{cr_commits_full}}

{{cr_author}}
{{cr_commentators}}
{{cr_reviewers}}
{{cr_submitter}}

{{cr_link}}

自定义模板

如果内置模板不能满足您的需求，您可以创建自定义的代码评审合并模板。自定义模板的识别基于以下规则：

• 普通合并模板：在 .aliyun/PULL_REQUEST_TEMPLATE/MERGE_TEMPLATE 目录下创建名为 normal_merge_message.txt 的文件表示普通合并模板。

• 压缩合并模板：在 .aliyun/PULL_REQUEST_TEMPLATE/MERGE_TEMPLATE 目录下创建名为 squash_merge_message.txt 的文件表示压缩合并模板。

文件路径和模板名称不区分大小写。

模板渲染

代码评审合并模板利用Mustache模板引擎进行变量渲染，以便快速且灵活地生成合并信息。接下来，将介绍支持的模板变量以及Mustache语法的基本规则。

支持的模板变量

在您的代码评审合并模板中，您可以使用以下变量来自动填充信息：

Mustache模板引擎语法简介

Mustache是一个逻辑简单的模板系统，通常称为“无逻辑”模板。它可以使用于HTML、配置文件、源代码等。模板标签使用双花括号（{{ 和 }}）包围。以下是Mustache基本语法：

Hello, {{name}}!

Hello, John!

{
 "people": [{"name": "Alice"},
 {"name": "Bob"},
 {"name": "Charlie"}]
}

People:
{{#people}}
- {{name}}
{{/people}}

People:
- Alice
- Bob
- Charlie

Hello, {{{name}}}!

Hello, <b>John</b>!

如何使用代码评审合并模板

当您准备合并一个合并请求时，您可以选择合并方式。根据您的选择（普通合并或压缩合并），系统将使用相应的合并模板来填充合并信息。