diff --git a/SUMMARY.md b/SUMMARY.md index 40c64f27940f31b1af9c070e7aca308bdb0a7af1..552b80af0b405bd234387c95d4fdf8d1ad97e833 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -47,7 +47,7 @@ * [关联Issue](docs/user/project/issues/crosslinking.md) * [截止日期](docs/user/project/issues/due-date.md) * [看板](docs/user/project/kanban.md) - * [Issue操作](docs/user/project/issues/actions.md) + * [操作Issue](docs/user/project/issues/actions.md) * [标签](docs/user/project/label.md) * [管理Issue](docs/user/project/issues/manage.md) * [里程碑](docs/user/project/milestone.md) diff --git a/_book/gitbook/gitbook-plugin-theme-fexa/logo.png b/_book/gitbook/gitbook-plugin-theme-fexa/logo.png index 8ef04aca0f633c9a1c7075681ef1db4b8e03c7f9..232da0313e258614b0101832ddc9d2d85c4c4b35 100644 Binary files a/_book/gitbook/gitbook-plugin-theme-fexa/logo.png and b/_book/gitbook/gitbook-plugin-theme-fexa/logo.png differ diff --git a/_book/index.html b/_book/index.html index 53070806dd1f61eb94eef210d8155f8da886dacd..47e15c383d902b8becbbe86cd05fc884f9d95bd1 100644 --- a/_book/index.html +++ b/_book/index.html @@ -12,7 +12,6 @@ - @@ -34,14 +33,6 @@ - - - - - - - - @@ -69,9 +60,6 @@ - - - @@ -798,7 +786,7 @@ - Issue操作 + 操作Issue @@ -1270,13 +1258,12 @@ - @@ -1301,10 +1288,6 @@ - - - - @@ -1317,8 +1300,6 @@ - - diff --git a/book.json b/book.json index 546ec9bc1aaf873f3cd3a47b5a0db92a140b238f..e89f38122fc4deaa386d9c4673f2dc55caee2f75 100644 --- a/book.json +++ b/book.json @@ -18,10 +18,8 @@ "tbfed-pagefooter", "chapter-fold", "-lunr", - "-search", - "search-pro", - "mermaid-gb3", - "advanced-emoji" + "-search", + "search-pro" ], "variables": { "themeFexa":{ diff --git a/docs/.DS_Store b/docs/.DS_Store index fd36d924cfb006d36c95de57fb7daedaaafb7c2d..f976682baec5a7c2b98821b6482d18fd641baab8 100644 Binary files a/docs/.DS_Store and b/docs/.DS_Store differ diff --git a/docs/img/import_projects_from_repo_url.png b/docs/img/import_projects_from_repo_url.png new file mode 100644 index 0000000000000000000000000000000000000000..4ad51a29940c9f52cab0a58b43160617730e9a0e Binary files /dev/null and b/docs/img/import_projects_from_repo_url.png differ diff --git a/docs/img/issues_main_view_numbered.png b/docs/img/issues_main_view_numbered.png new file mode 100644 index 0000000000000000000000000000000000000000..2693dca163d744a2523f23d4f6837a8e3f7723a4 Binary files /dev/null and b/docs/img/issues_main_view_numbered.png differ diff --git a/docs/user/project/import/by-url.md b/docs/user/project/import/by-url.md index 1fad93b282989889173b92d39a7d07adceec6012..0520d538d7e6e77fda5ce9f0aedde6eb4b022f0f 100644 --- a/docs/user/project/import/by-url.md +++ b/docs/user/project/import/by-url.md @@ -1,12 +1,12 @@ # 通过URL导入[](#通过URL导入 "Permalink") -您可以通过提供 Git URL 来导入现有存储库： +您可以通过提供 Git URL 来导入现有的代码仓库： -1. 在您的 GitLab 仪表板中，单击" **新建项目".** +1. 在您的仪表板中，单击" **新建项目"** 2. 切换到**导入项目**选项卡 -3. 点击**按 URL 回购**按钮 -4. 填写" Git 存储库 URL"和其余项目字段 +3. 点击**按 URL Repo**按钮 +4. 填写" Git 代码仓库 URL"和其余项目字段 5. 单击**创建项目**开始导入过程 6. 完成后，您将被重定向到新创建的项目 -[![Import project by repo URL](img/731943edb4428a3eb27c86d8d454d0e0.png)](img/import_projects_from_repo_url.png) \ No newline at end of file +[![Import project by repo URL](img/import_projects_from_repo_url.png)](img/import_projects_from_repo_url.png) \ No newline at end of file diff --git a/docs/user/project/import/github.md b/docs/user/project/import/github.md index 7f81bfdca3caf41b6b0cc4733675ec7a4d9559d6..292347c6a41f62cc90b73b9688bad20e73f2d929 100644 --- a/docs/user/project/import/github.md +++ b/docs/user/project/import/github.md @@ -1,106 +1,34 @@ # 从Github导入[](#从Github导入 "Permalink") -使用导入器，您可以将 GitHub 存储库导入 GitLab.com 或自管理的 GitLab 实例. +使用导入器，您可以将 GitHub 代码仓库导入 CODEChina。 -## Overview[](#overview "Permalink") - -**注意：**这些说明适用于 GitLab.com 上的用户，但是如果您是自助 GitLab 实例的管理员，或者要从 GitHub Enterprise 导入，则必须启用[GitHub 集成](../../../integration/github.html) . GitHub 集成是从 GitHub Enterprise 导入的唯一方法. 如果您使用的是 GitLab.com，则可以使用[个人访问令牌](#using-a-github-token)导入 GitHub 存储库，但不建议使用此方法，因为该方法无法将所有用户活动（例如问题和请求请求）与匹配的 GitLab 用户相关联. 如果您是自我管理的 GitLab 实例的管理员，则还可以使用[GitHub Rake 任务](../../../administration/raketasks/github_import.html)从 GitHub 导入项目，而不受 Sidekiq worker 的限制. +## 概览[](#overview "Permalink") 导入了项目的以下方面： -* 仓库描述（GitLab.com＆7.7+） -* Git 存储库数据（GitLab.com＆7.7+） -* 问题（GitLab.com 和 7.7+） -* 拉取请求（GitLab.com＆8.4+） -* Wiki 页面（GitLab.com＆8.4+） -* 里程碑（GitLab.com＆8.7+） -* 标签（GitLab.com 和 8.7+） -* 发行说明说明（GitLab.com 和 8.12+） -* 拉取请求评论评论（GitLab.com＆10.2+） -* 定期发布和请求请求注释 - -保留对拉取请求和问题的引用（GitLab.com＆8.7+），并且每个导入的存储库都保持可见性级别，除非该[可见性级别受到限制](../../../public_access/public_access.html#restricting-the-use-of-public-or-internal-projects) ，在这种情况下，它默认为默认项目可见性. - -## How it works[](#how-it-works "Permalink") - -导入问题和请求请求时，导入程序会尝试在 GitLab 实例的数据库中查找其 GitHub 作者和受让人（请注意，请求请求在 GitLab 中称为"合并请求"）. - -For this association to succeed, each GitHub author and assignee in the repository must meet one of the following conditions prior to the import: - -* 以前使用 GitHub 图标登录到 GitLab 帐户. -* 有一个 GitHub 帐户，其[主要电子邮件地址](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)与其 GitLab 帐户的电子邮件地址匹配. - -如果在 GitLab 的数据库中未找到项目中引用的用户，则将项目创建者（通常是启动导入过程的用户）设置为作者/受让人，但是会添加关于该问题的注释，其中提及原始 GitHub 作者. - -如果不存在任何新的名称空间（组），或者如果采用了名称空间，则导入器会创建存储库，该存储库将在启动导入过程的用户的名称空间下导入. 命名空间/存储库名称也可以使用适当的权限进行编辑. - -进口商还将在与未完成拉取请求相关的项目的分支上导入分支. 这些分支将以类似于`GH-SHA-username/pull-request-number/fork-name/branch`的命名方案导入. 与 GitHub 存储库相比，这可能导致分支中的差异. - -有关更多技术细节，您可以参考[GitHub Importer](../../../development/github_importer.html "使用 GitHub 导入器")开发人员文档. - -有关导入过程的概述，请参阅[从 GitHub 迁移到 GitLab](https://youtu.be/VYOXuOg9tQI)的视频. - -## Import your GitHub repository into GitLab[](#import-your-github-repository-into-gitlab "Permalink") - -### Using the GitHub integration[](#using-the-github-integration "Permalink") - -在开始之前，请确保要映射到 GitLab 用户的所有 GitHub 用户都具有以下任一条件： - -* 使用 GitHub 图标登录的 GitLab 帐户-或- -* 一个 GitLab 帐户，其电子邮件地址与 GitHub 用户的[公共电子邮件地址](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)匹配 - -用户匹配尝试将按该顺序进行，并且如果两种方法均未识别到用户，则该活动将与执行导入的用户帐户相关联. - -**注意：**如果您使用的是自助式 GitLab 实例，或者要从 GitHub Enterprise 导入，则此过程要求您已配置[GitHub 集成](../../../integration/github.html) . - -1. 在顶部导航栏中，单击**+** ，然后选择**新建项目** . -2. 选择**导入项目**选项卡，然后选择**GitHub** . -3. 选择第一个按钮以**列出您的 GitHub 存储库** . 您将被重定向到[GitHub 上](https://github.com)的页面以授权 GitLab 应用程序. -4. 点击**授权 gitlabhq** . 您将被重定向回 GitLab 的 Import 页面，并列出所有 GitHub 存储库. -5. 继续[选择要导入的存储库](#selecting-which-repositories-to-import) . - -### Using a GitHub token[](#using-a-github-token "Permalink") - -**注意：**不建议使用个人访问令牌导入项目. 如果您是 GitLab.com 用户，则可以使用个人访问令牌从 GitHub 导入项目，但是该方法无法将所有用户活动（例如问题和请求请求）与匹配的 GitLab 用户关联. 如果您是自我管理的 GitLab 实例的管理员，或者要从 GitHub Enterprise 导入，则不能使用个人访问令牌. 建议所有用户使用[GitHub 集成方法（上述）](#using-the-github-integration) . 在" [如何工作"](#how-it-works)部分中了解更多信息. - -如果您不使用 GitHub 集成，则仍可以通过 GitHub 执行授权以授予 GitLab 访问您的存储库的权限： - -1. 转到[https://github.com/settings/tokens/new](https://github.com/settings/tokens/new) -2. 输入令牌描述. -3. 选择回购范围​​. -4. Click **生成令牌**. -5. 复制令牌哈希. -6. 返回到 GitLab 并将令牌提供给 GitHub 导入器. -7. 点击**列出您的 GitHub 存储库**按钮，并等待 GitLab 读取您的存储库信息. 完成后，将带您到导入器页面以选择要导入的存储库. - -### Selecting which repositories to import[](#selecting-which-repositories-to-import "Permalink") - -在授权访问 GitHub 存储库后，您将重定向到 GitHub 导入程序页面，并列出 GitHub 存储库. - -1. 默认情况下，建议的存储库名称空间与 GitHub 中存在的名称匹配，但是根据您的权限，您可以选择在继续导入任何名称之前编辑这些名称. -2. 选择任意数量的存储库旁边的**导入**按钮，或选择**导入所有存储库** . 此外，您可以按名称过滤项目. 如果应用了过滤器，则" **导入所有存储库"**仅导入匹配的存储库. -3. " **状态"**列显示每个存储库的导入状态. 您可以选择让页面保持打开状态，它将实时更新，也可以稍后返回. -4. 导入存储库后，单击其 GitLab 路径以打开其 GitLab URL. - -[![Github importer page](img/67f7d8117f3d6bf60fe4d5e03bca7b6e.png)](img/import_projects_from_github_importer_v12_3.png) - -## Mirroring and pipeline status sharing[](#mirroring-and-pipeline-status-sharing "Permalink") - -根据您的 GitLab 层，可以设置[项目镜像](../repository/repository_mirroring.html) ，以使导入的项目与其 GitHub 副本保持同步. +* 仓库描述 +* Git 存储库数据 +* Issue +* 拉取请求 +* Wiki +* 里程碑 +* 标签 +* Release +* 拉取请求评论 +* 定期发布和请求注释 -此外，您可以配置 GitLab 以通过[GitHub Project Integration](../integrations/github.html)将管道状态更新发送回 GitHub. +保留对拉取请求和问题的引用，并且每个导入的存储库都保持可见性级别，除非该[可见性级别受到限制](../../../public_access/public_access.html#restricting-the-use-of-public-or-internal-projects) ，在这种情况下，它默认为默认项目可见性。 -如果使用[CI / CD 作为外部存储库](../../../ci/ci_cd_for_external_repos/index.html)导入项目，则会自动配置以上两项. +## 实现原理[](#how-it-works "Permalink") -## Improving the speed of imports on self-managed instances[](#improving-the-speed-of-imports-on-self-managed-instances "Permalink") +导入 Issue 和拉取请求时，导入程序会尝试在数据库中查找其 GitHub 作者和 指派人（请注意，拉取请求在 CODEChina 中被称为"合并请求"）。 -**注意：**必须具有对 GitLab 服务器的管理员访问权限. +为了导入成功，在Github 项目导入前，至少需要项目中的每个作者和指派人都应该满足下列条件： -对于大型项目，可能需要一段时间才能导入所有数据. 为了减少必要的时间，您可以增加处理以下队列的 Sidekiq 工作程序的数量： +* 有一个 GitHub 帐户，其[主要电子邮件地址](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)与其 CODEChina 帐户的电子邮件地址匹配。 -* `github_importer` -* `github_importer_advance_stage` +如果在 CODEChina 的数据库中未找到项目中引用的用户，则会将项目创建者（通常是启动导入的用户）设置为作者/指派人，但是对于该项目中 Issue 的评论，还是会提及到 Github 原作者。 -For an optimal experience, it’s recommended having at least 4 Sidekiq processes (each running a number of threads equal to the number of CPU cores) that *only* process these queues. It’s also recommended that these processes run on separate servers. For 4 servers with 8 cores this means you can import up to 32 objects (e.g., issues) in parallel. +如果导入项目的命名空间不存在，则导入项目时会创建新的命名空间/组织；如果名称空间已经被占用，则会将该项目导入至启动导入过程的用户的命名空间里，命名空间/代码仓库名称也可以由具有权限的用户进行编辑。 -减少克隆存储库所花费的时间可以通过增加存储 Git 存储库（适用于您的 GitLab 实例）的磁盘的网络吞吐量，CPU 容量和磁盘性能（例如，使用高性能 SSD）来完成. 增加 Sidekiq 工作人员的数量*不会*减少克隆存储库所花费的时间. \ No newline at end of file +有关更多技术细节，您可以参考使用 GitHub 导入器开发人员文档。 \ No newline at end of file diff --git a/docs/user/project/issues/actions.md b/docs/user/project/issues/actions.md index 155e599b006c7778743663e97e8f8ba43d5aac1b..ac7d53205b5b7d13bfa7414d782c17f85a8f9593 100644 --- a/docs/user/project/issues/actions.md +++ b/docs/user/project/issues/actions.md @@ -1,231 +1,167 @@ # 操作Issue[](#操作Issue "Permalink") -请通读[GitLab 问题文档](index.html)以获取有关 GitLab 问题的概述. +请参考[ Issue 文档](index.html)以了解更多关于 Issue 的介绍。 -## Parts of an Issue[](#parts-of-an-issue "Permalink") +## Issue的元素[](#parts-of-an-issue "Permalink") -下图说明了问题的外观. 请注意，根据使用的 GitLab 版本和查看问题的用户权限，某些部分看起来可能会略有不同或不存在. +下图说明了问题的构成，请注意，根据查看问题的用户权限不同，某些部分看起来可能会略有不同或不存在。 -您可以在一个屏幕上找到该问题的所有信息. +您可以在一个屏幕上找到该 Issue 的所有信息。 -[![Issue view](img/b6662e0dd306cb7949bbfd70db9b384c.png)](img/issues_main_view_numbered.png) +[![Issue view](/../../docs/img/issues_main_view_numbered.png)](img/issues_main_view_numbered.png) -* **1.** [New Issue, close issue (reopen issue, report issue)](#new-issue-close-issue-reopen-issue-report-issue) -* **2.** [To Do](#to-do) -* **3.** [Assignee](#assignee) - * **3.1.** [Multiple Assignees](#multiple-assignees-starter) -* **4.** [Epic](#epic-premium) -* **5.** [Milestone](#milestone) -* **6.** [Time tracking](#time-tracking) -* **7.** [Due date](#due-date) -* **8.** [Labels](#labels) -* **9.** [Weight](#weight-starter) -* **10.** [Confidentiality](#confidentiality) -* **11.** [Lock issue](#lock-issue) -* **12.** [Participants](#participants) -* **13.** [Notifications](#notifications) -* **14.** [Reference](#reference) -* **15.** [Edit](#edit) -* **16.** [Description](#description) -* **17.** [Mentions](#mentions) -* **18.** [Related Issues](#related-issues-starter) -* **19.** [Related Merge Requests](#related-merge-requests) -* **20.** [Award emoji](#award-emoji) -* **21.** [Show all activity](#show-all-activity) -* **22.** [Create Merge Request](#create-merge-request) -* **23.** [Issue history](#issue-history) - * [Activity sort order](#activity-sort-order) -* **24.** [Comments](#comments) -* **25.** [Submit comment, start a thread, or comment and close](#submit-comment-start-a-thread-or-comment-and-close) -* **26.** [Zoom meetings](#zoom-meetings) +* **1.** [新建 Issue, 关闭 issue (重新开启 issue, 报告 issue)](#new-issue-close-issue-reopen-issue-report-issue) +* **2.** [新建待办事项](#to-do) +* **3.** [指派](#assignee) +* **4.** [里程碑](#milestone) +* **5.** [工时统计](#time-tracking) +* **6.** [截止日期](#due-date) +* **7.** [标签](#labels) +* **8.** [机密性](#confidentiality) +* **9.** [锁定 Issue](#lock-issue) +* **10.** [参与者](#participants) +* **11.** [通知](#notifications) +* **12.** [移动 Issue](#reference) +* **13.** [编辑 Issue](#edit) +* **14.** [Issue 描述](#description) +* **15.** [相关合并请求](#related-merge-requests) +* **16.** [点赞](#award-emoji) +* **17.** [查看全部活动](#show-all-activity) +* **18.** [创建合并请求](#create-merge-request) +* **19.** [Issue 历史](#issue-history) +* **20.** [评论](#comments) +* **21.** [提交评论，开启新的讨论，关闭 Issue](#submit-comment-start-a-thread-or-comment-and-close) -问题从状态（打开或关闭）开始，然后是作者，并包括许多其他功能，在上图中编号，以逐一解释其含义. +Issue 从状态（打开或关闭）开始，然后是作者，并包括许多其他功能，在上图中编号，下面将逐一进行解释。 -当问题由其他用户更改时，问题屏幕的许多元素都会自动刷新，例如标题和说明. 注释和系统注释也会根据各种操作和内容更新自动更新. +当 Issue 由其他用户更改时，Issue 页面的许多元素都会自动刷新，例如标题和说明。评论和系统评论也会根据各种操作和内容更新自动更新。 -### New Issue, close issue (reopen issue, report issue)[](#new-issue-close-issue-reopen-issue-report-issue "Permalink") +### 新建 Issue, 关闭 issue (重新开启 issue, 报告 issue)[](#new-issue-close-issue-reopen-issue-report-issue "Permalink") -单击" **新问题"**将打开一个新窗口，以在同一项目中创建一个新问题. 单击**关闭问题**将关闭此问题，但不会被删除. 如果问题已经关闭，您仍然可以访问它，并且按钮将显示**Reopen issue** ，如下所示，您可以单击以重新打开问题. 重新开放的问题与其他任何问题都没有不同. +单击" **新建 Issue"**将打开一个新窗口，可以在同一项目中创建一个新 Issue。单击**关闭 Issue**将关闭此 Issue，但不会被删除。如果 Issue 已经关闭，您仍然可以访问它，并且按钮将显示**重新开启 issue** ，您可以单击以重新打开 Issue，重新开放的 Issue 与其他任何 Issue 都没有不同。 -[![Reopen Issue](img/136df5416c67f2d80606b4849658e289.png)](img/reopen-issue.png) +如果您无权修改 Issue，则" **关闭 Issue"**按钮将替换为" **举报 Issue"** ，您可以单击该按钮以[提交](../../abuse_reports.html)有关该 Issue [的滥用情况报告](../../abuse_reports.html)； 如果您有权修改 Issue，但仅在关闭 Issue后，它也会显示. -如果您无权修改问题，则" **关闭问题"**按钮将替换为" **报告问题"** ，您可以单击该按钮以[提交](../../abuse_reports.html)有关该问题[的滥用情况报告](../../abuse_reports.html) . 如果您有权修改问题，但仅在关闭问题后，它也会显示. +### 待办事项[](#to-do "Permalink") -[![Report Abuse](img/16f0d7c3d19700b0e30aa6c1528acb91.png)](img/report-abuse.png) +您可以在[待办事项列表](../../todos.html)添加待办事项或从中删除待办事项。具体可以执行的操作取决于待办事项是否已在"任务列表"中，如果问题是： -### To Do[](#to-do "Permalink") +* 已在您的待办事项清单上：该按钮标有" **标记为已完成"** ，单击按钮以从您的任务列表中删除该问题 +* 不在您的待办事项清单上：该按钮标有**添加待办事项** ，单击按钮将问题添加到您的"任务列表"中 -您可以在[GitLab 任务列表中](../../todos.html)添加问题或从中删除问题. - -执行此操作的按钮具有不同的标签，具体取决于问题是否已在"任务列表"中. 如果问题是： - -* 已在您的待办事项清单上：该按钮标有" **标记为已完成"** . 单击按钮以从您的任务列表中删除该问题. -* 不在您的待办事项清单上：该按钮标有**添加待办事项** . 单击按钮将问题添加到您的"任务列表"中. - -### Assignee[](#assignee "Permalink") +### 指派[](#assignee "Permalink") 可以将问题分配给： -* Yourself. -* 另一个人. -* [Many people](#multiple-assignees-starter). - -可以根据需要频繁更改受让人. 想法是，受让人应对该问题负责，直到将其重新分配给其他人以解决该问题为止. 分配给某人后，它将显示在其分配的问题列表中. - -**提示：**如果用户不是该项目的成员，则只有他们自己创建问题后才能将其分配给他们. - -#### Multiple Assignees[](#multiple-assignees-starter "Permalink") - -通常，多个人会共同处理同一问题，而在拥有问题共享所有权的大型团队中，跟踪这些问题尤其困难. - -在[GitLab Starter 中](https://about.gitlab.com/pricing/) ，您可以[将多个人分配](multiple_assignees_for_issues.html)给一个问题. - -### Epic[](#epic-premium "Permalink") - -您可以将问题分配给[Epic](../../group/epics/index.html) ，从而可以更好地管理相关问题组. - -### Milestone[](#milestone "Permalink") - -选择一个[里程碑](../milestones/index.html) ，将问题归因于此. - -### Time tracking[](#time-tracking "Permalink") - -使用[GitLab 快速行动](../quick_actions.html)来[跟踪估计和花费在问题上的时间](../time_tracking.html) . 您可以添加解决问题[所需时间](../time_tracking.html#estimates)的[估计，](../time_tracking.html#estimates)还可以添加解决问题[所花费的时间](../time_tracking.html#time-spent) . +* 您自己 +* 其他用户 -### Due date[](#due-date "Permalink") +可以根据需要频繁更改指派人，指派人应对该 Issue 负责，直到将其重新分配给其他人至解决该 Issue 为止。分配给某人后，Issue 将显示在其分配的 Issue 列表中。 -当您的工作时间很紧时，重要的是要有一种方法来为实现和解决问题设置截止日期. 这可以在[截止日期](due_dates.html)元素中完成. 截止日期可以根据需要进行多次更改. +**提示：**如果用户不是该项目的成员，则只有他们自己创建的 Issue 才能够分配给他们。 -### Labels[](#labels "Permalink") +### 里程碑[](#milestone "Permalink") -通过给它们加上[标签](../labels.html)来对问题进行分类. 它们有助于组织工作流程，并使您能够与[GitLab 发行委员会合作](index.html#issue-boards) . +选择一个[里程碑](../milestones/index.html) ，并将 Issue 归类到其中。 -还可以为组标签分配问题，该组标签允许您对同一组内的所有项目使用相同的标签. 它们的工作原理完全相同，但可立即用于该组中的所有项目. +### 工时统计[](#time-tracking "Permalink") -**提示：**如果标签尚不存在，可以单击**编辑** ，它会打开一个下拉菜单，从中可以选择**创建新标签** . +使用[快速行动](../quick_actions.html)来[跟踪估计和花费在 Issue 上的时间](../time_tracking.html) ，您可以添加解决 Issue [所需时间](../time_tracking.html#estimates)的[估计](../time_tracking.html#estimates)，还可以添加解决 Issue[所花费的时间](../time_tracking.html#time-spent) 。 -### Weight[](#weight-starter "Permalink") +### 截止日期[](#due-date "Permalink") -为问题[分配权重](issue_weight.html) . 使用较大的值表示完成此问题需要付出更多的努力. 仅允许正值或零. +当您的工作时间很紧时，有一种方法来为实现和解决 Issue 设置截止日期将尤为重要。这可以在[截止日期](due_dates.html)元素中完成，截止日期可以根据需要进行多次更改。 -### Confidentiality[](#confidentiality "Permalink") +### 标签[](#labels "Permalink") -您可以[将问题设置为机密](confidential_issues.html) . 设置后，未经授权的用户将无法访问该问题，也不会在项目问题委员会或问题列表中看到该问题. +通过给 Issue 加上[标签](../labels.html)来对其进行分类，它们有助于组织工作流程，并使您能够更顺畅的使用看板。 -### Lock issue[](#lock-issue "Permalink") +还可以为组织标签分配 Issue ，组织标签允许您对同一组内的所有项目使用相同的标签，它们的工作原理完全相同，并且可立即用于该组织的所有项目。 -您可以[锁定问题中的线程](../../discussions/index.html#lock-discussions) ，以防止添加更多评论. +**提示：**如果标签尚不存在，可以单击**编辑** ，它会打开一个下拉菜单，从中可以选择**创建新标签** 。 -### Participants[](#participants "Permalink") +### 机密性[](#confidentiality "Permalink") -涉及该问题的所有用户. 他们要么参与了该[线程](../../discussions/index.html) ，要么在描述或线程中被提及. +您可以[将 Issue 设置为机密](confidential_issues.html)， 设置后，未经授权的用户将无法访问该 Issue，也不会在项目看板或 Issue 列表中看到该 Issue。 -### Notifications[](#notifications "Permalink") +### 锁定 Issue[](#lock-issue "Permalink") -单击该图标以启用/禁用该问题的[通知](../../profile/notifications.html#issue--epics--merge-request-events) . 如果您以任何方式参与该问题，它将自动启用. +您可以[锁定 Issue 中的讨论](../../discussions/index.html#lock-discussions) ，以防止添加更多评论。 -* **Enable**: If you are not a participant in the discussion on that issue, but want to receive notifications on each update, subscribe to it. -* **禁用** ：如果您正在接收有关该问题的更新通知，但不再希望接收它们，请取消订阅. +### 参与者[](#participants "Permalink") -### Reference[](#reference "Permalink") +涉及该 Issue 的所有用户，他们要么参与了该 Issue 的[讨论](../../discussions/index.html) ，要么在描述或讨论中被提及。 -* 快速"复制"按钮，这个问题的参考，它看起来像`foo/bar#xxx` ，其中`foo`是`username`或`groupname` ， `bar`是`project-name` ，并且`xxx`是发行数量. +### 通知[](#notifications "Permalink") -### Edit[](#edit "Permalink") +单击图标以启用/禁用该 Issue 的[通知](../../profile/notifications.html#issue--epics--merge-request-events) ，如果您以任何方式参与了该 Issue，它将自动启用。 -单击此图标可打开要编辑的问题，您将有权访问与创建问题时相同的所有字段. 如果用户没有编辑问题的权限，则不会显示此图标. +* **启用**: 如果您不是该 Issue 的参与者，但想要了解该 Issue 的进展，您可以启用并订阅该 Issue 的更新通知 +* **禁用** ：如果您正在接收有关该 Issue 的更新通知，但不再希望接收它们，请禁用该通知 -### Description[](#description "Permalink") +### 编辑[](#edit "Permalink") -纯文本标题和问题描述位于问题页面的顶部中心. 该描述完全支持[GitLab 风味 Markdown](../../markdown.html#gitlab-flavored-markdown-gfm) ，允许许多格式选项. +单击此图标可编辑当前 Issue ，您将有权访问与创建 Issue 时的全部字段，如果用户没有编辑 Issue 的权限，则不会显示此图标。 -> [自 GitLab 12.6 起](https://gitlab.com/gitlab-org/gitlab/-/issues/10103) ， [问题历史记录](#issue-history)中列出了对[问题](#issue-history)描述的更改. +### 描述[](#description "Permalink") -### Mentions[](#mentions "Permalink") +纯文本标题和 Issue 描述位于 Issue 页面的顶部，该描述完全支持[Markdown](../../markdown.html#gitlab-flavored-markdown-gfm) ，支持许多格式。问题历史记录中列出了对 Issue 描述的更改记录。 -您可以使用`@username`或`@groupname`提及您的 GitLab 实例中存在的用户或组，除非他们在配置文件设置中禁用了所有通知，否则它们将通过待办事项和电子邮件得到通知. 这是在[通知设置中](../../profile/notifications.html)控制的. +### 提及[](#mentions "Permalink") -自己的提及（当前登录的用户）将以不同的颜色突出显示，使您可以轻松查看涉及到的评论，帮助您快速关注它们. +您可以使用`@username`或`@groupname`提及用户或组织，除非他们设置禁用了所有通知，否则它们将通过待办事项和电子邮件得到通知，这是在[通知设置中](../../profile/notifications.html)控制的。 -**提示：**避免在问题中提及`@all`并合并请求，因为它会向该项目组的所有成员发送电子邮件通知，这可以解释为垃圾邮件. +自己的提及（当前登录的用户）将以不同的颜色突出显示，使您可以轻松查看涉及到的评论，帮助您快速关注它们。 -### Related Issues[](#related-issues-starter "Permalink") +**提示：**避免在问题中提及`@all`并合并请求，因为它会向该项目组的所有成员发送电子邮件通知，产生垃圾邮件。 -这里列出了被称为[相关问题的问题](related_issues.html) . 您也可以单击`+`添加更多相关问题. +### 相关的合并请求[](#related-merge-requests "Permalink") -### Related Merge Requests[](#related-merge-requests "Permalink") +该 Issue 的描述或 Issue 讨论中提到的[合并请求](crosslinking_issues.html#from-merge-requests)在此处列为[相关合并请求](crosslinking_issues.html#from-merge-requests) ，另外，如果当前 Issue 在另一个合并请求中被提及，则该合并请求也将在此处列出。 -该问题的描述或问题线程中提到的[合并请求](crosslinking_issues.html#from-merge-requests)在此处列为[相关合并请求](crosslinking_issues.html#from-merge-requests) . 另外，如果当前问题在另一个合并请求中被提及是相关的，则该合并请求将在此处列出. +### 点赞[](#award-emoji "Permalink") -### Award emoji[](#award-emoji "Permalink") +您可以为该 Issue 点赞， 有"顶"和"踩"两种快捷方式，或者您可以单击浅灰色的"笑脸"图标并从可用的[Markdown Emoji](../../markdown.html#emoji)下拉列表中选择其他表情。 -您可以为该问题授予表情符号. 有" thumbs_up"和" thumbs_down"的快捷方式，或者您可以单击浅灰色的" face"从可用的[GitLab 风味 Markdown Emoji](../../markdown.html#emoji)下拉列表中选择其他反应. +**提示：在讨论中**发布"+1"作为评论会对该 Issue 的所有参与/订阅者造成垃圾邮件，也会使讨论内容显得混乱，因此不建议这样做.。给 Issue 点赞是一种让他们知道您的反应而不会发送垃圾邮件的方法，我们更建议您使用这种方式。 -**提示：在主题中**张贴" +1"作为评论会对该问题的所有订阅参与者造成垃圾邮件，会使主题混乱，因此不建议这样做. 授予表情符号是一种让他们知道您的反应而不会向其发送垃圾邮件的方法. +### 显示所有活动[](#show-all-activity "Permalink") -### Show all activity[](#show-all-activity "Permalink") +您可以通过单击**显示所有活动**并选择以下任一内容来过滤 Issue 历史记录中**显示的内容** ： -您可以通过单击**显示所有活动**并选择以下任一内容来过滤问题历史记录中**显示的内容** ： - -* **仅显示评论** ，仅显示主题并隐藏问题的更新. -* **仅显示历史记录** ，它隐藏线程并且仅显示更新. +* **仅显示评论** ，仅显示讨论并隐藏 Issue 的更新 +* **仅显示历史记录** ，仅显示更新并隐藏讨论 Also: -* 您可以使用`@username`或`@groupname`提及您的 GitLab 实例中存在的用户或组，除非他们已[禁用](#notifications)其配置文件设置中的[所有通知](#notifications) ，否则它们将通过待办事项和电子邮件得到[通知](#notifications) . -* 自己的提及（当前登录的用户）将以不同的颜色突出显示，使您可以轻松查看涉及到的评论，帮助您快速关注它们. - -[![Show all activity](img/6a23362ee367dd144c2c8ea315b8dde0.png)](img/show-all-activity.png) - -### Create Merge Request[](#create-merge-request "Permalink") - -在一个动作中创建一个新的分支和[**草稿**合并请求](../merge_requests/work_in_progress_merge_requests.html) . 默认情况下，该分支将被命名为`issuenumber-title` ，但是您可以选择任何名称，并且 GitLab 会验证该分支尚未被使用. 合并请求将自动继承问题的里程碑和标签，并设置为在合并时关闭问题. +* 您可以使用`@username`或`@groupname`提及用户或组，除非他们已[禁用](#notifications)其配置文件设置中的[所有通知](#notifications) ，否则它们将通过待办事项和电子邮件得到[通知](#notifications) +* 自己的提及（当前登录的用户）将以不同的颜色突出显示，使您可以轻松查看涉及到的评论，帮助您快速关注它们。 -[![Create MR from issue](img/2a301148b56e04c50113445dc7280c15.png)](img/create_mr_from_issue.png) +### 创建合并请求[](#create-merge-request "Permalink") -（可选）您可以选择仅创建一个[新分支](../repository/web_editor.html#create-a-new-branch-from-an-issue) ，以该问题命名. +通过一个操作同时完成创建一个新的分支和**草稿**合并请求， 默认情况下，该分支将被命名为`issuenumber-title` ，但是您可以选择任何名称，并且系统会验证该分支是否已经被使用。创建的合并请求将自动继承 Issue 的里程碑和标签，并设置为在合并时自动关闭 Issue 。 -### Issue history[](#issue-history "Permalink") +（可选）您可以选择仅创建一个[新分支](../repository/web_editor.html#create-a-new-branch-from-an-issue) ，并以该 Issue 命名。 -All comments and updates to the issue are tracked and listed here, but this can be filtered, as shown above. +### Issue 历史记录[](#issue-history "Permalink") -#### Activity sort order[](#activity-sort-order "Permalink") +所有向该 Issue 提交的评论和更新都会被列出在 Issue 历史记录中，如上面介绍的，可以通过过滤条件筛选 Issue 历史记录。 -在 GitLab 12.10 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/14588) . +#### 动态排序[](#activity-sort-order "Permalink") -您可以颠倒默认顺序，并与按顶部的最新项目排序的活动供稿进行交互. 您的首选项通过本地存储保存，并自动应用于您查看的每个问题. +您可以颠倒 Issue 动态的默认顺序，上方的 Issue 动态将按照您的选择排序。您的排序方式将通过本地存储保存，并自动应用于您查看的每一个 Issue 。 -要更改活动排序顺序，请单击**最旧的第一个**下拉菜单，然后选择最旧或最新的项目以首先显示. +要更改 Issue 动态排序顺序，请单击**按时间倒叙**下拉菜单，然后选择最旧或最新的优先显示。 -[![Issue activity sort order dropdown button](img/db92110fba2588fed57b9af6bb2a381c.png)](img/issue_activity_sort_order_v12_10.png) +### 评论[](#comments "Permalink") -### Comments[](#comments "Permalink") +通过在讨论中发布评论来协作解决 Issue ，评论框将完全支持Markdown。 -通过在其主题中发布评论来协作解决问题. 该文本字段还完全支持[GitLab 风味 Markdown](../../markdown.html#gitlab-flavored-markdown-gfm) . - -### Submit comment, start a thread, or comment and close[](#submit-comment-start-a-thread-or-comment-and-close "Permalink") +### 提交评论，开启新的讨论，关闭 Issue[](#submit-comment-start-a-thread-or-comment-and-close "Permalink") 撰写评论后，您可以： -* 单击**评论** ，您的评论将被发布. -* 选择从下拉列表中**启动线程** ，并启动一个新[的线程](../../discussions/index.html#threaded-discussions)这个问题的主线程中讨论具体的点. 这邀请其他参与者直接回复您的主题，并将相关评论分组在一起. - -[![Comment or thread](img/9cb5bb737c82aad68bc28e2a7357e05c.png)](img/comment-or-discussion.png) - -您也可以从此处关闭问题，因此无需滚动到问题页面的顶部. - -### Zoom meetings[](#zoom-meetings "Permalink") - -在 GitLab 12.3 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/31103) . - -您可以使用`/zoom`和`/remove_zoom` [快速动作](../quick_actions.html)将[GitLab](../../markdown.html#gitlab-flavored-markdown-gfm) `/remove_zoom` [Markdown](../../markdown.html#gitlab-flavored-markdown-gfm)作为附件添加和删除 Zoom 会议. - -附加问题的[Zoom](https://zoom.us)呼叫会导致问题顶部顶部标题下方的" **加入 Zoom"会议**按钮. - -详细了解如何[添加或删除缩放会议](associate_zoom_meeting.html) . - -### Publish an issue[](#publish-an-issue-ultimate "Permalink") - -[Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/30906) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 13.1. +* 单击**评论** ，您的评论将被发布 +* 选择从下拉列表中**启动新的讨论** ，并在当前 Issue 的主讨论中启动一个新的[讨论]来讨论更具体的点，可邀请其他参与者直接回复您的讨论，并将相关评论分组在一起。 -If a status page application is associated with the project, you can use the `/publish` [quick action](../quick_actions.html) to publish the issue. Refer to [GitLab Status Page](../status_page/index.html) for more information. \ No newline at end of file +您也可以从此处关闭 Issue ，无需滚动到 Issue 页面的顶部再关闭 Issue。 \ No newline at end of file