Informacje na temat wysyłania łatek do przejrzenia



Return to index

Pobierz TransChat z repozytorium Git w ten sposób:

git clone https://notabug.org/transchat/trans.chat.git

Git jest systemem kontroli wersji, używanym przy hostingu tej strony, aby skoordynować jej rozwój. Możesz pobrać i pracować nad całą tą stroną używając Gita.

Oprogramowanie Git dostępne jest na systemy Windows, MacOS, GNU+Linux, BSD i inne. Zdecydowanie polecamy system GNU+Linux lub BSD, jednak Windows i MacOS również dobrze działa z Gitem. Podstawowe informacje dotyczące korzystania z Gita znajdziesz za pomocą wyszukiwarki internetowej.

Niektóre z tych instrukcji zakładają, że korzystasz z GNU+Linux lub BSD, więc musisz dostosowywać je do siebie, jeśli używasz czegoś innego. Systemem operacyjnym wykorzystywanym przez czołowych administratorów tej strony jest GNU+Linux.

Możesz zgłaszać swoje łatki za pośrednictwem pull requests na Notabug lub poprzez

Edytowanie strony i dokumentacji w stylu wiki

Strona oraz dokumentacja zawarta jest w katalogu www repozytorium Git w formacie Markdown w stylu Pandoc. Strona ta konwertowana jest do statycznego HTML poprzez Pandoc, za pomocą skryptów, również umieszczonych w tym katalogu:

Wykorzystaj dowolny edytor tekstu (np. Vim, Emacs, Nano, Gedit) do edycji plików, zatwierdź zmiany i wyślij łatkę

Opcjonalnie, możesz też zainstalować serwer WWW (np. lighttpd lub nginx) lokalnie i ustawić katalog www z lokalnego repozytorium Git jako katalog główny. Z taką konfiguracją, możesz generować lokalną wersję strony TransChat i przeglądać ją, wpisując localhost w pasek adresu przeglądarki.

Prywatność współautorów (nie musisz ujawniać swojego imienia ani tożsamości!)

Wkład, który wnosisz w naszą stronę jest publicznie rejestrowany w repozytorium Git, do którego każdy ma dostęp. Obejmuje to nazwę użytkownika oraz adres e-mail autora łatki.

Nie musisz używać nazwy użytkownika ani adresu e-mail odnoszącego się do twojej tożsamości. Możesz wpisać cokolwiek, jeśli chcesz zachować swoją prywatność.

Z prawnego punktu widzenia, wszystkie prawa autorskie automatycznie obejmują postanowienia konwencji berneńskiej. Nieważne jest pod jaką nazwą i czy w ogóle zadeklarujesz swoje prawa autorskie (wymagamy jednak publikowania treści pod jedną z licencji wymienionych na tej stronie później)

Generalne wytyczne dotyczące zgłaszania łatek

Wymagamy, aby wszystkie zgłaszane łatki dostępne były na wolnej licencji: https://www.gnu.org/licenses/license-list.pl.html.

Jeśli nie zgadzasz się na odpowiednie używanie jednej z tych licencji, twój wkład zostanie odrzucony.

Zawsze deklaruj licencję twojej pracy! Nie deklarując żadnej, sprawiasz, że obowiązywać będą restrykcyjne prawa autorskie, które uczynią twoją pracę niewolną.

GNU+Linux jest rekomendowany jako system operacyjny do pracy nad TransChat.

Generalne wytyczne przeglądu kodu

Każda dowolna osoba może zgłosić swoją łatkę.

Zostanie ona przejrzana dla oceny jakości i zespojona z resztą strony po akceptacji.

Jak pobrać TransChat poprzez Git

Wprowadź w terminalu polecenie:

git clone https://notabug.org/transchat/trans.chat.git

Utworzy to nowy katalog o nazwie transchat, zawierający pliki strony. transchat.

Jak złaszać łatki (przez pull requests)

Załóż konto na https://notabug.org/ i (będąc zalogowan*) przejdź do strony https://notabug.org/transchat/trans.chat. Naciśnik Fork, co utworzy twoje własne repozytorium TransChat na twoim koncie użytkownika. Sklonuj swoje repozytorium, zmień w nim co chcesz i wyślij to na swoje konto NotABug.

Teraz, przejdź do https://notabug.org/trans.chat/pulls i kliknij New Pull Request.

Możesz w tym miejscu zgłaszać swoje poprawki. Alternatywnie, możesz też zalogować się na kanał IRC TransChat i powiadomić o łatkach, które chcesz, aby zostały przejrzane, jeśli posiadasz własne repozytorium, które je zawiera.

Gdy zgłosisz już pull request, opiekunowie witryny TransChat zostaną powiadomieni o nim e-mailem. Jeśli nie dostaniesz szybkie odpowiedzi, możesz też powiadomić członków projektu na kanale IRC #transchat w sieci Libera.

Markdown file for this page: https://trans.chat/contrib.pl.md

Site map

This HTML page was generated by untitled static site generator.