DevToys Web Pro iconDevToys Web ProBlogi
Hinda meid:
Proovi brauserilaiendust:

Märgikeneraator (Shieldsi stiilis SVG)

Eelseaded
Stiil
Logo (SVG või PNG data URI)

Eelvaade

build: passing

SVG-kood

  • Markdown (shields.io)

  • Markdown (ise majutatud SVG)

  • Laadi ülaltoodud SVG alla, lisa see oma hoidlasse (näiteks nimega badge.svg) ja viita sellele selle suhtelise teega, et vältida sõltuvust shields.io-st.

    HTML

  • reStructuredText

  • AsciiDoc

  • shields.io staatiline URL

  • Tehnilised üksikasjad

    Kuidas märgikeneraator töötab

    Mida märgikeneraator teeb

    Märgikeneraator koostab shieldsi stiilis olekumärke eraldiseisvate SVG-failidena. Sisesta silt ja teade, vali värvid (shieldsi nimed, nt brightgreen, hex- või rgb-väärtused) ning üks viiest stiilist: flat, flat-square, plastic, for-the-badge või social. Teksti laiused arvutatakse ligikaudu Verdana mõõdikute järgi, et märk sobiks sisuga, ja kõik renderdatakse sinu brauseris. Saad SVG-koodi, allalaadimise, samaväärse shields.io URL-i ja kleebitavad lõigud.

    Levinumad kasutusjuhud

    README-märgid võtavad kokku ehitusoleku, katvuse, versiooni, litsentsi, toetatud platvormid ja sponsorluse. Kasuta seda tööriista, kui soovid kohandatud märki, mida shields.io ei paku, märki, mis peab töötama võrguühenduseta või privaatvõrgus, või staatilist SVG-d hoidlas, et dokumentatsioon ei läheks katki, kui kolmanda poole teenus on maas. Eelseaded build passing, MIT-litsents, versioon, coverage ja PRs welcome annavad kiire alguse.

    Väljundvormingud

    Väljund sisaldab toor-SVG-d, Markdowni shields.io pildi URL-iga, Markdowni, mis viitab ise majutatud failile badge.svg, HTML-i img-märgendit, reStructuredText image-direktiivi ja AsciiDoc image-makrot. Shields.io staatiline URL järgib dokumenteeritud paomärkide reegleid: kriips muutub kaheks kriipsuks, alakriips kaheks alakriipsuks ja tühikud alakriipsudeks. URL luuakse ainult tekstina ja seda ei pärita kunagi.

    Levinud lõksud ja äärmuslikud juhud

    Värvid, mis ei ole tuntud nimi, hex-väärtus ega rgb()-kolmik, ignoreeritakse ja kasutatakse vaikeväärtust, mis takistab märgistuse süstimist SVG-sse. Logod peavad olema base64 SVG või PNG data URI-d ja need manustatakse piltidena, mitte kunagi toormärgistusena. Märgi laius on ligikaudne, seega võivad väga ebatavalised fondid või mitte-ladina tekst renderduda kastist veidi laiemalt. GitHub serveerib SVG-sid sinu hoidlast piirava sisupoliitikaga, seega kasuta hoidlast väljaspool manustamisel raw URL-i või shields.io varianti.