Cinco emblemas principais que levarão seu repositório GitHub ao próximo nível

Os emblemas do GitHub podem aumentar a legibilidade de um repositório, fornecendo aos usuários uma maneira rápida de capturar as métricas do repositório. Badges podem ser embutidos em seu README.md para esclarecer a importância e necessidade de seu projeto para outros desenvolvedores. Como resultado, os leitores têm uma ideia muito rápida do repositório, verificando os emblemas anexados.

Existem muitos emblemas do GitHub disponíveis na Internet. Aqui estão os cinco emblemas mais informativos para incluir em seu arquivo README.md. Para cada crachá listado, o código Markdown equivalente é fornecido.

O que os emblemas do GitHub podem fazer por você?

Adicionar emblemas do GitHub ao seu repositório pode parecer trivial, mas na verdade é incrivelmente útil. Tudo que você precisa fazer é importar o código Markdown da fonte para o arquivo README.md.

Quando criei meu repositório GitHub de programação Python, omiti os selos. Meu repositório não embelezado tinha o conteúdo certo, mas não se destacou. Por causa disso, o repositório ganhou muito pouco tráfego (visitantes únicos).

Relacionado: Como criar um repositório GitHub

Como criar seu primeiro repositório no Github

Quer compartilhar seus projetos de desenvolvimento online? Veja como começar com seu primeiro repositório Github.

Depois de adicionar mais emblemas ao meu repositório, vi um aumento automático no número de visitantes externos (de 5 para 767) mensalmente (veja seus visitantes únicos em Insights> Tráfego no seu repositório.)

Minha caixa de entrada estava cheia de comentários sobre o quão bem meu repositório se destacou de outros repositórios de programação Python - tudo por causa dos emblemas. Um simples emblema do GitHub pode mudar completamente a aparência do seu repositório.

Sempre tenha isso em mente: um emblema vale 1000 linhas de código.

O emblema GitHub Stats demonstra o total de estrelas, confirmações, solicitações pull, problemas e contribuições de seu repositório GitHub.

1. Estrelas: Os usuários salvam repositórios GitHub (como favoritos). Isso indica que o usuário está interessado e deseja se manter atualizado com o repositório salvo. No entanto, um repositório com estrela não pode ser editado.
2. Compromissos: Salvar uma alteração em um repositório é conhecido como Confirmar. Vários detalhes são anexados a um commit, conteúdo, mensagem (descrição), nome do autor e carimbo de data / hora.
3. Solicitação de pull: Uma solicitação pull informa outras pessoas sobre as melhorias que você enviou para um repositório GitHub diferente, exceto o seu. Freqüentemente, nos referimos a Pull Request como o coração da colaboração GitHub.
4. Problemas: Os problemas do GitHub são usados ​​para obter feedback do usuário, rastrear ideias, melhorias e listar bugs relatados ao repositório.
5. Contribuição: Contribuições do GitHub indicam o número de contribuições feitas a outros repositórios. Uma contribuição pode ser feita com a ajuda de um Pull Request.

Para adicionar o emblema GitHub Stats ao seu repositório, incorpore o código Markdown abaixo em seu arquivo README.md.

! [Estatísticas do seu repositório] ( https://github-readme-stats.vercel.app/api? username = Your_GitHub_Username & show_icons = true)

Certifique-se de alterar o nome de usuário = valor ao nome de usuário do GitHub. O emblema GitHub Stats também fornece classificações, bem como S + (top 1%), S (top 25%), A ++ (top 45%), A + (top 60%) e B + (todos). Quanto mais altas forem suas estatísticas, melhor será sua classificação.

Como o nome sugere, o emblema de idiomas mais usados ​​exibe os idiomas mais comuns usados ​​em todo o GitHub. É uma métrica do GitHub de quais linguagens como HTML, CSS, JavaScript, Python, Go, e mais têm a maior parte do código no GitHub. Os idiomas são listados em ordem decrescente.

Relacionado: Qual linguagem de programação você deve aprender?

Para adicionar o emblema dos Idiomas Mais Usados ​​ao seu repositório, incorpore o Markdown abaixo em seu arquivo README.md.

! [Estatísticas do seu repositório] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)

A única desvantagem desse emblema é que ele não lista Markdown como a linguagem mais comumente usada.

O selo de contribuidores exibe todas as operações, como aditivos, exclusões, e compromete que foram executados em seus repositórios. Quando você mescla uma solicitação pull em seu repositório, o indivíduo que criou a solicitação será adicionado como um contribuidor. É realmente um bom hábito dar crédito aos contribuidores que investiram seu tempo no fornecimento de uma atualização para o seu repositório.

O selo de contribuidores pode ser gerado usando contributors-img, um aplicativo da web que gera uma imagem para exibir a lista de contribuidores.

Gerar a imagem do colaborador é bastante trivial. Navegue até o site contributors-img e cole o nome do seu repositório junto com o seu nome de usuário para gerar o URL. Como alternativa, simplesmente incorpore o código Markdown fornecido abaixo para obter a imagem.

! [Imagem de colaboradores do GitHub] ( https://contrib.rocks/image? repo = Your_GitHub_Username / Your_GitHub_Repository_Name)

O gerador de piadas aleatórias irá gerar uma piada técnica na forma de perguntas e respostas. Por exemplo, "O que é um vírus de computador? A doença terminal”.

Para usar o emblema, você precisa incorporar o código Markdown em seu arquivo README.md conforme mostrado abaixo.

## 😂 Aqui está uma piada aleatória que vai fazer você rir!
! [Cartão de piadas] ( https://readme-jokes.vercel.app/api)

O emblema do contador de visualização de perfil exibe o número de vezes que seu perfil do GitHub foi visualizado em seu perfil. Para gerar este emblema, incorpore o seguinte código Markdown:

! [Contador de visualização do perfil] ( https://komarev.com/ghpvc/?username=Your_GitHub_Username)

Para gerar a contagem de visualizações do seu repositório, você pode querer usar o HITS (Como os idiotas rastreiam o sucesso) distintivo. É uma maneira simples de ver quantas pessoas visitaram seu GitHub repositório:

![Exitos]( https://hitcounter.pythonanywhere.com/count/tag.svg? url = Paste_Your_GitHub_Repository_Link_Here)

Mas a desvantagem do contador de visualizações de perfil e HITS é que eles não exibem a contagem de visualizações com IDs exclusivos. Cada vez que você recarregar o navegador / repositório, as contagens serão incrementadas. Pode-se facilmente obter mais visualizações atualizando a página.

Implementação completa de emblemas do GitHub

Usei meu repositório GitHub como exemplo. Para gerar os emblemas, é recomendável adicionar esses códigos ao arquivo README.md designado. Se você não tiver um arquivo README.md em seu repositório GitHub, criar um manualmente é a melhor opção.

# 5 principais emblemas que levarão seu repositório GitHub ao próximo nível
## 1. Estatísticas do GitHub
! [Estatísticas do seu repositório] ( https://github-readme-stats.vercel.app/api? username = Tanu-N-Prabhu & show_icons = true)
## 2. Línguas Mais Usadas
! [Estatísticas do seu repositório] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green)
## 3. Emblema de contribuidores
! [Estatísticas do seu repositório] ( https://contrib.rocks/image? repo = Tanu-N-Prabhu / Python)
## 4. Gerador de piadas aleatórias
! [Cartão de piadas] ( https://readme-jokes.vercel.app/api)
## 5. Contador de visualização de perfil
! [Contador de visualização do perfil] ( https://komarev.com/ghpvc/?username=Tanu-N-Prabhu)
### Repository View Counter - HITS
![Exitos]( https://hitcounter.pythonanywhere.com/count/tag.svg? url = https://github.com/Tanu-N-Prabhu/Python)

Não há necessidade de executar ou executar o trecho de código de markdown acima em seu arquivo README.md. No momento em que você salva o arquivo com a extensão (.md), o GitHub renderizará automaticamente a saída e as alterações serão refletidas diretamente em seu repositório.

Mais emblemas do GitHub disponíveis

Agora que você sabe como adicionar emblemas do GitHub ao seu repositório, é uma ótima opção para desenvolvedores e indivíduos que podem usar esses emblemas para aumentar a legibilidade de seus repositórios. Não é tão difícil - tudo que você precisa fazer é incorporar algumas linhas de código Markdown para gerar os emblemas.

Quanto mais emblemas você incluir em seu repositório, mais atenção receberá. Um único crachá terá a capacidade de fornecer informações úteis em termos de estatísticas, status e métricas.

Como clonar um repositório usando o GitHub Desktop

Quer se familiarizar com o software no GitHub? Veja como fazer isso com a ferramenta GitHub Desktop simplificada.

Sobre o autor