--- title: Informacje na temat wysyłania łatek do przejrzenia x-toc-enable: true ... 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](#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ć-transchat-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ę TransChat 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 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: . - 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 TransChat. 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ć 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 i (będąc zalogowan\*) przejdź do strony . 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 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.