Zuletzt bearbeitet vor 10 Monaten
von Margit Link-Rodrigue

Wie werde ich ein BlueSpice Hacker?

Version vom 2. Februar 2024, 10:56 Uhr von Margit Link-Rodrigue (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)


Dieser Artikel soll Entwicklern helfen, die notwendigen Fähigkeiten zu erwerben, um zur BlueSpice-Entwicklung beitragen zu können.

Warum solltest Du mitmachen?
Wenn Du Dich aktiv im Projekt beteiligst, hast Du die Chance dieses mitzugestalten. Ganz nach dem Motto "Veränderungen entstehen vor allem durch "Machen"", kannst Du Dich also einbringen. Großer Dank ist Dir sowieso sicher, aber selbstverständlich wird auch Dein Name in Bezug auf Deine jeweilige Mitarbeit öffentlich genannt. Ganz abgesehen davon, dass Du nicht nur uns, sondern den vielen Nutzern da draußen hilfst, die Dir ein Stilles oder Lautes Danke zukommen lassen.

Mitmachen[Bearbeiten | Quelltext bearbeiten]

Wie in allen Projekten gibt es die unterschiedlichsten Arten, wie Du Dich beteiligen kannst. Hier einige Beispiele wie Du Teil des BlueSpice-Projektes werden kannst.

Verbesserung der Code Qualität[Bearbeiten | Quelltext bearbeiten]

  • Docblöcke: Schreibe mit uns Dokumentationsblöcke im Quellcode. Du hilfst damit den Code zu vervollständigen und Unstimmigkeiten aufzudecken. Mehr zu den MediaWiki DocBlocks bei wikimedia.
  • Coding conventions: Hilf mit die Coding Conventions durchzusetzen. Wir nutzen dazu die Coding Conventions von MediaWiki.
  • Sicherheit: Sicherheit wird bei uns groß geschrieben. Wenn Du möchtest kannst Du helfen, diese weiter zu verbessern. Dazu solltest Du dich an die Empfehlungen für die Sicherheit für Entwickler halten.

Bugfixes[Bearbeiten | Quelltext bearbeiten]

Du kannst Ausschau halten nach kleineren und größeren Bugs. Wenn Dir nicht nur ein Bug auffällt, sondern Du auch gleich die Lösung programmiert hat - umso besser!
Hier eine Hilfestellung zum Debugging in MediaWiki

Code Review[Bearbeiten | Quelltext bearbeiten]

Hilf uns Entwicklungen zu bewerten. Dazu musst Du Dich in gerrit auskennen. Mehr dazu findest Du unter dem Punkt "Entwicklungsumgebung aufsetzen" und "Änderungen einchecken".

Kleine Ergänzungen[Bearbeiten | Quelltext bearbeiten]

Viele der existierenden Extensions bieten sich an, um weiterentwickelt zu werden und erweiterte Funktionalitäten anzubieten. Ganz konkret haben wir dafür im Kopf:
Dashboard Widgets, Statistiken, Sidebar Widgets, etc.

Eigene Erweiterungen[Bearbeiten | Quelltext bearbeiten]

Du kannst natürlich auch eigene Erweiterungen für BlueSpice schreiben. Bitte halte dazu den MediaWiki Workflow ein. Auf den MediaWiki Seiten findest Du ausführliche Hinweise wie Du eine eigene MediaWiki Extension entwickelst und was Du dazu beachten solltest. Diese Hinweise gelten auch für BlueSpice. Bitte lege für eigene Erweiterungen in gerrit ein eigenes Verzeichnis an, das wie folgt benannt ist:

mediawiki/skins/BlueSpiceDeine Erweiterung

Übersetzungen[Bearbeiten | Quelltext bearbeiten]

Übersetzungen werden natürlich jederzeit gebraucht. Bitte wende Dich dazu an die Community von translatewiki.net. Einen Überblick findest Du auf unserer dortigen Projektseite.

Und so läuft das Ganze ab[Bearbeiten | Quelltext bearbeiten]

Änderungen einchecken[Bearbeiten | Quelltext bearbeiten]

Du hast zwei Möglichkeiten Deine Patches einzubringen.

1. E-Mail an Hallo Welt!

Sende eine E-Mail mit Deinem Patch (git format-patch) an support@hallowelt.com. Wir checken dann die Änderung für Dich im Git-System ein, wo es den üblichen Prozess durchläuft.

2. Aktiv Mitmachen über das Git

Wir folgen hier genau dem Prozedere, das auch für die Beteiligung an der MediaWiki-Entwicklung vorgesehen ist:

  • Entwickler-Account bei MediaWiki holen
  • Git-review installieren
  • Code von BlueSpice auschecken
  • Änderungen vornehmen und einchecken
  • Änderungen werden in Gerrit gegengeprüft
  • Sobald alles passt, werden die Änderungen übernommen

Auf MediaWiki.org findet sich dazu auch eine kurze und eine ausführliche Anleitung.

Der Code von BlueSpice befindet sich in den folgenden Repositories:

mediawiki/extensions/BlueSpiceFoundation.git
mediawiki/extensions/BlueSpiceExtensions.git
mediawiki/skins/BlueSpiceSkin.git

und kann so ausgecheckt werden:

git clone ssh://USERNAME@gerrit.wikimedia.org:29418/mediawiki/extensions/BlueSpiceFoundation.git 

In den Repositories von BlueSpice ist es notwendig, das "+2" oder "Merge"-Recht zu haben, bevor man den Code selbst in das Produkt einpflegen kann. Um dieses zu bekommen, wendet euch an glaser@hallowelt.biz.

Wenn ihr eine eigene BlueSpice-Erweiterung schreiben wollt, lasst euch hier ein eigenes Repository geben. Am besten folgt ihr der Namenskonvention

mediawiki/extensions/BlueSpiceMeinWidget.git

See also[Bearbeiten | Quelltext bearbeiten]



Feedback zur Dokumentation ist im Community-Forum möglich.