doc/user: move IRCv3 chapter outside "Servers"

1 files changed, 168 insertions, 168 deletions

diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc
index acd6d5e10..ad578e307 100644
--- a/doc/pl/weechat_user.pl.adoc
+++ b/doc/pl/weechat_user.pl.adoc
@@ -3433,8 +3433,156 @@ który może być ustawiony na przykład na `~/.weechat`.
 Więcej informacji można znaleźć odwiedzając
 https://www.oftc.net/NickServ/CertFP/[tą stronę ^↗^,window=_blank].
 
+[[irc_sasl_authentication]]
+==== Uwierzytelnianie SASL
+
+WeeChat wspiera uwierzytelnianie SASL, używając różnych mechanizmów:
+
+* _plain_: hasło w czystym tekście (domyślne)
+* _scram-sha-1_: SCRAM z użyciem algorytmu SHA-1
+* _scram-sha-256_: SCRAM z użyciem algorytmu SHA-256
+* _scram-sha-512_: SCRAM z użyciem algorytmu SHA-512
+* _ecdsa-nist256p-challenge_: klucz prywatny/publiczny
+* _external_: certyfikat TLS po stronie klienta
+
+Opcje dla serwerów to:
+
+* _sasl_mechanism_: mechanizm do użycia (zobacz wyżej)
+* _sasl_timeout_: limit czasu (w sekundach) na uwierzytelnienie
+* _sasl_fail_: akcja wykonywana jeśli uwierzytelnienie się nie powiedzie
+* _sasl_username_: nazwa użytkownika (nick)
+* _sasl_password_: hasło
+* _sasl_key_: plik z kluczem prywatnym ECc (dla mechanizmu
+  _ecdsa-nist256p-challenge_)
+
+[[irc_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).
+
+Klucz można wygenerować za pomocą komendy:
+
+----
+$ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
+----
+
+[NOTE]
+Musisz zamienić `~/.config/weechat` na ścieżkę do katalogu z konfiguracją WeeChat,
+który może być ustawiony na przykład na `~/.weechat`.
+
+Klucz publiczny (zakodowany za pomocą base64) uzyskujemy wywołując komendę:
+
+----
+$ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
+----
+
+Połącz się do serwera, zidentyfikuj (na przykład za pomocą "nickserv identify")
+i ustaw swój klucz publiczny dla swojego konta, za pomocą nickserva (zamień
+wartość base64 wartościa dla swojego klucza):
+
+----
+/connect libera
+/msg nickserv identify your_password
+/msg nickserv set pubkey Av8k1FOGetUDq7sPMBfufSIZ5c2I/QYWgiwHtNXkVe/q
+----
+
+Konfiguracja opcji SASL dla serwera:
+
+----
+/set irc.server.libera.sasl_mechanism ecdsa-nist256p-challenge
+/set irc.server.libera.sasl_username "twój_nick"
+/set irc.server.libera.sasl_key "${weechat_config_dir}/ecdsa.pem"
+----
+
+Ponowne połączenie z serwerem:
+
+----
+/reconnect libera
+----
+
+[[irc_servers_connection]]
+==== Łączenie się z serwerem
+
+Możesz połączyć się z serwerem za pomocą komendy <<command_irc_connect,/connect>>:
+
+----
+/connect libera
+----
+
+Aby się rozłączyć:
+
+----
+/disconnect libera
+----
+
+Lub tylko to jeśli jesteś w buforze należącym do serwera _libera_ (serwer,
+kanał, wiadomości prywatne):
+
+----
+/disconnect
+----
+
+Jeśli łączysz się do wielu serwerów na raz, bufory serwerów są domyślnie połączone
+i możesz się między nimi przełączać za pomocą klawiszy kbd:[Ctrl+x]. +
+Możliwe jest wyłączenie automatycznego łączenia buforów serwerów i posiadania
+oddzielnych buforów dla serwerów:
+
+----
+/set irc.look.server_buffer independent
+----
+
+[[irc_tor_sasl]]
+==== Połączenie za pomocą Tora i SASL
+
+Niekróre serwery wspierają połączenia z sieci https://www.torproject.org/[Tor ^↗^,window=_blank],
+sieci wirtualnych tuneli, które umożliwają poprawienie swojej prywatności
+i bezpieczeństwa w Internecie.
+
+Pierwszym krokiem jest instalacja Tora. Dla Debiana (i pochodnych):
+
+----
+$ sudo apt-get install tor
+----
+
+W WeeChat należy stworzyć proxy socks5 dla serwisu Tor (nazwa hosta/IP i port
+zależą od twojej konfiguracji Tora):
+
+----
+/proxy add tor socks5 127.0.0.1 9050
+----
+
+Teraz należy dodać nowy serwer (zastąp nazwę serwera "irc-tor" i andres właściwymi
+wartościami):
+
+----
+/server add irc-tor adres.serwera.onion
+----
+
+Ustaw proxy dla Tor:
+
+----
+/set irc.server.irc-tor.proxy "tor"
+----
+
+Ustaw uwierzytelnianie SASL z użyciem ECDSA-NIST256P-CHALLENGE (zobacz rozdział
+<<irc_sasl_ecdsa_nist256p_challenge,SASL ECDSA-NIST256P-CHALLENGE>> żeby dowiedzieć
+się jak wygenerować klucz prywatny):
+
+----
+/set irc.server.irc-tor.sasl_mechanism ecdsa-nist256p-challenge
+/set irc.server.irc-tor.sasl_username "twój_użytkownik"
+/set irc.server.irc-tor.sasl_key "${weechat_config_dir}/ecdsa.pem"
+----
+
+Teraz pozostaje już się tylko połączyć z serwerem:
+
+----
+/connect irc-tor
+----
+
 [[irc_ircv3_support]]
-==== Wsparcie dla IRCv3
+=== Wsparcie dla IRCv3
 
 WeeChat wspiera następujące https://ircv3.net/irc/[rozszerzenia IRCv3 ^↗^,window=_blank]:
 
@@ -3466,7 +3614,7 @@ Tabele z porównaniem różnych klientów IRC, także WeeChat, można znaleźć
 https://ircv3.net/software/clients[tej stronie ^↗^,window=_blank].
 
 [[irc_ircv3_account_notify]]
-===== account-notify
+==== account-notify
 
 Specyfikacja: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
 
@@ -3485,7 +3633,7 @@ Przykłady:
 ....
 
 [[irc_ircv3_account_tag]]
-===== account-tag
+==== account-tag
 
 Specyfikacja: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
 
@@ -3514,7 +3662,7 @@ Wiadomość z tagami:
 ....
 
 [[irc_ircv3_away_notify]]
-===== away-notify
+==== away-notify
 
 Specyfikacja: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
 
@@ -3530,7 +3678,7 @@ konkretnym kolorze na liście nicków, za pomocą następujących opcji:
 
 // TRANSLATION MISSING
 [[irc_ircv3_batch]]
-===== batch
+==== batch
 
 Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
 
@@ -3541,7 +3689,7 @@ For now, WeeChat only stores messages received in a batch and processes as usual
 later, when the batch ends.
 
 [[irc_ircv3_cap_notify]]
-===== cap-notify
+==== cap-notify
 
 Specyfikacja: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
 
@@ -3557,7 +3705,7 @@ Przykłady:
 ....
 
 [[irc_ircv3_chghost]]
-===== chghost
+==== chghost
 
 Specyfikacja: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
 
@@ -3576,7 +3724,7 @@ Przykłady:
 
 // TRANSLATION MISSING
 [[irc_ircv3_draft_multiline]]
-===== draft/multiline
+==== draft/multiline
 
 Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
 
@@ -3630,7 +3778,7 @@ Display of the message sent in WeeChat:
 
 // TRANSLATION MISSING
 [[irc_ircv3_echo_message]]
-===== echo-message
+==== echo-message
 
 Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
 
@@ -3643,7 +3791,7 @@ it means it has been properly received by the server and propagated to other
 clients connected to the server as well.
 
 [[irc_ircv3_extended_join]]
-===== extended-join
+==== extended-join
 
 Specyfikacja: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
 
@@ -3660,7 +3808,7 @@ Przykład:
 ....
 
 [[irc_ircv3_invite_notify]]
-===== invite-notify
+==== invite-notify
 
 Specyfikacja: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
 
@@ -3674,7 +3822,7 @@ Przykłady:
 ....
 
 [[irc_ircv3_message_tags]]
-===== message-tags
+==== message-tags
 
 Specyfikacja: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
 
@@ -3684,7 +3832,7 @@ Tagi te mogą być wyświetlone za pomocą komendy `/debug tags`.
 Musi to być włączone, żeby używać <<typing_notifications,powiadomień o pisaniu>>.
 
 [[irc_ircv3_monitor]]
-===== monitor
+==== monitor
 
 Specyfikacja: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
 
@@ -3694,7 +3842,7 @@ WeeChat automatycznie użyje tego rozszerzenia jeśli jest dostępne podczas
 użycia komendy <<command_irc_notify,/notify>>.
 
 [[irc_ircv3_multi_prefix]]
-===== multi-prefix
+==== multi-prefix
 
 Specyfikacja: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
 
@@ -3720,14 +3868,14 @@ Przykład: wynik `/whois alice`:
 ....
 
 [[irc_ircv3_sasl]]
-===== SASL
+==== SASL
 
 Specyfikacja: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
 
 Zobacz dedykowany rozdział <<irc_sasl_authentication,autentykacja SASL>>.
 
 [[irc_ircv3_server_time]]
-===== server-time
+==== server-time
 
 Specyfikacja: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
 
@@ -3740,7 +3888,7 @@ każdy klient IRC połączony z Relay powinien włączyć tą właściwość je�
 chce wyświetlać prawdziwi czas wysłania wiadomości.
 
 [[irc_ircv3_setname]]
-===== setname
+==== setname
 
 Specyfikacja: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
 
@@ -3748,14 +3896,14 @@ Ta właściwość pozwala zmienić prawdziwą nazwę za pomocą komendy
 <<command_irc_setname,/setname>>.
 
 [[irc_ircv3_typing]]
-===== typing
+==== typing
 
 Specyfikacja: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
 
 Zobacz dedykowany rozdział <<typing_notifications,Powiadomienia o pisaniu>>.
 
 [[irc_ircv3_userhost_in_names]]
-===== userhost-in-names
+==== userhost-in-names
 
 Specyfikacja: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
 
@@ -3778,7 +3926,7 @@ Przykład nieprzetworzonych wiadomości IRC z tą właściwością:
 ....
 
 [[irc_ircv3_whox]]
-===== WHOX
+==== WHOX
 
 Specyfikacja: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
 
@@ -3787,154 +3935,6 @@ Ta właściwość pozwala na zarządanie dodatkowych pól w odpowiedzi na WHO
 WeeChat wyświetla wszystkie dodatkowe informacje otrzymane w odpowiedzi
 na WHO.
 
-[[irc_sasl_authentication]]
-==== Uwierzytelnianie SASL
-
-WeeChat wspiera uwierzytelnianie SASL, używając różnych mechanizmów:
-
-* _plain_: hasło w czystym tekście (domyślne)
-* _scram-sha-1_: SCRAM z użyciem algorytmu SHA-1
-* _scram-sha-256_: SCRAM z użyciem algorytmu SHA-256
-* _scram-sha-512_: SCRAM z użyciem algorytmu SHA-512
-* _ecdsa-nist256p-challenge_: klucz prywatny/publiczny
-* _external_: certyfikat TLS po stronie klienta
-
-Opcje dla serwerów to:
-
-* _sasl_mechanism_: mechanizm do użycia (zobacz wyżej)
-* _sasl_timeout_: limit czasu (w sekundach) na uwierzytelnienie
-* _sasl_fail_: akcja wykonywana jeśli uwierzytelnienie się nie powiedzie
-* _sasl_username_: nazwa użytkownika (nick)
-* _sasl_password_: hasło
-* _sasl_key_: plik z kluczem prywatnym ECc (dla mechanizmu
-  _ecdsa-nist256p-challenge_)
-
-[[irc_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).
-
-Klucz można wygenerować za pomocą komendy:
-
-----
-$ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
-----
-
-[NOTE]
-Musisz zamienić `~/.config/weechat` na ścieżkę do katalogu z konfiguracją WeeChat,
-który może być ustawiony na przykład na `~/.weechat`.
-
-Klucz publiczny (zakodowany za pomocą base64) uzyskujemy wywołując komendę:
-
-----
-$ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
-----
-
-Połącz się do serwera, zidentyfikuj (na przykład za pomocą "nickserv identify")
-i ustaw swój klucz publiczny dla swojego konta, za pomocą nickserva (zamień
-wartość base64 wartościa dla swojego klucza):
-
-----
-/connect libera
-/msg nickserv identify your_password
-/msg nickserv set pubkey Av8k1FOGetUDq7sPMBfufSIZ5c2I/QYWgiwHtNXkVe/q
-----
-
-Konfiguracja opcji SASL dla serwera:
-
-----
-/set irc.server.libera.sasl_mechanism ecdsa-nist256p-challenge
-/set irc.server.libera.sasl_username "twój_nick"
-/set irc.server.libera.sasl_key "${weechat_config_dir}/ecdsa.pem"
-----
-
-Ponowne połączenie z serwerem:
-
-----
-/reconnect libera
-----
-
-[[irc_servers_connection]]
-==== Łączenie się z serwerem
-
-Możesz połączyć się z serwerem za pomocą komendy <<command_irc_connect,/connect>>:
-
-----
-/connect libera
-----
-
-Aby się rozłączyć:
-
-----
-/disconnect libera
-----
-
-Lub tylko to jeśli jesteś w buforze należącym do serwera _libera_ (serwer,
-kanał, wiadomości prywatne):
-
-----
-/disconnect
-----
-
-Jeśli łączysz się do wielu serwerów na raz, bufory serwerów są domyślnie połączone
-i możesz się między nimi przełączać za pomocą klawiszy kbd:[Ctrl+x]. +
-Możliwe jest wyłączenie automatycznego łączenia buforów serwerów i posiadania
-oddzielnych buforów dla serwerów:
-
-----
-/set irc.look.server_buffer independent
-----
-
-[[irc_tor_sasl]]
-==== Połączenie za pomocą Tora i SASL
-
-Niekróre serwery wspierają połączenia z sieci https://www.torproject.org/[Tor ^↗^,window=_blank],
-sieci wirtualnych tuneli, które umożliwają poprawienie swojej prywatności
-i bezpieczeństwa w Internecie.
-
-Pierwszym krokiem jest instalacja Tora. Dla Debiana (i pochodnych):
-
-----
-$ sudo apt-get install tor
-----
-
-W WeeChat należy stworzyć proxy socks5 dla serwisu Tor (nazwa hosta/IP i port
-zależą od twojej konfiguracji Tora):
-
-----
-/proxy add tor socks5 127.0.0.1 9050
-----
-
-Teraz należy dodać nowy serwer (zastąp nazwę serwera "irc-tor" i andres właściwymi
-wartościami):
-
-----
-/server add irc-tor adres.serwera.onion
-----
-
-Ustaw proxy dla Tor:
-
-----
-/set irc.server.irc-tor.proxy "tor"
-----
-
-Ustaw uwierzytelnianie SASL z użyciem ECDSA-NIST256P-CHALLENGE (zobacz rozdział
-<<irc_sasl_ecdsa_nist256p_challenge,SASL ECDSA-NIST256P-CHALLENGE>> żeby dowiedzieć
-się jak wygenerować klucz prywatny):
-
-----
-/set irc.server.irc-tor.sasl_mechanism ecdsa-nist256p-challenge
-/set irc.server.irc-tor.sasl_username "twój_użytkownik"
-/set irc.server.irc-tor.sasl_key "${weechat_config_dir}/ecdsa.pem"
-----
-
-Teraz pozostaje już się tylko połączyć z serwerem:
-
-----
-/connect irc-tor
-----
-
 [[irc_channels]]
 === Kanały