빠른 답: GitHub Profile Trophy는 README용 작은 성취 카드입니다
GitHub Profile Trophy는 GitHub 사용자 이름을 기준으로 성취형 카드를 생성하는 도구입니다. 프로필 README가 이미 자기소개, 주요 프로젝트, 연락 경로를 설명하고 있을 때 보조 시각 신호로 유용합니다.
좋은 프로필 README 구조를 대체하지는 않습니다. 먼저 소개와 프로젝트 증거를 정리한 뒤 Trophy를 추가하세요.
가장 좋은 방식은 절제된 사용입니다. 읽기 쉬운 테마, 정확한 사용자 이름, 적은 행과 열, 불필요한 트로피 숨김을 적용하세요. 큰 카드를 맨 위에 두기보다 활동 섹션 근처에 작게 두는 편이 좋습니다.
가까운 목적에는 GitHub streak stats, profile-3d-contrib, GitHub City를 각각 구분해 사용하세요.
README를 복잡하게 만들지 않고 Trophy 추가하기
설정은 쉽지만 배치 판단이 중요합니다. 아이콘, 랭크, 색상은 시선을 끌기 때문에 활동 이해에 도움이 되는 위치에만 두어야 합니다.
게시 전 데스크톱과 모바일에서 README를 확인하세요. 첫 화면이 이미 배지와 위젯으로 가득하다면 먼저 정리하세요.
README 목표 정하기
채용, 오픈소스, 학습 기록, 포트폴리오 중 무엇을 위한 프로필인지 정합니다.
공식 저장소에서 시작하기
유지되는 프로젝트나 호스팅 URL을 사용하고 사용자 이름을 정확히 설정합니다.
차분한 테마 선택
GitHub 라이트/다크 모드 모두에서 읽기 쉬워야 합니다.
행, 열, 랭크 줄이기
작은 카드가 더 빠르게 읽히고 약한 신호를 줄입니다.
활동 문맥 근처에 배치
무엇을 보여주는지 한 문장으로 설명하고 프로젝트나 GitHub City로 연결합니다.
GitHub Profile Trophy vs Streak Stats, Readme Stats, GitHub City
각 위젯은 답하는 질문이 다릅니다. 방문자가 몇 초 안에 알아야 할 내용에 맞춰 고르세요.
모두 상단에 쌓지 마세요. 작은 카드 하나와 좋은 프로젝트 링크가 더 설득력 있습니다.
| 옵션 | 적합한 용도 | 설정 | 위험 | 추천 위치 |
|---|---|---|---|---|
| GitHub Profile Trophy | 공개 성취와 활동 신호. | 호스팅 URL 파라미터 설정. | 프로젝트 증거가 없으면 장식처럼 보임. | 소개 아래나 활동 섹션 근처. |
| GitHub Streak Stats | 보이는 기여 리듬. | streak 이미지 추가. | 생산성 점수처럼 오해될 수 있음. | 데이터 한계 설명과 함께 사용. |
| GitHub Readme Stats | 언어, 저장소, 프로필 카드. | 카드 유형, 사용자, 테마 선택. | 많으면 README가 무거워짐. | 프로젝트 설명을 보강할 때. |
| GitHub City | 인터랙티브 3D 탐색. | 도구에서 사용자 이름 입력. | 작은 README 카드는 아님. | 전체 기여 패턴 탐색 링크. |
Trophy 카드가 이상할 때 확인할 점
대부분은 파라미터, 캐시, 공개 데이터 기대치에서 발생합니다.
트로피가 없다고 항상 서비스 오류는 아닙니다.
카드가 비어 있음
사용자 이름, URL 인코딩, 네트워크, GitHub의 원격 이미지 로딩을 확인합니다.
카드가 너무 넓음
열, 행, 크기를 줄이고 모바일에서 테스트합니다.
색상이 어색함
더 중립적인 테마와 적은 배지 색상을 사용합니다.
트로피가 과장됨
숨기거나 설명을 추가해 실제 작업을 과장하지 않습니다.
좋은 프로필 README에서 Trophy를 둘 위치
초기 요약 뒤나 활동 섹션 근처에 두세요. 좋은 프로젝트를 아래로 밀어내면 안 됩니다.
강한 프로필은 글, 실제 프로젝트 증거, 하나의 시각 레이어로 구성됩니다. 이미 통계 카드가 많다면 GitHub City 링크가 더 명확할 수 있습니다.
내부 링크는 목적별로 사용하세요. 구조는 README 템플릿, 데이터 규칙은 contribution graph, 탐색은 GitHub City입니다.
실전 규칙
Trophy 카드가 다음 프로젝트를 더 신뢰하게 만들지 못한다면 아래로 옮기거나 제거하세요.
FAQ
GitHub Profile Trophy란?
GitHub 사용자 이름을 위한 성취형 트로피 카드를 생성하는 도구입니다.
README.md에 어떻게 추가하나요?
호스팅 URL에 사용자, 테마, 옵션을 설정하고 Markdown 또는 HTML 이미지로 삽입합니다.
GitHub Readme Stats와 같은가요?
아닙니다. Trophy는 성취 카드이고 Readme Stats는 언어, 저장소, 프로필 통계 카드입니다.
프로필 맨 위에 둬야 하나요?
보통은 아닙니다. 소개와 주요 프로젝트가 먼저 와야 합니다.
GitHub City와 함께 쓸 수 있나요?
네. Trophy는 작은 신호, GitHub City는 더 풍부한 3D 보기입니다.