Discourse GitHub

[Discourse]

	Riepilogo	Discourse GitHub consente al personale di assegnare badge agli utenti in base ai contributi su GitHub. Inoltre, permette agli utenti di creare linkback e permalinks di GitHub
	Guida all’installazione	Questo plugin è incluso nel nucleo di Discourse. Non è necessario installare il plugin separatamente.

Poiché si tratta di un plugin #ufficiale mantenuto dal team di Discourse, #supporto, Bug, UX e #richiesta_di_funzionalità possono essere inviati nelle categorie appropriate qui su Meta, e contrassegnati con il tag appropriato del plugin. Clicca sui link qui sotto per iniziare.

\u003ckbd\u003e \u0026nbsp;Supporto \u003c/kbd\u003e \u003ckbd\u003e \u0026nbsp;Bug \u003c/kbd\u003e \u003ckbd\u003e \u0026nbsp;UX \u003c/kbd\u003e \u003ckbd\u003e \u0026nbsp;Funzionalità\u003c/kbd\u003e

Funzionalità

Badge di GitHub

Assegna badge ai tuoi utenti in base ai contributi su GitHub.

Come utilizzare:

1. Abilita github badges enabled nelle Impostazioni → Plugin.
2. Genera un token di accesso GitHub e incollalo nella impostazione github linkback access token. Vedi di seguito per le istruzioni.
3. Aggiungi uno o più URL dei repository GitHub da scansionare per i contributi nella impostazione del sito github badges repos.

Come funziona il conteggio dei badge:

I badge contano i commit su tutti i repository, e quando un utente contribuisce a più repository, tutti i suoi commit vengono sommati in un conteggio totale.

Badge del committente:

• Bronzo: 1 commit
• Argento: 25 commit
• Oro: 1000 commit

Progressione del badge: Man mano che gli utenti accumulano più contributi su uno qualsiasi dei repository monitorati, avanzano automaticamente attraverso i livelli di badge. Ad esempio, se un utente contribuisce al Repo A e poi al Repo B, entrambi i contributi vengono conteggiati nel totale, consentendogli di avanzare dal Bronzo all’Argento e all’Oro.

Linkback di GitHub

Crea un collegamento da una pull request o da un commit di GitHub a un post di Discourse in cui viene menzionato.

Come utilizzare:

1. Abilita github linkback enabled nelle Impostazioni → Plugin.
2. Genera un token di accesso GitHub e incollalo nella impostazione github linkback access token. Vedi di seguito per le istruzioni.
3. Infine, aggiungi i progetti a cui desideri inviare i post nella impostazione del sito github linkback projects nei formati:
   • username/repository per repository specifici
   • username/* per tutti i repository di un determinato utente

Permalink di GitHub

Sostituisci i link non permanenti di GitHub con permalinks.

Come utilizzare:

1. Abilita github permalinks enabled nelle Impostazioni → Plugin.

Configurazione

Token di accesso GitHub

Per far funzionare la funzione linkback e assegnare i badge agli utenti, è necessario fornire un token di accesso GitHub. Puoi generare il tuo token qui: Sign in to GitHub · GitHub.

La funzione linkback richiede lo scope public_repo, mentre l’assegnazione dei badge non richiede alcuno scope (lascia tutto deselezionato se vuoi solo i badge). Poiché lo scope public_repo concede accesso di scrittura ai repository, ti consigliamo di creare un account GitHub a uso unico che non abbia accesso a nessun repository e utilizzarlo solo per generare un token.

CRONACHIA

DA FARE

[ImmaZoni (Justin)]

Qual è il processo per più collegamenti? li aggiunge semplicemente allo stesso commento del commit? o crea un commento completamente nuovo ogni volta?

[satonotdead]

Mi chiedo se i badge di commit e PR potrebbero essere semplificati perché stiamo cercando di evitare Il paradosso della scelta :)\n\nAttualmente ho appena fatto il fork e cancellato i badge di commit ma ovviamente mi sono perso dal badge di commit (perché sto committando direttamente) e il fork non equivale a rimanere sempre con il core.

[xomiamoore (Mia)]

@Discourse

• username/repository per repository specifiche
• username/* per tutti i repository di un certo utente

Il carattere jolly * non ha funzionato per un’organizzazione GitHub, ho finito per inserire ogni repository individualmente. Qualcun altro ha avuto problemi con questo con un’organizzazione rispetto a un utente?

[greyli]

Come impostare la lingua del commento di linkback?

[cultiv (Sebastiaan Janssen)]

Grazie, mi piace molto questo plugin! Ero confuso riguardo al sistema dei badge e sono stato felice di trovare la spiegazione in un altro argomento: Github Badges are not working. Its hard to see if I do something wrong or if the plugin is not working - #4 by simon

Tuttavia, quella risposta osserva che

Il plugin crea 6 badge:

Non vedo nessuno di questi badge, non sono sicuro di cosa sia successo? C’è un modo per (ri)attivare la creazione di questi badge?

[cultiv (Sebastiaan Janssen)]

Per rispondere alla mia domanda, dopo qualche ora l’attività pianificata è stata eseguita e in quel momento sono stati creati i badge.

@cultiv

C’è un modo per (ri)attivare la creazione di questi badge?

Il modo manuale per farlo sarebbe attivare il job sidekiq, a quanto pare.

[tomtjes (Thomas Reintjes)]

Richiesta di funzionalità: escludere categorie e/o tag dai linkback

Abbiamo una categoria Annunci in cui il plugin RSS automaticamente recupera le nuove versioni di GitHub. Quando le note di rilascio collegano a problemi, anche quel link appare su Discourse e viene creato un linkback, ma uno che non è utile a nessuno, creando confusione su Github.

Vorrei poter escludere certi post, cioè categorie o tag o anche solo post dell’utente configurato nel plugin RSS, dal creare linkback.

[david (David Taylor)]

Questo plugin è ora incluso nel core di Discourse come parte di Bundling more popular plugins with Discourse core. Se stai auto-ospitando e utilizzi il plugin, devi rimuoverlo dal tuo app.yml prima del tuo prossimo aggiornamento.