概要: git activity graph はデータそのものではなく表示方法です
git activity graph は、開発活動を時間軸で見せるための視覚表現です。GitHubプロフィールの貢献グラフ、コミットカレンダー、READMEウィジェット、または GitHub City の3D表示を指すことがあります。
重要なのは、グラフは元データそのものではないという点です。まずGitHubが活動を集計し、その後にツールがチャート、アニメーション、3Dシティとして表示します。
不具合確認なら公式プロフィールグラフとリポジトリ履歴から始めます。ポートフォリオ用途なら、データを確認してから目的に合う見せ方を選びます。
種類と使い分け
この検索意図には、活動確認、欠けたコミットの調査、README表示、ポートフォリオ用3Dビジュアルが混在します。
| 種類 | 向いている用途 | 制限 | 次の手順 |
|---|---|---|---|
| GitHub貢献グラフ | 日・週・年単位の見える活動を確認する。 | GitHubの集計ルールに従い、非公開詳細は隠れます。 | 貢献グラフガイドを読む。 |
| GitHub commit graph | メール、ブランチ、fork、欠けたコミットを調べる。 | Issue、レビュー、非公開作業の全体は測れません。 | コミットガイドを使う。 |
| README活動グラフ | プロフィールに軽い視覚要素を置く。 | 公開データ、キャッシュ、外部サービスに依存します。 | 公式グラフを先に確認する。 |
| GitHub City 3D | 活動パターンを記憶に残る3Dシティにする。 | 元データの欠けを引き継ぎます。 | 確認後に GitHub City を開く。 |
共有前の確認手順
グラフが空、極端に小さい、または実際の作業と合わないときに使う確認手順です。
公式プロフィールを開く
まずGitHub公式の貢献グラフで、活動が集計されているか確認します。
リポジトリ履歴と比べる
リポジトリにはあるのにプロフィールに出ない場合は、メール、ブランチ、fork、日時を確認します。
非公開設定を確認する
非公開活動はプロフィール設定に従って匿名の活動として見えることがあります。
見せ方を選ぶ
確認には通常グラフ、軽い表示にはREADME、3D表示にはGitHub Cityを使います。
文脈を添える
グラフは見える活動パターンであり、コード品質や非公開作業の全量ではありません。
Git activity graph と contribution chart と commit graph の違い
似た言葉ですが役割は違います。貢献グラフはGitHubが何を数えたか、commit graphはなぜコミットが出ないか、git activity graphはどの見せ方を選ぶかを扱います。
このページは選択のための入口で、詳細なルールや調査が必要な場合は個別ガイドへつなぎます。
貢献グラフ
可視化前に公式データを確認する。
Commit graph
メール、ブランチ、forkの問題を調べる。
README graph
公開データ前提の小さな表示に使う。
GitHub City
正しいデータを3Dのストーリーに変える。
よくある問題
多くの場合、問題はチャートではなく元データです。未確認メール、対象外ブランチ、未マージfork、非公開設定、更新待ちが原因になります。
見た目を直す前に、必ずデータ源を確認します。不完全な履歴に基づく美しいビジュアルは誤解を招きます。
実用ルール
公式プロフィールに活動が出ていないなら、下流のチャート、README、3Dシティも未完成として扱います。
GitHub Cityの位置づけ
GitHub Cityは、平面のヒートマップ以上の見せ方が必要なときの視覚レイヤーです。活動パターンを探索しやすい3Dシティに変換します。
公式グラフが正しいと確認してから使うと、ポートフォリオや発表用の信頼できるビジュアルになります。
FAQ
git activity graphとは何ですか?
GitまたはGitHub活動を時間軸で示す視覚表現です。
GitHub contribution graphと同じですか?
同じではありません。contribution graphは公式プロフィールグラフで、git activity graphはより広い表現です。
なぜ空になりますか?
メール、ブランチ、fork、非公開設定、更新遅延が主な原因です。
ポートフォリオで使えますか?
使えますが、見える公開活動のパターンであることを説明してください。
いつGitHub Cityを使うべきですか?
公式グラフが正しいと確認できた後、3D表示として共有したいときです。