diff options
author | Sebastien Helleu <flashcode@flashtux.org> | 2009-09-05 16:43:16 +0200 |
---|---|---|
committer | Sebastien Helleu <flashcode@flashtux.org> | 2009-09-05 16:43:16 +0200 |
commit | d8886cdbe61a5526fbcf0017a7d95bae5368e6d7 (patch) | |
tree | 395b5c8935f0513c96b9fd78c9ea173f02c8dbb1 /doc/pl | |
parent | 2bf41636171cd48ed86a875b416485bc051b543d (diff) | |
download | weechat-d8886cdbe61a5526fbcf0017a7d95bae5368e6d7.zip |
Add polish quickstart guide
Diffstat (limited to 'doc/pl')
-rw-r--r-- | doc/pl/CMakeLists.txt | 26 | ||||
-rw-r--r-- | doc/pl/Makefile.am | 37 | ||||
-rw-r--r-- | doc/pl/weechat_quickstart.pl.txt | 246 |
3 files changed, 309 insertions, 0 deletions
diff --git a/doc/pl/CMakeLists.txt b/doc/pl/CMakeLists.txt new file mode 100644 index 000000000..b4929dbdf --- /dev/null +++ b/doc/pl/CMakeLists.txt @@ -0,0 +1,26 @@ +# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org> +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see <http://www.gnu.org/licenses/>. +# + +# quickstart +ADD_CUSTOM_COMMAND( + OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.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_quickstart.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.pl.txt + DEPENDS + ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.pl.txt + COMMENT "Building weechat_quickstart.pl.html" +) +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}) diff --git a/doc/pl/Makefile.am b/doc/pl/Makefile.am new file mode 100644 index 000000000..02ebb671a --- /dev/null +++ b/doc/pl/Makefile.am @@ -0,0 +1,37 @@ +# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org> +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see <http://www.gnu.org/licenses/>. +# + +docdir = $(datadir)/doc/$(PACKAGE) + +EXTRA_DIST = CMakeLists.txt \ + weechat_quickstart.pl.txt + +all-local: weechat_quickstart.pl.html + +# 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 + +# install docs + +install-data-hook: + $(mkinstalldirs) $(DESTDIR)$(docdir)/ + $(INSTALL_DATA) *.html $(DESTDIR)$(docdir)/ + +# clean + +clean-local: + -rm -f *.html diff --git a/doc/pl/weechat_quickstart.pl.txt b/doc/pl/weechat_quickstart.pl.txt new file mode 100644 index 000000000..b43d76247 --- /dev/null +++ b/doc/pl/weechat_quickstart.pl.txt @@ -0,0 +1,246 @@ +WeeChat szybki start +==================== +FlashCode <flashcode@flashtux.org> + + +[[start]] +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 +klawiszowymi). + +Wywołaj "weechat-curses" z terminala. + + +[[help_options]] +Pomoc online / opcje +-------------------- + +WeeChat posiada pomoc dla wszystkich komend, wystarczy wywołać /help +Aby otrzymać pomoc dla konkretnej komendy wpisz `/help command` + +Do ustawiania opcji służy `/set config.sekcja.opcja wartość` +(gdzie `config` jest nazwą konfiguracyjną (`weechat` dla rdzenia, lub nazwa +wtyczki), `sekcja` sekcja pliku konfiguracyjnego, oraz `opcja` nazwa opcji). + +WeeChat natychmiast używa nowej wartości (*nigdy* nie musisz restartoweać WeeChat +po zmianach w ustawieniach). + +Możesz użyć `/set` z częściową nazwą zmiennej oraz dziką kartą "*" na początku +lub końcu, aby wyświetlić wszystkie opcje zawierające te litery. +Na przykład: + +`/set`:: + wyświetli wszystkie opcje (WeeChat oraz wtyczek) + +`/set weechat.*`:: + wyświetli opcje WeeChat + +`/set irc.*`:: + wyświetli opcje wtyczki IRC + +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ą +komendy `/save`, która wymusza zapisanie opcji). + +Możesz edytować ręcznie pliko konfiguracyjne (*.conf) i przeładować je za pomocą +komendy `/reload`, jeśli nie chcesz użyć komendy `/set`. + + +[[core_vs_plugins]] +Rdzeń vs wtyczki +---------------- + +"Rdzeń" WeeChat jest używany tylko do wyświetlania danych na ekranie oraz +interakcji z użytkownikiem, oznacza to, że rdzeń weechat bez wtyczek jest +bezużyteczny (wierni użytkownicy: IRC był częścią rdzenia dla wersji < = 0.2.6). + +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. + + +[[create_irc_server]] +Tworzenie serwera IRC +--------------------- + +Możesz dodać serwer IRC za pomocą komendy `/server`, na przykład: + + /server add oftc irc.oftc.org/6667 + +Jak zawsze w razie wątpliwości dostępna jest pomoc: `/help server` + + +[[irc_server_options]] +Ustawianie własnych opcji dla serwerów IRC +------------------------------------------ + +WeeChat używa domyślnych wartości dla wszystkich serwerów ("fall backs"), jeśli +nie określisz konkretnej wartości dla opcji serwera. +Te domyślne opcje to "irc.server_default.*". + +Dla każdej opcji serwera WeeChat używa jej wartości jeśli jest zdefiniowana (nie +"null"). W przeciwnym przypadku WeeChat używa wartości domyślnych ("irc.server_default.xxx"). + +Na przykład znajdują się tam domyślne nicki (bazujące na Twoim loginie un*x), +możesz je zmienić dla serwera oftc następującą komendą: + + /set irc.server.oftc.nicks "mójnick1,mójnick2,mójnick3,mójnick4,mójnick5" + +Ustawienie nazwy użytkownika i imienia: + + /set irc.server.oftc.username "Moja nazwa użytkownika" + /set irc.server.oftc.realname "Moje imię" + +Aby włączyć automatyczne łączenie się z serwerem przy starcie: + + /set irc.server.oftc.autoconnect on + +Aby wykonać komendę po połączeniu z serwerem, na przykład zidentyfikować się +w nickserv: + + /set irc.server.oftc.command "/msg nickserv identify xxxxxx" + +Przypis: wiele komend może być oddzielonych ';' (średnik) + +Aby automatycznie wejść na kanały po połączeniu z serwerem: + + /set irc.server.oftc.autojoin "#kanał1,#kanał2" + +Aby usunąć wartość dla opcji serwera, używając w zamian wartości domyślnej, +na przykład, aby używać domyślnych nicków (irc.server_default.nicks): + + /set irc.server.oftc.nicks null + +Inne opcje: możesz ustawić pozostałe opcje za pomocą komendy ("xxx" to +nazwa opcji): + + /set irc.server.oftc.xxx wartość + + +[[connect_to_irc_server]] +Łączenie się z serwerem IRC i automatyczne wchodzenie na kanały +--------------------------------------------------------------- + + /connect oftc + +[NOTE] +Ta komenda może być użyta do utworzenia i połączenia sie z nowym serwerem bez +użycia komendy `/server` (czy mam powtarzać, że pomoc dla tej komendy można +uzyskać dzięki `/help connect` ?). + +Domyślnie bufory serwerów są połączone z buforem WeeChat 'core'. Aby przełączać +się pomiędzy biforem 'core' a buforami serwerów możesz użyć ctrl-X. + +Jest możliwe wyłączenie automatycznego łączenia buforów serwerów, aby mieć +oddzielne bufory dla serwerów: + + /set irc.look.server_buffer independent + + +[[join_part_irc_channels]] +Wchodzenie/wychodzenie z kanałów IRC +------------------------------------ + +`/join #kanał`:: + wejście na kanał + +`/part [wiadomość pożegnalna]`:: + wyjście z kanału (zostawiając otwarty bufor) + +`/close [wiadomość pożegnalna]`:: + zamknięcie bufora serwera lub kanału (`/close` jest aliasem `/buffer close`) + + +[[buffer_window]] +Zarządzanie buforami/oknami +--------------------------- + +Bufor jest to element łączący wtyczkę z numerem, kategorią, +oraz nazwą. Zawiera on dane wyświetlane na ekranie. + +Okno jest widokiem na bufor. Domyślnie jedno okno wyświetla jeden bufor. +Jeśli podzielisz ekran, ujrzysz wiele okien z wieloma buforami jednocześnie. + +Komendy do zarządzania buforami i oknami: + + /buffer + /window + +(Nie będę powtarzać, że możesz uzyskać pomoc za pomocą /help na tych komendach) + +Na przykład, aby pionowo podzielić ekran na małe okno (1/3 szerokości), +oraz duże okno (2/3), użyj komendy: + + /window splitv 33 + + +[[key_bindings]] +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 +- '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 +- 'tab': dopełnia tekst w pasku danych wejściowych, dokładnie jak w terminalu +- '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 +dowolnego klawisza do komendy używajac komendy `/key`. +Przydatnym skrótem jest meta-k (alt-k) do odnajdywania kodów klawiszy. + +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: + + /key bind meta-y /buffer close + +Aby usunąć klawisz: + + /key unbind meta-y + + +[[plugins_scripts]] +Wtyczki/skrypty +--------------- + +W niektórych dystrybucjach jak 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 +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. + +Wiele zewnętrznych wtyczek/skryptów (od społeczności) jest dostępnych dla +WeeChat: http://www.weechat.org/plugins + +Najprostrzym sposobem na instalowanie skryptów jest użycie skryptu 'weeget.py': + +. ściągnij i skopiuj 'weeget.py' do ~/.weechat/python/autoload/ +. załaduj skrypt: `/python autoload` +. lista skryptów: `/weeget list` (dla pomocy: `/help weeget`) + + +[[more_doc]] +Więcej dokumentacji +------------------- + +Możesz teraz używać WeeChat oraz przeczytać FAQ/dokumentację w razie innych pytań: +http://www.weechat.org/doc + +Miłej pracy z WeeChat! |