必需的合作作者信息
向提交添加合作作者之前,您必须知道用于每个合作作者的适当电子邮件地址。 为使合作作者的提交计为贡献,必须使用与他们在 GitHub.com 上的帐户相关联的电子邮件。
如果用户选择将其电子邮件地址保密,则应使用其 GitHub
提供的 no-reply
电子邮件地址来保护其隐私。 否则,合作作者的电子邮件地址将在提交消息中公开。 如果要保持电子邮件地址的私密性,可选择使用 GitHub
为 Git 操作提供的 no-reply
电子邮件地址,并要求其他共同作者在提交尾行中列出你的 no-reply
电子邮件地址。
有关详细信息,请参阅“设置提交电子邮件地址”。
提示:通过分享此信息可帮助共同作者找到其首选电子邮件地址:
-
若要查找 GitHub 提供的
no-reply
电子邮件地址,请导航至“将我的电子邮件地址保密”下的电子邮件设置页面。 -
若要在计算机上查找用于配置 Git 的电子邮件地址,请在命令行上运行
git config user.email
。
使用 GitHub Desktop 创建合作提交
可以使用 GitHub Desktop 创建合作提交。 有关详细信息,请参阅“在 GitHub Desktop 中提交并审查对项目的更改”和 GitHub Desktop。
在命令行上创建合作提交
-
收集每位合作作者的姓名和电子邮件地址。 如果有人选择保密其电子邮件地址,你应使用他们的 GitHub 提供的
no-reply
电子邮件地址以保护他们的隐私。 -
输入提交消息以及简短、有意义的更改描述。 在提交描述后,不要加上右引号,而是添加两个空行。
$ git commit -m "Refactor usability tests. > >
提示: 如果在命令行上使用文本编辑器来键入提交消息,请确保在提交描述的末尾和
Co-authored-by:
提交尾部之间有两个换行符。 -
在提交消息的下一行,根据每个共同作者的特定信息键入
Co-authored-by: name <name@example.com>
。 在合作作者的信息后面,添加一个右引号。如果要添加多个共同作者,请为每个共同作者键入一个
Co-authored-by:
提交尾行。 不要在每个合著者行之间添加空白行。$ git commit -m "Refactor usability tests. > > Co-authored-by: NAME <NAME@EXAMPLE.COM> Co-authored-by: ANOTHER-NAME <ANOTHER-NAME@EXAMPLE.COM>"
在下次推送时,新的提交和消息将显示在 GitHub.com 上。 有关详细信息,请参阅“推送提交到远程仓库”。
在 GitHub
上创建合作提交
在 GitHub
上使用 Web 编辑器对文件进行更改后,可通过在提交消息中添加 Co-authored-by:
尾行来创建共同创作的提交。
- 收集每位合作作者的姓名和电子邮件地址。 如果有人选择保密其电子邮件地址,你应使用他们的 GitHub 提供的
no-reply
电子邮件地址以保护他们的隐私。 - 单击“提交更改...”
- 在“提交消息”字段中,键入简短、有意义的提交消息,以描述所做的更改。
- 在提交消息下方的文本框中,根据每个共同作者的特定信息添加
Co-authored-by: name <name@example.com>
。 如果要添加多个共同作者,请为每个共同作者键入一个Co-authored-by:
提交尾行。 - 单击“提交更改”或“建议更改” 。
新的提交和消息将显示在 GitHub.com 上。
其他阅读材料
- "查看项目的贡献者"
- “更改提交消息”
- GitHub Desktop 文档中的“在 GitHub Desktop 中提交并审查对项目的更改”