DevToys Web Pro iconDevToys Web ProБлог
Оцініть нас:
Спробуйте розширення для браузера:

Генератор бейджів (SVG у стилі Shields)

Пресети
Стиль
Логотип (SVG або PNG data URI)

Попередній перегляд

build: passing

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 у репозиторії, щоб документація не ламалася, коли сторонній сервіс недоступний. Пресети для успішної збірки, ліцензії MIT, версії, покриття та PRs welcome дають швидкий старт.

    Формати виводу

    Вивід містить сирий SVG, Markdown із URL зображення shields.io, Markdown із посиланням на власний badge.svg, тег HTML img, директиву image для reStructuredText і макрос image для AsciiDoc. Статичний URL shields.io дотримується задокументованих правил екранування: один дефіс стає двома дефісами, одне підкреслення стає двома підкресленнями, а пробіли стають підкресленнями. URL лише генерується як текст і ніколи не запитується.

    Типові підводні камені та крайні випадки

    Кольори, які не є розпізнаною назвою, значенням hex чи трійкою rgb(), ігноруються й замінюються типовим, що запобігає впровадженню розмітки в SVG. Логотипи мають бути SVG або PNG data URI у base64 і вбудовуються як зображення, ніколи як сира розмітка. Ширина бейджа є наближеною, тому дуже незвичні шрифти або нелатинський текст можуть відображатися трохи ширшими за рамку. GitHub віддає SVG з вашого репозиторію з обмежувальною політикою вмісту, тож для вбудовування поза репозиторієм використовуйте raw-URL або варіант shields.io.