| Resumo | Discourse GitHub permite que a equipe atribua distintivos aos usuários com base em contribuições no GitHub. Também permite que os usuários criem linkbacks do GitHub e perma-links. | |
| Guia de Instalação | Este plugin está incluso no núcleo do Discourse. Não há necessidade de instalar o plugin separadamente. |
Recursos
Distintivos do GitHub
Atribua distintivos aos seus usuários com base em contribuições no GitHub.
Como usar:
- Ative
github badges enablednas Configurações -\u0026gt; Plugins. - Gere um token de acesso do GitHub e cole-o na configuração
github linkback access token. Veja abaixo para instruções. - Adicione uma ou mais URLs dos repositórios do GitHub para escanear contribuições na configuração do site
github badges repos.
Como o contagem de distintivos funciona:
Os distintivos contam commits em todos os repositórios, e quando um usuário contribui em vários repositórios, todos os seus commits são somados em uma contagem total.
Distintivos de Contribuidor:
- Bronze: 1 commit
- Prata: 25 commits
- Ouro: 1000 commits
Progressão de Distintivos: À medida que os usuários acumulam mais contribuições em qualquer um dos repositórios monitorados, eles avançam automaticamente por níveis de distintivos. Por exemplo, se um usuário contribui no Repo A e depois no Repo B, ambas as contribuições contam para seu total, permitindo que ele progrida do Bronze para a Prata e depois para o Ouro.
Linkback do GitHub
Crie um link de uma solicitação de pull ou commit do GitHub de volta a uma postagem do Discourse onde ele é mencionado.
Como usar:
- Ative
github linkback enablednas Configurações -\u0026gt; Plugins. - Gere um token de acesso do GitHub e cole-o na configuração
github linkback access token. Veja abaixo para instruções. - Finalmente, adicione os projetos que deseja postar na configuração do site
github linkback projectsnos formatos:username/repositorypara repositórios específicosusername/*para todos os repositórios de um determinado usuário
Permalink do GitHub
Substitua links não-permanentes do GitHub por permalinks.
Como usar:
- Ative
github permalinks enablednas Configurações -\u0026gt; Plugins.
Configuração
Token de Acesso do GitHub
Para que o recurso de linkback funcione e os distintivos sejam concedidos aos seus usuários, você precisa fornecer um token de acesso do GitHub. Você pode gerar seu token aqui: Sign in to GitHub · GitHub.
O recurso de linkback requer o escopo public_repo, e conceder distintivos não requer nenhum escopo (deixe tudo desmarcado se você quiser apenas distintivos). Como o escopo public_repo concede acesso de escrita aos repositórios, recomendamos que você crie uma conta de GitHub descartável que não tenha acesso a nenhum repositório e use-a apenas para gerar um token.
