빠른 답변: GitHub City는 contribution graph를 기준으로 합니다
GitHub contribution graph는 GitHub 프로필에 표시되는 달력형 활동 차트입니다. 조건을 만족하는 커밋, pull request, issue, review 등이 포함될 수 있지만 모든 Git 작업을 그대로 보여주는 원시 로그는 아닙니다.
이 점은 GitHub City에서 중요합니다. 3D 기여 도시는 사용할 수 있는 활동 데이터만큼만 완전합니다. 공식 그래프에서 커밋이 빠져 있다면 생성된 도시도 비어 있거나 낮거나 예상과 다르게 보일 수 있습니다.
실용적인 순서는 간단합니다. 공식 그래프를 먼저 확인하고, 활동이 GitHub 규칙을 만족하는지 살피고, 필요하면 업데이트를 기다린 뒤 GitHub City나 다른 3D GitHub contribution graph 도구를 사용하세요.
GitHub contribution graph에는 무엇이 계산되나요?
GitHub의 공식 규칙은 구체적입니다. 3D 시각화를 점검하기 전에 중요한 확인 항목을 정리했습니다.
| 활동 | 계산될 수 있는 경우 | 확인할 것 |
|---|---|---|
| Commits | 계정과 연결되고, 검증된 이메일을 사용하며, 적합한 저장소의 계산 대상 branch에 들어간 경우 계산될 수 있습니다. | 커밋 이메일, default 또는 gh-pages branch, 저장소 공개 상태, fork 여부. |
| Pull requests | 적합한 저장소에서 열리고 GitHub 계정과 연결된 경우 계산될 수 있습니다. | PR을 연 계정, 저장소 상태, PR 공개 여부. |
| Issues and discussions | 적합한 저장소에서 발생하고 계정과 연결된 경우 계산될 수 있습니다. | 저장소 공개 상태와 프로필 활동 표시 여부. |
| Code reviews | 적합한 저장소의 pull request에 연결된 review는 계산될 수 있습니다. | 리뷰한 PR, 저장소 적합성, 사용한 계정. |
| Private contributions | 비공개 기여 표시가 켜져 있으면 익명화된 칸으로 표시될 수 있습니다. | 프로필 설정과 세부 정보가 아닌 익명 count를 기대하는지. |
GitHub 커밋이 표시되지 않는 이유
그래프가 이상해 보이면 아래 순서대로 확인하세요. 외부 시각화 도구를 의심하기 전에 대부분의 문제를 가를 수 있습니다.
커밋 이메일 확인
GitHub가 커밋 이메일을 계정과 연결할 수 있어야 합니다. 회사 이메일, 오타, 미검증 주소를 쓰면 표시되지 않을 수 있습니다.
branch와 저장소 확인
작업은 보통 적합한 저장소의 계산 대상 branch에 들어가야 합니다. merge되지 않은 branch, fork, 부적합한 저장소는 빠질 수 있습니다.
비공개 설정 확인
비공개 작업은 모든 세부 정보를 보여주지 않습니다. 초록 그래프에 반영하려면 비공개 기여 표시 설정을 확인하세요.
업데이트 기다리기
최근 활동은 표시까지 시간이 걸릴 수 있습니다. 방금 push했다면 조금 뒤 다시 비교하세요.
공식 프로필과 비교
공식 프로필에 보이지 않는 작업은 GitHub City, GitHub Skyline 및 다른 3D visualizer에도 보이지 않을 수 있습니다.
비공개 저장소 기여가 초록 그래프에 영향을 주나요?
비공개 저장소 활동은 GitHub의 개인정보 규칙 안에서만 contribution graph에 영향을 줄 수 있습니다. 비공개 기여 표시를 켜면 활동이 있었다는 사실은 보일 수 있지만 저장소 이름이나 민감한 세부 정보는 공개되지 않습니다.
포트폴리오에서는 이 차이가 중요합니다. 진한 그래프는 꾸준함을 보여주지만 정확한 비공개 작업 내용을 증명하지는 않습니다. 마찬가지로 GitHub 3D contribution graph는 리듬과 밀도를 보여주는 것이지 완전한 감사 로그가 아닙니다.
포트폴리오 원칙
비공개 활동을 시각적으로 반영하려면 설정을 켜고, 중요한 비공개 작업은 이력서나 포트폴리오 설명에서 따로 설명하세요.
GitHub City와 3D contribution graph 도구에 미치는 영향
GitHub City는 contribution pattern을 도시 같은 장면으로 바꿉니다. 보기 쉽게 만들지만 데이터 공백도 더 눈에 띄게 합니다. 활동이 많았던 한 주가 빠지면 낮은 구역처럼 보일 수 있습니다.
3D 도시를 공유하기 전에 공식 프로필 그래프를 기준으로 삼으세요. 초록 그래프가 정확하면 3D view는 강한 시각적 이야기 층이 됩니다. 초록 그래프가 틀렸다면 원본 데이터를 먼저 바로잡아야 합니다.
GitHub City를 쓰기 좋은 때
공식 contribution graph가 정확하고 프로필이나 포트폴리오에 기억에 남는 시각 자료를 넣고 싶을 때.
문제를 확인해야 할 때
도시가 비어 있거나 최근 작업이 없거나 비공개 기여가 예상과 다르게 보일 때.
규칙의 가장 좋은 출처
계산 규칙은 GitHub 공식 문서를 보고, 이 글은 실무 체크리스트로 사용하세요.
다음 내부 단계
기준이 맞으면 GitHub City 홈페이지에서 3D 도시를 생성하세요.
FAQ
GitHub contribution graph란 무엇인가요?
GitHub 프로필에 표시되는 달력형 활동 차트입니다. 조건을 만족하는 기여를 요약하지만 모든 commit이나 action의 원시 로그는 아닙니다.
왜 GitHub에 제 커밋이 보이지 않나요?
연결되지 않은 이메일, 계산 대상이 아닌 branch, fork 동작, 비공개 표시, 저장소 적합성, 업데이트 지연이 흔한 원인입니다.
GitHub Classroom 커밋도 그래프에 표시되나요?
GitHub의 일반 기여 규칙을 만족하면 표시될 수 있습니다. fork, 비공개 저장소, 부적합한 branch에서는 예상과 다를 수 있습니다.
GitHub City가 공식 contribution graph를 대체하나요?
아니요. GitHub City는 기여 패턴을 시각적으로 보여주는 층입니다. 활동이 계산되었는지 확인하는 기준은 공식 그래프입니다.
3D 그래프가 비공개 저장소 이름을 보여줄 수 있나요?
비공개 세부 정보를 노출해서는 안 됩니다. 설정이 허용할 때도 익명화된 기여 count로 표현되어야 합니다.