diff options
Diffstat (limited to 'doc/pl/weechat_user.pl.adoc')
| -rw-r--r-- | doc/pl/weechat_user.pl.adoc | 344 |
1 files changed, 172 insertions, 172 deletions
diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index c4fd26d70..0350d21c2 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -268,7 +268,7 @@ Lista popularnych opcji: Kompilacja <<scripts_plugins,wtyczki Python>> z użyciem Pythona 2 zamiast Pythona 3. | ENABLE_RELAY | `ON`, `OFF` | ON | - Kompilacja <<relay_plugin,wtyczki relay>>. + Kompilacja <<relay,wtyczki relay>>. | ENABLE_RUBY | `ON`, `OFF` | ON | Kompilacja <<scripts_plugins,wtyczki ruby>>. @@ -3673,167 +3673,8 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=irc_options] -[[plugins]] -== Wtyczki - -Wtyczka jest biblioteka dynamiczną, napisaną w C i skompilowaną, która jest -ładowana przez WeeChat. -W systemach GNU/Linux plik ma rozszerzenie ".so", w Windowsie ".dll". - -Znalezione wtyczki są automatycznie ładowane podczas uruchamiania WeeChat, -możliwe jest również ładowanie lub wyładowywanie wtyczek podczas pracy WeeChat. - -Ważne jest, aby odróżniać _wtyczkę_ od _skryptu_: _wtyczka_ jest to plik binarny -skompilowany i ładowany za pomocą polecenia `/plugin`, natomiast _skrypt_ to -plik tekstowy, ładowany za pomocą wtyczki jak na przykład _python_ za pomocą -polecenia `/python`. - -Możesz użyć komendy `/plugin` żeby załadować/wyładować wtyczkę, lub wyświetlić -wszystkie załadowane wtyczki. - -Podcza wyładowywania wtyczki WeeChat usówa: - -* bufory -* opcje konfiguracyjne (options są zapisywane w plikach) -* wszystkie hooki: komendy, modyfikatory, procesy, etc. -* infos i infolists -* hdata -* elementy pasków. - -Przykłady ładowania, wyładowywania i wyświetlania załadowanych wtyczek: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Domyślne wtyczki: - -[width="100%",cols="1,5",options="header"] -|=== -| Wtyczka | Opis -| alias | Definiuje aliasy dla komend. -| buflist | Element paska z listą buforów. -| charset | Ustawianie kodowania dla buforów. -| exec | Wykonuje zewnętrzną komendę z poziomu WeeChat. -| fifo | Kolejka FIFO używana do zdalnego wysyłania poleceń dla WeeChat. -| fset | Szybkie ustawianie opcji WeeChat i wtyczek. -| irc | Protokół IRC. -| logger | Logowanie zawartości buforów do plików. -| relay | Przekazuje dane przez sieć. -| script | Zarządzanie skryptami. -| python | Wsparcie dla skryptów napisanych w Pythonie. -| perl | Wsparcie dla skryptów napisanych w Perlu. -| ruby | Wsparcie dla skryptów napisanych w Ruby. -| lua | Wsparcie dla skryptów napisanych w Lua. -| tcl | Wsparcie dla skryptów napisanych w Tcl. -| guile | Wsparcie dla skryptów napisanych w Guile (scheme). -| javascript | Wsparcie dla skryptów napisanych w JavaScript. -| php | Wsparcie dla skryptów napisanych w PHP. -| spell | Sprawdzanie pisowni w linii poleceń. -| trigger | Zamiana tekstu i wykonywanie komend dla zdarzeń wywołanych przez WeeChat/wtyczki. -| typing | Pokazuje użytkowników obecnie piszących wiadomości. -| xfer | Przesyłanie plików i bezpośredni chat. -|=== - -Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleźć w -link:weechat_plugin_api.en.html[Opisie API wtyczek] (Angielski) i -link:weechat_scripting.pl.html[Poradniku pisania skryptów]. - -[[exec_plugin]] -=== Exec - -Komenda `/exec` pozwala wykonać zewnętrzne polecenie wewnątrz WeeChat i wyświetlić -jej wynik lokalnie lub wysłać do bufora. - -[[exec_commands]] -==== Komendy - -include::includes/autogen_user_commands.pl.adoc[tag=exec_commands] - -[[exec_options]] -==== Opcje - -Sekcje w pliku _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| command | /set exec.command.* | Opcje dla komend. -| color | /set exec.color.* | Kolory. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Możesz zdalnie kontrolować WeeChat, poprzez wysyłanie komend lub tekstu do -kolejki FIFO (jeśli opcja "fifo.file.enabled" jest włączona, domyślnie jest -włączona). - -Strumień FIFO jest zlokalizowany w katalogu uruchomieniowym WeeChat i ma -domyślnie nazwę weechat_fifo_12345_ (gdzie _12345_ to numer procesu WeeChat). - -Składnia dla komend/tekstu przekazywanego do kolejki FIFO wygląda następująco: - -.... - wtyczka.bufor *tekst lub komenda - *tekst lub komenda -.... - -Kilka przykładów: - -* Zmiana nicka na serwerze IRC libera na "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Wysłanie wiadomości na kanał IRC #weechat: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Wysłanie wiadomości do obecnego bufora: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Wysłanie dwóch komend do wyładowania/przeładowania skryptów Python (należy - oddzielić je za pomocą "\n"): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Komendy - -include::includes/autogen_user_commands.pl.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Opcje - -Sekcje w pliku _fifo.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| plik | /set fifo.file.* | Kontrola kolejki FIFO. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=fifo_options] - -[[relay_plugin]] -=== Relay +[[relay]] +== Relay Wtyczka relay jest używana do przekazywania danych przez sieć, z użyciem różnych protokołów: @@ -3849,7 +3690,7 @@ protokołów: ** WeeCloud (JavaScript): https://github.com/eirikb/weecloud [[relay_password]] -==== Hasło +=== Hasło Zaleca się ustawenia hasła dla pośrednika za pomocą poniższych komend: @@ -3861,7 +3702,7 @@ Zaleca się ustawenia hasła dla pośrednika za pomocą poniższych komend: Hasło to używane jest przez protokoły _irc_ i _weechat_. [[relay_totp]] -==== TOTP +=== TOTP TOTP (Time-based One-Time Password) może zostać użyte jako drugi stopień uwierzytelnienia dla protokołu _weechat_, poza normalnym hasłem. @@ -3890,7 +3731,7 @@ na przykład: ---- [[relay_ssl]] -==== SSL +=== SSL Możesz używać SSL poprzez utworzenie certyfikatu i klucza prywatnego, oraz użycie prefiksu "ssl." w nazwie protokołu. @@ -3918,7 +3759,7 @@ za pomocą polecenia: ---- [[relay_irc_proxy]] -==== IRC proxy +=== IRC proxy Wtyczka relay może zachowywać się jak proxy dla IRC: będzie symulować serwer IRC, możesz się połączyć do niego za pomocą dowolnego klienta IRC (w tym WeeChat). @@ -3959,12 +3800,12 @@ za pomocą tych komend: ---- [[relay_weechat_protocol]] -==== Protokół WeeChat +=== Protokół WeeChat Wtyczka relay może wysyłać dane do zdalnego interfejsu korzystając z protokołu WeeChat. -Możesz połączyć się zdalnym inrerfejsem, listę znajdziesz w <<relay_plugin>>. +Możesz połączyć się zdalnym inrerfejsem, listę znajdziesz w <<relay>>. [IMPORTANT] WeeChat NIE MOŻE się połączyć z innym WeeChat za pomocą tego protokołu. @@ -3979,7 +3820,7 @@ Teraz możesz się połączyć zdalnym interfejsem na porcie 9000 za pomocą has "moje_hasło". [[relay_websocket]] -==== WebSocket +=== WebSocket Protokół WebSocket (https://tools.ietf.org/html/rfc6455[RFC 6455]) jest wspierany dla wszystkich protokołów. @@ -4000,7 +3841,7 @@ Port (9000 w przykładzie) to port zdefiniowany we wtyczce relay. Adres URL musi się zawsze kończyć "/weechat" (dla protokołów _irc_ i _weechat_). [[relay_unix_socket]] -==== Sockety UNIXowe +=== Sockety UNIXowe Używając opcji protokołu "unix" razem z komendą `/relay`, można nasłuchiwać dowolnego protokołu za pomocą socketu UNIXowego w podanej ścieżce. Na przykład: @@ -4023,12 +3864,12 @@ Przekerowuje to połączenia lokalnych klientów łączących się na port 9000 WeeChat uruchomionej na "hostname". [[relay_commands]] -==== Komendy +=== Komendy include::includes/autogen_user_commands.pl.adoc[tag=relay_commands] [[relay_options]] -==== Opcje +=== Opcje Sekcje w pliku _relay.conf_: @@ -4047,6 +3888,165 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=relay_options] +[[plugins]] +== Wtyczki + +Wtyczka jest biblioteka dynamiczną, napisaną w C i skompilowaną, która jest +ładowana przez WeeChat. +W systemach GNU/Linux plik ma rozszerzenie ".so", w Windowsie ".dll". + +Znalezione wtyczki są automatycznie ładowane podczas uruchamiania WeeChat, +możliwe jest również ładowanie lub wyładowywanie wtyczek podczas pracy WeeChat. + +Ważne jest, aby odróżniać _wtyczkę_ od _skryptu_: _wtyczka_ jest to plik binarny +skompilowany i ładowany za pomocą polecenia `/plugin`, natomiast _skrypt_ to +plik tekstowy, ładowany za pomocą wtyczki jak na przykład _python_ za pomocą +polecenia `/python`. + +Możesz użyć komendy `/plugin` żeby załadować/wyładować wtyczkę, lub wyświetlić +wszystkie załadowane wtyczki. + +Podcza wyładowywania wtyczki WeeChat usówa: + +* bufory +* opcje konfiguracyjne (options są zapisywane w plikach) +* wszystkie hooki: komendy, modyfikatory, procesy, etc. +* infos i infolists +* hdata +* elementy pasków. + +Przykłady ładowania, wyładowywania i wyświetlania załadowanych wtyczek: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Domyślne wtyczki: + +[width="100%",cols="1,5",options="header"] +|=== +| Wtyczka | Opis +| alias | Definiuje aliasy dla komend. +| buflist | Element paska z listą buforów. +| charset | Ustawianie kodowania dla buforów. +| exec | Wykonuje zewnętrzną komendę z poziomu WeeChat. +| fifo | Kolejka FIFO używana do zdalnego wysyłania poleceń dla WeeChat. +| fset | Szybkie ustawianie opcji WeeChat i wtyczek. +| irc | Protokół IRC. +| logger | Logowanie zawartości buforów do plików. +| relay | Przekazuje dane przez sieć. +| script | Zarządzanie skryptami. +| python | Wsparcie dla skryptów napisanych w Pythonie. +| perl | Wsparcie dla skryptów napisanych w Perlu. +| ruby | Wsparcie dla skryptów napisanych w Ruby. +| lua | Wsparcie dla skryptów napisanych w Lua. +| tcl | Wsparcie dla skryptów napisanych w Tcl. +| guile | Wsparcie dla skryptów napisanych w Guile (scheme). +| javascript | Wsparcie dla skryptów napisanych w JavaScript. +| php | Wsparcie dla skryptów napisanych w PHP. +| spell | Sprawdzanie pisowni w linii poleceń. +| trigger | Zamiana tekstu i wykonywanie komend dla zdarzeń wywołanych przez WeeChat/wtyczki. +| typing | Pokazuje użytkowników obecnie piszących wiadomości. +| xfer | Przesyłanie plików i bezpośredni chat. +|=== + +Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleźć w +link:weechat_plugin_api.en.html[Opisie API wtyczek] (Angielski) i +link:weechat_scripting.pl.html[Poradniku pisania skryptów]. + +[[exec_plugin]] +=== Exec + +Komenda `/exec` pozwala wykonać zewnętrzne polecenie wewnątrz WeeChat i wyświetlić +jej wynik lokalnie lub wysłać do bufora. + +[[exec_commands]] +==== Komendy + +include::includes/autogen_user_commands.pl.adoc[tag=exec_commands] + +[[exec_options]] +==== Opcje + +Sekcje w pliku _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| command | /set exec.command.* | Opcje dla komend. +| color | /set exec.color.* | Kolory. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Możesz zdalnie kontrolować WeeChat, poprzez wysyłanie komend lub tekstu do +kolejki FIFO (jeśli opcja "fifo.file.enabled" jest włączona, domyślnie jest +włączona). + +Strumień FIFO jest zlokalizowany w katalogu uruchomieniowym WeeChat i ma +domyślnie nazwę weechat_fifo_12345_ (gdzie _12345_ to numer procesu WeeChat). + +Składnia dla komend/tekstu przekazywanego do kolejki FIFO wygląda następująco: + +.... + wtyczka.bufor *tekst lub komenda + *tekst lub komenda +.... + +Kilka przykładów: + +* Zmiana nicka na serwerze IRC libera na "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Wysłanie wiadomości na kanał IRC #weechat: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Wysłanie wiadomości do obecnego bufora: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Wysłanie dwóch komend do wyładowania/przeładowania skryptów Python (należy + oddzielić je za pomocą "\n"): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Komendy + +include::includes/autogen_user_commands.pl.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Opcje + +Sekcje w pliku _fifo.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| plik | /set fifo.file.* | Kontrola kolejki FIFO. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=fifo_options] + [[scripts_plugins]] === Skryptowe |