| ... | ... | @@ -8,7 +8,7 @@ |
|
|
|
|
|
|
|
每个项目都可以定义自己的一组描述模板，这些模板将被添加到项目代码仓库的根目录中。
|
|
|
|
|
|
|
|
描述模板必须用[Markdown](/docs/user/markdown.md)编写，并存储在项目的存储库中的`.gitlab`目录下，且仅考虑默认分支的模板。
|
|
|
|
描述模板必须用[Markdown](/docs/user/markdown)编写，并存储在项目的存储库中的`.gitlab`目录下，且仅考虑默认分支的模板。
|
|
|
|
|
|
|
|
## 示例[](#use-cases "Permalink")
|
|
|
|
|
| ... | ... | @@ -18,12 +18,12 @@ |
|
|
|
|
|
|
|
## 创建 Issue 描述模板[](#creating-issue-templates "Permalink")
|
|
|
|
|
|
|
|
在代码仓库的`.gitlab/issue_templates/`目录内创建一个新的 Markdown（ `.md` ）文件，提交并推送到您的默认分支。
|
|
|
|
在代码仓库的`.gitlab/issue_templates/`目录内创建一个新的 Markdown（ `` ）文件，提交并推送到您的默认分支。
|
|
|
|
|
|
|
|
可以通过以下步骤新建一个 markdown 文件:
|
|
|
|
|
|
|
|
1. 单击`master`旁边的`+`按钮，然后单击**新建文件**
|
|
|
|
2. 将 Issue 模板的名称添加到`master`旁边的**文件名称**文本字段中，确保单词之间用下划线分隔，并且文件的扩展名为`.md` ，例如`feature_request.md`
|
|
|
|
2. 将 Issue 模板的名称添加到`master`旁边的**文件名称**文本字段中，确保单词之间用下划线分隔，并且文件的扩展名为`` ，例如`feature_request`
|
|
|
|
3. 提交并推送到您的默认分支
|
|
|
|
|
|
|
|
如果您的存储库中没有`.gitlab/issue_templates`目录，则需要创建它。
|
| ... | ... | @@ -35,21 +35,21 @@ |
|
|
|
3. 再次单击`master`旁边的`+`按钮，然后选择**新建目录**
|
|
|
|
4. 将新目录命名为`issue_templates`，并提交到默认分支
|
|
|
|
|
|
|
|
要检查它是否正常工作，请[创建一个新 Issue](/docs/user/project/issues/manage.md#create-a-new-issue)，然后查看是否可以选择描述模板。
|
|
|
|
要检查它是否正常工作，请[创建一个新 Issue](/docs/user/project/issues/manage#create-a-new-issue)，然后查看是否可以选择描述模板。
|
|
|
|
|
|
|
|
## 创建合并请求描述模板[](#creating-merge-request-templates "Permalink")
|
|
|
|
|
|
|
|
与 Issue 模板类似，在代码仓库的`.gitlab/merge_request_templates/`目录内创建一个新的 Markdown（ `.md` ）文件. 提交并推送到您的默认分支。
|
|
|
|
与 Issue 模板类似，在代码仓库的`.gitlab/merge_request_templates/`目录内创建一个新的 Markdown（ `` ）文件. 提交并推送到您的默认分支。
|
|
|
|
|
|
|
|
## 使用模板[](#using-the-templates "Permalink")
|
|
|
|
|
|
|
|
假设我们已经创建了`.gitlab/issue_templates/Bug.md`文件，在创建或编辑问题时，这将启用`Bug`下拉选项，选择`Bug`，`Bug.md`模板文件中的内容将被复制到 Issue 描述字段；可以通过"重置模板"按钮放弃您在选择模板后所做的任何更改，并将其恢复为初始状态。
|
|
|
|
假设我们已经创建了`.gitlab/issue_templates/Bug`文件，在创建或编辑问题时，这将启用`Bug`下拉选项，选择`Bug`，`Bug`模板文件中的内容将被复制到 Issue 描述字段；可以通过"重置模板"按钮放弃您在选择模板后所做的任何更改，并将其恢复为初始状态。
|
|
|
|
|
|
|
|
## 描述模板示例[](#description-template-example "Permalink")
|
|
|
|
|
|
|
|
GitLab 社区版项目中提供了一些 Issue 及合并请求的描述模板，具体的可以参考[`.gitlab`文件夹](https://gitlab.com/gitlab-org/gitlab/tree/master/.gitlab)中的一些示例。
|
|
|
|
|
|
|
|
**提示：**可以在描述模板中使用[快速操作](/docs/user/project/quick-actions.md)来快速添加标签，指派人和里程碑。仅当提交问题或合并请求的用户有权执行相关操作时，才可以执行快速操作。
|
|
|
|
**提示：**可以在描述模板中使用[快速操作](/docs/user/project/quick-actions)来快速添加标签，指派人和里程碑。仅当提交问题或合并请求的用户有权执行相关操作时，才可以执行快速操作。
|
|
|
|
|
|
|
|
以下是一个 bug 的模板示例：
|
|
|
|
|
| ... | ... | |
