Github徽章无法正常工作。很难判断是我操作有误还是插件本身出了问题

支持
,
1

似乎无法向以下地址添加问题：

somehow 徽章似乎无法正常工作。我是否做错了什么？
您需要实际的仓库克隆 URL 还是项目 URL？
您能否在 readme 中为可能的 URL 添加一个示例？
我可以只添加一个组织，然后所有公共仓库都会被考虑用于徽章吗？
是否有任何视觉反馈可以告诉我我做得对还是错？

3 个赞
2

另外，您能否具体说明一下如何找到用户与 GitHub 提交的关联？
这是通过邮箱匹配还是姓名匹配来实现的？我应该告诉我的社区成员如何获取 GitHub 徽章？他们必须通过 GitHub 登录吗？

4

抱歉回复晚了。我正在按照本指南配置并测试该插件：https://meta.discourse.org/t/discourse-github/99895。

指南与插件的 README 之间有一个区别：指南指出，需要生成一个 GitHub 访问令牌才能授予徽章。在授予徽章之前，必须将该访问令牌添加到您站点的 github linkback access token 设置中。

要创建访问令牌，请访问 Sign in to GitHub · GitHub Token）”按钮即可。

授予徽章还需要设置另一个站点设置：github badges repo。请输入您希望授予徽章的每个 GitHub 仓库的完整 URL。浏览器地址栏中显示的 URL 即可用于此目的。

该插件会创建 6 种徽章：

  • Contributor（贡献者）
  • Great contributor（优秀贡献者）
  • Amazing contributor（杰出贡献者）
  • Committer（提交者）
  • Frequent committer（频繁提交者）
  • Amazing committer（杰出提交者）

列表中的前三种徽章在由插件创建时即已启用。列表中的后三种徽章需要您从“管理 / 徽章”页面手动启用。

授予“频繁提交者”和“杰出提交者”徽章所需的提交次数，可通过 github silver badge min commits 和 github gold badge min commits 站点设置进行配置。

关于徽章的最后一项说明：它们是通过每 4 小时运行一次的后端作业授予的。这意味着，从用户在 GitHub 上活跃到获得徽章，可能会有长达 4 小时的延迟。

系统会根据 GitHub 提交的电子邮件地址来查找用户。在大多数情况下，这就是用户的电子邮件地址。对于已将 git 配置为使用 GitHub 的 no-reply 邮箱地址（<username>@users.noreply.github.com）的用户，插件会尝试根据该邮箱地址中的用户名部分来查找用户。具体做法是在 Discourse 的 GithubUserInfo 表中搜索匹配的用户名。只有当用户曾通过 GitHub 登录过 Discourse 时，才会通过这种方式找到他们。

我也正在查看插件的回链（linkback）功能。我很快将更新插件的 README 以及 Meta 上的插件指南。

如果您在我们托管的网站上配置该插件，可以通过向您的站点管理仪表板中提供的支持邮箱发送邮件，获得专属支持。

5 个赞
5

非常感谢您如此详细的解释，这真的很有帮助。

我有一个关于插件功能的建议，实现起来应该不难。作为管理员，我了解团队在 GitHub 和论坛中互动的关键工程师，因此我们清楚双方的身份。您觉得是否可以通过插件设置，手动将 Discourse 用户与 GitHub 账号关联起来？这样即使插件无法自动找到用户，也能启用该功能。

2 个赞