올바른 파일 준비하기
GitHub의 현재 안내는 1 MB 미만의 PNG, JPG, GIF 파일을 허용합니다. 최소 640 × 320픽셀을 권장하며 최적의 표시에는 1280 × 640을 권장합니다. 더 큰 2:1 캔버스로 시작한 뒤 훨씬 작게 줄였을 때도 읽히는지 확인하세요.
가상의 CSV 검증기라면 프로젝트 이름, ‘가져오기 전에 CSV 파일 검사’, 간단한 입력과 오류 예시를 배치할 수 있습니다. 터미널 세션 전체를 썸네일에 넣지 마세요. 공유 화면에서 이미지가 잘릴 수 있으므로 중요한 글자는 가장자리에서 떨어뜨리세요.
업로드하고 공유 링크 확인하기
저장소 Settings에서 Social preview를 찾아 Edit를 선택하고 이미지를 업로드하세요. 독자가 볼 공유 대상에 공개 저장소 URL을 공유하고 그곳에서 결과를 확인하세요. 업로드 성공이 모든 플랫폼의 캐시된 미리보기를 즉시 바꾼다는 뜻은 아닙니다.
- 공유할 저장소에 해당하는 이미지인지 확인하세요.
- 업로드 전에 파일 형식, 픽셀 크기, 파일 용량을 확인하세요.
- 읽기 쉬운 대비를 사용하고 투명한 이미지는 밝고 어두운 배경 모두에서 확인하세요.
- 오래된 이미지가 보이면 저장된 저장소 설정을 확인하고 공유 플랫폼의 캐시를 조사하세요.
미리보기와 프로젝트를 일치시키기
이미지, README, 릴리스 공지에서 동일한 프로젝트 이름과 목적을 사용하세요. 스크린샷이 실험 기능을 보여 준다면 표시하거나 안정적인 작업 흐름을 사용하세요. 꾸며낸 Star 수, 고객 로고, 성능 주장을 추가하지 마세요.
프로젝트의 핵심 사용 사례가 바뀌면 이미지를 다시 검토하세요. 미리보기는 소통을 위한 자료이며 순위, 클릭률, GitHub Star를 별도로 보장하지 않습니다.
자주 묻는 질문
저장소 소유자의 아바타와 같은 것인가요?
아닙니다. 소유자 아바타는 계정을 식별합니다. 맞춤 저장소 소셜 미리보기는 링크를 공유할 때 특정 프로젝트를 나타냅니다.
투명 배경을 사용할 수 있나요?
GitHub는 PNG 투명도를 지원합니다. 여러 배경에서 대비를 확인하세요. 공유 대상의 외형을 모른다면 단색 배경이 실용적입니다.
업로드 후에도 이전 미리보기가 보이는 이유는 무엇인가요?
먼저 새 이미지가 올바른 저장소에 저장되었는지 확인하세요. 공유 플랫폼은 미리보기를 캐시할 수 있으며, 갱신 동작은 저장소 설정과 별개입니다.