diff options
author | Sebastien Helleu <flashcode@flashtux.org> | 2009-09-05 21:49:28 +0200 |
---|---|---|
committer | Sebastien Helleu <flashcode@flashtux.org> | 2009-09-05 21:49:28 +0200 |
commit | 0ef168d29d1c7a0b39d1f0b05a68090fd7fa80e9 (patch) | |
tree | 8ed38f7638eb5d32822f5fb92cceaad2ec796dcf /doc/pl | |
parent | babf5a8c9b81eede2f9e91bf13a7f183611941c9 (diff) | |
download | weechat-0ef168d29d1c7a0b39d1f0b05a68090fd7fa80e9.zip |
Add polish FAQ and tester's guide, update polish quickstart
Diffstat (limited to 'doc/pl')
-rw-r--r-- | doc/pl/CMakeLists.txt | 22 | ||||
-rw-r--r-- | doc/pl/Makefile.am | 16 | ||||
-rw-r--r-- | doc/pl/weechat_faq.pl.txt | 332 | ||||
-rw-r--r-- | doc/pl/weechat_quickstart.pl.txt | 18 | ||||
-rw-r--r-- | doc/pl/weechat_tester.pl.txt | 142 |
5 files changed, 519 insertions, 11 deletions
diff --git a/doc/pl/CMakeLists.txt b/doc/pl/CMakeLists.txt index b4929dbdf..14cdca2d2 100644 --- a/doc/pl/CMakeLists.txt +++ b/doc/pl/CMakeLists.txt @@ -14,6 +14,17 @@ # along with this program. If not, see <http://www.gnu.org/licenses/>. # +# FAQ +ADD_CUSTOM_COMMAND( + OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.pl.html + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.pl.txt + DEPENDS + ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.pl.txt + COMMENT "Building weechat_faq.pl.html" +) +ADD_CUSTOM_TARGET(doc-faq-pl ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.pl.html) +INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.pl.html DESTINATION share/doc/${PROJECT_NAME}) + # quickstart ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.pl.html @@ -24,3 +35,14 @@ ADD_CUSTOM_COMMAND( ) ADD_CUSTOM_TARGET(doc-quickstart-pl ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.pl.html) INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.pl.html DESTINATION share/doc/${PROJECT_NAME}) + +# tester's guide +ADD_CUSTOM_COMMAND( + OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.pl.txt + DEPENDS + ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.pl.txt + COMMENT "Building weechat_tester.pl.html" +) +ADD_CUSTOM_TARGET(doc-tester-pl ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html) +INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html DESTINATION share/doc/${PROJECT_NAME}) diff --git a/doc/pl/Makefile.am b/doc/pl/Makefile.am index 02ebb671a..ef4d296b9 100644 --- a/doc/pl/Makefile.am +++ b/doc/pl/Makefile.am @@ -17,14 +17,26 @@ docdir = $(datadir)/doc/$(PACKAGE) EXTRA_DIST = CMakeLists.txt \ - weechat_quickstart.pl.txt + weechat_faq.pl.txt \ + weechat_quickstart.pl.txt \ + weechat_tester.pl.txt -all-local: weechat_quickstart.pl.html +all-local: weechat_faq.pl.html \ + weechat_quickstart.pl.html \ + weechat_tester.pl.html + +# FAQ +weechat_faq.pl.html: weechat_faq.pl.txt + $(ASCIIDOC) -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_faq.pl.html weechat_faq.pl.txt # quickstart weechat_quickstart.pl.html: weechat_quickstart.pl.txt $(ASCIIDOC) -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.pl.html weechat_quickstart.pl.txt +# tester's guide +weechat_tester.pl.html: weechat_tester.pl.txt + $(ASCIIDOC) -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_tester.pl.html weechat_tester.pl.txt + # install docs install-data-hook: diff --git a/doc/pl/weechat_faq.pl.txt b/doc/pl/weechat_faq.pl.txt new file mode 100644 index 000000000..78d662761 --- /dev/null +++ b/doc/pl/weechat_faq.pl.txt @@ -0,0 +1,332 @@ +WeeChat FAQ (Często zadawane pytania) +===================================== +FlashCode <flashcode@flashtux.org> + + +Ogólne +------ + + +[[why_choose_weechat]] +Dlaczego wybrać WeeChat? X-Chat i Irssi są takie dobre... +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Ponieważ WeeChat jest lekki i posiada wiele nowych możliwości. +Niektóre cechy (wersja > = 0.3.x): + +* wsparcie dla wielu protokołów dzięki wtyczką (IRC, Jabber) +* wiele zdalnych GUI w dodatku do Courses (już niedługo) +* dostępny w wielu językach +* rozszerzalny dzięki wtyczką (C, Perl, Python, Ruby, Lua, Tcl) +* bufory z wolną zawartością +* filtrowanie po tagach i wyrażeniach regularnych +* poziome i pionowe dzielenie okien +* paski które możemy tworzyć i dostosowywać do własnych potrzeb +* lista nicków dostępna w każdym GUI +* przyrostowe wyszukiwanie tekstu w buforach, przeskakiwanie do podświetleń +* strumień FIFO do zdalnej kontroli +* wsparcie dla aspell +* podwójny zestaw znaków (kodowanie/dekodowanie) +* tworzony od podstaw (nie bazuje na żadnym innym kliencie) +* wielo platformowy +* 100% GPL i wolny + +Więcej informacji na stronie: http://www.weechat.org/features + + +Kompilacja / instalacja +----------------------- + + +[[gui]] +Słyszałem o wielu GUI dla WeeChat. Jak moge je skompilować/użyć? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Obecnie dostępne jest tylko GUI Courses. + +Pozostałe będą dostępne jeko zdalne klienty (obecnie rozwijane). + + +[[compile_git]] +Nie mogę skompilować WeeChat po sklonowaniu repozytorium git, dlaczego? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Zalecaną metodą kompilacji WeeChat jest użycie cmake. + +Jeśli kompilujesz używając autotools (nie cmake), upewnij się, że posiadasz +najnowszą wersję autoconf i automake (WeeChat jest rozwijany z użyciem autoconf 2.61 +oraz automake 1.10.1). + +Innym sposobem jest zainstalowanie "paczki deweloperskiej", która wymaga mniej +zależności. Ten pakiet jest budowany prawie codziennie z użyciem repozytorium +git. Ten pakiet może odpowiadać dokładnie wersji z gita i jest mniej wygodny +przy aktualizowaniu jak klonowanie z gita. + + +Używanie WeeChat +---------------- + + +[[lost]] +Uruchomiłem WeeChat, ale czuję się zagubiony, co robić? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Dla pomocy wpisz `/help`. Aby uzyskać pomoc dla komendy wpisz `/help komenda`. +Klawisze i komendy są wypisane w dokumentacji. + +Nowym użytkowniką zaleca się przeczytanie quickstart (szybki start) +(zobacz stronę z dokumentacją na stronie www). + + +[[buffer_vs_window]] +Słyszałem o "buforach" i "oknach", jaka jest między nimi różnica? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +'bufor' jest określany przez numer, nazwę, wyświetlane linie (i trochę innych +danych). + +'okno' jest to obszar ekranu wyświetlający bufor. Możliwe jest podzielenie +ekranu na wiele okien. + +Każde okno wyświetla jeden bufor. Bufor może być ukryty (nie wyświetlany przez +okno) lub wyświetlany w jednym lub więcej oknach. + + +[[charset]] +Nie widzę niektórych znaków diakrytycznych, co mogę zrobić? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Jest to częsty problem, przeczytaj i sprawdź *WSZYSTKIE* poniższe rozwiązania. + +Dla wersji < 0.2.3, zaleca się uaktualnienie do najnowszej stabilnej wersji. + +Dla wersji > = 0.2.3: + +* sprawdź czy weechat-curses jest zlinkowany z libncursesw (uwaga: wymagane na + więkrzości dystrybucji ale nie wszystkich): `ldd /path/to/weechat-curses` +* sprawdź czy wtyczka "Charset" jest załadowana za pomocą komendy `/plugin` + (jeśli nie jest, to najprawdopodbniej potrzebujesz pakietu "weechat-plugins") +* sprawdź ustawienia kodowania (w buforze serwera). Powinieneś ujrzeć 'ISO-XXXXXX' + lub 'UTF-8' dla kodowania terminala. Jeśli zobaczysz 'ANSI_X3.4-1968' lub inna + wartość to twoje locale są prawdopodobnie złe. +* ustaw globalną wartość dekodowania, na przykład: +** w WeeChat < = 0.2.6: `/setp charset.global.decode = ISO-8859-2` +** w WeeChat > = 0.3.x: `/set charset.default.decode "ISO-8859-2"` +* jeślu kożystasz z UTF-8: +** sprawdź czy twój terminal jest przystosowany dla UTF-8 (zalecanym terminalem + dla UTF-8 jest rxvt-unicode) +** jeśli kożystasz ze screena, sprawdź czy jest uruchomiony z trybem UTF-8 + ("`defutf8 on`" w ~/.screenrc lub `screen -U` uruchamiając screena) + +[NOTE] +UTF-8 jest zalecany dla WeeChat. Jeśli kożystasz z locali ISO lub innych, +sprawdź czy *wszystkie* twoje ustawienia (terminal, screen, ..) są ISO, +a *nie* UTF-8. + + +[[bars_background]] +Paski jak tytuł i status nie są filtrowane, kolor tła zatrzymuje się po tekście, czemu? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Może to być spowodowane złą wartośćią zmiennej środowiskowej TERM (spójrz na +wynik `echo $TERM` w terminalu). + +W zależności, gdzie uruchamiasz WeeChat, powinieneś uzyskać: + +* jeśli WeeChat jest uruchomiony lokalnie lub na zdalnej maszynie bez screena, + zależy od używanego terminala: 'xterm', 'rxvt', .. +* jeśli WeeChat działa pod screenem, powinieneś mieć 'screen'. + +W razie potrzeby, popraw zmienna TERM: `export TERM="xxx"`. + + +[[screen_weird_chars]] +Kiedy używam weechat pod screenem, dostaje dziwne losowe znaki, jak to naprawić? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Może to być spowodowane przez złą wartość zmiennej środowiskowej TERM (spójrz na +wynik `echo $TERM` w terminalu). + +Na przykład, 'xterm-color' może wyświetlać takie dziwne znaki, możesz użyc 'xterm', +który działa dobrze (jak wiele innych wartości). + +W razie potrzeby, popraw zmienna TERM: `export TERM="xxx"`. + + +[[key_bindings]] +Jak mogę zmienić przypisania klawiszy? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Przypisania klawiszy mozna dostosować za pomocą komendy /key. + +Domyślnie Meta-k (zazwyczaj Alt-k) pozwala pobrać kod klawiszy i umieścić +go w wierszu poleceń. + + +[[openbsd_plugins]] +Używam OpenBSD, WeeChat nie ładuje żadnych pluginów, co jest nie tak? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Pod OpenBSD, nazwy wtyczek kończą się ".so.0.0" (".so" dla Linuksa). + +Musisz ustawić: + +* dla WeeChat < = 0.2.6: + + `/set plugins_extension = ".so.0.0"` +* dla WeeChat > = 0.3.x: + + `/set weechat.plugin.extension ".so.0.0"` + +Następnie: `/plugin autoload`. + + +[[scripts]] +Jak załadować skrypty Perl/Python/Ruby/Lua/Tcl? Czy skrypty są kompatybilne z innymi klientami IRC? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Możesz użyć komend `/perl`, `/python`, `/ruby`, `/lua` oraz `/tcl`, aby załadować +skrypt (domyślna lokalizacja skryptów to '~/.weechat/<język>/'). + +Skrypty nie są kompatybilne z innymi klientami IRC. + +Uwagi: + +* skrypty w '~/.weechat/<język>/autoload/' są automatycznie ładowane przy + uruchomieniu WeeChat. +* wtyczka 'tcl' jest dostępna dla wersji > = 0.3.x. + + +[[change_locale_without_quit]] +Chcę zmienić język komunikatów wyświetlanych przez WeeChat, ale bez jego zamykania, czy jest to możliwe? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Tak,musisz użyć pythonowego skryptu shell.py (dostępny na stronie programu), +oraz użyć tych komend po załadowaniu skryptu: + + /shell setenv LANG=pl_PL.UTF-8 + /upgrade + +Aby otrzymać polskie komunikaty dla kodowania UTF-8 w terminalu, osóby +używające ISO, moga wykonać: `/shell setenv LANG=pl_PL`. + + +[[terminal_copy_paste]] +Jak mogę kopiować/wklejać tekst bez wklejania listy nicków w interfejsie Courses? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Możesz użyć terminala z prostokątnym zaznaczaniem (jak rxvt-unicode, +konsole, gnome-terminal, ...). Klawisze to zazwyczaj ctrl + alt + zaznaczenie myszką. + +Innym rozwiązaniem jest przesunięcie listy nicków na górę lub dół, na przykład: + +* dla WeeChat < = 0.2.6: + + `set look_nicklist_position = top` +* dla WeeChat > = 0.3.x: + + `/bar set nicklist position top` + + +[[highlight_notification]] +Jak mogę zostać powiadomiony, jeśli ktoś będzię chciał przyciągnąć moją uwagę na kanale? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +W zależnośći od wersji WeeChat: + +* dla WeeChat < = 0.2.6: użyj skryptu 'sound.pl' (dostępny na stronie ze + skryptami), następnie ustawienie komendy systemowej (do odtworzenia dźwięku, + wyświetlenia wiadomości, ..) za pomocą komendy: + + `/setp perl.sound.cmd_highlight = "/ścieżka/do/komendy argumenty"` +* dla WeeChat > = 0.3.x: użyj skryptu 'launcher.pl' (dostępny na stronie ze + skryptami), następnie ustawienie komendy systemowej (do odtworzenia dźwięku, + wyświetlenia wiadomości, ..) za pomocą komendy: + + `/set plugins.var.perl.launcher.signal.weechat_highlight "/ścieżka/do/komendy argumenty"` + +Istnieje wiele innych skryptów do powiadomień, zajrzyj na stronę wtyczek/skryptów: +http://www.weechat.org/plugins + + +[[filter_irc_join_part_quit]] +Jak moge filtrować wiadomości o wejściu/opuszczeniu/wyjściu na kanałach IRC? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +W zależności od wersji WeeChat: + +* dla WeeChat < = 0.2.6: + + `/ignore * join #weechat freenode` + + `/ignore * part #weechat freenode` + + `/ignore * quit #weechat freenode` + + (kanał i/lib serwer mogą być "*", `/help ignore` dla pomocy) + +* dla WeeChat > = 0.3.x: + +** inteligentny filtr (pokazuje te informacje tylko od osób ostatnio aktywnych): + + `/set irc.look.smart_filter on` + + `/filter add irc_smart * irc_smart_filter *` + + (`/help irc.look.smart_filter` oraz `/help filter` dla pomocy) + +** globalny filtr (ukrywa *wszystkie* wejścia/opuszczenia/wyjścia): + + `/filter add jpk * irc_join,irc_part,irc_quit *` + + (`/help filter` dla pomocy) + + +[[ignore_vs_filter]] +Jaka jest różnica między komendami/ignore i /filter ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Komenda `/ignore` jest komendą IRC, zatem odnosi się tylko do buforów IRC +(serwery i kanały). +Pozwala ignorować niektóre nicki lub hosty użytkowników serwera lub kanału +(komendy nie stotuje się do treści wiadomości). +Pasujące wiadomości są usuwane przez wtyczkę IRC przed wyświetleniem (nigdy +ich nie zobaczysz). + +Komenda `/filter` jest komenda rdzenia, zatem odnosi się do dowolnego bufora. +Pozwala filtrować niektóre linie w buforach za pomocą tagów lub wyrażeń +regularnych dla przedrostków i zawartości lini. +Filtrowane linie są tylko ukrywane, nie usuwane, można je zobaczyć wyłączając +filtry (domyślnie alt + "=" zmienia stan filtrów). + + +Rozwój +------ + + +[[bug_task_patch]] +Jak zgłaszać błędy, prosić o nowe możliwości lub wysyłać patche? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Są 3 możliwości: + +. możesz dołączyć do nas na IRC: 'irc.freenode.net', kanał '#weechat' +. możesz użyć strony www savannah: + * zgłosić błąd: https://savannah.nongnu.org/bugs/?group=weechat + * poprosić o nową możliwość: https://savannah.nongnu.org/task/?group=weechat + * wysłać patch: https://savannah.nongnu.org/patch/?group=weechat +. możesz napisać do deweloperów, na stronie wsparcia możesz znaleźć ich maile: + http://www.weechat.org/about + (możesz się zapisać na listę mailingową "support" i na niej pisać) + + +[[supported_os]] +Jaka jest lista platform wspieranych przez WeeChat? Czy będzie przeportowany na inne systemy operacyjne? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Pełną listę można znaleźć na stronie: http://www.weechat.org/download + +Robimy co w naszej mocy, aby WeeChat działał na tylu platformach ile to tylko +możliwe. Mile widziana jest pomoc w testowaniu dla systemów, których nie mamy. + + +[[help_developers]] +Chcę pomóc programistą WeeChat. Co mogę zrobić? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Jest wiele zadań do zrobienia (testowanie, kod, dokumentacja, ...) + +Skontaktuj się z nami na IRC lub mailowo, szczegóły: +http://www.weechat.org/about + +[[donate]] +Czy mogę dac pieniądze albo inne rzeczy deweloperą WeeChat? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Tak możesz dać nam pieniądze, aby wspomóc rozwój. +Szczegóły na http://www.weechat.org/donate diff --git a/doc/pl/weechat_quickstart.pl.txt b/doc/pl/weechat_quickstart.pl.txt index b43d76247..b1d18b8ef 100644 --- a/doc/pl/weechat_quickstart.pl.txt +++ b/doc/pl/weechat_quickstart.pl.txt @@ -8,7 +8,7 @@ Uruchamianie WeeChat -------------------- Zalecanym emulatorem terminala dla X (ale nieobowiązkowym) jest rxvt-unicode -(posiada dobre wsparcie UTF-8, oraz nie ma problemów z domyślnymi sktótami +(posiada dobre wsparcie UTF-8, oraz nie ma problemów z domyślnymi skrótami klawiszowymi). Wywołaj "weechat-curses" z terminala. @@ -44,10 +44,10 @@ Na przykład: Możesz wyświetlić pomoc dla opcji dzięki `/help`, na przykład: `/help weechat.look.highlight`. -Wszystkie ustawienia są zapisywane podczas yjścia z WeeChat (lub za pomocą +Wszystkie ustawienia są zapisywane podczas wyjścia z WeeChat (lub za pomocą komendy `/save`, która wymusza zapisanie opcji). -Możesz edytować ręcznie pliko konfiguracyjne (*.conf) i przeładować je za pomocą +Możesz edytować ręcznie pliki konfiguracyjne (*.conf) i przeładować je za pomocą komendy `/reload`, jeśli nie chcesz użyć komendy `/set`. @@ -62,7 +62,7 @@ bezużyteczny (wierni użytkownicy: IRC był częścią rdzenia dla wersji < = 0 Wszystkie protokoły sieciowe jak IRC są dostarczane w oddzielnych pluginach. Użyj komendy `/plugin` do wyświetlenia załadowanych wtyczek, powinieneś zobaczyć -na liście "irc"oraz inne wtyczki. +na liście "irc" oraz inne wtyczki. [[create_irc_server]] @@ -187,7 +187,7 @@ Skróty klawiszowe WeeChat używa domyślnie wiele klawiszy. Wszystie z nich są w dokumentacji, ale powinieneś znać przynajmniej kilka najprzydatniejszych: -- 'alt + sytzałki lewo/prawo' (lub 'F5'/'F6'): przełącza na poprzedni/następny bufor +- 'alt + strzałki lewo/prawo' (lub 'F5'/'F6'): przełącza na poprzedni/następny bufor - 'F7'/'F8': przełącza na poprzednie/następne okno (jeśli ekran jest podzielony) - 'F9'/'F10': przewija pasek z tematem kanału - 'F11'/'F12': przewija listę z nickami @@ -195,7 +195,7 @@ ale powinieneś znać przynajmniej kilka najprzydatniejszych: - 'page up/down': przewija tekst w obecnym buforze - 'alt + A': skocz do bufora z aktywnością (w hotliście) -Zgodnie z Twoja klawiaturą i/lub potrzebami, możesz zmienić przypisanie +Zgodnie z Twoją klawiaturą i/lub potrzebami, możesz zmienić przypisanie dowolnego klawisza do komendy używajac komendy `/key`. Przydatnym skrótem jest meta-k (alt-k) do odnajdywania kodów klawiszy. @@ -203,7 +203,7 @@ Na przykład, aby przypisać meta-y (alt-y) do komendy `/buffer close`: /key bind (wciśnij meta-k) (wciśnij meta-y) /buffer close -Otrzymasz w lini komend: +Otrzymasz w lini poleceń: /key bind meta-y /buffer close @@ -216,7 +216,7 @@ Aby usunąć klawisz: Wtyczki/skrypty --------------- -W niektórych dystrybucjach jak Debian, wtyczki są dostarczane jako oddzielne +W niektórych dystrybucjach, jak np Debian, wtyczki są dostarczane jako oddzielne pakiety (jak weechat-plugins). Wtyczki są automatycznie ładowane, kiedy zostaną wykryte (proszę spojrzeć do dokumentacji WeeChat, aby się dowiedzieć jak ładowac/wyładowywać wtyczki lub @@ -224,7 +224,7 @@ skrypty). Niektóre pluginy pozwalają na używanie skryptów w WeeChat (w wielu językach jak Perl, Python, Ruby, Lua oraz Tcl). Te wtyczki muszą być załadowane za pomoca komendy -`/plugin` dostarczają one komendy jak `/perl`, używane do ładowania skryptów. +`/plugin`, dostarczają one komendy jak `/perl`, używane do ładowania skryptów. Wiele zewnętrznych wtyczek/skryptów (od społeczności) jest dostępnych dla WeeChat: http://www.weechat.org/plugins diff --git a/doc/pl/weechat_tester.pl.txt b/doc/pl/weechat_tester.pl.txt new file mode 100644 index 000000000..05a17abdf --- /dev/null +++ b/doc/pl/weechat_tester.pl.txt @@ -0,0 +1,142 @@ +Poradnik testera WeeChat +======================== +FlashCode <flashcode@flashtux.org> + + +[[purpose]] +Cel +--- + +Wielu wdzięcznych użytkowników pyta nas jak mogą pomóc w rozwoju WeeChat. +Najłatwiejszym (a zarazem najtrudniejszym) sposobem jest testowanie! + +Testowanie jest bardzo ważną częścią rozwoju oprogramowania i nie powinno być +niedoceniane. Kiedy nowe funkcje są implementowane, powinny zostać przetestowane, +ale dla wielu z nich jest za dużo możliwości użycia lub nie są łątwe do +zasymulowania dlatego programiści nie są wstanie sprawdzić ich wszystkich. + +Na przykład: Powszechnie znana wtyczka od kodowania została wprowadzona w +WeeChat 0.2.2: żaden z nas (programistów, współpracowników, testerów) nie +używał kanałów ze znakami narodowymi w nazwach, kiedy wersja 0.2.2 została +wypuszczona zostaliśmy zalani użytkownikami z Rosji obwiniającymi nas. +Gdy będziemy mieli więcej testrów taka sytuacja nie powinna się już zdarzyć +w przyszłości. + +Testowanie stabilenj wersji WeeChat jest bezcelowe, ponieważ programiści są +zajęci cały czas implementowaniem nowych rzeczy (oraz poprawianiem błędów). + + +[[prepare_system]] +Przygotuj swój system +--------------------- + +Bardzo nam pomoże, jeśli włączysz linuksowe pliki 'core': jeśli WeeChat zawiesi, +się Linuks zapisze plik zwany 'core'. Plik ten zawiera uzyteczne informacje +pozwalające dokładnie zlokalizować bład w WeeChat. + +Jeśli korzystasz z powłoki 'bash', dodaj następującą linijkę do `~/.bashrc`: + + ulimit -c unlimited + + +[[download]] +Pobieranie wersji rozwojowej +---------------------------- + +Świerzy kod (z najnowszymi błędami i funkcjami) przechowywany jest w repozytorium GIT. + +Możesz się zdecydować na własnoręczne zbudowanie (zalecana metoda): + +* wersja z GIT może być zbudowana i zainstalowana równolegle z wersją stabulną, +* nie potrzebujesz uprawnień administratora, oraz nie musisz poświęcać stabilnej + wersji WeeChat. + +[[get_sources]] +Pobierz i zbuduj źródła +~~~~~~~~~~~~~~~~~~~~~~~ + +Najpierw stwórz katalog, na przykład 'weechat-git': + +--------------------- +$ mkdir ~/weechat-git +$ cd ~/weechat-git +--------------------- + +Jeśli masz zainstalowanego gita, po prostu zklonuj repozytorium (zalecana +metoda): + +-------------------------------------------- +$ git clone git://git.sv.gnu.org/weechat.git +$ cd weechat +-------------------------------------------- + +UWAGA: Później możesz wykonać w tym katalogu "`git pull`", aby pobrać najnowsze +poprawki. + +Oczywiście możesz pobrać paczke oznaczoną jako 'devel': + +----------------------------------------------------------------- +$ wget http://www.weechat.org/files/src/weechat-devel.tar.bz2 +$ tar xvjf weechat-devel.tar.bz2 +$ cd weechat-devel +----------------------------------------------------------------- + +Do zbudowania źródeł zaleca się cmake: + +-------------------------------------------------------------- +$ mkdir build +$ cd build +$ cmake .. -DPREFIX=$HOME/weechat-git -DCMAKE_BUILD_TYPE=Debug +$ make +$ make install +-------------------------------------------------------------- + +Jeśli nie posiadasz cmake, nadal jest możliwe użycie autotools: + +---------------------------------------------------------- +$ ./autogen.sh # (only if you cloned git repository) +$ ./configure --prefix=$HOME/weechat-git +$ make +$ make install +---------------------------------------------------------- + +[[install_binary_package]] +Instalowanie pakietów binarnych +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +W zależności od dystrybucji Linuksa: + +* Debian: http://debian.flashtux.org/ +* Gentoo: http://www.weechat.org/download +* ArchLinux: PKGBUILD z http://aur.archlinux.org/ +* inne: nie mamy pojęcia! Eheh. + + +[[run]] +Uruchomienie WeeChat +-------------------- + +Zalca się uruchomianie WeeChat z innym katalogiem (różnym od wersji stabilnej), +za pomocą opcji `--dir`. + +Komenda to: + + ~/weechat-git/bin/weechat-curses --dir ~/.weechat-dev + +Jeśli nadal nie śpisz powinieneś ujrzeć znajomy interfejs i chwalić się +z posiadania najnowszej możliwej wersji WeeChat. ;) + +Teraz jeśli zaobserwujesz dziwne zachowanie (może sprawiać problemy, ulec awari +lub zagotować Twoje piwo) nie wachaj się wejść na kanał `#weechat` na serwerze +`irc.freenode.net` i nam o tym opowiedzieć. + +Jeśli wszystko będzie w porządku - też nam o tym powiedz, potrzebujemy Twojej opinii! + + +[[links]] +Przydatne linki +--------------- + +* Repozytorium GIT: http://git.savannah.gnu.org/gitweb/?p=weechat.git +* System śledzenia błędów: https://savannah.nongnu.org/bugs/?group=weechat +* Kanał RSS dokonywanych poprawek: http://git.savannah.gnu.org/gitweb/?p=weechat.git;a=rss |