Las 5 mejores insignias que llevarán su repositorio de GitHub al siguiente nivel
Las insignias de GitHub pueden mejorar la legibilidad de un repositorio al proporcionar a los usuarios una forma rápida de capturar las métricas del repositorio. Las insignias se pueden incrustar en su README.md para aclarar la importancia y la necesidad de su proyecto a otros desarrolladores. Como resultado, los lectores obtienen una idea muy rápida del repositorio al verificar las insignias adjuntas.
Hay muchas insignias de GitHub disponibles en Internet, aquí están las cinco insignias más informativas para incluir en su archivo README.md. Para cada insignia enumerada, se proporciona el código Markdown equivalente.
¿Qué pueden hacer las insignias de GitHub por ti?
Agregar insignias de GitHub a su repositorio puede parecer trivial, pero de hecho es increíblemente útil. Todo lo que necesita hacer es importar el código Markdown desde la fuente a su archivo README.md.
Cuando creé mi repositorio de Python Programming GitHub, omití las insignias. Mi repositorio sin adornos tenía el contenido correcto pero no se destacaba. Debido a esto, el repositorio ganó muy poco tráfico (visitantes únicos).
Después de agregar más insignias a mi repositorio, vi un aumento automático en los visitantes externos (de 5 a 767) mensuales (vea sus visitantes únicos en Insights> Tráfico en su repositorio).
Mi bandeja de entrada estaba llena de comentarios sobre lo bien que se destacaba mi repositorio de otros repositorios de programación de Python, todo debido a las insignias. Una simple insignia de GitHub puede cambiar por completo el aspecto de su repositorio.
Siempre tenga esto en cuenta: una insignia vale 1000 líneas de código.
1. Estadísticas de GitHub
La insignia de estadísticas de GitHub muestra el total de estrellas, confirmaciones, solicitudes de extracción, problemas y contribuciones de su repositorio de GitHub.
- Estrellas : los usuarios guardan repositorios de GitHub (como marcadores). Esto indica que el usuario está interesado y desea mantenerse actualizado con el repositorio guardado. Sin embargo, un repositorio destacado no se puede editar.
- Confirmaciones : guardar un cambio en un repositorio se denomina Confirmación. Se añaden varios detalles a una confirmación, contenido, mensaje (descripción), nombre del autor y marca de tiempo .
- Solicitud de extracción : una solicitud de extracción informa a otros sobre las mejoras que ha enviado a un repositorio de GitHub diferente, excepto al suyo. A menudo nos referimos a Pull Request como el corazón de la colaboración de GitHub.
- Problemas : los problemas de GitHub se utilizan para obtener comentarios de los usuarios, realizar un seguimiento de las ideas, las mejoras y enumerar los errores informados al repositorio.
- Contribución : las contribuciones de GitHub indican la cantidad de contribuciones que se han realizado a otros repositorios. Se puede hacer una contribución con la ayuda de una solicitud de extracción.
Para agregar la insignia de GitHub Stats a su repositorio, incruste el siguiente código de Markdown en su archivo README.md.
Asegúrese de cambiar el valor username = por el nombre de usuario de su GitHub. La insignia de estadísticas de GitHub también proporciona rangos como S + (1% superior), S (25% superior), A ++ (45% superior), A + (60% superior) y B + (todos) . Cuanto más altas sean tus estadísticas, mejor será tu clasificación.
2. Idiomas más utilizados
Como sugiere el nombre, la insignia Idiomas más utilizados muestra los idiomas más utilizados en GitHub. Es una métrica de GitHub de qué lenguajes como HTML, CSS, JavaScript, Python, Go y más tienen la mayor cantidad de código en GitHub. Los idiomas se enumeran en orden descendente.
Para agregar la insignia de Idiomas más usados a su repositorio, incruste el Markdown a continuación en su archivo README.md.
El único inconveniente de esta insignia es que no incluirá Markdown como el idioma más utilizado.
3. Insignia de contribuyentes
La insignia de contribuyentes muestra todas las operaciones, como adiciones , eliminaciones y confirmaciones que se han realizado en sus repositorios. Cuando fusiona una solicitud de extracción en su repositorio, la persona que creó la solicitud se agregará como colaborador. Es realmente un buen hábito dar crédito a los contribuyentes que han invertido su tiempo en proporcionar una actualización a su repositorio.
La insignia de contribuyentes se puede generar utilizando contributors-img, una aplicación web que genera una imagen para mostrar la lista de contribuyentes.
Generar la imagen del colaborador es bastante trivial. Navegue hasta el sitio web contributors-img y pegue el nombre de su repositorio junto con su nombre de usuario para generar la URL. Alternativamente, simplemente inserte el código de Markdown que se proporciona a continuación para obtener la imagen.
4. Generador de bromas al azar
El generador de bromas al azar generará una broma técnica en forma de preguntas y respuestas. Por ejemplo, “ ¿Qué es un virus informático? La enfermedad terminal ”.
Para usar la insignia, debe incrustar el código Markdown en su archivo README.md como se muestra a continuación.
## Here is a random joke that'll make you laugh!
5. Contador de visualización del perfil
La insignia Contador de visualización de perfil muestra la cantidad de veces que se ha visto su perfil de GitHub en su perfil. Para generar esta insignia, inserte el siguiente código de Markdown:
Para generar el recuento de vistas de su repositorio, es posible que desee utilizar la insignia HITS ( Cómo los idiotas rastrean el éxito ). Es una forma sencilla de ver cuántas personas han visitado su repositorio de GitHub :
Pero la desventaja tanto del contador de vistas de perfil como de HITS es que no muestran el recuento de vistas con ID únicos. Cada vez que recarga el navegador / repositorio, los recuentos se incrementarán. Uno podría obtener fácilmente más vistas actualizando la página.
Implementación completa de las insignias de GitHub
He usado mi repositorio de GitHub como ejemplo. Para generar las insignias, se recomienda que agregue estos códigos a su archivo README.md designado. Si no tiene un archivo README.md en su repositorio de GitHub, la mejor opción es crear uno manualmente.
# 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
No es necesario ejecutar o ejecutar el fragmento de código de rebajas anterior en su archivo README.md. En el momento en que guarde el archivo con la extensión (.md), GitHub procesará automáticamente la salida y los cambios se reflejarán directamente en su repositorio.
Más insignias de GitHub disponibles
Ahora que sabe cómo agregar insignias de GitHub a su repositorio, es una excelente opción para los desarrolladores y las personas que pueden usar estas insignias para aumentar la legibilidad de sus repositorios. No es tan difícil, todo lo que necesita hacer es incrustar algunas líneas de código Markdown para generar las insignias.
Cuantas más insignias incluyas en tu repositorio, más atención recibirás. Una sola insignia tendrá la capacidad de proporcionar información útil en términos de estadísticas, estado y métricas.