议题可用于跟踪漏洞、增强功能或其他请求。 更多信息请参阅“关于议题”。
仓库管理员可以禁用仓库的议题。 更多信息请参阅“禁用议题”。
从仓库创建议题
- 在 您的 GitHub Enterprise Server 实例 上,导航到仓库的主页面。
- 在仓库名称下,单击 议题。
- 单击 New issue(新建议题)。
- 如果您的仓库使用议题模板,请在要打开的议题类型旁边单击 Get started(开始)。 或者,如果您想打开的议题类型未包括在可用选项中,单击 Open a blank issue(打开空白议题)。
- 键入议题的� �题和说明。
- 如果您是项目维护员,可以将议题分配给某人、将其添� 到项目板、将其与里程碑关联或应用� �签。
- 完成后,单击 Submit new issue(提交新议题)。
使用 GitHub CLI 创建议题
GitHub CLI 是用于从计算机的命令行使用 GitHub 的开源工具。 从命令行操作时,您可以使用 GitHub CLI 来节省时间并避免切换上下文。 要了解 GitHub CLI 的更多信息,请参阅“关于 GitHub CLI”。
要创建议题,请使用 gh issue create
子命令。 若要跳过交互式提示,请包括 --body
and the --title
� �志。
gh issue create --title "My new issue" --body "Here are more details."
您还可以指定受理人、� �签、里程碑和项目。
gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"
从评论创建议题
您可以从议题或拉取请求中的评论打开新议题。 从评论打开议题时,该议题包含一个代� �段,显示评论的原始发布位置。
- 导航到您要从中打开议题的评论。
- 在该评论中,单击 。
- 单击 Reference in new issue(新议题中的引用)。
- 使用“Repository(仓库)”下拉菜单,并选择要在其中打开议题的仓库。
- 键入议题的描述性� �题和正文。
- 单击 Create issue(创建过滤器)。
- 如果您是项目维护员,可以将议题分配给某人、将其添� 到项目板、将其与里程碑关联或应用� �签。
- 完成后,单击 Submit new issue(提交新议题)。
从代� �创建议题
您可以从文件或拉取请求的特定代� �行打开新议题。 从代� �打开议题时,议题包含小片段,其中显示所选代� �的行或范围。 只能打开存储代� �的仓库中的议题。
- 在 您的 GitHub Enterprise Server 实例 上,导航到仓库的主页面。
- 找到要在议题中引用的代� �:
- 要打开文件中代� �相关的议题,请找到该文件。
- 要打开拉取请求中代� �相关的议题,请找到该拉取请求并单击 Files changed(文件已更改)。 然后浏览到含有要包含在评论中的代� �的文件,并单击 View(查看)。
- 选择是选择一行还是一个范围:
- 要选择单行代� �,请单击行号以高亮显示该行。
- 要选择代� �范围,请单击范围内第一行的行号以高亮显示代� �行。 然后,将� � �停在代� �范围的最后一行,按 Shift,再单击行号以高亮显示范围。
- 要选择单行代� �,请单击行号以高亮显示该行。
- 在代� �范围左侧,单击 。 在下拉菜单中,单击 Reference in new issue(新议题中的引用)。
- 键入议题的� �题和说明。
- 如果您是项目维护员,可以将议题分配给某人、将其添� 到项目板、将其与里程碑关联或应用� �签。
- 完成后,单击 Submit new issue(提交新议题)。
从项目板说明创建议题
如果使用项目板对工作进行跟踪和排列优先级,您可以将项目板注释转换为议题。 更多信息请参阅“关于项目板”和“向项目板添� 备注”。
从 URL 查询创建议题
您可以使用查询参数打开议题。 查询参数是 URL 中可以定制的部分,用于在 GitHub 上共享特定的网页视图,如搜索过滤结果或议题模板。 要创建自己的查询参数,必须将键与值进行配对。
提示:也可使用默认� �签、受理人和议题� �题创建议题模板。 更多信息请参阅“使用模板鼓励有用的议题和拉取请求”。
必须具有适当的权限才可执行使用相关查询参数的操作。 例如,必须具有向议题添� � �签的权限才可使用 labels
查询参数。 更多信息请参阅“组织的仓库角色”。
如果使用查询参数创建� 效的 URL,或者没有适当的权限,URL 将返回 404 未找到
错误页。 如果您创建的 URL 超过服务器限制,URL 将返回 414 URI 过长
错误页面。
查询参数 | 示例 |
---|---|
title | https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report 使用� �签 "bug" 和� �题 "New bug report" 创建议题。 |
正文 | https://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. 创建一个� �题为 "New bug report" 的议题,并且议题正文中有评论 "Describe the problem"。 |
labels | https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug 使用� �签 "help wanted" 和 "bug" 创建议题。 |
里程碑 | https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones 创建包含里程碑 "testing milestones" 的议题。 |
assignees | https://github.com/octo-org/octo-repo/issues/new?assignees=octocat 创建议题并分配到 @octocat。 |
projects | https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 创建� �题为 "Bug fix" 的议题并将其添� 到组织的项目板 1。 |
模板 | https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md 使用模板在议题正文中创建议题。 template 查询参数支持仓库� �目录 docs/ 或 .github/ 的 ISSUE_TEMPLATE 子目录中存储的模板。 更多信息请参阅“使用模板鼓励有用的议题和拉取请求”。 |