Os 5 principais emblemas 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 emblema 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).
Depois de adicionar mais emblemas ao meu repositório, observei um aumento automático no número de visitantes externos (de 5 para 767) mensalmente (veja seus visitantes únicos em Insights> Tráfego em 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.
1. Estatísticas do GitHub
O emblema GitHub Stats demonstra o total de estrelas, confirmações, solicitações de pull, problemas e contribuições de seu repositório GitHub.
- 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.
- Commits : Salvar uma alteração em um repositório é conhecido como Commit. Vários detalhes são anexados a um commit, conteúdo, mensagem (descrição), nome do autor e carimbo de data / hora .
- Pull Request : um Pull Request informa outras pessoas sobre as melhorias que você enviou para um repositório GitHub diferente, exceto o seu. Freqüentemente nos referimos à solicitação de pull como o coração da colaboração GitHub.
- Problemas : os problemas do GitHub são usados para obter feedback do usuário, rastrear ideias, aprimoramentos e listar bugs relatados ao repositório.
- Contribuição : as contribuições do GitHub indicam o número de contribuições que foram feitas a outros repositórios. Uma contribuição pode ser feita com a ajuda de um Pull Request.
Para adicionar o emblema do GitHub Stats ao seu repositório, incorpore o código Markdown abaixo em seu arquivo README.md.
Certifique-se de alterar o valor username = para seu nome de usuário do GitHub. O emblema GitHub Stats também fornece classificações, 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.
2. Idiomas mais usados
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 outras têm mais código no GitHub. Os idiomas são listados em ordem decrescente.
Para adicionar o emblema dos Idiomas Mais Usados ao seu repositório, incorpore o Markdown abaixo ao seu arquivo README.md.
A única desvantagem desse emblema é que ele não listará o Markdown como a linguagem mais comumente usada.
3. Selo de contribuidores
O emblema de contribuidores exibe todas as operações, como adições , exclusões e confirmações que foram realizadas 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 fornecendo 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 seu nome de usuário para gerar a URL. Como alternativa, simplesmente incorpore o código Markdown fornecido abaixo para obter a imagem.
4. Gerador de piadas aleatórias
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.
## Here is a random joke that'll make you laugh!
5. Contador de visualização de perfil
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:
Para gerar a contagem de visualizações do seu repositório, você pode usar o emblema HITS ( How Idiots Track Success ). É uma maneira simples de ver quantas pessoas visitaram seu repositório GitHub :
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ê recarrega o navegador / repositório, as contagens são incrementadas. É fácil obter mais visualizações atualizando a página.
Implementação completa dos selos 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.
# Top 5 Badges That Will Take Your GitHub Repository to the Next Level
## 1. GitHub Stats
## 2. Most Used Languages
## 3. Contributors Badge
## 4. Random Joke Generator
## 5. Profile View Counter
### Repository View Counter - HITS
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.
