 |
Resumen | Discourse GitHub permite al personal asignar insignias a los usuarios basadas en sus contribuciones a GitHub. También permite a los usuarios crear enlaces a GitHub y enlaces permanentes |
 |
Guía de instalación | Este plugin está incluido en el núcleo de Discourse. No es necesario instalar el plugin por separado. |
Características
Insignias de GitHub
Asigna insignias a tus usuarios basadas en sus contribuciones a GitHub.
Cómo usar:
- Habilita
github badges enableden Configuración → Plugins. - Genera un token de acceso de GitHub y pégalo en la configuración
github linkback access token. Consulta las instrucciones a continuación. - Añade una o más URLs de los repositorios de GitHub que deseas escanear para las contribuciones en la configuración del sitio
github badges repos.
Cómo funciona el conteo de insignias:
Las insignias cuentan los commits en todos los repositorios, y cuando un usuario contribuye a múltiples repositorios, todos sus commits se suman en un recuento total.
Insignias de colaborador:
- Bronce: 1 commit
- Plata: 25 commits
- Oro: 1000 commits
Progresión de insignias: A medida que los usuarios acumulan más contribuciones en cualquiera de los repositorios rastreados, progresan automáticamente a través de los niveles de insignias. Por ejemplo, si un usuario contribuye en el Repositorio A y luego en el Repositorio B, ambas contribuciones se suman a su total, permitiéndole progresar de Bronce a Plata y luego a Oro.
Enlace de retorno de GitHub
Crea un enlace desde una solicitud de extracción (pull request) o un commit de GitHub hacia una publicación de Discourse donde se menciona.
Cómo usar:
- Habilita
github linkback enableden Configuración → Plugins. - Genera un token de acceso de GitHub y pégalo en la configuración
github linkback access token. Consulta las instrucciones a continuación. - Finalmente, añade los proyectos a los que deseas publicar en la configuración del sitio
github linkback projectsen los formatos:nombre_usuario/repositoriopara repositorios específicosnombre_usuario/*para todos los repositorios de un usuario determinado
Enlace permanente de GitHub
Reemplaza los enlaces no permanentes de GitHub por enlaces permanentes.
Cómo usar:
- Habilita
github permalinks enableden Configuración → Plugins.
Configuración
Token de acceso de GitHub
Para que la función de enlace de retorno funcione y las insignias se otorguen a tus usuarios, necesitas proporcionar un token de acceso de GitHub. Puedes generar tu token aquí: Sign in to GitHub · GitHub.
La función de enlace de retorno requiere el alcance public_repo, y otorgar insignias no requiere ningún alcance (deja todo desmarcado si solo deseas insignias). Dado que el alcance public_repo otorga acceso de escritura a los repositorios, recomendamos que crees una cuenta de GitHub de desecho que no tenga acceso a ningún repositorio y úsala solo para generar un token.