 |
摘要 | Discourse GitHub 允许管理员根据用户的 GitHub 贡献分配徽章。同时允许用户创建 GitHub 链接回传和永久链接 |
 |
安装指南 | 此插件已捆绑在 Discourse 核心中，无需单独安装。 |
功能
GitHub 徽章
根据用户的 GitHub 贡献分配徽章。
使用方法：
- 在设置 -\u0026gt; 插件中启用
github badges enabled。 - 生成 GitHub 访问令牌并将其粘贴到
github linkback access token设置中。详见下方说明。 - 在
github badges repos站点设置中添加一个或多个要扫描贡献的 GitHub 仓库 URL。
徽章计数方式：
徽章计算所有仓库中的提交次数，当用户在多个仓库中做出贡献时，所有提交将合并为一个总数。
提交者徽章：
- 青铜：1 次提交
- 银：25 次提交
- 金：1000 次提交
徽章晋升：随着用户在任何跟踪仓库中积累更多贡献，他们将自动晋升到徽章等级。例如，如果用户在仓库 A 中提交，然后在仓库 B 中提交，所有贡献都会计入总数，从而使其从青铜晋升到银，再到金。
GitHub 链接回传
从 GitHub 的拉取请求或提交创建指向 Discourse 帖子的链接，该帖子中提到了该请求或提交。
使用方法：
- 在设置 -\u0026gt; 插件中启用
github linkback enabled。 - 生成 GitHub 访问令牌并将其粘贴到
github linkback access token设置中。详见下方说明。 - 最后，在
github linkback projects站点设置中添加您希望发布到的项目，格式如下：username/repository用于特定仓库username/*用于某个用户的全部仓库
GitHub 永久链接
将 GitHub 非永久链接替换为 永久链接。
使用方法：
- 在设置 -\u0026gt; 插件中启用
github permalinks enabled。
配置
GitHub 访问令牌
为了使链接回传功能正常工作并授予用户徽章，您需要提供一个 GitHub 访问令牌。您可以在以下位置生成令牌：Sign in to GitHub · GitHub
链接回传功能需要 public_repo 范围，而授予徽章则不需要任何范围（如果仅需要徽章，请保持所有选项未选中）。由于 public_repo 范围授予了对仓库的 写入权限，我们建议您创建一个 临时 GitHub 账户，该账户没有访问任何仓库，并仅用于生成令牌。