GitHub 贡献直方图

Question

我正在尝试了解 GitHub 贡献数据及其显示方式。我创建了一个愚蠢的两步过程来“绘制”贡献 (which can be found here) .

我刚刚意识到每一天的“重量”是相对于一年中剩余时间的，而不是固定的。因此，我想执行两个附加功能。

展平

获取您的公共(public)贡献历史记录并根据需要创建提交，以便一年中的每一天都有相同的数量。为此，我需要:

• AJAX 从我自己的服务器请求数据(因为他们不允许 XSS)
• 从那里请求 https://github.com/users/%s/contributions_calendar_data (example)
• 每天创建足够的提交以等于当年最高的公共(public)事件

选择颜色

除了扁平化之外，我想提供选择颜色的功能(GitHub 的绿色阴影之一用于绘制您的日常事件)。这是我不知道该做什么的地方。

如果不首先“扁平化”提交事件，我不会提供功能，因为这看起来更令人生畏。但是，我的问题是:

• 鉴于每天都有 T 次提交的提交事件历史记录，需要多少次提交才能实现每个色调“等级”？
• 引入新提交时这些值如何变化？

例如，假设我将提交历史扁平化为每天 85 次提交，每种颜色需要多少次提交？如果我包含更多级别，这些会有所不同吗？

如果“基本级别”是 400，而不是 85，那将如何影响提交历史？

供引用，this is the repo我正在做实验。它基本上是一个让您“绘图”的 Web 界面，以及一个获取 UI 的 JSON 输出并为您生成一堆空提交的 CLI。

不用说我不太了解统计数据。

Answer 1

好问题!

AJAX request the data from my own server (since they don't allow XSS)

要获得公共(public)贡献，您可以使用ghcal如下所示:

var GhCal = require("ghcal");

GhCal("bevacqua", function (err, data) {
    console.log(err || data);
});

这将在回调中为您提供如下输出:

[..., ["2015-04-26", 22], ...]

Given a commit activity history where every single day has T commits, how many commits are needed to achieve each hue "tier"?

根据我的测试，如果每一天都有相同数量的提交 (T)，那么要让一天变得更暗，您只需要再添加一次提交(这意味着 当天 T + 1)。

在创建 git-stats 时，我有同样的问题。具体如何运作的规则尚未公开。我给 GitHub 发邮件询问他们的算法，他们回复说:

We can't share how exactly the colors are computed (and we tweak that from time to time), but it's based on mapping the contribution count for a specific day to a color based on the distribution of contribution counts for the whole year (each range is assigned a specific color).

所以，简而言之，正如您所注意到的，有五个级别，数据被规范化为具有不同的级别，具体取决于每天完成的提交数量，并且其背后的算法不时更改.

For example, say I flatten the commit history to 85 commits per day, how many commits will each color require?

根据我的测试，只有一个。

Will these be different if I include more levels?

是的，但老实说，您应该尝试一下。 :D

If the "base level" is 400, rather than 85, how will that affect the commit history?

我几乎可以肯定，在这种情况下，只有当您想要拥有多个级别时，差异才会显着。如果你所有的日子都是 400，除了你有 401 的那一天，我想那一天会比其他日子更黑。

可能让用户决定他一天要创建多少次提交会更好。 :)

github-contributions是我创建的一个项目，它做相关的事情(在贡献日历上绘制/创建文本)。