(język polski dla Joomla! 4.0 i nowszych)
👍🎉 Po pierwsze, dzięki za poświęcanie czasu, aby wnieść wkład! 🎉👍
Nasz Kodeks postępowania. Proszę przeczytać uważnie
Rozpoczęcie pracy z git i github. Jeśli nie masz git na swoim komputerze, zainstaluj go.
Jeśli nie czujesz się komfortowo z wierszem poleceń, tutaj są samouczki, jak korzystać z narzedzi GUI.
Sforkuj to repozytorium, wybierając na przycisk "Fork" na górze tej strony. Spowoduje to utworzenie kopii tego repozytorium na Twoim koncie.
Zwróć uwagę, na to, którą gałąź repozytorium kopiujesz. Najbardziej aktualne pliki językowe znajdują się zawsze w galęzi oznaczonej numerem najbliższej planowanej wersji Joomla, np. pakiet-4.0.3.
Teraz sklonuj rozwidlone repozytorium na swój komputer. Przejdź na swoje konto GitHub, otwórz rozwidlone repozytorium, kliknij przycisk klonowania, a następnie kliknij ikonę copy to clipboard (kopiuj do schowka).
Otwórz terminal i uruchom następujące polecenie git:
git clone "url, który właśnie skopiowałeś"
gdzie "url, który właśnie skopiowałeś" (bez cudzysłowu) jest adresem url do tego repozytorium (twojego forka tego projektu). Zobacz poprzednie kroki, aby uzyskać adres url.
Na przykład:
git clone https://github.com/to-twoje-konto/jezyk-J4.git
gdzie to-twoje-konto jest Twoją nazwą użytkownika na GitHubie. Tutaj skopiujesz zawartość repozytorium jezyk-J4 z GitHuba na swój komputer.
Przejdź do Issues i utwórz nowy problem lub wykorzystaj otwarty problem do napisania PR.
Zazwyczaj nie ma PR bez wcześniejszego zgłoszenia problemu. Mamy zasadę najpierw issue.
Przejdź do katalogu repozytorium na swoim komputerze (jeśli jeszcze tam nie jesteś):
cd jezyk-J4
Teraz utwórz gałąź, używając polecenia git checkout:
git checkout -b <tu-nazwa-twojej-nowej-gałęzi>
Na przykład:
git checkout -b <numer-problemu>
(Nazwa gałęzi nie musi mieć numeru problemu w nazwie, ale jest to łatwy sposób, aby odnieść się do konkretnego problemu).
Teraz otwórz wszystkie pliki w edytorze tekstowym lub w IDE np. PhpStorm i wprowadź zmiany. Następnie zapisz plik.
Jeśli wejdziesz do katalogu projektu i wykonasz polecenie git status, zobaczysz, że są zmiany.
Dodaj te zmiany do gałęzi, którą właśnie utworzyłeś używając polecenia git add:
git add .
Teraz zatwierdź te zmiany, używając komendy git commit:
git commit -m "np. łatka #<numer-problemu>"
zamień <numer-problemu> numerem problemu.
Pchnij swoje zmiany, używając polecenia
git push:
git push origin <tu-wpisz-swoja-nazwe>
zamień <tu-wpisz-swoja-nazwe> na nazwę gałęzi, którą utworzyłeś wcześniej.
Jeśli przejdziesz do swojego repozytorium na GitHubie, zobaczysz przycisk Compare & pull request (Porównaj i wyślij prośbę o rozpatrzenie). Kliknij na ten przycisk.
Teraz wyślij pull request (żądanie scalenia).
Zawsze będziemy się starać reagować na zgłoszenia lub scalać PR tak szybko, jak to możliwe. Otrzymasz wiadomość e-mail z powiadomieniem, gdy zmiany zostaną scalone.
Gratulacje! Właśnie ukończyłeś standardowy proes pracy fork -> clone -> edit -> PR, z którym często będziesz się spotykał jako współtwórca!