---
title: Informacje na temat wysyłania łatek do przejrzenia
x-toc-enable: true
...

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](#jak-zgłaszać-łatki-przez-pull-requests) lub poprzez

Edytowanie strony i dokumentacji w stylu wiki
---------------------------------------------

Strona oraz dokumentacja zawarta jest w katalogu `www` [repozytorium Git](#jak-pobrać-transit-poprzez-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:

- index.sh: generuje kanał informacyjny (w sekcji „Nowości”)
- publish.sh: konwertuje pliki .md do formatu HTML
- Makefile: odwołując się do index.sh i publish.sh, kompiluje całą stronę Transit

Wykorzystaj dowolny edytor tekstu (np. Vim, Emacs, Nano, Gedit) do edycji plików,
zatwierdź zmiany i [wyślij łatkę](#jak-zgłaszać-łatki-przez-pull-requests)

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>.

- Dla dokumentacji wymagamy licencji GNU Free Documentation License w wersji 1.3 lub wyższej. Obejmuje to wszystkie strony na których wnosisz wkład lub które zmieniasz.
- GNU General Public License v3 jest zalecane, jeśli dokonujesz zmian w kodzie (np. pracując nad skryptami używanymi do kompilacji tej strony)

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ę](#jak-zgłaszać-łatki-przez-pull-requests).

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.
