doc: move section "IRC" at top level after "Configuration" (user's guide)

1 files changed, 182 insertions, 182 deletions

diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc
index ae513b0a0..eec091478 100644
--- a/doc/pl/weechat_user.pl.adoc
+++ b/doc/pl/weechat_user.pl.adoc
@@ -235,7 +235,7 @@ Lista popularnych opcji:
   Kompilacja <<scripts_plugins,wtyczki guile>> (Scheme).
 
 | ENABLE_IRC | `ON`, `OFF` | ON |
-  Kompilacja <<irc_plugin,wtyczki IRC>>.
+  Kompilacja <<irc,wtyczki IRC>>.
 
 | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF |
   Kompilacja <<scripts_plugins,wtyczki javascript>>.
@@ -2809,167 +2809,8 @@ Opcje:
 
 include::includes/autogen_user_options.pl.adoc[tag=weechat_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]
-
-[[irc_plugin]]
-=== IRC
+[[irc]]
+== IRC
 
 Wtyczka IRC jest zaprojektowana do prowadzenia rozmów z innymi osobami przez
 protokół IRC.
@@ -2979,7 +2820,7 @@ rozmowami DCC i transferami plików (poprzez wtyczkę xfer, zobacz
 <<xfer_plugin,Wtyczka xfer>>).
 
 [[irc_command_line_options]]
-==== Opcje z linii poleceń
+=== Opcje z linii poleceń
 
 Możliwe jest podanie adresu URL do jednego lub wielu serwerów IRC:
 
@@ -2995,10 +2836,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
 ----
 
 [[irc_servers]]
-==== Serwery
+=== Serwery
 
 [[irc_servers_add]]
-===== Dodanie serwera
+==== Dodanie serwera
 
 Domyślnie nie są zdefiniowane żadne serwery. Możesz dodać ich tyle ile chcesz
 za pomocą polecenia <<command_irc_server,/server>>.
@@ -3040,7 +2881,7 @@ uwierzytelnione osoby. W takim przypadku możesz ustawić opóźnienie dla
 komendy: `/set irc.server.libera.command_delay 5`.
 
 [[irc_servers_options]]
-===== Opcje serwerów
+==== Opcje serwerów
 
 Opcje serwerów są nazywane w taki sposób `irc.server.<serwer>.<opcja>`,
 gdzie `<serwer>` to zdefiniowana nazwa serwera, `<opcja>` to nazwa opcji. +
@@ -3106,14 +2947,14 @@ zrobić za pomocą:
 ----
 
 Następnie możesz zresetować opcję serwera do jej domyślnej (dziedziczonej)
-wartości, która teraz ma wartość `on` zamiast domyślnego `off`: 
+wartości, która teraz ma wartość `on` zamiast domyślnego `off`:
 
 ----
 /unset irc.server.libera.autoconnect
 ----
 
 [[irc_ssl_certificates]]
-===== Certyfikaty SSL
+==== Certyfikaty SSL
 
 Podczas łączenia się z serwerem IRC, WeeChat domyślnie sprawdza czy połączenie
 jest w pełni zaufane.
@@ -3141,7 +2982,7 @@ Opcja "ssl_verify" jest domyślnie włączona, weryfikacja jest restrykcyjna i m
 się nie powieść, nawet jeśli wszystko było OK w wersjach przed 0.3.1.
 
 [[irc_connect_oftc_with_certificate]]
-====== Pierwszy przykład: połączenie z oftc i sprawdzenie certyfikatu
+===== Pierwszy przykład: połączenie z oftc i sprawdzenie certyfikatu
 
 * Import certyfikatu w kosoli:
 
@@ -3164,7 +3005,7 @@ Możliwe jest umieszczenie wielu certyfikatów w pliku CAs.pem.
 ----
 
 [[irc_connect_oftc_with_certfp]]
-====== Drugi przykład: połączenie z oftc używając CertFP
+===== Drugi przykład: połączenie z oftc używając CertFP
 
 * Tworzenie certyfikatu w konsoli:
 
@@ -3189,7 +3030,7 @@ który może być ustawiony na przykład na `~/.weechat`.
 Więcej informacji można znaleźć pod adresem: https://www.oftc.net/NickServ/CertFP
 
 [[irc_sasl_authentication]]
-===== Uwierzytelnianie SASL
+==== Uwierzytelnianie SASL
 
 WeeChat wspiera uwierzytelnianie SASL, używając różnych mechanizmów:
 
@@ -3211,7 +3052,7 @@ Opcje dla serwerów to:
   _ecdsa-nist256p-challenge_)
 
 [[irc_sasl_ecdsa_nist256p_challenge]]
-====== SASL ECDSA-NIST256P-CHALLENGE
+===== SASL ECDSA-NIST256P-CHALLENGE
 
 Musisz wygenerować klucz prywatny w celu uwierzytelnienia za pomocą mechanizmu
 ECDSA-NIST256P-CHALLENGE (hasło nie potrzebne do połączenia).
@@ -3257,7 +3098,7 @@ Ponowne połączenie z serwerem:
 ----
 
 [[irc_servers_connection]]
-===== Łączenie się z serwerem
+==== Łączenie się z serwerem
 
 Możesz połączyć się z serwerem za pomocą komendy <<command_irc_connect,/connect>>:
 
@@ -3288,7 +3129,7 @@ oddzielnych buforów dla serwerów:
 ----
 
 [[irc_tor_sasl]]
-===== Połączenie za pomocą TORa i SASL
+==== Połączenie za pomocą TORa i SASL
 
 Niekróre serwery wspierają połączenia z sieci TOR (https://www.torproject.org/),
 sieci wirtualnych tuneli, które umożliwają poprawienie swojej prywatności
@@ -3337,7 +3178,7 @@ Teraz pozostaje już się tylko połączyć z serwerem:
 ----
 
 [[irc_channels]]
-==== Kanały
+=== Kanały
 
 Możesz dołączać do kanałów za pomocą komendy <<command_irc_join,/join>>:
 
@@ -3353,7 +3194,7 @@ Wyjście z kanału (zostawiając otwarty bufor):
 
 Kanały do których dołączyłeś nie są zapisywane. Jeśli chcesz automatycznie
 do nich dołączać podczas łączenia się z serwerem, należy ustawić opcje
-serwera `autojoin`: 
+serwera `autojoin`:
 
 ----
 /set irc.server.libera.autojoin "#weechat"
@@ -3374,7 +3215,7 @@ nie:
 Informacje na temat formatu można uzyskać za pomocą `/help irc.server.libera.autojoin`.
 
 [[irc_private_messages]]
-==== Prywatne wiadomości
+=== Prywatne wiadomości
 
 Możesz wysłać prywatną wiadomość za pomocą polecenia <<command_irc_query,/query>>,
 co otwiera oddzielny bufor:
@@ -3397,7 +3238,7 @@ W celu zamknięcia prywatnego buforu możesz wykonać to polecenie w prywatnym b
 ----
 
 [[irc_smart_filter_join_part_quit]]
-==== Inteligentne filtry dla wiadomości
+=== Inteligentne filtry dla wiadomości
 
 Inteligentny filtr umożliwia filtrowanie informacji o wejściu/opuszczeniu/wyjściu
 z kanału, kiedy dany nick nie powiedział nic na kanale w ciągu ostatnich X minut.
@@ -3434,7 +3275,7 @@ Jeśli osoba nie odzywała się w ciągu ostatnich 5 minut, jej wejście i/lub
 opuszczenie/wyjście zostanie ukryte na kanale.
 
 [[irc_ctcp_replies]]
-==== Odpowiedzi CTCP
+=== Odpowiedzi CTCP
 
 Możliwe jest dostosowywanie odpowiedzi CTCP, lub blokowanie niektórych zapytań
 CTCP (brak odpowiedzi).
@@ -3510,7 +3351,7 @@ Jeśli opcje CTCP nie są zdefiniowane (domyślne), odpowiedzi CTCP to:
 |===
 
 [[irc_target_buffer]]
-==== Bufor dla wiadomości IRC
+=== Bufor dla wiadomości IRC
 
 Jest możliwe dostosowanie buforu docelowego dla wiadomości IRC (bufor użyty do
 wyświetlania wiadomości) za pomocą opcji `+irc.msgbuffer.*+`.
@@ -3642,12 +3483,12 @@ Kilka przykładów:
 ----
 
 [[irc_commands]]
-==== Komendy
+=== Komendy
 
 include::includes/autogen_user_commands.pl.adoc[tag=irc_commands]
 
 [[irc_options]]
-==== Opcje
+=== Opcje
 
 Sekcje w pliku _irc.conf_:
 
@@ -3669,6 +3510,165 @@ 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]
+
 [[logger_plugin]]
 === Logger