빠른 답: PNG는 정적 공유용이지 실시간 추적용이 아닙니다
GitHub contribution PNG는 기여 활동을 정적 이미지로 만든 것입니다. 게시 후 바뀌지 않아야 하는 포트폴리오, 글, 발표 자료, 소셜 미리보기에 적합합니다.
PNG를 진실의 원본으로 보면 안 됩니다. 원본은 GitHub contribution graph와 GitHub의 규칙입니다. 공식 그래프에서 빠진 활동은 PNG에서도 빠집니다.
프로필 README에는 동적 SVG 카드나 github-profile-3d-contrib가 더 나을 수 있습니다. 3D 탐색은 GitHub City를 사용하세요.
PNG, SVG, 3D 기여 시각화 비교
형식은 표시 위치에 따라 결정합니다. PNG는 간단하지만 자동 업데이트되지 않습니다. SVG는 README에서 선명하고, 3D는 탐색과 포트폴리오 스토리에 좋습니다.
고정 게시에는 PNG, 최신 상태에는 SVG, 인터랙션에는 GitHub City를 선택하세요.
원본 데이터 선택
GitHub 공식 그래프나 신뢰할 수 있는 generator에서 시작하세요. 사용자 이름, 기간, 비공개 기여 표시 설정을 확인하세요.
고정 게시에는 PNG 사용
슬라이드, 포트폴리오, 기사 이미지, 소셜 미리보기처럼 고정 이미지가 필요한 곳에 PNG를 사용하세요.
업데이트되는 README에는 SVG 사용
README에서 이미지를 계속 최신 상태로 유지해야 한다면 SVG 카드나 workflow로 생성한 asset을 사용하세요.
탐색에는 GitHub City 사용
방문자가 화면을 조작하거나 활동 밀도를 비교하거나 개발 과정을 보여 줘야 한다면 GitHub City로 안내하세요.
GitHub Contribution PNG 실전 워크플로
좋은 작업 흐름은 export 버튼보다 중요합니다. 먼저 공식 그래프가 올바른 활동을 보여 주는지 확인한 뒤 최종 크기에서 읽기 쉬운 이미지를 내보내고 주변에 맥락을 추가하세요.
README에는 정적 PNG를 올린 뒤 방치하지 마세요. 최신 상태가 중요하다면 SVG나 자동화된 workflow를 선택하세요.
| 형식 | 적합한 용도 | 업데이트 방식 |
|---|---|---|
| 기여 PNG 이미지 | 포트폴리오, 기사, 발표, 소셜 미리보기 | 정적 스냅샷, 수동 업데이트 |
| README SVG 카드 | README 섹션과 가벼운 배지 | 서비스나 workflow로 새로 고칠 수 있음 |
| 3D 기여 이미지 | 프로필 시각 자료와 연간 회고 | 대개 workflow로 생성되며 출력 확인 필요 |
| GitHub City 3D 보기 | 인터랙티브 탐색과 스토리텔링 | 보이는 데이터를 바탕으로 한 브라우저 경험 |
GitHub Contribution PNG가 적합한 사용 사례
최신성보다 안정성이 중요할 때는 정적 이미지를 사용하세요. 계속 업데이트되거나 상호작용해야 한다면 다른 형식을 선택하세요.
포트폴리오 근거
특정 연도, 프로젝트 기간, 스프린트를 설명할 때 PNG가 잘 맞습니다.
발표 슬라이드
슬라이드에는 원격 서비스에 의존하지 않는 안정적인 시각화가 필요합니다.
기사 일러스트
PNG는 설명을 보조하지만 결론은 색인 가능한 HTML 텍스트에 남겨야 합니다.
README에서는 주의
정적 PNG는 오래됩니다. 동적 카드나 README 템플릿 섹션을 사용하세요.
문제 해결: PNG가 이상해 보이는 이유
이미지가 비어 있거나 불완전해 보이면 export 설정 전에 데이터를 진단하세요. 커밋 이메일, 브랜치, 포크, 비공개 표시, 업데이트 지연을 확인하세요.
이미지가 흐리면 더 큰 크기로 내보낸 뒤 한 번만 압축하세요. 이미지에 긴 문장을 넣지 말고 설명은 색인 가능한 텍스트로 남기세요.
선택 규칙
고정 게시에는 PNG, 업데이트되는 README에는 SVG 또는 생성 카드, 인터랙티브 탐색에는 GitHub City를 사용하세요.
FAQ
GitHub contribution PNG는 어떻게 만드나요?
먼저 공식 그래프나 신뢰할 수 있는 generator를 확인한 뒤 고정 표시가 필요할 때 고해상도 이미지를 내보내세요.
GitHub README에는 PNG가 SVG보다 좋은가요?
대체로 아닙니다. SVG나 생성 카드는 더 선명하고 업데이트하기 쉽습니다.
PNG에 비공개 기여를 표시할 수 있나요?
원본 그래프가 공개하거나 익명화해 보여 주는 활동만 표시할 수 있습니다. 비공개 저장소의 세부 정보가 드러나면 안 됩니다.
PNG에 일부 커밋이 보이지 않는 이유는 무엇인가요?
PNG는 보통 원본 그래프를 반영합니다. 이메일, 브랜치, 포크, 비공개 설정, 업데이트 시간을 확인하세요.
PNG 대신 GitHub City를 사용해야 하나요?
인터랙티브한 3D 도시에는 GitHub City를, 고정 asset에는 PNG를 사용하세요.