= WeeChat szybki start :author: Sébastien Helleu :email: flashcode@flashtux.org :lang: pl :toc: left :toc-title: Spis treści :sectnums: :docinfo1: Tłumaczenie: * Krzysztof Korościk , 2009-2018 [[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 skrótami klawiszowymi. Wywołaj z terminala: ---- $ weechat ---- [[help]] == Pomoc online WeeChat posiada pomoc dla wszystkich komend, wystarczy wywołać: ---- /help ---- Aby otrzymać pomoc dla konkretnej komendy wpisz: ---- /help komenda ---- Pomoc dostępna jest równiez dla opcji: ---- /help config.section.option ---- (gdzie `config` jest nazwą konfiguracyjną (`weechat` dla rdzenia, lub nazwa wtyczki), `sekcja` sekcja pliku konfiguracyjnego, oraz `opcja` nazwa opcji). [[options]] == Ustawianie opcji Do ustawiania opcji służy: ---- /set config.sekcja.opcja wartość ---- WeeChat natychmiast używa nowej wartości (*nigdy* nie musisz restartować WeeChat po zmianach w ustawieniach). Wszystkie ustawienia są zapisywane podczas wyjścia z WeeChat (lub za pomocą komendy `/save`, która wymusza zapisanie opcji). [IMPORTANT] *Nie zaleca się* ręcznie edytować plików konfiguracyjnych, ponieważ WeeChat może je nadpisać w dowolnej chwili (na przykład podczas `/quit`), oraz po każdej zmianie musisz wykonać komendę `/reload` (ryzykując utratę zmian, które nie zostały zapisane za pomocą `/save`). + Możesz użyć komendy `/set`, która sprawdza wartość i nanosi od razu wymagane zmiany. Wtyczka _fset_ pozwala na łatwe przeglądanie i zmianę opcji. Na przykład w celu wyświetlenia opci WeeChat: ---- /fset weechat.* ---- Opcji IRC: ---- /fset irc.* ---- Komenda `/fset` posiada uzupełanianie części nazw opcji, na przykład jeśli napiszesz `/fset hot` i naciśniesz kbd:[Tab] zostanie to uzupełnione do `/fset hotlist`. Jeśli wciśniesz kbd:[Enter], zostaną wyświetlone opcje dotyczące hotlist. Więcej informacji o komendzie `/fset`, można uzyskać wpisując `/help fset`. [[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 wtyczkach. Użyj komendy `/plugin` do wyświetlenia załadowanych wtyczek, powinieneś zobaczyć na liście "irc" oraz inne wtyczki. [[add_irc_server]] == Dodawanie serwera IRC Możesz dodać serwer IRC za pomocą komendy `/server`, na przykład: ---- /server add freenode chat.freenode.net ---- W tej komendzie `freenode` to nazwa wewnętrzna używana przez WeeChat: będziesz mógł połączyć się za pomocą `/connect freenode`. Opcje serwera będą miały postać _irc.server.freenode.xxx_. 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 freenode następującą komendą: ---- /set irc.server.freenode.nicks "mójnick,mójnick2,mójnick3,mójnick4,mójnick5" ---- Ustawienie nazwy użytkownika i imienia: ---- /set irc.server.freenode.username "Moja nazwa użytkownika" /set irc.server.freenode.realname "Moje imię" ---- Aby włączyć automatyczne łączenie się z serwerem przy starcie: ---- /set irc.server.freenode.autoconnect on ---- W celu połączenia z użyciem SSL: ---- /set irc.server.freenode.addresses "chat.freenode.net/7000" /set irc.server.freenode.ssl on ---- Jeśli SASL jest dostępny na serwerze, można użyć go do uwierzytelnienia (zostaniesz zidentyfikowany przed wejściem na kanał): ---- /set irc.server.freenode.sasl_username "mójnick" /set irc.server.freenode.sasl_password "xxxxxxx" ---- Żeby wykonać komendę po połączeniu z serwerem, na przykład uwierzytelnienie przez nickserv (tylko jeśli nie uwierzytelniasz się przez SASL): ---- /set irc.server.freenode.command "/msg nickserv identify xxxxxxx" ---- [NOTE] Opcja _command_ może zawierać wiele komend, należy je oddzielić `;` (średnik). Jeśli chcesz zabezpieczyć swoje hasło podane w plikach konfiguracyjnych możesz użyć bezpiecznych danych. Najpierw ustaw hasło: ---- /secure passphrase to jest moje tajne hasło ---- Następnie dodaj swoje hasło, np dla sieci freenode: ---- /secure set freenode_password xxxxxxx ---- Następnie możesz użyć `+${sec.data.freenode_password}+` zamiast swojego hasła dla opcji IRC omówionych wcześniej, na przykład: ---- /set irc.server.freenode.sasl_password "${sec.data.freenode_password}" ---- Aby automatycznie wejść na kanały po połączeniu z serwerem: ---- /set irc.server.freenode.autojoin "#kanał1,#kanał2" ---- [TIP] Możesz dopełnić nazwę lub wartość opzji za pomocą klawisza kbd:[Tab] oraz kbd:[Shift+Tab] dla częściowego dopełnienia (przydatne dla długich nazw jak nazwy opcji). 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): ---- /unset irc.server.freenode.nicks ---- Inne opcje: możesz ustawić pozostałe opcje za pomocą komendy ("xxx" to nazwa opcji): ---- /set irc.server.freenode.xxx wartość ---- [[connect_to_irc_server]] == Łączenie z serwerem IRC ---- /connect freenode ---- Dzięki tej komendzie WeeChat łączy się z serwerem freenode i automatycznie wchodzi na kanały skonfigurowane w opcji "autojoin" dla serwera. [NOTE] Ta komenda może być użyta do utworzenia i połączenia się z nowym serwerem bez użycia komendy `/server` (zobacz `/help connect`). Domyślnie bufory serwerów są połączone z buforem WeeChat _core_. Aby przełączać się pomiędzy buforem _core_ a buforami serwerów możesz użyć kbd:[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 Wejście na kanał: ---- /join #kanał ---- Wyjście z kanału (zostawiając otwarty bufor): ---- /part [wiadomość pożegnalna] ---- Zamknij serwer, kanał albo prywatny bufor (`/close` to alias dla `/buffer close`): ---- /close ---- [WARNING] Zamknięcie buforu serwera poskutkuje zamknięciem wszystkich buforów prywatnych/kanałów. Rozłączanie się z serwerem, w buforze serwera: ---- /disconnect ---- [[irc_private_messages]] == Prywatne wiadomości IRC Otworzenie bufora i wysłanie wiadomości do innego użytkownika (nick _foo_): ---- /query foo to jest wiadomość ---- Zamykanie prywatnego bufora: ---- /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 ---- 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 ---- Usunięcie podziału: ---- /window merge ---- [[key_bindings]] == Skróty klawiszowe WeeChat używa domyślnie wiele klawiszy. Wszystkie z nich są w dokumentacji, ale powinieneś znać przynajmniej kilka najprzydatniejszych: - kbd:[Alt+←] / kbd:[Alt+→] lub kbd:[F5] / kbd:[F6]: przełącza na poprzedni/następny bufor - kbd:[F1] / kbd:[F2]: przewija pasek z listą buforów ("buflist") - kbd:[F7] / kbd:[F8]: przełącza na poprzednie/następne okno (jeśli ekran jest podzielony) - kbd:[F9] / kbd:[F10]: przewija pasek z tematem kanału - kbd:[F11] / kbd:[F12]: przewija listę z nickami - kbd:[Tab]: dopełnia tekst w pasku danych wejściowych, dokładnie jak w terminalu - kbd:[PgUp] / kbd:[PgDn]: przewija tekst w obecnym buforze - kbd:[Alt+a]: skocz do bufora z aktywnością (w hotliście) Zgodnie z Twoją klawiaturą i/lub potrzebami, możesz zmienić przypisanie dowolnego klawisza do komendy używając komendy `/key`. Przydatnym skrótem jest kbd:[Alt+k] do odnajdywania kodów klawiszy. Na przykład, aby przypisać kbd:[Alt+!] do komendy `/buffer close`: ---- /key bind (wciśnij alt-k) (wciśnij alt-!) /buffer close ---- Otrzymasz w linii poleceń: ---- /key bind meta-! /buffer close ---- Aby usunąć klawisz: ---- /key unbind meta-! ---- [[plugins_scripts]] == Wtyczki/skrypty 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 ładować/wyładowywać wtyczki lub skrypty). Dostępne jest wiele zewnętrznych skryptów (od społeczności), możesz je pobrać i zainstalować za pomocą komendy `/script`, na przykład: ---- /script install go.py ---- Więcej informacji można uzyskać wykonując komendę `/help script`. Listę skryptów dostepnych dla WeeChat można uzyskać wywołując komendę `/script` lub pod adresem https://weechat.org/scripts [[more_doc]] == Więcej dokumentacji Możesz teraz używać WeeChat oraz przeczytać FAQ/dokumentację w razie innych pytań: https://weechat.org/doc Miłej pracy z WeeChat!