Ten dokument jest napisany dla WeeChat w wersji ≥ 0.3.0, ale powinien być używany dla najnowszej stabilnej wersji.

Tłumaczenie:

1. Ogólne

1.1. Skąd się wzięła nazwa "WeeChat"?

"Wee" to akronim rekursywny oznaczającym "Wee Enhanced Environment". Stąd kompletna nazwa to "Wee Enhanced Environment for Chat".

"Wee" oznacza również "bardzo mały" (tak jest jeszcze inne znaczenie, ale nie pasuje ono do WeeChat!).

1.2. Dlaczego wybrać WeeChat? X-Chat i Irssi są takie dobre…​

Ponieważ Weechat jest bardzo lekki i posiada innowacyjne funkcje.

More info on the WeeChat features page: https://weechat.org/about/features

2. Kompilacja / instalacja

2.1. Słyszałem o wielu GUI dla WeeChat. Jak mogę je skompilować/użyć?

Dostępne są zdalne interfejsy, możesz o nich poczytać na tej stronie: https://weechat.org/about/interfaces

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

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.

2.3. Jak zainstalować WeeChat na macOS?

Zaleca się użycie Homebrew, pomoc uzyskasz za pomocą komendy:

brew info weechat

Możesz zainstalować WeeChat za pomocą komendy:

brew install weechat --with-aspell --with-curl --with-python --with-perl --with-ruby --with-lua --with-guile

2.4. Uruchomiłem WeeChat, ale czuję się zagubiony, co robić?

Dla pomocy wpisz /help. Aby uzyskać pomoc dla komendy wpisz /help komenda. Keys and commands are listed in documentation.

Nowym użytkowniką zaleca się przeczytanie dokumentu Szybki start.

3. Wyświetlanie

3.1. Nie widzę niektórych znaków diakrytycznych, co mogę zrobić?

It’s a common issue with a variety of causes, please read carefully and check ALL solutions below:

  • sprawdź czy weechat jest zlinkowany z libncursesw (uwaga: wymagane na większości dystrybucji ale nie wszystkich): ldd /ścieżka/do/weechat

  • sprawdź czy wtyczka "charset" jest załadowana za pomocą komendy /plugin (jeśli nie jest, to najprawdopodobniej potrzebujesz pakietu "weechat-plugins")

  • sprawdź wyjście komendy /charset (w głównym buforze). Powinieneś zobaczyć ISO-XXXXXX lub UTF-8 dla kodowania terminala. Jeśli widzisz ANSI_X3.4-1968 lub inne wartości, twoje ustawienie dla locale najprawdopodobniej jest złe.
    Aby to naprawić, sprawdź zainstalowane w systemie kodowania za pomocą locale -a i ustaw odpowiednią wartość zmiennej $LANG, na przykład: export LANG=en_US.UTF-8.

  • ustaw globalną wartość dekodowania, na przykład: /set charset.default.decode "ISO-8859-2"

  • jeśli korzystasz z UTF-8:

    • sprawdź czy twój terminal jest przystosowany dla UTF-8 (zalecanym terminalem dla UTF-8 jest rxvt-unicode)

    • jeśli korzystasz ze screena, sprawdź czy jest uruchomiony z trybem UTF-8 (“defutf8 on” w ~/.screenrc lub screen -U uruchamiając screena)

  • sprawdź czy opcja weechat.look.eat_newline_glitch jest wyłączona (ta opcja może powodować błędy wyświetlania)

UTF-8 jest zalecany dla WeeChat. Jeśli korzystasz z lokalizacji ISO lub innych, sprawdź czy wszystkie twoje ustawienia (terminal, screen, ..) są ISO, a nie UTF-8.

3.2. Niektóre znaki unicode są wyświetlane w terminalu ale nie w WeeChat, dlaczego?

Może to być spowodowane przez błąd libc w funkcji wcwidth, który powinien zostać naprawiony w glibc 2.22 (może jeszcze nie być dostępny w twojej dystrybucji).

Istnieje sposób na obejście błędu funkcji wcwidth: https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat

Więcej informacji można znaleźć w zgłoszeniu błędu: https://github.com/weechat/weechat/issues/79

3.3. Paski jak tytuł i status nie są filtrowane, kolor tła zatrzymuje się po tekście, czemu?

Może to być spowodowane złą wartością zmiennej środowiskowej TERM (spójrz na wynik echo $TERM w terminalu).

W zależności, gdzie uruchamiasz WeeChat, powinieneś uzyskać:

  • jeżeli WeeChat działa lokalnie lub na zdalnej maszynie bez programów jak screen czy tmux, zależy od używanego terminala: xterm, xterm-256color, rxvt-unicode, rxvt-256color, …​

  • jeśli WeeChat działa pod screenem, zmienna $TERM powinna zawierać screen lub screen-256color,

  • jeśli WeeChat działa pod tmuxem, zmienna $TERM powinna zawierać tmux, tmux-256color, screen lub screen-256color.

W razie potrzeby, popraw zmienna TERM: export TERM="xxx".

3.4. Podczas używania WeeChat pod screenem/tmuxem pojawiają mi się dziwne, losowe znaki, jak to naprawić?

Może to być spowodowane przez złą wartość zmiennej TERM w swojej powłoce (spójrz na wynik echo $TERM w swoim terminalu, poza screenem/tmuxem).
Na przykład, xterm-color może wyświetlać takie dziwne znaki, możesz użyć xterm, który działa dobrze (jak wiele innych wartości).
W razie potrzeby, popraw zmienna TERM: export TERM="xxx".

Jeśli używasz gnome-terminal, sprawdź czy opcja "Ambigous-width chracters" w menu Preferencje/Profile/Kompatybilność jest ustawiona na narrow.

3.5. Skompilowałem WeeChat pod macOS i wszędzie na ekranie widzę "(null)", co jest nie tak?

Jeśli samodzielnie skompilowałeś ncursesw, spróbuj użyć domyślnej wersji (dostarczanej z systemem).

Ponadto, pod macOS, zaleca się instalowanie WeeChat za pomocą managera pakietów Homebrew.

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

Each window displays one buffer, or a set of merged buffers. A buffer can be hidden (not displayed by a window) or displayed by one or more windows.

3.7. Jak wyświetlić listę z buforami po lewej stronie?

W wersji WeeChat ≥ 1.8, wtyczka buflist jest domyślnie włączona i załadowana.

W starszych wersjach możesz zainstalować skrypt buffers.pl:

/script install buffers.pl

Ograniczenie rozmiaru bufora z listą kanałów (zamień "buflist" na "buffers" jeśli używasz skryptu buffers.pl):

/set weechat.bar.buflist.size_max 15

Aby przesunąć pasek na spód:

/set weechat.bar.buflist.position bottom

Przewijanie paska: jeśli obsługa myszy jest włączona (skrót: Alt+m), możesz przewijać pasek za pomocą rolki myszy.

Domyślne skróty do przewijania paska buflist to F1, F2, Alt+F1 oraz Alt+F2.

Dla skryptu buffers.pl, możesz zdefiniować skróty w podobny sposób do istniejących skrótów do przewijania listy nicków.
Na przykład F1, F2, Alt+F1 oraz Alt+F2:

/key bind meta-OP /bar scroll buffers * -100%
/key bind meta-OQ /bar scroll buffers * +100%
/key bind meta-meta-OP /bar scroll buffers * b
/key bind meta-meta-OQ /bar scroll buffers * e
Klawisze "meta-OP" i "meta-OQ" mogą być inne dla twojego terminala. W celu znalezienia ich kodów wciśnij Alt+k następnie przycisk.

3.8. Jak mogę ograniczyć długość wyświetlanych nicków lub usunąć wyrównanie w oknie rozmowy?

W celu ograniczenia długości nicków w oknie rozmowy:

/set weechat.look.prefix_align_max 15

Żeby usunąć wyrównanie nicków:

/set weechat.look.prefix_align none

3.9. Co oznacza [H: 3(1,8), 2(4)] na pasku statusu?

Jest to "hotlista", lista buforów z ilością nieprzeczytanych wiadomości, w kolejnoci: podświetlenia, prywatne wiadomości, wiadomości, inne (jak wejścia/wyjścia).
Ilość "nieprzeczytanych wiadomości" to lista nowych wyświetlonych/odebranych wiadomości od ostatniej wizyty w buforze.

w przykładzie [H: 3(1,8), 2(4)], oznacza:

  • 1 highlight and 8 unread messages on buffer #3,

  • 4 nieprzeczytane wiadomości w buforze #2.

Kolor bufora/licznika zależy od typu wiadomoci, domyślne kolory:

  • podświetlenie: lightmagenta / magenta

  • prywatna wiadomość: lightgreen / green

  • wiadomość: yellow / brown

  • inne: default / default (kolor tekstu w terminalu)

Kolory można zmienić za pomocą opcji weechat.color.status_data_* (bufory) i weechat.color.status_count_* (liczniki).
Pozostałe opcje hotlist można zmienić za pomocą opcji weechat.look.hotlist_*.

Więcej informacji na temat hotlity można znaleźć w Poradniku użytkownika / Układ ekranu.

3.10. Jak używać linii poleceń z więcej niż jednym wierszem?

Opcja size paska wprowadzania może zostać ustawiona na wartość wyższą niż 1 (dla ustalonej wartości, domyślny rozmiar to 1) lub 0 dla dynamicznego rozmiaru, następnie opcja size_max ustali maksymalny rozmiar (0 = brak limitu).

Przykład dynamicznego rozmiaru:

/set weechat.bar.input.size 0

Maksymalny rozmiar równy 2:

/set weechat.bar.input.size_max 2

3.11. Czy jest możliwe wyświetlanie tylko jednego paska wejściowego dla wszystkich okien (po podzieleniu)?

Tak, należy stworzyć pasek typu "root" (z elementem mówiącym, w którym oknie aktualnie jesteśmy), następnie usunąć obecny pasek wejściowy.

Na przykład:

/bar add rootinput root bottom 1 0 [buffer_name]+[input_prompt]+(away),[input_search],[input_paste],input_text
/bar del input

Jeśli kiedyś przestanie ci to odpowiadać, po prostu usuń ten pasek, WeeChat automatycznie stworzy nowy pasek "input" jeśli element "input_text" nie zostanie użyty w żadnym z pasków:

/bar del rootinput

3.12. Jak mogę kopiować/wklejać tekst bez wklejania listy nicków?

W WeeChat od wersji ≥ 1.0, możesz użyć trybu niesformatowanego wyświetlania (domyślnie: Alt+l), which will show just the contents of the currently selected window, without any formatting.

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:

/set weechat.bar.nicklist.position top

3.13. Jak mogę kliknąć na długi URL (dłuższy niż linia)?

W WeeChat od wersji ≥ 1.0, możesz użyć trybu niesformatowanego wyświetlania (domyślnie: Alt+l).

Żeby operowanie na URLach było latwiejsze możesz:

  • przenieść listę nicków na górę:

/set weechat.bar.nicklist.position top
  • wyłączyć wyrównanie dla wieloliniowych słów (WeeChat ≥ 1.7):

/set weechat.look.align_multiline_words off
  • albo dla wszystkich zawiniętych lini:

/set weechat.look.align_end_of_lines time

W WeeChat ≥ 0.3.6 można włączyć opcję "eat_newline_glitch", dzięki której znaki nowej linii nie są dodawane na końcu każdej wyświetlanej linii (nie zakłóci to zaznaczania urli):

/set weechat.look.eat_newline_glitch on
Ta opcja może spowodować pojawienie się błędów. Jeśli doświadczysz takich problemów wyłącz tą opcję.

Innym rozwiązaniem jest użycie skryptu:

/script search url

3.14. Chcę zmienić język komunikatów wyświetlanych przez WeeChat, ale bez jego zamykania, czy jest to możliwe?

Tak, dla wersji WeeChat ≥ 1.0:

/set env LANG pl_PL.UTF-8
/upgrade

Dla starszych wersji WeeChat:

/script install shell.py
/shell setenv LANG=pl_PL.UTF-8
/upgrade

3.15. Jak mogę użyć 256 kolorów w WeeChat?

256 kolorów jest wspierane tylko w WeeChat ≥ 0.3.4.

Najpierw należy sprawdzić czy wartość zmiennej środowiskowej TERM jest poprawna,\ zalecane wartości to:

  • w screenie: screen-256color

  • pod tmuxem: screen-256color lub tmux-256color

  • poza screenem/tmuxem: xterm-256color, rxvt-256color, putty-256color, …​

Może okazać się konieczne zainstalowanie pakietu "ncurses-term" w celu użycia tych wartości w zmiennej TERM.

Jeśli używasz screena, możesz dodać to do swojego ~/.screenrc:

term screen-256color

Jeśli twoja zmienna TERM posiada złą wartość i WeeChat jest już uruchomiony, możesz zmienić ją za pomocą tych dwóch komend (dla wersji Weechat ≥ 1.0):

/set env TERM screen-256color
/upgrade

Dla wersji 0.3.4, musisz użyć komendy /color w celu dodania nowych kolorów.

Dla wersji ≥ 0.3.5, można używać dowolnego numeru koloru w opcjach (opcjonalnie: można stworzyć alias dla koloru za pomocą komendy /color).

Więcej informacji o zarządzaniu kolorami można znaleźć w Poradniku użytkownika / Kolory.

3.16. Jak mogę wyszukać tekst w buforze (jak za pomocą /lastlog w irssi)?

Domyślny skrót klawiszowy to Ctrl+r (komenda: /input search_text_here).

Poruszanie się między podświetleniami: Alt+p / Alt+n.

Więcej informacji o skrótach klawiszowych można znaleźć w Poradniku użytkownika / Domyślne skróty klawiszowe.

3.17. Jak mogę wykonywać komendy, kiedy terminal stanie się/przestanie być aktywny?

Musisz włączyć obsługę tego zdarzenia za pomocą specjalnego kodu wysyłanego do terminala.

Ważne:

  • Musisz użyć współczesnego terminala zgodnego z xterm.

  • Dodatkowo, istotne jest, any zmenna TERM była utawiona na wartość xterm lub xterm-256color.

  • Jeśli używaz tmuxa, musisz dodatkowo włączyć obsługę zdarzeń aktywności poprzez dodanie set -g focus-events on do pliku .tmux.conf.

  • Nie działa to pod screenem.

Żeby wysłać kod podczas uruchamiania WeeChat:

/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"

Następnie przypisz dwie kombinacje klawiszy dla stanu aktywności (zamień komendy /print własnymi komendami:

/key bind meta2-I /print -core focus
/key bind meta2-O /print -core unfocus

3.18. Kiedy WeeChat działa pod screenem, tekst wklejany do innego okna screena ma dodane ~0 i ~1 dookoła, dlaczego?

Jest to spowodowane przez opcję wklejania nawiasów, która jest domyślnie włączona i nie jest właściwie obsługiwana przez inne okna screena.

Możesz po prostu wyłączyć tą opcję:

/set weechat.look.paste_bracketed off

4. Przypisania klawiszy

4.1. Niektóre skróty klawiszowe (alt + klawisz) nie działają, dlaczego?

Jeśli używasz terminali jak xterm lub uxterm, niektóre skróty domyślnie nie będą działać. Możesz dodać następujące linie do pliku ~/.Xresources:

  • dla xterm:

XTerm*metaSendsEscape: true
  • dla uxterm:

UXTerm*metaSendsEscape: true

Następnie przeładować zasoby (xrdb -override ~/.Xresources) lub zrestartować X.

Jeśli używasz aplikacji Terminal na macOS włącz opcję "Use option as meta key" w menu Settings/Keyboard. Następnie możesz używać klawisza Option jako klawisza meta.

4.2. Jak mogę zmienić przypisania klawiszy?

Przypisania klawiszy można dostosować za pomocą komendy /key.

Domyślnie Alt+k pozwala pobrać kod klawiszy i umieścić go w wierszu poleceń.

4.3. Jakim skrótem można przejść do buforu 11 (lub o większym numerze)?

Skrót to Alt+j i dwie cyfry, na przykład Alt+j, 1, 1 przejdzie do buforu 11.

Można również samemu stworzyć skrót, na przykład:

/key bind meta-q /buffer *11

Listę domyślnych skrótów klawiszowych można znależć w Poradniku uzytkownika / Domyślne skróty klawiszowe.

Aby przesjść do bufora o numerze ≥ 100, możesz zdefiniować trigger i następnie użyć komendy w stylu /123 żeby przejść do bufora #123:

/trigger add numberjump modifier "2000|input_text_for_buffer" "${tg_string} =~ ^/[0-9]+$" "=\/([0-9]+)=/buffer *${re:1}=" "" "" "none"

4.4. Jak używać globalnej historii (zamiast historii buforu) za pomocą strzałek góra/dół?

Możesz przypisać strzałki w górę i dół do globalnej historii (domyślnie dla globalnej historii przypisane są klawisze Ctrl+ oraz Ctrl+).

Przykład:

/key bind meta2-A /input history_global_previous
/key bind meta2-B /input history_global_next
Klawisze "meta2-A" i "meta2-B" mogą być inne dla twojego terminala. W celu znalezienia ich kodów wciśnij Alt+k następnie przycisk.

5. Obsługa myszy

5.1. Obsługa myszy w ogóle nie działa, co mogę zrobić?

Mysz nie jest obsługiwana w WeeChat ≥ 0.3.6.

Na samym początku należy włączyć obsługę myszy:

/mouse enable

Jeśli to nie pomogło należy sprawdzić wartość zmiennej TERM w swojej powłoce (wynik komendy echo $TERM w swoim terminalu). W zależności od używanego terminfo, mysz może nie być wspierana.

Możesz sprawdzić wsparcie myszy w terminalu:

$ printf '\033[?1002h'

Następnie kliknij pierwszy znak w terminalu (górny lewy róg). Powinieneś zobaczyć " !!#!!".

Aby wyłączyć wsparcie dla myszy w terminalu:

$ printf '\033[?1002l'

5.2. Mysz nic nie robi dla X lub Y większych od 94 (lub 222), dlaczego?

Niektóre terminale wysyłają tylko znaki ISO dla położenia myszy, dlatego nie działa to dla X/Y większych dla 94 (lub 222).

Powinieneś użyć terminala wspierającego położenia UTF-8 dla myszy, jak rxvt-unicode.

5.3. Jak mogę zaznaczyć lub wkleić tekst w terminalu z włączoną obsługa myszy w WeeChat?

Kiedy obsługa myszy jest włączona w WeeChat, można użyć modyfikatora Shift do zaznaczania lub kliknać w terminalu, tak jak w przypadku wyłączonej obsługi myszy (w niektórych terminalach jak iTerm należy użyć Alt zamiast Shift).

6. IRC

6.1. Mam problemy podczas połączenia z serwerem używającym SSL, co mogę zrobić?

Jeśli używasz Mac macOS, musisz zainstalować openssl z Homebrew. Plik CA zostanie wygenerowany korzystając z systemowego keychaina. Możez natępnie ustawić ścierzkę do certyfikatów w WeeChat:

/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"

Jeśli widzisz błędy gnutls, możesz użyć innej wielkości klucza Diffie-Hellman (domyślnie 2048):

/set irc.server.example.ssl_dhkey_size 1024

Jeśli widzisz błędy związanie z certyfikatami, możesz wyłączyć opcję "ssl_verify" (należy jednak uważać, ponieważ połączenie będzie mniej bezpieczne):

/set irc.server.example.ssl_verify off

Jeśli serwer ma niewłaściwy certyfikat i wiesz jaki on powinien być, możesz podać sumę kontrolną (SHA-512, SHA-256 lub SHA-1):

/set irc.server.example.ssl_fingerprint 0c06e399d3c3597511dc8550848bfd2a502f0ce19883b728b73f6b7e8604243b

6.2. Podczas łączenia się z serwerem poprzez SSL widzę tylko błąd "TLS handshake failed", co mogę zrobić?

Możesz spróbować innego ciągu priorytetu (tylko WeeChat ≥ 0.3.5), zamień "xxx" nazwą serwera:

/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"

6.3. Jak mogę połączyć się z serwerem freenode używając SSL?

Ustaw opcję weechat.network.gnutls_ca_file do pliku z certyfikatami:

/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"

Uwaga: jeśli używasz macOS z openssl zainstalowanym przez homebrew, możesz wykonać:

/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
Należy sprawdzić czy plik znajduje się w systemie (zazwyczaj dostarczany przez pakiet "ca-certificates").

Ustaw port serwera, SSL, następnie się połącz:

/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode

6.4. Jak połączyć się z serwerem wymagającym "oauth"?

Niektóre serwery jak twitch wymagają oauth do połączenia.

Oauth to po prostu hasło w postaci "oauth:hasło".

Możesz dodać taki serwer i połączyć się z nim za pomocą komend (zamień nazwę i adres na poprawne wartości):

/server add nazwa irc.server.org -password=oauth:hasło
/connect nazwa

6.5. Jak mogę się zidentyfikować przed wejściem na kanały?

Jeśli serwer wspiera SASL, możesz użyć tego zamiast wysyłać komendę do nickserva, na przykład:

/set irc.server.freenode.sasl_username "nick"
/set irc.server.freenode.sasl_password "xxxxxxx"

Jeśli serwer nie wspiera SASL, możesz dodać odstęp pomiędzy komendą a wejściem na kanały):

/set irc.server.freenode.command_delay 5

6.6. 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 stosuje się do treści wiadomości). Pasujące wiadomości są usuwane przez wtyczkę IRC przed wyświetleniem (so you’ll never see them, and can’t be recovered by removing the ignore).

The /filter command is a WeeChat core command, so it applies to any buffer. Pozwala filtrować niektóre linie w buforach za pomocą tagów lub wyrażeń regularnych dla przedrostków i zawartości linii. Filtrowane linie są tylko ukrywane, nie usuwane, można je zobaczyć wyłączając filtry (domyślnie Alt+= zmienia stan filtrów).

6.7. Jak mogę filtrować wiadomości o wejściu/opuszczeniu/wyjściu na kanałach IRC?

Za pomocą inteligentnych filtrów (zachowuje wejścia/opuszczenia/wyjścia od osób piszących niedawno):

/set irc.look.smart_filter on
/filter add irc_smart * irc_smart_filter *

Za pomocą globalnego filtru (ukrywa wszystkie wejścia/opuszczenia/wyjścia):

/filter add joinquit * irc_join,irc_part,irc_quit *
+For help: /help filter, /help irc.look.smart_filter and see +Poradniku użytkownika / Inteligentne filtry dla wiadomości.

6.8. Jak mogę filtrować wyświetlane wiadomości podczas wejścia na kanał IRC?

W wersjach WeeChat ≥ 0.4.1, możesz wybrać to, jakie wiadomości są wyświetlane a jakie nie podczas wchodzenia na kanał, za pomocą opcji irc.look.display_join_message (więcej informacji można znaleźć wykonując /help irc.look.display_join_message).

W celu ukrycia wiadomości (ale zachowując je w buforze), możesz je filtrować używając tagu (na przykład irc_329 dla daty utworzenia kanału). zobacz /help filter w celu uzyskania pomocy z filtrami.

6.9. Jak mogę filtrować informacje o przyznaniu voice (np na serwerze Bitlbee)?

Filtrowanie wiadomości o przyznaniu voice nie jest proste, ponieważ może on zostać nadany wraz z innymi atrybutami w jednej wiadomości IRC.

Zapewne chcesz to zrobić, ponieważ Bitlbee używa voice do wskazania nieobecnych użytkowników, oraz jesteś zasypywany takimi wiadomościami. Możesz to zmienić oraz pozwolić WeeChat używać specjalnego koloru dla nieobecnych nicków.

Dla Bitlbee ≥ 3, należy wykonać na kanale &bitlbee:

channel set show_users online,away

Dla starszych wersji Bitlbee, należy wykonać na kanale &bitlbee:

set away_devoice false

Aby dowiedzieć się jak sprawdzić nieobecność w WeeChat, spójrz na pytanie o nieobecnych osobach.

Jeśli napewno chcesz filtrować wiadomości o statusie voice, możesz użyć tej komendy, nie jest ona jednak doskonała (działa tylko jeśli pierwszy z modyfikowanych trybów to voice):

/filter add hidevoices * irc_mode (\+|\-)v

6.10. Jak mogę zobaczyć kto jest aktualnie nieobecny ?

Należy ustawić opcję irc.server_default.away_check na wartość większą od zera (minuty pomiędzy sprawdzaniem czy nick jest nieobecny).

Możesz ustawić opcję irc.server_default.away_check_max_nicks w celu ustalenia sprawdzania nieobecności dla małych kanałów.

Na przykład, aby sprawdzać nieobecność nicków co 5, dla kanałów z maksymalnie 25 osobami:

/set irc.server_default.away_check 5
/set irc.server_default.away_check_max_nicks 25
Dla WeeChat ≤ 0.3.3, opcje te to irc.network.away_check oraz irc.network.away_check_max_nicks.

6.11. Jak mogę zostać powiadomiony, jeśli ktoś będzie chciał przyciągnąć moją uwagę na kanale?

W wersji WeeChat ≥ 1.0, domyślnie dodany jest trigger "beep" wysyłający BEL do terminala przy podświetleniu lub prywatnej wiadomości. Dzięki temu możesz skonfigurować swój terminal (lub multiplekser jak screen/tmux) do wykonania komendy lub odtworzenia dźwięku, kiedy BEL zostanie odebrany.

Lub możesz dodać komendę w triggerze "beep":

/set trigger.trigger.beep.command "/print -beep;/exec -bg /ścieżka/do/komendy argumenty"

W starszych wersjach WeeChat, możesz użyć skryptu jak beep.pl lub launcher.pl.

Dla launcher.pl, należ przeprowadzić konfigurację:

/set plugins.var.perl.launcher.signal.weechat_highlight "/ścieżka/do/komendy argumenty"

Inne podobne skrypty:

/script search notify

6.12. How can I disable highlights for specific nicks?

With WeeChat ≥ 0.3.4 you can use the hotlist_max_level_nicks_add buffer property to set the max hotlist level for some nicks, per buffer, or per group of buffers (like IRC servers).

To only disable highlights, you’d have to set it to 2:

/buffer set hotlist_max_level_nicks_add joe:2,mike:2

This buffer property isn’t stored in the configuration though. To automatically reapply these buffer properties, you would need the buffer_autoset.py script:

/script install buffer_autoset.py

For example, to permanently disable highlights from "mike" on #weechat on the IRC server freenode:

/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2

To apply it to the entire freenode server instead:

/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2

For more examples, see /help buffer_autoset.

6.13. Jak mogę zmienić docelowy bufor dla komendy w połączonym buforze (jak bufor z serwerami)?

Domyślna kombinacja to Ctrl+x (komenda: /input switch_active_buffer).

7. Pluginy / skrypty

7.1. 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ć:

/set weechat.plugin.extension ".so.0.0"
/plugin autoload

7.2. Jak mogę instalować skrypty? Czy są one kompatybilne z innymi klientami IRC?

With WeeChat ≥ 0.3.9 you can use the command /script to install and manage scripts (see /help script for help). For older versions there is weeget.py and script.pl.

Skrypty nie są kompatybilne z innymi klientami IRC.

7.3. Komenda "/script update" nie może odczytać skryptów, jak to naprawić?

Najpierw zapoznaj się z zagadnieniami dotyczącymi połączeń SSL znajdującymi się w tym dokumencie (zwłaszcza opcji weechat.network.gnutls_ca_file).

Jeśli to nie pomoże spróuj ręcznie usunąć plik z listą skryptów (z poziomu powłoki):

$ rm ~/.weechat/script/plugins.xml.gz

Następnie ponownie zaktualizuj listę sktyptów w WeeChat:

/script update

If you still have an error, then you must disable the automatic update of file in WeeChat and download the file manually outside WeeChat (that means you’ll have to update manually the file yourself to get updates):

  • w WeeChat:

/set script.scripts.cache_expire -1
  • w powłoce, z zainstalowanym programem curl:

$ cd ~/.weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz

7.4. Zainstalowałem słowniki aspell w systemie, jak mogę ich użyć bez restartowania WeeChat?

Musisz przeładować wtyczkę aspell:

/plugin reload aspell

8. Ustawienia

8.1. Czy mogę ręcznie edytować pliki konfiguracyjne (*.conf)?

Możesz, ale NIE jest to zalecane.

Zaleca się użycie komendy /set:

  • Możesz dopałnić nazwę i wartość opcji za pomocą klawisza Tab (lub Shift+Tab dla częściowego dopełnieina, przydatne dla nazw).

  • wartość jest sprawdzana, w razie błędu wyświetlana jest wiadomość

  • wartości zmieniane są od razu, nie trzeba retartować WeeChat ani nic takiego

Jeśli nadal chcesz ręcznie edytować pliki, powinieneś zachować ostrożność:

  • jeśli wprowadzisz nieprawidłową wartość dla opcji, WeeChat wyświetli błąd przy ładowaniu i odrzuci błędną wartość (zostanie użyta wartość domyślna)

  • jeśli WeeChat jet uruchomiony, należy wykonać komendę /reload, jeżeli jakieś ustawienia zostały zmienione ale nie zapisane za pomocą /save, zostaną utracone

8.2. Jak mogę zmusić WeeChat do zużywania mniejszej ilości pamięci?

W celu zmniejszenia używanej pamięci możesz zastosować się do poniższych rad:

  • używać najnowsze stabilnej wersji (powinna mieć mniej wycieków pamięci niż starsze wersje)

  • nie ładuj nieużywanych pluginów, np: aspell, buflist, fifo, logger, perl, python, ruby, lua, tcl, guile, javascript, php, xfer (używana do DCC). See /help weechat.plugin.autoload.

  • ładować tylko naprawdę używane skrypty

  • nie ładuj certyfikatów jeśli SSL NIE jest używany: ustaw pusty ciąg w opcji weechat.network.gnutls_ca_file

  • zmniejsz wartość dla opcji weechat.history.max_buffer_lines_number lub ustaw wartość opcji weechat.history.max_buffer_lines_minutes

  • zmniejszyć wartość opcji weechat.history.max_commands

8.3. Jak mogę zmusić WeeChat do zużywania mniejszej mocy CPU?

Możesz skorzystać z tych samych porad jak dla memory, oraz tych:

  • schowaj pasek "nicklist": /bar hide nicklist

  • usuń wyświetlanie sekund w czasie na pasku statusu: /set weechat.look.item_time_format "%H:%M" (domyślna wartość)

  • wyłącz automatyczne sprawdzanie poprawności wpisywanych słów w linii poleceń (o ile je włączyłeś): /set aspell.check.real_time off

  • ustaw zmienną TZ (na przykład: export TZ="Europe/Warsaw"), w celu zmniejszenia częstotliwości czytania pliku /etc/localtime

8.4. Mam paranoję na temat bezpieczeństwa, które ustawienia powinienem zmienić, żeby być bardziej bezpiecznym?

Wyłącz wiadomości o wyjściu z kanału i rozłączenia z serwerem:

/set irc.server_default.msg_part ""
/set irc.server_default.msg_quit ""

Wyłącz odpowiedzi na wszystkie zapytania CTCP:

/set irc.ctcp.clientinfo ""
/set irc.ctcp.finger ""
/set irc.ctcp.source ""
/set irc.ctcp.time ""
/set irc.ctcp.userinfo ""
/set irc.ctcp.version ""
/set irc.ctcp.ping ""

Wyładuj i wyłącz automatyczne ładowanie wtyczki "xfer" (używanej przez IRC DCC):

/plugin unload xfer
/set weechat.plugin.autoload "*,!xfer"

Zdefiniuj hasło i używaj bezpiecznych danych wszędzie gdzie możesz dla danych wrażliwych jak hasła: zobacz /help secure oraz /help na opcjach (czy możesz użyć bezpiecznych danych, jest to zaznaczone w pomocy). See also Poradniku użytkownika / Zabezpieczone dane.

Na przykład:

/secure passphrase xxxxxxxxxx
/secure set freenode_username username
/secure set freenode_password xxxxxxxx
/set irc.server.freenode.sasl_username "${sec.data.freenode_username}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"

8.5. Chcę się podzielić moją konfiguracją WeeChat, które pliki powinienem pokazać, a które nie?

Możesz pokazywać pliki z ~/.weechat/*.conf poza plikiem sec.conf, który zawiera Twoje hasla zaszywrowane Twoim kluczem.

Niektóre pliki jak irc.conf mogą zawierać wrażliwe dane jak hasła do serwerów/kanałów (jeśli nie zostały dodane do sec.conf za pomocą komendy /secure).

Przejrzyj Poradnik użytkownika / Pliki i foldery, gdzie znajdziesz więcej informacji o plikach konfiguracyjnych.

9. Rozwój

9.1. Jak zgłaszać błędy, prosić o nowe możliwości lub wysyłać patche?

9.2. Kiedy uruchamiam WeeChat pod gdb dostaję komunikat o wątkach, co mogę z tym zrobić?

Podczas uruchamiania WeeChat pod gdb, można spotkać się z takim błędem:

$ gdb /scieżka/do/weechat
(gdb) run
[Thread debugging using libthread_db enabled]
Cannot find new threads: generic error

Żeby to naprawić, można użyć takiej komendy(należy zmienić ścieżki do libpthread oraz WeeChat na właściwe dla naszego systemu):

$ LD_PRELOAD=/lib/libpthread.so.0 gdb /ścieżka/do/weechat
(gdb) run

9.3. Jaka jest lista platform wspieranych przez WeeChat? Czy będzie przeportowany na inne systemy operacyjne?

Pełną listę można znaleźć na stronie: https://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.

9.4. 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: https://weechat.org/about/support

Tak możesz dać nam pieniądze, aby wspomóc rozwój. Szczegóły na https://weechat.org/donate