Генератор бейджей (SVG в стиле Shields)
Предпросмотр
Код SVG
Markdown (shields.io)
Markdown (SVG на собственном хостинге)
Скачайте SVG выше, закоммитьте его в репозиторий (например, как badge.svg) и ссылайтесь на относительный путь, чтобы не зависеть от shields.io.
HTML
reStructuredText
AsciiDoc
Статический URL shields.io
Технические детали
Как работает генератор бейджей
Что делает генератор бейджей
Генератор бейджей создаёт бейджи статуса в стиле shields в виде отдельных SVG-файлов. Введите подпись и сообщение, выберите цвета (названия shields вроде brightgreen, значения hex или rgb) и один из пяти стилей: flat, flat-square, plastic, for-the-badge или social. Ширина текста оценивается по метрикам Verdana, чтобы бейдж подходил по размеру, а всё отрисовывается в вашем браузере. Вы получаете код SVG, загрузку, эквивалентный URL shields.io и готовые к вставке фрагменты.
Типичные сценарии
Бейджи в README отражают статус сборки, покрытие, версию, лицензию, поддерживаемые платформы и спонсорство. Используйте этот инструмент, когда нужен свой бейдж, которого нет в shields.io, когда бейдж должен работать офлайн или в закрытой сети, либо когда статический SVG коммитится в репозиторий, чтобы документация не ломалась из-за недоступности стороннего сервиса. Пресеты build passing, MIT license, version, coverage и PRs welcome помогут быстро начать.
Форматы вывода
Результат включает необработанный SVG, Markdown с URL изображения shields.io, Markdown со ссылкой на собственный badge.svg, HTML-тег img, директиву image для reStructuredText и макрос image для AsciiDoc. Статический URL shields.io следует задокументированным правилам экранирования: дефис превращается в два дефиса, подчёркивание — в два подчёркивания, а пробелы — в подчёркивания. URL только формируется как текст и никогда не запрашивается.
Типичные ловушки и особые случаи
Цвета, не являющиеся распознаваемым названием, значением hex или тройкой rgb(), игнорируются, и используется цвет по умолчанию, что предотвращает внедрение разметки в SVG. Логотипы должны быть data URI base64 в формате SVG или PNG и встраиваются как изображения, а не как необработанная разметка. Ширина бейджа приблизительна, поэтому очень необычные шрифты или нелатинский текст могут отображаться чуть шире рамки. GitHub отдаёт SVG из вашего репозитория со строгой политикой содержимого, поэтому при встраивании за пределами репозитория используйте raw-URL или вариант shields.io.