shields
1.0.0
Este é o lar de Shields.io, um serviço para emblemas concisos, consistentes e legíveis no formato SVG e raster, que pode ser facilmente incluído no GitHub ReadMes ou em qualquer outra página da web. O serviço suporta dezenas de serviços de integração contínua, registros de pacotes, distribuições, lojas de aplicativos, redes sociais, serviços de cobertura de código e serviços de análise de código. Todo mês, serve mais de 1,6 bilhão de imagens e é usado por alguns dos projetos de código aberto mais populares do mundo, vs Code, Vue.js e Bootstrap, para citar alguns.
Este repo hosts:
Faça seus próprios emblemas! (Exemplo rápido: https://img.shields.io/badge/left-right-f39f37 )
Navegue por uma lista completa de crachás e localize um crachá específico usando a barra de pesquisa ou navegando nas categorias. Clique no crachá para preencher os elementos de dados necessários para esse tipo de crachá (como seu nome de usuário ou repositório) e opcionalmente personalizar (etiqueta, cores etc.). E está pronto para uso!
Use o botão na parte inferior para copiar o URL ou o snippet do crachá, que pode ser adicionado a lugares como os arquivos do seu Github ReadMe ou outras páginas da Web.
Shields é um projeto comunitário. Convidamos sua participação através de problemas e solicitamos solicitações! Você pode ler as diretrizes contribuintes.
Ao adicionar ou alterar um serviço, adicione testes.
Este projeto tem um estoque bastante de sugestões! Se você é novo no projeto, talvez deseje abrir uma solicitação de tração para abordar um deles.
Você pode ler um tutorial sobre como adicionar um crachá.
Se você pretende relatar ou contribuir com uma correção relacionada às vulnerabilidades de segurança, consulte primeiro nossa política de segurança.
npm ci para instalar as dependências.npm start para iniciar o servidor Badge e o servidor de dev frontend.http://localhost:3000/ Para visualizar o front -end. Quando os arquivos de origem do servidor são alterados, o servidor Badge deve reiniciar automaticamente (usando o Nodemon). Quando os arquivos do front -end mudam, o servidor dev -dev ( docusaurus start ) também deve recarregar automaticamente. No entanto, as definições de crachá são criadas apenas antes do início do servidor. Para regenerar esses, execute npm run prestart ou reinicie manualmente o servidor.
Para depurar um crachá da linha de comando, execute npm run badge -- /npm/v/nock . Ele também funciona com URLs completos como npm run badge -- https://img.shields.io/npm/v/nock .
Use npm run debug:server para iniciar o servidor no modo de depuração. Esta receita mostra como depurar o aplicativo Node.js no código VS.
Shields possui suporte experimental ao GITPOD, um ambiente de desenvolvimento pré-configurado que é executado no seu navegador. Para usar o gitpod, clique no botão abaixo e faça login no GitHub. O GITPOD também oferece um complemento do navegador, embora não seja necessário. Por favor, relate quaisquer bugs, perguntas ou sugestões do gitpod na edição #2772.
Os testes de instantâneo garantem que não faça alterações inadvertidamente que afetem a saída SVG ou JSON. Ao alterar deliberadamente a saída, execute SNAPSHOT_DRY=1 npm run test:package para visualizar as alterações nos instantâneos salvos e SNAPSHOT_UPDATE=1 npm run test:package para atualizá -los.
O servidor pode ser configurado para usar o Sentry (configuração) e Prometheus (configuração).
Nossa suíte de teste completa e a cobertura de código são executadas diariamente.
Há documentação sobre como hospedar seu próprio servidor.
Os crachás de status são amplamente utilizados em projetos de software de código aberto e privados. Os acadêmicos estudaram os emblemas "Signal" fornecem sobre a qualidade do projeto de software. Existem muitas bibliotecas existentes para prestar esses crachás e alternativas ao serviço de distintivos de Shields hospedado. Awesome-Badges é uma coleção com curadoria de tais recursos. Contribuições podem ser consideradas lá. (A presença de um projeto nessa coleção não deve ser interpretada como um endosso nem promoção do projeto Shields)
B.Adge.me foi o site original para este serviço. Heroku naquela época tinha uma coisa que dificultava o uso de um domínio de Toplevel com ele, daí o domínio estranho. Ele usou o código desenvolvido em 2013 a partir de uma biblioteca chamada GH-Badges, ambos desenvolvidos por Thaddée Tyl. O projeto se fundiu com o Shields.io, fazendo -o usar o código b.adge.me e fechado B.Adge.me.
A especificação original do crachá foi desenvolvida em 2013 por Olivier Lacan. Foi inspirado pelo Travis CI e crachás semelhantes (havia muito menos, naquela época). Em 2014, Thaddée Tyl redesenhou -o com a ajuda de um funcionário da Travis CI e convenceu todos a mudar para ele. O design antigo é o que hoje é chamado de estilo plástico; O novo é o estilo plano.
Você pode ler mais sobre o início do projeto, a motivação da especificação de crachá SVG e a própria especificação.
Mantenedores:
Ex -alunos:
Todos os ativos e código estão sob a licença CC0 e em domínio público, a menos que especificado de outra forma.
Graças às pessoas e empresas que doam dinheiro, serviços ou tempo para manter o projeto funcionando. https://shields.io/comunity
