Informacje na temat wysyłania łatek do przejrzenia

Edytuj tę stronę -- Powróć do poprzedniej strony

EnglishpolskiPortuguês

Pobierz Transit z repozytorium Git w ten sposób:

git clone https://notabug.org/transit/transit-website.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 Transit 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 Transit.

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ć Transit poprzez Git

Wprowadź w terminalu polecenie:

git clone https://notabug.org/transit/transit-website.git

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

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

Załóż konto na https://notabug.org/ i (będąc zalogowan*) przejdź do strony https://notabug.org/transit/transit-website. Naciśnik Fork, co utworzy twoje własne repozytorium Transit 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/transit-transit-website/pulls i kliknij New Pull Request.

Możesz w tym miejscu zgłaszać swoje poprawki. Alternatywnie, możesz też zalogować się na kanał IRC Transit 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 Transit zostaną powiadomieni o nim e-mailem. Jeśli nie dostaniesz szybkie odpowiedzi, możesz też powiadomić członków projektu na kanale IRC ##transit w sieci Freenode.


Edytuj tę stronęLicencjaSzablon licencjiWkładZasady zachowania

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License Version 1.3 or any later version published by the Free Software Foundation with no Invariant Sections, no Front Cover Texts, and no Back Cover Texts. A copy of this license is found in /fdl-1.3.html

Aby uzyskać informacje odnośnie praw autorskich dla danej strony w danym okresie czasu, zajrzyj do repozytorium Git na którym strona jest hostowana i sprawdź historię zmian.