Ten artykuł został napisany, aby pomóc początkującym programistom nauczyć się umiejętności potrzebnych do wniesienia wkładu w rozwój BlueSpice.
Dlaczego warto wnieść swój wkład?
Kiedy jesteś aktywnie zaangażowany w projekt, masz możliwość kształtowania jego przyszłości. Zmiany są powodowane przez działania. Z pewnością otrzymasz wielkie "dziękuję" i zostaniesz publicznie doceniony za swoją pracę. Co więcej, pomagasz wielu użytkownikom, którzy podziękują Ci po cichu lub głośno.
Przyłącz się
Jak w każdym innym projekcie, istnieje wiele możliwości uczestnictwa. Oto kilka przykładów tego, co możesz zrobić w projekcie BlueSpice.
Poprawa jakości kodu
- Doc blocs: Napisz z nami dokumentując bloki w kodzie źródłowym. Pomaga nam to w uzupełnianiu kodu i sprawdzaniu rozbieżności. Więcej o MediaWiki DocBlocks na wikimedia.
- Konwencje kodowania: Pomoc w egzekwowaniu konwencji kodowania. Używamy konwencji kodowania MediaWiki.
- Bezpieczeństwo: ma wysoki priorytet. Prosimy o pomoc w jego poprawie. Dlatego powinieneś zajrzeć do Bezpieczeństwo dla programistów.
Poprawki błędów
Szukaj mniejszych i większych błędów. A jeśli już zaprogramowałeś rozwiązanie, tym lepiej!
Tutaj znajdziesz pomoc dotyczącą debugowania w MediaWiki
Recenzja kodu
Pomóż nam w recenzowaniu kodu. Dlatego musisz być zaznajomiony z gerritem. Więcej informacji można znaleźć w sekcjach "Konfigurowanie środowiska programistycznego" i "Zatwierdzanie zmian".
Mały dodatek
Wiele z istniejących rozszerzeń chce być rozwijanych i zapewnia możliwości rozszerzenia funkcjonalności. Co mamy na myśli:
Dashboard Widgets, Statics, Sidebar, Widgety itp.
Własne rozszerzenia
Oczywiście można tworzyć własne rozszerzenia BlueSpice. Należy postępować zgodnie z przepływem pracy MediaWiki. Dobry samouczek można znaleźć na stronach MediaWiki, takich jak ta Rozwijanie rozszerzeń MediaWiki. Z tymi notatkami należy się również zapoznać przy tworzeniu BlueSpice. Należy utworzyć osobne repozytorium w gerrit o nazwie jak poniżej:
mediawiki/skins/BlueSpiceYourExtension
Tłumaczenia
Tłumaczenia są potrzebne cały czas. Prosimy o kontakt ze społecznością translatewiki.net.
Oto jak to działa
Wprowadzanie zmian
Istnieją dwie możliwości dostarczania poprawek.
1. Mail do Hallo Welt!
Wyślij e-mail z poprawką w formacie(git format-patch) na adres support@hallowelt.com. Zatwierdzimy zmianę w git, gdzie musi ona przejść przez standardowy proces.
2. Aktywne uczestnictwo poprzez Git
Postępujemy zgodnie z procedurą, która jest również powszechna w społeczności programistów MediaWiki:
- Załóż konto deweloperskie MediaWiki
- Zainstalować git-review
- sprawdzić kod BlueSpice
- Zatwierdź swoje zmiany
- Zmiany są weryfikowane w gerrit
- Gdy wszystko będzie w porządku, zmiany zostaną zaakceptowane.
Na MediaWiki.org można znaleźć krótki i rozszerzony samouczek.
Kod BlueSpice można znaleźć w tych repozytoriach:
mediawiki/extensions/BlueSpiceFoundation.git mediawiki/extensions/BlueSpiceExtensions.git mediawiki/skins/BlueSpiceSkin.git
i w ten sposób można się sprawdzić:
git clone ssh://USERNAME@gerrit.wikimedia.org:29418/mediawiki/extensions/BlueSpiceFoundation.git
W repozytoriach BlueSpice konieczne jest posiadanie uprawnień "+2" lub "Merge" przed samodzielnym zatwierdzeniem kodu do produktu. Zapytaj Markusa Glasera, jeśli uważasz, że potrzebujesz tego rodzaju dostępu (glaser@hallowelt.biz).
Jeśli chcesz pisać własne rozszerzenia dla BlueSpice, poproś o własne repozytorium tutaj. Prosimy o przestrzeganie konwencji nazewnictwa.
mediawiki/extensions/BlueSpiceMyWidget.git
Dyskusje