DevToys Web Pro iconDevToys Web ProBlog
Oceń nas:
Wypróbuj rozszerzenie przeglądarki:

Generator odznak (SVG w stylu Shields)

Gotowe ustawienia
Styl
Logo (SVG lub PNG data URI)

Podgląd

build: passing

Kod SVG

  • Markdown (shields.io)

  • Markdown (własny hosting SVG)

  • Pobierz powyższy SVG, zatwierdź go w repozytorium (na przykład jako badge.svg) i odwołaj się do niego ścieżką względną, aby nie zależeć od shields.io.

    HTML

  • reStructuredText

  • AsciiDoc

  • Statyczny URL shields.io

  • Szczegóły techniczne

    Jak działa generator odznak

    Co robi generator odznak

    Generator odznak tworzy odznaki statusu w stylu shields jako samodzielne pliki SVG. Wpisz etykietę i wiadomość, wybierz kolory (nazwy shields, takie jak brightgreen, wartości hex lub rgb) oraz jeden z pięciu stylów: flat, flat-square, plastic, for-the-badge lub social. Szerokości tekstu są przybliżane na podstawie metryk Verdana, aby odznaka pasowała do zawartości, a całość jest renderowana w przeglądarce. Otrzymujesz kod SVG, plik do pobrania, równoważny URL shields.io i gotowe do wklejenia fragmenty.

    Typowe zastosowania

    Odznaki w README podsumowują status builda, pokrycie, wersję, licencję, obsługiwane platformy i sponsoring. Użyj tego narzędzia, gdy chcesz mieć własną odznakę, której shields.io nie oferuje, gdy odznaka ma działać offline lub w sieci prywatnej albo gdy statyczny SVG jest zatwierdzany w repozytorium, aby dokumentacja nigdy nie psuła się przez awarię zewnętrznej usługi. Gotowe ustawienia build passing, MIT license, version, coverage i PRs welcome pozwalają szybko zacząć.

    Formaty wyjściowe

    Wynik obejmuje surowy SVG, Markdown z adresem URL obrazu shields.io, Markdown wskazujący na własny badge.svg, znacznik HTML img, dyrektywę image reStructuredText i makro image AsciiDoc. Statyczny URL shields.io stosuje udokumentowane reguły ucieczki: myślnik staje się dwoma myślnikami, podkreślnik dwoma podkreślnikami, a spacje podkreślnikami. URL jest tylko generowany jako tekst i nigdy nie jest wywoływany.

    Typowe pułapki i przypadki brzegowe

    Kolory, które nie są rozpoznaną nazwą, wartością hex ani trójką rgb(), są ignorowane i używany jest kolor domyślny, co zapobiega wstrzykiwaniu znaczników do SVG. Logo muszą być URI danych base64 SVG lub PNG i są osadzane jako obrazy, nigdy jako surowe znaczniki. Szerokość odznaki jest przybliżona, więc bardzo nietypowe czcionki lub tekst spoza alfabetu łacińskiego mogą być renderowane nieco szerzej niż ramka. GitHub serwuje pliki SVG z repozytorium z restrykcyjną polityką treści, więc przy osadzaniu poza repozytorium użyj surowego URL lub wariantu shields.io.