Las insignias de GitHub pueden aumentar 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).
Relacionado: Cómo crear un repositorio de GitHub
¿Quiere compartir sus proyectos de desarrollo en línea? A continuación, le mostramos cómo comenzar con su primer repositorio de Github.
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 completamente el aspecto de su repositorio.
Siempre tenga esto en cuenta: una insignia vale 1000 líneas de código.
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 los repositorios de GitHub (como los 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.
- Compromete: 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.
- Cuestiones: 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.
! [Estadísticas de su repositorio] ( https://github-readme-stats.vercel.app/api? username = Your_GitHub_Username & show_icons = true)Asegúrate de cambiar el nombre de usuario = value al nombre de usuario de tu GitHub. La insignia de estadísticas de GitHub también proporciona rangos, así 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.
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.
Relacionado: ¿Qué lenguaje de programación debería aprender?
Para agregar la insignia de Idiomas más usados a su repositorio, incruste el Markdown a continuación en su archivo README.md.
! [Estadísticas de su repositorio] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)El único inconveniente de esta insignia es que no incluirá Markdown como el idioma más utilizado.
La insignia de colaboradores muestra todas las operaciones, como adiciones, eliminaciones, y comete 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 usando contributors-img, una aplicación web que genera una imagen para mostrar la lista de contribuyentes.
Generar la imagen del colaborador es bastante trivial. Vaya al sitio web contributors-img y pegue el nombre de tu repositorio junto con tu 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.
! [Imagen de los colaboradores de GitHub] ( https://contrib.rocks/image? repo = Your_GitHub_Username / Your_GitHub_Repository_Name)El generador de bromas al azar generará una broma técnica en forma de preguntas y respuestas. Por ejemplo, "¿Qué es un virus de computadora? La enfermedad terminal”.
Para usar la insignia, debe incrustar el código de Markdown en su archivo README.md como se muestra a continuación.
## 😂 ¡Aquí hay una broma al azar que te hará reír!
! [Tarjeta de chistes] ( https://readme-jokes.vercel.app/api)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:
! [Contador de visualizaciones de perfil] ( https://komarev.com/ghpvc/?username=Your_GitHub_Username)Para generar el recuento de vistas de su repositorio, es posible que desee utilizar HITS (Cómo rastrean el éxito los idiotas) Insignia. Es una forma sencilla de ver cuántas personas han visitado su GitHub repositorio:
Pero la desventaja tanto del contador de visualizaciones de perfil como de HITS es que no muestran el recuento de visualizaciones 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.
# 5 insignias principales que llevarán su repositorio de GitHub al siguiente nivel
## 1. Estadísticas de GitHub
! [Estadísticas de su repositorio] ( https://github-readme-stats.vercel.app/api? username = Tanu-N-Prabhu & show_icons = true)
## 2. Idiomas más usados
! [Estadísticas de su repositorio] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green)
## 3. Insignia de colaboradores
! [Estadísticas de su repositorio] ( https://contrib.rocks/image? repo = Tanu-N-Prabhu / Python)
## 4. Generador de bromas al azar
! [Tarjeta de chistes] ( https://readme-jokes.vercel.app/api)
## 5. Contador de visualización de perfil
! [Contador de visualizaciones de perfil] ( https://komarev.com/ghpvc/?username=Tanu-N-Prabhu)
### Contador de vistas del repositorio - 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.
¿Quieres familiarizarte con el software en GitHub? A continuación, le mostramos cómo llegar al este con la herramienta GitHub Desktop optimizada.
- Programación
- Reducción
- GitHub
Suscríbete a nuestro boletín
¡Únase a nuestro boletín de noticias para obtener consejos técnicos, reseñas, libros electrónicos gratuitos y ofertas exclusivas!
Un paso más…!
Confirme su dirección de correo electrónico en el correo electrónico que le acabamos de enviar.
