배지 생성기(Shields 스타일 SVG)
미리보기
SVG 코드
Markdown(shields.io)
Markdown(셀프 호스팅 SVG)
위의 SVG를 다운로드해 저장소에 커밋(예: badge.svg)하고 이 상대 경로로 참조하면 shields.io에 의존하지 않아도 됩니다.
HTML
reStructuredText
AsciiDoc
shields.io 정적 URL
기술적 세부 정보
배지 생성기 작동 방식
배지 생성기가 하는 일
배지 생성기는 Shields 스타일의 상태 배지를 독립형 SVG 파일로 만듭니다. 레이블과 메시지를 입력하고, 색상(brightgreen 같은 Shields 이름, hex 또는 rgb 값)과 5가지 스타일(flat, flat-square, plastic, for-the-badge, social) 중 하나를 선택하세요. 텍스트 너비는 Verdana 메트릭을 기준으로 근사하여 배지가 내용에 맞게 조정되며, 모든 렌더링은 브라우저에서 이루어집니다. SVG 코드, 다운로드, 동등한 shields.io URL, 바로 붙여넣을 수 있는 스니펫을 받을 수 있습니다.
일반적인 사용 사례
README 배지는 빌드 상태, 커버리지, 버전, 라이선스, 지원 플랫폼, 후원 현황을 요약합니다. shields.io에서 제공하지 않는 사용자 지정 배지가 필요할 때, 오프라인이나 사설 네트워크에서도 동작해야 할 때, 또는 서드파티 서비스가 중단되어도 문서가 깨지지 않도록 저장소에 정적 SVG를 커밋하고 싶을 때 이 도구를 사용하세요. build passing, MIT license, version, coverage, PRs welcome 프리셋으로 빠르게 시작할 수 있습니다.
출력 형식
출력에는 원시 SVG, shields.io 이미지 URL을 사용한 Markdown, 셀프 호스팅 badge.svg를 가리키는 Markdown, HTML img 태그, reStructuredText image 지시문, AsciiDoc image 매크로가 포함됩니다. shields.io 정적 URL은 문서화된 이스케이프 규칙을 따릅니다. 대시 하나는 대시 두 개로, 밑줄 하나는 밑줄 두 개로, 공백은 밑줄로 바뀝니다. URL은 텍스트로만 생성되며 실제로 요청되지는 않습니다.
흔한 함정과 예외 상황
인식되는 이름, hex 값, rgb() 세 값이 아닌 색상은 무시되고 기본값이 사용되므로 SVG에 마크업이 삽입되는 것을 방지합니다. 로고는 base64 SVG 또는 PNG data URI여야 하며 이미지로 삽입되고 원시 마크업으로는 삽입되지 않습니다. 배지 너비는 근사값이므로 매우 특이한 글꼴이나 라틴 문자가 아닌 텍스트는 상자보다 약간 넓게 렌더링될 수 있습니다. GitHub는 저장소의 SVG를 엄격한 콘텐츠 정책으로 제공하므로 저장소 밖에 삽입할 때는 raw URL이나 shields.io 변형을 사용하세요.