Generatore di badge markdown
Crea badge shields.io per un README e avvolgili in Markdown, HTML o reStructuredText.
Generatore di badge markdown
Ogni README che mostra uno stato di compilazione, un numero di versione o un'icona di licenza in alto utilizza un badge shields.io — una piccola immagine SVG composta da un'etichetta, un valore e un colore. Questo strumento crea quel badge per te: compila l'etichetta, il valore e il colore, scegli uno stile e un logo facoltativo, e assemblerà l'URL shields.io e lo avvolgerà nel markup che il tuo progetto utilizza effettivamente.
L'opzione di stile copre tutti e cinque i rendering shields.io — flat, flat-square, plastic, for-the-badge e social — e il campo logo accetta qualsiasi slug simple-icons (github, npm, docker e centinaia di altri), tinto con il colore del logo quando vuoi che corrisponda al badge. Aggiungi un link e il badge diventa cliccabile nella pagina renderizzata; aggiungi testo alternativo e rimane significativo per uno screen reader. Il formato di output passa tra Markdown, HTML e reStructuredText, in modo che lo stesso badge si inserisca direttamente in un README, un sito di documentazione o un progetto Sphinx senza modificare manualmente il markup.
Costruire più badge contemporaneamente è quello per cui è la seconda casella: incolla un elenco, un badge per riga come etichetta|valore|colore, e lo strumento lo trasforma in una fila di badge fianco a fianco — il modello che vedi sotto un titolo di progetto con compilazione, copertura, versione e licenza tutti in una riga. Attiva l'ordinamento per ordinare quella fila alfabeticamente, o aggiungi una tabella di badge per renderizzare anche lo stesso set come riferimento a due colonne. L'opzione di escape gestisce la particolarità shields.io che confonde le persone: un trattino o uno spazio letterale all'interno di un'etichetta deve essere raddoppiato o sostituito prima che l'URL sia valido, e questo strumento lo fa automaticamente a meno che non lo disattivi.
Tutto viene eseguito nel tuo browser. L'etichetta, il valore e qualsiasi elenco in lotto che incolla vengono utilizzati solo per costruire una stringa URL localmente — nulla viene caricato e lo strumento non contatta mai shields.io stesso, scrive solo il link. Copia il risultato, scaricalo come file .txt o invialo all'input di un altro strumento per continuare a modificare.