Skip to main content

创建项目(测试版)

了解如何创建项目、填充项目并添加自定义字段。

项目是可自定义的项集合,可随 GitHub 数据保持最新状态。 您的项目可以跟踪议题、拉取请求以及您加入的想法。 您可以添加自定义字段并为特定目的创建视图。

注意: 项目(测试版)目前处于公开测试阶段,可能会有所变化。

创建项目

创建组织项目

  1. 在 GitHub 上,导航到组织的主页面。

  2. 单击 Projects(项目)

  3. 选择 New project(新项目)下拉菜单并点击 New project (Beta)(新项目 [测试版])

    新项目

创建用户项目

  1. 在任何 GitHub 页面上,单击您的头像,然后选择 Your projects(您的项目)

  2. 选择 New project(新项目)下拉菜单并点击 New project (Beta)(新项目 [测试版])

    新项目

更新项目描述和 README

You can set your project's description and README to share the purpose of your project, provide instructions on how to use the project, and include any relevant links.

  1. 导航到您的项目。
  2. 在右上角,单击 以打开菜单。
  3. 在菜单中,单击 Settings(设置) 以访问项目设置。
  4. To add a short description to your project, under "Add a description", type your description in the text box and click Save.
  5. To update your project's README, under "README", type your content in the text box.
    • You can format your README using Markdown. 更多信息请参阅“基本撰写和格式语法”。
    • To toggle between the text box and a preview of your changes, click or .
  6. To save changes to your README, click Save.

You can view and make quick changes to your project description and README by navigating to your project and clicking in the top right.

为您的项目添加项

您的项目可以跟踪草稿议题、议题和拉取请求。

创建草稿议题

草稿议题有助于快速捕获想法。

  1. 将光标放在项目底部一行, 的旁边。
  2. 输入您的想法,然后按 Enter
  3. 要添加正文文本,请单击草稿议题的标题。 在出现的 Markdown 输入框中,输入草稿正文的文本,然后单击 Save(保存)

草稿议题可以具有标题、文本正文、受理人以及项目中的任何自定义字段。 为了填充草稿议题的存储库、标签或里程碑,必须首先将草稿问题转换为议题。 更多信息请参阅“将草稿议题转换为议题”。

注意:用户在草稿议题中被分配或提及时不会收到通知,除非草稿议题已转换为议题。

议题和拉取请求

粘贴议题或拉取请求的 URL

  1. 将光标放在项目底部一行, 的旁边。
  2. 粘贴议题或拉取请求的 URL。

搜索议题或拉取请求

  1. 将光标放在项目底部一行, 的旁边。
  2. 输入 #
  3. 选择拉取请求或议题所在的仓库。 您可以输入仓库名称的一部分来缩小选项范围。
  4. 选择议题或拉取请求。 您可以键入标题的一部分以缩小选项范围。

从存储库添加多个议题或拉取请求

  1. 在 GitHub.com 上,导航到包含要添加到项目中的议题或拉取请求的存储库。
  2. 在仓库名称下,单击 Issues(议题) Pull requests(拉取请求)议题和拉取请求选项卡选择
  3. 在每个议题标题的左侧,选择要添加到项目中的议题。 显示用于选择议题或拉取请求的复选框的屏幕截图
  4. (可选)若要选择页面上的每个议题或拉取请求,请在议题或拉取请求列表的顶部选择全部。 显示用于全选的复选框的屏幕截图
  5. 在议题列表或拉取请求上方,单击 Projects (beta)(项目[测试版])显示用于全选的复选框的屏幕截图
  6. 单击要向其添加所选议题或拉取请求的项目。 显示用于全选的复选框的屏幕截图

从议题或拉取请求中分配项目

  1. 导航到要添加到项目的议题或拉取请求。

  2. 在侧边栏中,单击 Projects(项目)

  3. 选择要添加议题或拉取请求的项目。

  4. (可选)填充自定义字段。

    项目侧边栏

将草稿议题转换为议题

在表格布局中:

  1. 在要转换的草稿议题上单击
  2. 选择 Convert to issue(转换为议题)
  3. 选择要将议题添加到的存储库。
  4. 或者,编辑要转换的草稿议题的 labelsmilestonerepository 字段。

在板布局中:

  1. 在要转换的草稿议题上单击
  2. 选择 Convert to issue(转换为议题)
  3. 选择要将议题添加到的存储库。

从项目中删除项

您可以对项存档以保留项目中有关该项的上下文,但将其从项目视图中移除。 您可以删除某个项以将其从项目中完全移除。

  1. 选择要存档或删除的项。 要选择多个项,请执行下列操作之一:
    • Command+点击 (Mac) 或 Ctrl+点击 (Windows/Linux) 每个项。
    • 选择一个项,然后按 Shift+Shift+ 以选择最初所选项上方或下方的其他项。
    • 选择一个项,然后 Shift+点击另一个项以选择两个项之间的所有项。
    • 输入 Command+A (Mac) 或 Ctrl+A (Windows/Linux) 以选择板布局中列中的所有项或表格布局中的所有项。
  2. 要存档所有选定项,请输入 E。 要删除所有选定项,请输入 Del。 或者,选择 (在表格布局中)或 (在板布局中),然后选择所需的操作。

您可以恢复已存档的项,但不能恢复已删除的项。 更多信息请参阅“恢复存档的项”。

恢复存档的项

  1. 导航到您的项目。

  2. 在右上角,单击

  3. 在菜单中,单击 Archived items(已存档的项)

  4. (可选)要筛选显示的已存档项,请在项列表上方的文本框中键入筛选器。 有关可用筛选器的详细信息,请参阅“筛选项目 (测试版)”。

    显示用于筛选已存档项的字段的屏幕截图

  5. 在每个项标题的左侧,选择要恢复的项。

    显示已存档项旁边复选框的屏幕截图

  6. 要恢复所选项,请在项列表上方单击 Restore(恢复)

    显示"恢复"按钮的屏幕截图

添加字段

随着字段值的变化,它们会自动同步,以便您的项目及其跟踪的项保持最新。

显示现有字段

您的项目跟踪有关议题和拉取请求的最新信息,包括对标题、受理人、标签、里程碑、存储库、审阅者和链接的拉取请求所做的任何更改。 当项目初始化时,会显示“标题”和“受理人”;其他字段隐藏。 您可以更改项目中这些字段的可见性。

  1. 要打开项目命令面板,请按 Command+K (Mac) 或 Ctrl+K (Windows/Linux)。
  2. 开始键入 "show"。
  3. 选择所需的命令(例如: "Show: Repository")。

或者,您可以在界面中执行以下操作:

  1. 单击最右侧字段标题中的 。 将显示带有项目字段的下拉菜单。 显示或隐藏字段
  2. 选择您想要显示或隐藏的字段。 指示显示哪些字段。

添加自定义字段

您可以添加自定义字段到项目。 自定义字段将显示在项目中议题和拉取请求的侧栏。

自定义字段可以是文本、数字、日期、单选或迭代:

  • 文本:值可以是任何文本。
  • 数字:值必须是数字。
  • 日期:值必须是日期。
  • 单选:必须从一组指定的值中选择值。
  • 迭代:必须从一组日期范围(迭代)中选择值。 过去的迭代将自动标记为“已完成”,覆盖当前日期范围的迭代将标记为“当前”。 更多信息请参阅“管理项目中的迭代”。
  1. 要打开项目命令面板,请按 Command+K (Mac) 或 Ctrl+K (Windows/Linux)。 开始输入 "Create new field" 的任何部分。 当 "Create new field" 显示在命令板中时,选择它。
  2. 或者,单击最右侧字段标题中的 。 将显示带有项目字段的下拉菜单。 单击 New field(新建字段)
  3. 将显示一个弹出窗口,供您输入有关新字段的信息。 新建字段
  4. 在文本框中,输入新字段的名称。
  5. 选择下拉菜单并点击所需的类型。
  6. 如果您指定单选为类型,请输入选项。
  7. 如果指定迭代为类型,请输入第一个迭代的开始日期和迭代的持续时间。 将自动创建三个迭代,您可以在项目的设置页上添加其他迭代。

您还可以编辑自定义字段。

  1. 导航到您的项目。

  2. 在右上角,单击 以打开菜单。

  3. 在菜单中,单击 Settings(设置) 以访问项目设置。

  4. Fields(字段)下,选择要编辑的字段。

  5. 对于单选字段,您可以添加、删除或重新排序选项。

  6. 对于迭代字段,您可以添加或删除迭代、更改迭代名称以及更改迭代的开始日期和持续时间。

    有关修改迭代字段的详细信息,请参阅“管理项目中的迭代”。

自定义视图

您可以将项目视为表格或板、按字段对项分组、筛选项,等等。 更多信息请参阅“自定义项目(测试版)视图”。

配置内置自动化

项目(测试版)包括内置工作流程,可用于根据某些事件更新项的状态。 例如,您可以在项添加到项目时自动将状态设置为待办事项 ,或在议题关闭时将状态设置为完成

当项目初始化时,默认情况下会启用两个工作流程:当项目中的议题或拉取请求关闭时,其状态设置为完成;项目中的拉取请求合并时,其状态设置为完成

您可以为项目启用或禁用内置工作流程。

  1. 导航到您的项目。
  2. 在右上角,单击 以打开菜单。
  3. 在菜单中,单击 Workflows(工作流程)
  4. Default workflows(默认工作流程)下,单击要编辑的工作流程。
  5. 如果工作流程可以同时应用于议题和拉取请求,请在 When(何时)旁边,选中要对其执行操作的项类型。
  6. Set(设置)旁边,选择要将状态设置为的值。
  7. 如果工作流程已禁用,请单击 Disabled(已禁用)旁边的切换开关以启用工作流程。

将项目添加到存储库

您可以在存储库中列出相关项目。 您只能列出由拥有存储库的同一用户或组织拥有的项目。

为了使存储库成员能够看到存储库中列出的项目,他们必须具有项目的可见性。 更多信息请参阅“管理项目(测试版)的可见性”和“管理对项目(测试版)的访问”。

  1. 在 GitHub 上,导航到仓库的主页面。
  2. 单击 Projects(项目)
  3. 单击侧栏中的项目(测试版)
  4. 单击 Add project(添加项目)
  5. 在显示的搜索栏中,搜索由拥有存储库的同一用户或组织拥有的项目。
  6. 单击某个项目以将其列在您的存储库中。