| Zusammenfassung | Discourse GitHub ermöglicht es Mitarbeitern, Benutzern Abzeichen basierend auf GitHub-Beiträgen zuzuweisen. Außerdem können Benutzer GitHub-Linkbacks und Permalinks erstellen. | |
| Installationsanleitung | Dieses Plugin ist in der Discourse-Kernsoftware enthalten. Es ist keine separate Installation des Plugins erforderlich. |
Funktionen
GitHub-Abzeichen
Weisen Sie Benutzern Abzeichen basierend auf GitHub-Beiträgen zu.
So verwenden Sie es:
- Aktivieren Sie
GitHub-Abzeichen aktiviertin Einstellungen → Plugins. - Generieren Sie einen GitHub-Zugriffstoken und fügen Sie ihn in die Einstellung
GitHub-Linkback-Zugriffstokenein. Siehe unten für Anweisungen. - Fügen Sie eine oder mehrere URLs der GitHub-Repos hinzu, die nach Beiträgen durchsucht werden sollen, in der Site-Einstellung
GitHub-Abzeichen-Repos.
Wie die Abzeichenzählung funktioniert:
Abzeichen zählen Commits über alle Repositories hinweg, und wenn ein Benutzer zu mehreren Repos beiträgt, werden alle seine Commits zusammengezählt, um eine Gesamtzahl zu bilden.
Committierer-Abzeichen:
- Bronze: 1 Commit
- Silber: 25 Commits
- Gold: 1000 Commits
Abzeichenfortschritt: Wenn Benutzer über die verfolgten Repositories hinweg mehr Beiträge sammeln, steigen sie automatisch durch die Abzeigstufen. Zum Beispiel, wenn ein Benutzer zu Repo A und dann zu Repo B beiträgt, zählen beide Beiträge zu ihrer Gesamtzahl und ermöglichen es ihnen, von Bronze zu Silber zu Gold zu wechseln.
GitHub-Linkback
Erstellen Sie einen Link von einem GitHub-Pull-Request oder Commit zurück zu einem Discourse-Beitrag, in dem er erwähnt wird.
So verwenden Sie es:
- Aktivieren Sie
GitHub-Linkback aktiviertin Einstellungen → Plugins. - Generieren Sie einen GitHub-Zugriffstoken und fügen Sie ihn in die Einstellung
GitHub-Linkback-Zugriffstokenein. Siehe unten für Anweisungen. - Fügen Sie schließlich die Projekte hinzu, die Sie posten möchten, in der Site-Einstellung
GitHub-Linkback-Projekteim Format:benutzername/repositoryfür bestimmte Repositoriesbenutzername/*für alle Repositories eines bestimmten Benutzers
GitHub-Permalink
Ersetzen Sie GitHub-Nicht-Permalinks durch Permalinks.
So verwenden Sie es:
- Aktivieren Sie
GitHub-Permalinks aktiviertin Einstellungen → Plugins.
Konfiguration
GitHub-Zugriffstoken
Um die Linkback-Funktion zu ermöglichen und den Benutzern Abzeichen zu gewähren, benötigen Sie einen GitHub-Zugriffstoken. Sie können Ihren Token hier generieren: Sign in to GitHub · GitHub.
Die Linkback-Funktion erfordert den public_repo-Bereich, und für die Vergabe von Abzeichen ist kein Bereich erforderlich (lassen Sie alles deaktiviert, wenn Sie nur Abzeichen wollen). Da der public_repo-Bereich Schreibzugriff auf Repositories gewährt, empfehlen wir, ein einsatzfertiges GitHub-Konto zu erstellen, das keinen Zugriff auf Repositories hat, und es nur zum Generieren eines Tokens zu verwenden.
