早わかり: GitHub Profile 3D Contrib とは?
GitHub Profile 3D Contrib は、ユーザーの contribution calendar をプロフィール README に置ける 3D 画像へ変換する GitHub Action です。外部ビューアを開くのではなく、workflow が生成画像をリポジトリへ commit し、README に最新の 3D カレンダーを表示します。
github profile 3d contrib を探す人は、YAML、画像パス、定期実行、権限設定を知りたいことが多いです。一方で GitHub City を探す人は、リポジトリを編集せずブラウザで 3D city をすぐ確認したい意図が強いです。
README に残す画像が必要なら profile-3d-contrib、ブラウザで素早く眺めるなら GitHub City、複数ツールの違いを見るなら 3D ツール比較 が適しています。
github profile 3d contrib で来た場合、このページの範囲は README 自動化、GitHub Actions、生成ファイル、トラブルシューティングです。ユーザー名を入力してオンラインの 3D シティを見る場合は GitHub City を使ってください。
README を壊さず profile-3d-contrib を設定する手順
公式 Action から始め、画像がプロフィールに表示される前に GitHub 固有の条件を確認します。小さく明示的で、手動再実行しやすい設定が安全です。
特別なプロフィール repository を作る
GitHub username と完全に同じ名前の public repository を作ります。GitHub はこの repository をプロフィール README として扱います。
workflow ファイルを追加する
.github/workflows/profile-3d.yml を作成し、contents: write と GITHUB_TOKEN を設定します。
一度手動実行する
初回は workflow_dispatch で実行し、権限、token、YAML、ファイル不足のエラーを確認します。
生成画像を埋め込む
生成された SVG または PNG のパスを README.md に追加します。branch、folder、大小文字、相対パスを確認してください。
private contribution 設定を確認する
private contribution はプロフィール設定で公開要約が許可されている場合だけ反映されます。
確認すべき workflow ファイルと設定
設定自体は小さくても、workflow、生成先フォルダ、README の画像パス、プロフィール設定がつながって動きます。
Actions のログでは生成できているのに README に出ない場合、原因は generator ではなく、branch、cache、Markdown のパス指定であることが多いです。
| ファイルまたは設定 | 役割 | 確認点 |
|---|---|---|
| README.md | GitHub profile に 3D calendar を表示します。 | commit 済み画像とパス、大小文字が一致しているか。 |
| .github/workflows/profile-3d.yml | 予定実行または手動実行で generator を動かします。 | 書き込み権限と手動 trigger があるか。 |
| 出力フォルダ | 生成された SVG/PNG を保存します。 | workflow 後にファイルが commit されているか。 |
| プロフィール設定 | private activity の公開要約を制御します。 | 表示したい場合だけ有効化します。 |
| ワークフローのコミット手順 | 生成された SVG または PNG をプロフィールリポジトリへ書き戻します。 | 生成画像だけをコミットし、空コミットを避け、キャッシュファイルを含めないようにします。 |
profile-3d-contrib と GitHub City と GitHub Skyline の違い
どれも GitHub contribution data を使いますが、README 画像、ブラウザ閲覧、モデル出力という目的が異なります。
profile-3d-contrib
README に常時表示する画像に最適です。repository 設定と Actions が必要です。
GitHub City
ブラウザですぐ 3D city を探索したいときに最適です。YAML 追加は不要です。
GitHub Skyline
README 画像やブラウザ city ではなく、model 風の 3D 出力がほしいときに向いています。
3D 画像が出ない・古いときの確認点
画像が出ない場合は、まず最新の Actions run を開きます。失敗していれば token、権限、YAML、rate limit を確認します。成功しているなら README の画像パスを疑います。
画像が空なら、公式の GitHub contribution graph と比較します。公式カレンダーに出ない活動は、通常 3D 画像にも出ません。commit の原因は commit graph ガイド を確認してください。
古い画像のままなら、cron の timezone、branch protection、commit/push の有無、README 画像キャッシュを確認します。
Actions が成功しても画像が変わらない場合は、出力ファイルのハッシュ、README の画像 URL、GitHub やブラウザーのキャッシュを確認してください。
プロフィール全体の構成をまだ決めている場合は、3D 画像を追加する前に GitHub profile README テンプレートガイド を確認してください。 生成された 3D 画像ではない静的 README ウィジェットについては、この Actions workflow を変える前に GitHub streak stats ガイドを使ってください。
README generator で生の Git データを直接デバッグしない
profile-3d-contrib は GitHub が公開している contribution 表示を可視化します。数が合わないときは、メール、default branch、private contribution、fork ルールを先に確認してください。
FAQ
profile-3d-contrib は GitHub City と同じですか?
いいえ。profile-3d-contrib は Actions で README 用画像を生成し、GitHub City はブラウザで操作する visualizer です。
GitHub Actions は必要ですか?
通常の設定では必要です。画像を自動生成して commit するために Actions を使います。
3D 画像が空なのはなぜですか?
公式 contribution graph、workflow 権限、token、username、出力 branch、README パスを確認してください。
private contribution は表示できますか?
GitHub が公開要約として許可した範囲だけ反映できます。
素早く共有するならどのツールですか?
インタラクティブ表示なら GitHub City、README に置くなら profile-3d-contrib です。
github-profile-3d-contrib は通常どんなファイルを生成しますか?
多くの設定では 3D 貢献カレンダーの SVG または PNG 画像を生成し、プロフィールリポジトリ内のフォルダーに保存して README.md から参照します。
YAML を変える前に何を確認すべきですか?
プロフィールリポジトリ名、Actions 権限、出力フォルダー、ブランチ、README パス、ユーザー名、GitHub 公式グラフに期待する活動が出ているかを確認します。