GitHub 使用指南
GitHub GuidesGitHub 仓库
  • GitHub 使用指南
  • Hello World
    • 简介
    • 什么是 GitHub?
    • 创建一个仓库
    • 创建一个分支
    • 修改并提交更改
    • 发起拉取请求
    • 合并拉取请求
  • 理解 GitHub 工作流
    • 简介
    • 创建分支
    • 提交更改
    • 发起拉取请求
    • 讨论并评审代码
    • 部署
    • 合并
  • GitHub Pages 入门
    • 简介
    • 创建你的网站
    • 做一些修改
    • 下一步
  • Git 手册
    • 简介
    • 什么是版本控制系统?
    • 什么是仓库?
    • Git 基础
    • GitHub
  • 复刻他人项目
    • 简介
    • 为项目做贡献
    • 复刻仓库
    • 克隆你所复刻的项目
    • 修改并推送
    • 发起拉取请求
  • 多多社交
    • 简介
    • 关注一个朋友
    • 查看一个项目仓库
    • 你可以做更多的事情
  • 使代码可引用
    • 简介
    • 选择你的仓库
    • 登录 Zenodo
    • 查看仓库设置
    • 发布新版本
    • 创建 DOI
    • 即将完成
  • 精通 Issues
    • 简介
    • 里程碑,标签和被指派人
    • 通知,@提及 和引用
    • 搜索
    • 概述 & 报告
    • Issues 的其他用途
  • 精通 Markdown
    • 简介
    • 什么是 Markdown?
    • 例子
    • 语法指南
    • GitHub 风味 Markdown
  • 项目文档化
    • 简介
    • 创建你的 README
    • 格式化你的 README
    • 创建你的 wiki
    • 添加内容
    • 添加页面
    • 语法高亮
Powered by GitBook
On this page
  • 通知
  • @提及
  • 引用

Was this helpful?

Export as PDF
  1. 精通 Issues

通知,@提及 和引用

Previous里程碑,标签和被指派人Next搜索

Last updated 2 years ago

Was this helpful?

通过在问题中使用@提及 和引用,你可以通知其他 GitHub 用户和团队,并相互交叉关联问题。这些方法提供了一种灵活的方式,可以让合适的人员高效地解决问题,并且易于学习和使用。它们适用于 GitHub 上的所有文本字段 —— 它们是我们的文本格式化语法的一部分,称为 。

Markdown 例子

如果你想了解更多信息,请查看 。

通知

通过这些设置,当人们特别提到你时,你会收到邮件,接着就可以访问基于 Web 的界面及时了解你感兴趣的仓库。

被静默的通知线程在你再次特别提及之前,将不再显示为未读。这是一个静默你不感兴趣的(可能是你不熟悉的某个子系统)通知线程的一个很好的策略。如果你将问题标记为已读,则它将保持这种状态,直到有人再次对该通知线程发表评论为止。

GitHub 还同步邮件通知的已读/未读状态 —— 如果你在邮件客户端中读取通知,它将在基于 Web 的界面中(如果你喜欢此功能,请确保允许你的邮件客户端显示图片)标记为已读。

@提及

@提及 是我们在 GitHub Issues 中引用其他 GitHub 用户的方式。在描述或 issue 的任何评论内,提及另一个 GitHub 用户的@用户名 以向他们发送通知。这与 Twitter 使用@提及 的方式非常相似。

我们喜欢使用 /cc 语法( 抄送的缩写)来提及 issues 中的人:

It looks like the new widget form is broken on Safari. When I try and create the widget, Safari crashes. This is reproducible on 10.8, but not 10.9. Maybe a browser bug?

/cc @kneath @jresig

如果你知道要提及的特定用户,这种方法很有用,但很多时候我们在团队中工作但不知道谁可以帮助我们。@提及 也适用于 GitHub 组织内的团队。如果你在@acmeinc 组织下创建一个名为 browser-bugs 的团队,你可以使用@提及 提醒该团队:

/cc @acmeinc/browser-bugs

这将向 browser-bugs 团队的每个成员发送通知。

引用

通常情况下,issues 取决于其他 issues,或者至少与它们有关,并且你希望将这两个 issues 关联起来。你可以通过输入主题标签和问题编号来引用 issues。

Hey @kneath, I think the problem started in #42

当你这样做时,我们将在 issue #42 中创建一个如下所示的事件:

另一个仓库中的 issue 只需在名称之前包含仓库名即可:kneath/example-project#42 。

使用 GitHub Issues 的一个更有趣的方法是直接从提交中引用 issue。在提交消息中包含 issue 编号即可。

通过在提交合并到 master 分支时将提交信息前缀写为 “Fixes”,“Fixed”,“Fix”,“Closes”,“Closed”,或“Close”,它也会自动关闭该问题。

通过引用,可以将正在完成的工作与正在跟踪的错误进行深入关联,这是增加项目历史可读性的好方法。

是 GitHub 与你的 Issues 保持同步的方式。你可以使用它们来查找有关仓库的新 issues,或者只是知道某人何时需要你的输入才能继续处理 issue。

有两种方法可以接收通知:通过邮件和 web。你可以配置接收通知的方式。如果你预计收到大量通知,我们建议你接收所参与项目的 web + 邮件通知,以及所看过项目的 web 通知。

通知截屏

你可以通过界面访问你的所有通知。此界面非常适合一次浏览许多通知并将其标记为已读或静默该通知线程。尝试使用键盘快捷键来加速你的工作流 —— 在页面上按 ? 查看可用的快捷键。

个人通知截屏
创建引用截屏
提交中引用的截屏
通知
在设置中
通知
GitHub 版 Markdown
Mastering Markdown