diff options
author | Sébastien Helleu <flashcode@flashtux.org> | 2022-06-25 08:53:18 +0200 |
---|---|---|
committer | Sébastien Helleu <flashcode@flashtux.org> | 2022-06-25 08:53:18 +0200 |
commit | 42a0a19828e223fd3ec3ed789f8b6a80e9cd8215 (patch) | |
tree | d73112d0a074470398c48ff5c296fb708eb70dbb /doc | |
parent | 8788fcedc834c0fb53ed5565dca86f4e7618f43f (diff) | |
download | weechat-42a0a19828e223fd3ec3ed789f8b6a80e9cd8215.zip |
doc/user: add a chapter on supported IRCv3 extensions
Diffstat (limited to 'doc')
-rw-r--r-- | doc/de/weechat_user.de.adoc | 273 | ||||
-rw-r--r-- | doc/en/weechat_user.en.adoc | 272 | ||||
-rw-r--r-- | doc/fr/weechat_user.fr.adoc | 278 | ||||
-rw-r--r-- | doc/it/weechat_user.it.adoc | 273 | ||||
-rw-r--r-- | doc/ja/weechat_user.ja.adoc | 273 | ||||
-rw-r--r-- | doc/pl/weechat_user.pl.adoc | 273 | ||||
-rw-r--r-- | doc/sr/weechat_user.sr.adoc | 273 |
7 files changed, 1907 insertions, 8 deletions
diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index e8a4147ac..0cd764997 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -3386,6 +3386,277 @@ das auch beispielsweise `~/.weechat` sein kann. Für weiterreichende Informationen lesen Sie bitte: https://www.oftc.net/NickServ/CertFP/ +// TRANSLATION MISSING +[[irc_ircv3_support]] +==== IRCv3 support + +WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions]: + +* <<irc_ircv3_account_notify,account-notify>> +* <<irc_ircv3_account_tag,account-tag>> +* <<irc_ircv3_away_notify,away-notify>> +* <<irc_ircv3_cap_notify,cap-notify>> +* <<irc_ircv3_chghost,chghost>> +* <<irc_ircv3_extended_join,extended-join>> +* <<irc_ircv3_invite_notify,invite-notify>> +* <<irc_ircv3_message_tags,message-tags>> +* <<irc_ircv3_monitor,monitor>> +* <<irc_ircv3_multi_prefix,multi-prefix>> +* <<irc_ircv3_sasl,SASL v3.2>> +* <<irc_ircv3_server_time,server-time>> +* <<irc_ircv3_setname,setname>> +* <<irc_ircv3_typing,typing>> +* <<irc_ircv3_userhost_in_names,userhost-in-names>> +* <<irc_ircv3_whox,WHOX>> + +By default all capabilities supported by the server and WeeChat are +automatically enabled +(see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>). + +Tables with comparison of different IRC clients, including WeeChat, are available +on this page: https://ircv3.net/software/clients. + +[[irc_ircv3_account_notify]] +===== account-notify + +Specification: https://ircv3.net/specs/extensions/account-notify + +This capability allows the server to send messages when users identify or +unidentify on the server. + +WeeChat displays such messages if the option +<<option_irc.look.display_account_message,irc.look.display_account_message>> +is enabled (default value). + +Examples: + +.... +-- alice wurde identifiziert als Alice01 + +-- alice hat sich nicht identifiziert +.... + +[[irc_ircv3_account_tag]] +===== account-tag + +Specification: https://ircv3.net/specs/extensions/account-tag + +This capability allows the server to send account as message tag to commands +sent to the client. + +WeeChat parses this tag and saves it in the message, but it is not used or +displayed. It can be used in <<command_filter,/filter>> command to filter +messages matching specific accounts. + +Example of raw IRC message received: + +.... +@account=Alice01 :user@example.com PRIVMSG #test :Hello! +.... + +Message displayed in channel: + +.... +<alice> Hello! +.... + +Message with tags: + +.... +<alice> Hello! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1] +.... + +[[irc_ircv3_away_notify]] +===== away-notify + +Specification: https://ircv3.net/specs/extensions/away-notify + +This capability allows the server to send away notifications for users present +on the same channels as you. + +When the away status is changed for a user (away or back), this is reflected +with a specific color in the nicklist, using the following options: + +* <<option_irc.server_default.away_check,irc.server_default.away_check>> +* <<option_irc.server_default.away_check_max_nicks,irc.server_default.away_check_max_nicks>> +* <<option_weechat.look.item_away_message,weechat.look.item_away_message>> + +[[irc_ircv3_cap_notify]] +===== cap-notify + +Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand + +This capability allows the server to advertise on new or removed capabilities +on the server (via `CAP NEW` and `CAP DEL` commands). + +Examples: + +.... +-- irc: Clientfähigkeit, nicht verfügbar: sasl + +-- irc: Clientfähigkeit, entfernt: sasl +.... + +[[irc_ircv3_chghost]] +===== chghost + +Specification: https://ircv3.net/specs/extensions/chghost + +This capability allows the server to send messages when users change name or host. + +When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>> +is enabled (default value), the host changes are automatically hidden if the nick +has not spoken for several minutes. + +The color of the change host message is controlled by the option +<<option_irc.color.message_chghost,irc.color.message_chghost>>. + +Example: + +.... +-- alice (user@example.com) hat den Host nach test.com geändert +.... + +[[irc_ircv3_extended_join]] +===== extended-join + +Specification: https://ircv3.net/specs/extensions/extended-join + +This capability allows the server to send account and real name when users +join channels. + +WeeChat displays this additional information in join messages if the option +<<option_irc.look.display_extended_join,irc.look.display_extended_join>> +is enabled (default value). + +Example: + +.... +--> john [John01] (John Doe) (~user@example.com) hat den Kanal #test betreten +.... + +[[irc_ircv3_invite_notify]] +===== invite-notify + +Specification: https://ircv3.net/specs/extensions/invite-notify + +This capability allows the server to send invite messages when users are +invited to channels. + +Example: + +.... +-- alice hat bob in den Kanal #test eingeladen +.... + +[[irc_ircv3_message_tags]] +===== message-tags + +Specification: https://ircv3.net/specs/extensions/message-tags + +This capability allows to add metadata in messages. + +These tags can be displayed using the command `/debug tags`. + +It must be enabled to use <<typing_notifications,typing notifications>>. + +[[irc_ircv3_monitor]] +===== monitor + +Specification: https://ircv3.net/specs/extensions/monitor + +This capability allows the server to send notifications when clients become +online/offline. + +WeeChat automatically uses this extension if available when using the +<<command_irc_notify,/notify>> command. + +[[irc_ircv3_multi_prefix]] +===== multi-prefix + +Specification: https://ircv3.net/specs/extensions/multi-prefix + +This capability allows the server to send all user modes at once in +<<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. + + +//// +Example: output of `/names`: + +.... +-- Nicks #test: [@%+alice bob +carol] +.... +//// + +[NOTE] +For now, WeeChat doesn't display all prefixes in the `/names` output, even if +they are received and properly saved internally. + +Example: output of `/whois alice`: + +.... +-- [alice] @%+#test +.... + +[[irc_ircv3_sasl]] +===== SASL + +Specification: https://ircv3.net/specs/extensions/sasl-3.2 + +See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>. + +[[irc_ircv3_server_time]] +===== server-time + +Specification: https://ircv3.net/specs/extensions/server-time + +This capability allows the server to send time for messages as message tag. + +When the time is received in a message, WeeChat uses it to display the message +(it can then be displayed with a past date). + +The <<relay_irc_proxy,IRC proxy>> in Relay plugin supports this capability, +so any IRC client of Relay should enable it to display the real message time +in the backlog sent upon connection. + +[[irc_ircv3_setname]] +===== setname + +Specification: https://ircv3.net/specs/extensions/setname + +This capability lets you change your real name by using the +<<command_irc_setname,/setname>> command. + +[[irc_ircv3_typing]] +===== typing + +Specification: https://ircv3.net/specs/client-tags/typing + +See the dedicated chapter <<typing_notifications,Typing notifications>>. + +[[irc_ircv3_userhost_in_names]] +===== userhost-in-names + +Specification: https://ircv3.net/specs/extensions/userhost-in-names + +This capability allows the server to send hostnames in <<command_irc_names,/names>> +responses. + +[NOTE] +WeeChat doesn't display hostnames in the `/names` output. + +Example of raw IRC messages received without the capability: + +.... +:irc.server 353 alice = #test :@alice bob +carol +.... + +Example of raw IRC messages received with the capability: + +.... +:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3 +.... + +[[irc_ircv3_whox]] +===== WHOX + +Specification: https://ircv3.net/specs/extensions/whox + +This capability lets you request additional fields in the WHO response +(via the <<command_irc_who,/who>> command). + +WeeChat displays all additional information received in the WHO output. + [[irc_sasl_authentication]] ==== SASL Authentifizierung @@ -3921,7 +4192,7 @@ die "message-tags"-Fähigkeit aktiviert ist (dies kann mit folgendenen Befehl, wie folgt überprüfen werden <<command_irc_cap,/cap>>). + Unter der Haube wird die Eingabe des Client-Tags gemäß dieser Spezifikation verwendet: -https://ircv3.net/specs/client-tags/typing.html. +https://ircv3.net/specs/client-tags/typing. [[typing_activation]] === Aktivierung diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index 277852542..16f41d47d 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -3321,6 +3321,276 @@ which can also be for example `~/.weechat`. For more information, look at https://www.oftc.net/NickServ/CertFP/ +[[irc_ircv3_support]] +==== IRCv3 support + +WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions]: + +* <<irc_ircv3_account_notify,account-notify>> +* <<irc_ircv3_account_tag,account-tag>> +* <<irc_ircv3_away_notify,away-notify>> +* <<irc_ircv3_cap_notify,cap-notify>> +* <<irc_ircv3_chghost,chghost>> +* <<irc_ircv3_extended_join,extended-join>> +* <<irc_ircv3_invite_notify,invite-notify>> +* <<irc_ircv3_message_tags,message-tags>> +* <<irc_ircv3_monitor,monitor>> +* <<irc_ircv3_multi_prefix,multi-prefix>> +* <<irc_ircv3_sasl,SASL v3.2>> +* <<irc_ircv3_server_time,server-time>> +* <<irc_ircv3_setname,setname>> +* <<irc_ircv3_typing,typing>> +* <<irc_ircv3_userhost_in_names,userhost-in-names>> +* <<irc_ircv3_whox,WHOX>> + +By default all capabilities supported by the server and WeeChat are +automatically enabled +(see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>). + +Tables with comparison of different IRC clients, including WeeChat, are available +on this page: https://ircv3.net/software/clients. + +[[irc_ircv3_account_notify]] +===== account-notify + +Specification: https://ircv3.net/specs/extensions/account-notify + +This capability allows the server to send messages when users identify or +unidentify on the server. + +WeeChat displays such messages if the option +<<option_irc.look.display_account_message,irc.look.display_account_message>> +is enabled (default value). + +Examples: + +.... +-- alice has identified as Alice01 + +-- alice has unidentified +.... + +[[irc_ircv3_account_tag]] +===== account-tag + +Specification: https://ircv3.net/specs/extensions/account-tag + +This capability allows the server to send account as message tag to commands +sent to the client. + +WeeChat parses this tag and saves it in the message, but it is not used or +displayed. It can be used in <<command_filter,/filter>> command to filter +messages matching specific accounts. + +Example of raw IRC message received: + +.... +@account=Alice01 :user@example.com PRIVMSG #test :Hello! +.... + +Message displayed in channel: + +.... +<alice> Hello! +.... + +Message with tags: + +.... +<alice> Hello! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1] +.... + +[[irc_ircv3_away_notify]] +===== away-notify + +Specification: https://ircv3.net/specs/extensions/away-notify + +This capability allows the server to send away notifications for users present +on the same channels as you. + +When the away status is changed for a user (away or back), this is reflected +with a specific color in the nicklist, using the following options: + +* <<option_irc.server_default.away_check,irc.server_default.away_check>> +* <<option_irc.server_default.away_check_max_nicks,irc.server_default.away_check_max_nicks>> +* <<option_weechat.look.item_away_message,weechat.look.item_away_message>> + +[[irc_ircv3_cap_notify]] +===== cap-notify + +Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand + +This capability allows the server to advertise on new or removed capabilities +on the server (via `CAP NEW` and `CAP DEL` commands). + +Examples: + +.... +-- irc: client capability, now available: sasl + +-- irc: client capability, removed: sasl +.... + +[[irc_ircv3_chghost]] +===== chghost + +Specification: https://ircv3.net/specs/extensions/chghost + +This capability allows the server to send messages when users change name or host. + +When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>> +is enabled (default value), the host changes are automatically hidden if the nick +has not spoken for several minutes. + +The color of the change host message is controlled by the option +<<option_irc.color.message_chghost,irc.color.message_chghost>>. + +Example: + +.... +-- alice (user@example.com) has changed host to test.com +.... + +[[irc_ircv3_extended_join]] +===== extended-join + +Specification: https://ircv3.net/specs/extensions/extended-join + +This capability allows the server to send account and real name when users +join channels. + +WeeChat displays this additional information in join messages if the option +<<option_irc.look.display_extended_join,irc.look.display_extended_join>> +is enabled (default value). + +Example: + +.... +--> john [John01] (John Doe) (~user@example.com) has joined #test +.... + +[[irc_ircv3_invite_notify]] +===== invite-notify + +Specification: https://ircv3.net/specs/extensions/invite-notify + +This capability allows the server to send invite messages when users are +invited to channels. + +Example: + +.... +-- alice has invited bob to #test +.... + +[[irc_ircv3_message_tags]] +===== message-tags + +Specification: https://ircv3.net/specs/extensions/message-tags + +This capability allows to add metadata in messages. + +These tags can be displayed using the command `/debug tags`. + +It must be enabled to use <<typing_notifications,typing notifications>>. + +[[irc_ircv3_monitor]] +===== monitor + +Specification: https://ircv3.net/specs/extensions/monitor + +This capability allows the server to send notifications when clients become +online/offline. + +WeeChat automatically uses this extension if available when using the +<<command_irc_notify,/notify>> command. + +[[irc_ircv3_multi_prefix]] +===== multi-prefix + +Specification: https://ircv3.net/specs/extensions/multi-prefix + +This capability allows the server to send all user modes at once in +<<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. + + +//// +Example: output of `/names`: + +.... +-- Nicks #test: [@%+alice bob +carol] +.... +//// + +[NOTE] +For now, WeeChat doesn't display all prefixes in the `/names` output, even if +they are received and properly saved internally. + +Example: output of `/whois alice`: + +.... +-- [alice] @%+#test +.... + +[[irc_ircv3_sasl]] +===== SASL + +Specification: https://ircv3.net/specs/extensions/sasl-3.2 + +See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>. + +[[irc_ircv3_server_time]] +===== server-time + +Specification: https://ircv3.net/specs/extensions/server-time + +This capability allows the server to send time for messages as message tag. + +When the time is received in a message, WeeChat uses it to display the message +(it can then be displayed with a past date). + +The <<relay_irc_proxy,IRC proxy>> in Relay plugin supports this capability, +so any IRC client of Relay should enable it to display the real message time +in the backlog sent upon connection. + +[[irc_ircv3_setname]] +===== setname + +Specification: https://ircv3.net/specs/extensions/setname + +This capability lets you change your real name by using the +<<command_irc_setname,/setname>> command. + +[[irc_ircv3_typing]] +===== typing + +Specification: https://ircv3.net/specs/client-tags/typing + +See the dedicated chapter <<typing_notifications,Typing notifications>>. + +[[irc_ircv3_userhost_in_names]] +===== userhost-in-names + +Specification: https://ircv3.net/specs/extensions/userhost-in-names + +This capability allows the server to send hostnames in <<command_irc_names,/names>> +responses. + +[NOTE] +WeeChat doesn't display hostnames in the `/names` output. + +Example of raw IRC messages received without the capability: + +.... +:irc.server 353 alice = #test :@alice bob +carol +.... + +Example of raw IRC messages received with the capability: + +.... +:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3 +.... + +[[irc_ircv3_whox]] +===== WHOX + +Specification: https://ircv3.net/specs/extensions/whox + +This capability lets you request additional fields in the WHO response +(via the <<command_irc_who,/who>> command). + +WeeChat displays all additional information received in the WHO output. + [[irc_sasl_authentication]] ==== SASL authentication @@ -3838,7 +4108,7 @@ show a list of users currently typing a message on the buffer. It is used by IRC plugin on channel and private buffers, when the "message-tags" capability is enabled (you can check with <<command_irc_cap,/cap>> command). + Under the hood, typing client tag is used, following this specification: -https://ircv3.net/specs/client-tags/typing.html. +https://ircv3.net/specs/client-tags/typing. [[typing_activation]] === Activation diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index 3352c0442..5d72e2b09 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -3431,6 +3431,280 @@ config WeeChat qui peut aussi être par exemple `~/.weechat`. Pour plus d'informations, consulter https://www.oftc.net/NickServ/CertFP/ +[[irc_ircv3_support]] +==== Support IRCv3 + +WeeChat supporte les https://ircv3.net/irc/[extensions IRCv3] suivantes : + +* <<irc_ircv3_account_notify,account-notify>> +* <<irc_ircv3_account_tag,account-tag>> +* <<irc_ircv3_away_notify,away-notify>> +* <<irc_ircv3_cap_notify,cap-notify>> +* <<irc_ircv3_chghost,chghost>> +* <<irc_ircv3_extended_join,extended-join>> +* <<irc_ircv3_invite_notify,invite-notify>> +* <<irc_ircv3_message_tags,message-tags>> +* <<irc_ircv3_monitor,monitor>> +* <<irc_ircv3_multi_prefix,multi-prefix>> +* <<irc_ircv3_sasl,SASL v3.2>> +* <<irc_ircv3_server_time,server-time>> +* <<irc_ircv3_setname,setname>> +* <<irc_ircv3_typing,typing>> +* <<irc_ircv3_userhost_in_names,userhost-in-names>> +* <<irc_ircv3_whox,WHOX>> + +Par défaut toutes les capacités supportées par le serveur et WeeChat sont +automatiquement activées (voir l'option +<<option_irc.server_default.capabilities,irc.server_default.capabilities>>). + +Des tableaux avec une comparaison des différents clients IRC, incluant WeeChat, +sont disponibles sur cette page : https://ircv3.net/software/clients. + +[[irc_ircv3_account_notify]] +===== account-notify + +Spécification : https://ircv3.net/specs/extensions/account-notify + +Cette capacité autorise le serveur à envoyer des messages lorsque les utilisateurs +s'identifient ou perdent l'identification sur le serveur. + +WeeChat affiche ces messages si l'option +<<option_irc.look.display_account_message,irc.look.display_account_message>> +est activée (valeur par défaut). + +Exemples : + +.... +-- alice s'est identifié en tant que Alice01 + +-- alice n'est plus identifié +.... + +[[irc_ircv3_account_tag]] +===== account-tag + +Spécification : https://ircv3.net/specs/extensions/account-tag + +Cette capacité autorise le serveur à envoyer le compte comme étiquette de message +dans les commandes envoyées au client. + +WeeChat extrait cette étiquette et la sauve dans le message, mais elle n'est pas +utilisée ni affichée. Elle peut être utilisée dans la commande <<command_filter,/filter>> +pour filtrer les messages correspondants à des comptes spécifiques. + +Exemple de message IRC brut reçu : + +.... +@account=Alice01 :user@example.com PRIVMSG #test :Bonjour ! +.... + +Message affiché dans le canal : + +.... +<alice> Bonjour ! +.... + +Message avec les étiquettes : + +.... +<alice> Bonjour ! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1] +.... + +[[irc_ircv3_away_notify]] +===== away-notify + +Spécification : https://ircv3.net/specs/extensions/away-notify + +Cette capacité autorise le serveur à envoyer des notifications d'absence pour +les utilisateurs qui sont sur les mêmes canaux que vous. + +Lorsque le statut d'absence est changé pour un utilisateur (absent ou de retour), +cela est reflété avec une couleur spécifique dans la liste des pseudos, en utilisant +les options suivantes : + +* <<option_irc.server_default.away_check,irc.server_default.away_check>> +* <<option_irc.server_default.away_check_max_nicks,irc.server_default.away_check_max_nicks>> +* <<option_weechat.look.item_away_message,weechat.look.item_away_message>> + +[[irc_ircv3_cap_notify]] +===== cap-notify + +Spécification : https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand + +Cette capacité autorise le serveur à avertir des nouvelles capacités ou celles +supprimées sur le serveur (via les commandes `CAP NEW` et `CAP DEL`). + +Exemples : + +.... +-- irc : client capability, maintenant disponible : sasl + +-- irc : client capability, supprimé : sasl +.... + +[[irc_ircv3_chghost]] +===== chghost + +Spécification : https://ircv3.net/specs/extensions/chghost + +Cette capacité autorise le serveur à envoyer des messages lorsque les utilisateurs +changent de nom ou d'hôte. + +Lorsque l'option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>> +est activée (valeur par défaut), les changements d'hôtes sont automatiquement +masqués si le pseudo n'a pas parlé pendant plusieurs minutes. + +La couleur du message de changement d'hôte est contrôlée par l'option +<<option_irc.color.message_chghost,irc.color.message_chghost>>. + +Exemple : + +.... +-- alice (user@example.com) a changé d'hôte pour test.com +.... + +[[irc_ircv3_extended_join]] +===== extended-join + +Spécification : https://ircv3.net/specs/extensions/extended-join + +Cette capacité autorise le serveur à envoyer le compte et nom réel lorsque les +utilisateurs rejoignent les canaux. + +WeeChat affiche les informations additionnelles dans les messages de "join" +si l'option +<<option_irc.look.display_extended_join,irc.look.display_extended_join>> +est activée (valeur par défaut). + +Exemple : + +.... +--> john [John01] (John Doe) (~user@example.com) a rejoint #test +.... + +[[irc_ircv3_invite_notify]] +===== invite-notify + +Spécification : https://ircv3.net/specs/extensions/invite-notify + +Cette capacité autorise le serveur à envoyer des messages d'invitation lorsque +les utilisateurs sont invités sur des canaux. + +Exemple : + +.... +-- alice a invité bob sur #test +.... + +[[irc_ircv3_message_tags]] +===== message-tags + +Spécification : https://ircv3.net/specs/extensions/message-tags + +Cette capacité autorise l'envoi de méta-données dans les messages. + +Ces étiquettes peuvent être affichées avec la commande `/debug tags`. + +Elle doit être activer pour utiliser les <<typing_notifications,notifications de saisie>>. + +[[irc_ircv3_monitor]] +===== monitor + +Spécification : https://ircv3.net/specs/extensions/monitor + +Cette capacité autorise le serveur à envoyer des notifications lorsque les clients +se connectent ou se déconnectent. + +WeeChat utilise automatiquement cette extension si disponible lorsque la commande +<<command_irc_notify,/notify>> est utilisée. + +[[irc_ircv3_multi_prefix]] +===== multi-prefix + +Spécification : https://ircv3.net/specs/extensions/multi-prefix + +Cette capacité autorise le serveur à envoyer tous les modes utilisateur d'un coup +dans les réponses à <<command_irc_names,/names>> et <<command_irc_whois,/whois>>. + + +//// +Exemple : sortie de `/names` : + +.... +-- Pseudos #test : [@%+alice bob +carol] +.... +//// + +[NOTE] +Pour l'instant, WeeChat n'affiche pas les préfixes dans la sortie de `/names`, +même s'ils sont reçus et correctement sauvegardés en interne. + +Exemple : sortie de `/whois alice` : + +.... +-- [alice] @%+#test +.... + +[[irc_ircv3_sasl]] +===== SASL + +Spécification : https://ircv3.net/specs/extensions/sasl-3.2 + +Voir le chapitre dédié <<irc_sasl_authentication,Authentification avec SASL>>. + +[[irc_ircv3_server_time]] +===== server-time + +Spécification : https://ircv3.net/specs/extensions/server-time + +Cette capacité autorise le serveur à envoyer l'heure pour les messages sous forme +d'étiquette de message. + +Lorsque l'heure est reçue dans un message, WeeChat l'utilise pour afficher le message +(qui peut alors avoir une date dans le passé). + +Le <<relay_irc_proxy,proxy IRC>> dans l'extension Relay supporte cette capacité, +donc tout client IRC de Relay devrait l'activer pour afficher l'heure réelle +des messages dans l'historique des messages envoyés à la connexion. + +[[irc_ircv3_setname]] +===== setname + +Spécification : https://ircv3.net/specs/extensions/setname + +Cette capacité vous permet de changer votre nom réel en utilisant la commande +<<command_irc_setname,/setname>>. + +[[irc_ircv3_typing]] +===== typing + +Spécification : https://ircv3.net/specs/client-tags/typing + +Voir le chapitre dédié <<typing_notifications,Notifications de saisie>>. + +[[irc_ircv3_userhost_in_names]] +===== userhost-in-names + +Spécification : https://ircv3.net/specs/extensions/userhost-in-names + +Cette capacité autorise le serveur à envoyer les noms d'hôtes dans les réponses à +<<command_irc_names,/names>>. + +[NOTE] +WeeChat n'affiche pas les noms d'hôtes dans la sortie de `/names`. + +Exemple de message IRC brut reçu sans la capacité : + +.... +:irc.server 353 alice = #test :@alice bob +carol +.... + +Exemple de message IRC brut reçu avec la capacité : + +.... +:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3 +.... + +[[irc_ircv3_whox]] +===== WHOX + +Spécification : https://ircv3.net/specs/extensions/whox + +Cette capacité vous permet de demander des champs additionnels dans la réponse +WHO (via la commande <<command_irc_who,/who>>). + +WeeChat affiche ces informations additionnelles reçus dans la sortie de WHO. + [[irc_sasl_authentication]] ==== Authentification avec SASL @@ -3962,7 +4236,7 @@ Elle est utilisée par l'extension IRC sur les tampons de canaux et privés, lorsque la capacité "message-tags" est activée (vous pouvez vérifier avec la commande <<command_irc_cap,/cap>>). + Sous le capot, l'étiquette client typing est utilisée, en suivant cette -spécification : https://ircv3.net/specs/client-tags/typing.html. +spécification : https://ircv3.net/specs/client-tags/typing. [[typing_activation]] === Activation @@ -4134,7 +4408,7 @@ commande : ---- [[relay_irc_proxy]] -=== IRC proxy +=== Proxy IRC L'extension Relay peut agir comme un proxy IRC : elle simulera un serveur IRC, et vous pourrez vous connecter sur WeeChat avec n'importe quel autre client IRC diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index 3ea052c1d..402bc84ab 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -3590,6 +3590,277 @@ which can also be for example `~/.weechat`. Per maggiori informazioni consultare https://www.oftc.net/NickServ/CertFP/ +// TRANSLATION MISSING +[[irc_ircv3_support]] +==== IRCv3 support + +WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions]: + +* <<irc_ircv3_account_notify,account-notify>> +* <<irc_ircv3_account_tag,account-tag>> +* <<irc_ircv3_away_notify,away-notify>> +* <<irc_ircv3_cap_notify,cap-notify>> +* <<irc_ircv3_chghost,chghost>> +* <<irc_ircv3_extended_join,extended-join>> +* <<irc_ircv3_invite_notify,invite-notify>> +* <<irc_ircv3_message_tags,message-tags>> +* <<irc_ircv3_monitor,monitor>> +* <<irc_ircv3_multi_prefix,multi-prefix>> +* <<irc_ircv3_sasl,SASL v3.2>> +* <<irc_ircv3_server_time,server-time>> +* <<irc_ircv3_setname,setname>> +* <<irc_ircv3_typing,typing>> +* <<irc_ircv3_userhost_in_names,userhost-in-names>> +* <<irc_ircv3_whox,WHOX>> + +By default all capabilities supported by the server and WeeChat are +automatically enabled +(see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>). + +Tables with comparison of different IRC clients, including WeeChat, are available +on this page: https://ircv3.net/software/clients. + +[[irc_ircv3_account_notify]] +===== account-notify + +Specification: https://ircv3.net/specs/extensions/account-notify + +This capability allows the server to send messages when users identify or +unidentify on the server. + +WeeChat displays such messages if the option +<<option_irc.look.display_account_message,irc.look.display_account_message>> +is enabled (default value). + +Examples: + +.... +-- alice has identified as Alice01 + +-- alice has unidentified +.... + +[[irc_ircv3_account_tag]] +===== account-tag + +Specification: https://ircv3.net/specs/extensions/account-tag + +This capability allows the server to send account as message tag to commands +sent to the client. + +WeeChat parses this tag and saves it in the message, but it is not used or +displayed. It can be used in <<command_filter,/filter>> command to filter +messages matching specific accounts. + +Example of raw IRC message received: + +.... +@account=Alice01 :user@example.com PRIVMSG #test :Hello! +.... + +Message displayed in channel: + +.... +<alice> Hello! +.... + +Message with tags: + +.... +<alice> Hello! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1] +.... + +[[irc_ircv3_away_notify]] +===== away-notify + +Specification: https://ircv3.net/specs/extensions/away-notify + +This capability allows the server to send away notifications for users present +on the same channels as you. + +When the away status is changed for a user (away or back), this is reflected +with a specific color in the nicklist, using the following options: + +* <<option_irc.server_default.away_check,irc.server_default.away_check>> +* <<option_irc.server_default.away_check_max_nicks,irc.server_default.away_check_max_nicks>> +* <<option_weechat.look.item_away_message,weechat.look.item_away_message>> + +[[irc_ircv3_cap_notify]] +===== cap-notify + +Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand + +This capability allows the server to advertise on new or removed capabilities +on the server (via `CAP NEW` and `CAP DEL` commands). + +Examples: + +.... +-- irc: client capability, now available: sasl + +-- irc: client capability, removed: sasl +.... + +[[irc_ircv3_chghost]] +===== chghost + +Specification: https://ircv3.net/specs/extensions/chghost + +This capability allows the server to send messages when users change name or host. + +When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>> +is enabled (default value), the host changes are automatically hidden if the nick +has not spoken for several minutes. + +The color of the change host message is controlled by the option +<<option_irc.color.message_chghost,irc.color.message_chghost>>. + +Example: + +.... +-- alice (user@example.com) has changed host to test.com +.... + +[[irc_ircv3_extended_join]] +===== extended-join + +Specification: https://ircv3.net/specs/extensions/extended-join + +This capability allows the server to send account and real name when users +join channels. + +WeeChat displays this additional information in join messages if the option +<<option_irc.look.display_extended_join,irc.look.display_extended_join>> +is enabled (default value). + +Example: + +.... +--> john [John01] (John Doe) (~user@example.com) has joined #test +.... + +[[irc_ircv3_invite_notify]] +===== invite-notify + +Specification: https://ircv3.net/specs/extensions/invite-notify + +This capability allows the server to send invite messages when users are +invited to channels. + +Example: + +.... +-- alice ha invitato bob in #test +.... + +[[irc_ircv3_message_tags]] +===== message-tags + +Specification: https://ircv3.net/specs/extensions/message-tags + +This capability allows to add metadata in messages. + +These tags can be displayed using the command `/debug tags`. + +It must be enabled to use <<typing_notifications,typing notifications>>. + +[[irc_ircv3_monitor]] +===== monitor + +Specification: https://ircv3.net/specs/extensions/monitor + +This capability allows the server to send notifications when clients become +online/offline. + +WeeChat automatically uses this extension if available when using the +<<command_irc_notify,/notify>> command. + +[[irc_ircv3_multi_prefix]] +===== multi-prefix + +Specification: https://ircv3.net/specs/extensions/multi-prefix + +This capability allows the server to send all user modes at once in +<<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. + + +//// +Example: output of `/names`: + +.... +-- Nick #test: [@%+alice bob +carol] +.... +//// + +[NOTE] +For now, WeeChat doesn't display all prefixes in the `/names` output, even if +they are received and properly saved internally. + +Example: output of `/whois alice`: + +.... +-- [alice] @%+#test +.... + +[[irc_ircv3_sasl]] +===== SASL + +Specification: https://ircv3.net/specs/extensions/sasl-3.2 + +See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>. + +[[irc_ircv3_server_time]] +===== server-time + +Specification: https://ircv3.net/specs/extensions/server-time + +This capability allows the server to send time for messages as message tag. + +When the time is received in a message, WeeChat uses it to display the message +(it can then be displayed with a past date). + +The <<relay_irc_proxy,IRC proxy>> in Relay plugin supports this capability, +so any IRC client of Relay should enable it to display the real message time +in the backlog sent upon connection. + +[[irc_ircv3_setname]] +===== setname + +Specification: https://ircv3.net/specs/extensions/setname + +This capability lets you change your real name by using the +<<command_irc_setname,/setname>> command. + +[[irc_ircv3_typing]] +===== typing + +Specification: https://ircv3.net/specs/client-tags/typing + +See the dedicated chapter <<typing_notifications,Typing notifications>>. + +[[irc_ircv3_userhost_in_names]] +===== userhost-in-names + +Specification: https://ircv3.net/specs/extensions/userhost-in-names + +This capability allows the server to send hostnames in <<command_irc_names,/names>> +responses. + +[NOTE] +WeeChat doesn't display hostnames in the `/names` output. + +Example of raw IRC messages received without the capability: + +.... +:irc.server 353 alice = #test :@alice bob +carol +.... + +Example of raw IRC messages received with the capability: + +.... +:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3 +.... + +[[irc_ircv3_whox]] +===== WHOX + +Specification: https://ircv3.net/specs/extensions/whox + +This capability lets you request additional fields in the WHO response +(via the <<command_irc_who,/who>> command). + +WeeChat displays all additional information received in the WHO output. + [[irc_sasl_authentication]] ==== Autenticazione SASL @@ -4148,7 +4419,7 @@ show a list of users currently typing a message on the buffer. It is used by IRC plugin on channel and private buffers, when the "message-tags" capability is enabled (you can check with <<command_irc_cap,/cap>> command). + Under the hood, typing client tag is used, following this specification: -https://ircv3.net/specs/client-tags/typing.html. +https://ircv3.net/specs/client-tags/typing. [[typing_activation]] === Activation diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index cdbc36132..bc8b73027 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -3449,6 +3449,277 @@ which can also be for example `~/.weechat`. より詳しい情報は https://www.oftc.net/NickServ/CertFP/ を確認してください。 +// TRANSLATION MISSING +[[irc_ircv3_support]] +==== IRCv3 support + +WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions]: + +* <<irc_ircv3_account_notify,account-notify>> +* <<irc_ircv3_account_tag,account-tag>> +* <<irc_ircv3_away_notify,away-notify>> +* <<irc_ircv3_cap_notify,cap-notify>> +* <<irc_ircv3_chghost,chghost>> +* <<irc_ircv3_extended_join,extended-join>> +* <<irc_ircv3_invite_notify,invite-notify>> +* <<irc_ircv3_message_tags,message-tags>> +* <<irc_ircv3_monitor,monitor>> +* <<irc_ircv3_multi_prefix,multi-prefix>> +* <<irc_ircv3_sasl,SASL v3.2>> +* <<irc_ircv3_server_time,server-time>> +* <<irc_ircv3_setname,setname>> +* <<irc_ircv3_typing,typing>> +* <<irc_ircv3_userhost_in_names,userhost-in-names>> +* <<irc_ircv3_whox,WHOX>> + +By default all capabilities supported by the server and WeeChat are +automatically enabled +(see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>). + +Tables with comparison of different IRC clients, including WeeChat, are available +on this page: https://ircv3.net/software/clients. + +[[irc_ircv3_account_notify]] +===== account-notify + +Specification: https://ircv3.net/specs/extensions/account-notify + +This capability allows the server to send messages when users identify or +unidentify on the server. + +WeeChat displays such messages if the option +<<option_irc.look.display_account_message,irc.look.display_account_message>> +is enabled (default value). + +Examples: + +.... +-- alice has identified as Alice01 + +-- alice has unidentified +.... + +[[irc_ircv3_account_tag]] +===== account-tag + +Specification: https://ircv3.net/specs/extensions/account-tag + +This capability allows the server to send account as message tag to commands +sent to the client. + +WeeChat parses this tag and saves it in the message, but it is not used or +displayed. It can be used in <<command_filter,/filter>> command to filter +messages matching specific accounts. + +Example of raw IRC message received: + +.... +@account=Alice01 :user@example.com PRIVMSG #test :Hello! +.... + +Message displayed in channel: + +.... +<alice> Hello! +.... + +Message with tags: + +.... +<alice> Hello! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1] +.... + +[[irc_ircv3_away_notify]] +===== away-notify + +Specification: https://ircv3.net/specs/extensions/away-notify + +This capability allows the server to send away notifications for users present +on the same channels as you. + +When the away status is changed for a user (away or back), this is reflected +with a specific color in the nicklist, using the following options: + +* <<option_irc.server_default.away_check,irc.server_default.away_check>> +* <<option_irc.server_default.away_check_max_nicks,irc.server_default.away_check_max_nicks>> +* <<option_weechat.look.item_away_message,weechat.look.item_away_message>> + +[[irc_ircv3_cap_notify]] +===== cap-notify + +Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand + +This capability allows the server to advertise on new or removed capabilities +on the server (via `CAP NEW` and `CAP DEL` commands). + +Examples: + +.... +-- irc: クライアントの機能、現在利用可能なもの: sasl + +-- irc: クライアントの機能、削除されたもの: sasl +.... + +[[irc_ircv3_chghost]] +===== chghost + +Specification: https://ircv3.net/specs/extensions/chghost + +This capability allows the server to send messages when users change name or host. + +When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>> +is enabled (default value), the host changes are automatically hidden if the nick +has not spoken for several minutes. + +The color of the change host message is controlled by the option +<<option_irc.color.message_chghost,irc.color.message_chghost>>. + +Example: + +.... +-- alice (user@example.com) がホストを test.com に変更しました +.... + +[[irc_ircv3_extended_join]] +===== extended-join + +Specification: https://ircv3.net/specs/extensions/extended-join + +This capability allows the server to send account and real name when users +join channels. + +WeeChat displays this additional information in join messages if the option +<<option_irc.look.display_extended_join,irc.look.display_extended_join>> +is enabled (default value). + +Example: + +.... +--> john [John01] (John Doe) (~user@example.com) が #test に参加 +.... + +[[irc_ircv3_invite_notify]] +===== invite-notify + +Specification: https://ircv3.net/specs/extensions/invite-notify + +This capability allows the server to send invite messages when users are +invited to channels. + +Example: + +.... +-- alice が bob を #test に招待しました +.... + +[[irc_ircv3_message_tags]] +===== message-tags + +Specification: https://ircv3.net/specs/extensions/message-tags + +This capability allows to add metadata in messages. + +These tags can be displayed using the command `/debug tags`. + +It must be enabled to use <<typing_notifications,typing notifications>>. + +[[irc_ircv3_monitor]] +===== monitor + +Specification: https://ircv3.net/specs/extensions/monitor + +This capability allows the server to send notifications when clients become +online/offline. + +WeeChat automatically uses this extension if available when using the +<<command_irc_notify,/notify>> command. + +[[irc_ircv3_multi_prefix]] +===== multi-prefix + +Specification: https://ircv3.net/specs/extensions/multi-prefix + +This capability allows the server to send all user modes at once in +<<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. + + +//// +Example: output of `/names`: + +.... +-- ニックネーム #test: [@%+alice bob +carol] +.... +//// + +[NOTE] +For now, WeeChat doesn't display all prefixes in the `/names` output, even if +they are received and properly saved internally. + +Example: output of `/whois alice`: + +.... +-- [alice] @%+#test +.... + +[[irc_ircv3_sasl]] +===== SASL + +Specification: https://ircv3.net/specs/extensions/sasl-3.2 + +See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>. + +[[irc_ircv3_server_time]] +===== server-time + +Specification: https://ircv3.net/specs/extensions/server-time + +This capability allows the server to send time for messages as message tag. + +When the time is received in a message, WeeChat uses it to display the message +(it can then be displayed with a past date). + +The <<relay_irc_proxy,IRC proxy>> in Relay plugin supports this capability, +so any IRC client of Relay should enable it to display the real message time +in the backlog sent upon connection. + +[[irc_ircv3_setname]] +===== setname + +Specification: https://ircv3.net/specs/extensions/setname + +This capability lets you change your real name by using the +<<command_irc_setname,/setname>> command. + +[[irc_ircv3_typing]] +===== typing + +Specification: https://ircv3.net/specs/client-tags/typing + +See the dedicated chapter <<typing_notifications,Typing notifications>>. + +[[irc_ircv3_userhost_in_names]] +===== userhost-in-names + +Specification: https://ircv3.net/specs/extensions/userhost-in-names + +This capability allows the server to send hostnames in <<command_irc_names,/names>> +responses. + +[NOTE] +WeeChat doesn't display hostnames in the `/names` output. + +Example of raw IRC messages received without the capability: + +.... +:irc.server 353 alice = #test :@alice bob +carol +.... + +Example of raw IRC messages received with the capability: + +.... +:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3 +.... + +[[irc_ircv3_whox]] +===== WHOX + +Specification: https://ircv3.net/specs/extensions/whox + +This capability lets you request additional fields in the WHO response +(via the <<command_irc_who,/who>> command). + +WeeChat displays all additional information received in the WHO output. + [[irc_sasl_authentication]] ==== SASL 認証 @@ -3975,7 +4246,7 @@ show a list of users currently typing a message on the buffer. It is used by IRC plugin on channel and private buffers, when the "message-tags" capability is enabled (you can check with <<command_irc_cap,/cap>> command). + Under the hood, typing client tag is used, following this specification: -https://ircv3.net/specs/client-tags/typing.html. +https://ircv3.net/specs/client-tags/typing. [[typing_activation]] === Activation diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index b38006387..f3e392da8 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -3357,6 +3357,277 @@ 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/ +// TRANSLATION MISSING +[[irc_ircv3_support]] +==== IRCv3 support + +WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions]: + +* <<irc_ircv3_account_notify,account-notify>> +* <<irc_ircv3_account_tag,account-tag>> +* <<irc_ircv3_away_notify,away-notify>> +* <<irc_ircv3_cap_notify,cap-notify>> +* <<irc_ircv3_chghost,chghost>> +* <<irc_ircv3_extended_join,extended-join>> +* <<irc_ircv3_invite_notify,invite-notify>> +* <<irc_ircv3_message_tags,message-tags>> +* <<irc_ircv3_monitor,monitor>> +* <<irc_ircv3_multi_prefix,multi-prefix>> +* <<irc_ircv3_sasl,SASL v3.2>> +* <<irc_ircv3_server_time,server-time>> +* <<irc_ircv3_setname,setname>> +* <<irc_ircv3_typing,typing>> +* <<irc_ircv3_userhost_in_names,userhost-in-names>> +* <<irc_ircv3_whox,WHOX>> + +By default all capabilities supported by the server and WeeChat are +automatically enabled +(see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>). + +Tables with comparison of different IRC clients, including WeeChat, are available +on this page: https://ircv3.net/software/clients. + +[[irc_ircv3_account_notify]] +===== account-notify + +Specification: https://ircv3.net/specs/extensions/account-notify + +This capability allows the server to send messages when users identify or +unidentify on the server. + +WeeChat displays such messages if the option +<<option_irc.look.display_account_message,irc.look.display_account_message>> +is enabled (default value). + +Examples: + +.... +-- alice zidentyfikował się jako Alice01 + +-- alice został niezidentyfikowany +.... + +[[irc_ircv3_account_tag]] +===== account-tag + +Specification: https://ircv3.net/specs/extensions/account-tag + +This capability allows the server to send account as message tag to commands +sent to the client. + +WeeChat parses this tag and saves it in the message, but it is not used or +displayed. It can be used in <<command_filter,/filter>> command to filter +messages matching specific accounts. + +Example of raw IRC message received: + +.... +@account=Alice01 :user@example.com PRIVMSG #test :Hello! +.... + +Message displayed in channel: + +.... +<alice> Hello! +.... + +Message with tags: + +.... +<alice> Hello! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1] +.... + +[[irc_ircv3_away_notify]] +===== away-notify + +Specification: https://ircv3.net/specs/extensions/away-notify + +This capability allows the server to send away notifications for users present +on the same channels as you. + +When the away status is changed for a user (away or back), this is reflected +with a specific color in the nicklist, using the following options: + +* <<option_irc.server_default.away_check,irc.server_default.away_check>> +* <<option_irc.server_default.away_check_max_nicks,irc.server_default.away_check_max_nicks>> +* <<option_weechat.look.item_away_message,weechat.look.item_away_message>> + +[[irc_ircv3_cap_notify]] +===== cap-notify + +Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand + +This capability allows the server to advertise on new or removed capabilities +on the server (via `CAP NEW` and `CAP DEL` commands). + +Examples: + +.... +-- irc: możliwości klienta, teraz dostępne: sasl + +-- irc: możliwości klienta, usunięte: sasl +.... + +[[irc_ircv3_chghost]] +===== chghost + +Specification: https://ircv3.net/specs/extensions/chghost + +This capability allows the server to send messages when users change name or host. + +When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>> +is enabled (default value), the host changes are automatically hidden if the nick +has not spoken for several minutes. + +The color of the change host message is controlled by the option +<<option_irc.color.message_chghost,irc.color.message_chghost>>. + +Example: + +.... +-- alice (user@example.com) zmienił hosta na test.com +.... + +[[irc_ircv3_extended_join]] +===== extended-join + +Specification: https://ircv3.net/specs/extensions/extended-join + +This capability allows the server to send account and real name when users +join channels. + +WeeChat displays this additional information in join messages if the option +<<option_irc.look.display_extended_join,irc.look.display_extended_join>> +is enabled (default value). + +Example: + +.... +--> john [John01] (John Doe) (~user@example.com) wszedł na #test +.... + +[[irc_ircv3_invite_notify]] +===== invite-notify + +Specification: https://ircv3.net/specs/extensions/invite-notify + +This capability allows the server to send invite messages when users are +invited to channels. + +Example: + +.... +-- alice zaprosił bob na #test +.... + +[[irc_ircv3_message_tags]] +===== message-tags + +Specification: https://ircv3.net/specs/extensions/message-tags + +This capability allows to add metadata in messages. + +These tags can be displayed using the command `/debug tags`. + +It must be enabled to use <<typing_notifications,typing notifications>>. + +[[irc_ircv3_monitor]] +===== monitor + +Specification: https://ircv3.net/specs/extensions/monitor + +This capability allows the server to send notifications when clients become +online/offline. + +WeeChat automatically uses this extension if available when using the +<<command_irc_notify,/notify>> command. + +[[irc_ircv3_multi_prefix]] +===== multi-prefix + +Specification: https://ircv3.net/specs/extensions/multi-prefix + +This capability allows the server to send all user modes at once in +<<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. + + +//// +Example: output of `/names`: + +.... +-- Nicki #test: [@%+alice bob +carol] +.... +//// + +[NOTE] +For now, WeeChat doesn't display all prefixes in the `/names` output, even if +they are received and properly saved internally. + +Example: output of `/whois alice`: + +.... +-- [alice] @%+#test +.... + +[[irc_ircv3_sasl]] +===== SASL + +Specification: https://ircv3.net/specs/extensions/sasl-3.2 + +See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>. + +[[irc_ircv3_server_time]] +===== server-time + +Specification: https://ircv3.net/specs/extensions/server-time + +This capability allows the server to send time for messages as message tag. + +When the time is received in a message, WeeChat uses it to display the message +(it can then be displayed with a past date). + +The <<relay_irc_proxy,IRC proxy>> in Relay plugin supports this capability, +so any IRC client of Relay should enable it to display the real message time +in the backlog sent upon connection. + +[[irc_ircv3_setname]] +===== setname + +Specification: https://ircv3.net/specs/extensions/setname + +This capability lets you change your real name by using the +<<command_irc_setname,/setname>> command. + +[[irc_ircv3_typing]] +===== typing + +Specification: https://ircv3.net/specs/client-tags/typing + +See the dedicated chapter <<typing_notifications,Typing notifications>>. + +[[irc_ircv3_userhost_in_names]] +===== userhost-in-names + +Specification: https://ircv3.net/specs/extensions/userhost-in-names + +This capability allows the server to send hostnames in <<command_irc_names,/names>> +responses. + +[NOTE] +WeeChat doesn't display hostnames in the `/names` output. + +Example of raw IRC messages received without the capability: + +.... +:irc.server 353 alice = #test :@alice bob +carol +.... + +Example of raw IRC messages received with the capability: + +.... +:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3 +.... + +[[irc_ircv3_whox]] +===== WHOX + +Specification: https://ircv3.net/specs/extensions/whox + +This capability lets you request additional fields in the WHO response +(via the <<command_irc_who,/who>> command). + +WeeChat displays all additional information received in the WHO output. + [[irc_sasl_authentication]] ==== Uwierzytelnianie SASL @@ -3880,7 +4151,7 @@ Jest używana przez wtyczkę IRC na kanałach i w prywatnych buforach, kiedy serwer posiada włączoną opcję "message-tags" (możesz to sprawdzić komendą <<command_irc_cap,/cap>>). + Pod spodem, używany jest tag klienta "typing" zgodnie z tą specyfikacją: -https://ircv3.net/specs/client-tags/typing.html. +https://ircv3.net/specs/client-tags/typing. [[typing_activation]] === Aktywacja diff --git a/doc/sr/weechat_user.sr.adoc b/doc/sr/weechat_user.sr.adoc index cec8b6110..09735a382 100644 --- a/doc/sr/weechat_user.sr.adoc +++ b/doc/sr/weechat_user.sr.adoc @@ -3109,6 +3109,277 @@ $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick За више информација, погледајте https://www.oftc.net/NickServ/CertFP/ +// TRANSLATION MISSING +[[irc_ircv3_support]] +==== IRCv3 support + +WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions]: + +* <<irc_ircv3_account_notify,account-notify>> +* <<irc_ircv3_account_tag,account-tag>> +* <<irc_ircv3_away_notify,away-notify>> +* <<irc_ircv3_cap_notify,cap-notify>> +* <<irc_ircv3_chghost,chghost>> +* <<irc_ircv3_extended_join,extended-join>> +* <<irc_ircv3_invite_notify,invite-notify>> +* <<irc_ircv3_message_tags,message-tags>> +* <<irc_ircv3_monitor,monitor>> +* <<irc_ircv3_multi_prefix,multi-prefix>> +* <<irc_ircv3_sasl,SASL v3.2>> +* <<irc_ircv3_server_time,server-time>> +* <<irc_ircv3_setname,setname>> +* <<irc_ircv3_typing,typing>> +* <<irc_ircv3_userhost_in_names,userhost-in-names>> +* <<irc_ircv3_whox,WHOX>> + +By default all capabilities supported by the server and WeeChat are +automatically enabled +(see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>). + +Tables with comparison of different IRC clients, including WeeChat, are available +on this page: https://ircv3.net/software/clients. + +[[irc_ircv3_account_notify]] +===== account-notify + +Specification: https://ircv3.net/specs/extensions/account-notify + +This capability allows the server to send messages when users identify or +unidentify on the server. + +WeeChat displays such messages if the option +<<option_irc.look.display_account_message,irc.look.display_account_message>> +is enabled (default value). + +Examples: + +.... +-- alice се идентификовао као Alice01 + +-- alice је уклонио идентификацију +.... + +[[irc_ircv3_account_tag]] +===== account-tag + +Specification: https://ircv3.net/specs/extensions/account-tag + +This capability allows the server to send account as message tag to commands +sent to the client. + +WeeChat parses this tag and saves it in the message, but it is not used or +displayed. It can be used in <<command_filter,/filter>> command to filter +messages matching specific accounts. + +Example of raw IRC message received: + +.... +@account=Alice01 :user@example.com PRIVMSG #test :Hello! +.... + +Message displayed in channel: + +.... +<alice> Hello! +.... + +Message with tags: + +.... +<alice> Hello! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1] +.... + +[[irc_ircv3_away_notify]] +===== away-notify + +Specification: https://ircv3.net/specs/extensions/away-notify + +This capability allows the server to send away notifications for users present +on the same channels as you. + +When the away status is changed for a user (away or back), this is reflected +with a specific color in the nicklist, using the following options: + +* <<option_irc.server_default.away_check,irc.server_default.away_check>> +* <<option_irc.server_default.away_check_max_nicks,irc.server_default.away_check_max_nicks>> +* <<option_weechat.look.item_away_message,weechat.look.item_away_message>> + +[[irc_ircv3_cap_notify]] +===== cap-notify + +Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand + +This capability allows the server to advertise on new or removed capabilities +on the server (via `CAP NEW` and `CAP DEL` commands). + +Examples: + +.... +-- irc: могућност клијента, сада је доступно: sasl + +-- irc: могућност клијента, уклоњено: sasl +.... + +[[irc_ircv3_chghost]] +===== chghost + +Specification: https://ircv3.net/specs/extensions/chghost + +This capability allows the server to send messages when users change name or host. + +When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>> +is enabled (default value), the host changes are automatically hidden if the nick +has not spoken for several minutes. + +The color of the change host message is controlled by the option +<<option_irc.color.message_chghost,irc.color.message_chghost>>. + +Example: + +.... +-- alice (user@example.com) је променио свој хост на test.com +.... + +[[irc_ircv3_extended_join]] +===== extended-join + +Specification: https://ircv3.net/specs/extensions/extended-join + +This capability allows the server to send account and real name when users +join channels. + +WeeChat displays this additional information in join messages if the option +<<option_irc.look.display_extended_join,irc.look.display_extended_join>> +is enabled (default value). + +Example: + +.... +--> john [John01] (John Doe) (~user@example.com) је приступио у #test +.... + +[[irc_ircv3_invite_notify]] +===== invite-notify + +Specification: https://ircv3.net/specs/extensions/invite-notify + +This capability allows the server to send invite messages when users are +invited to channels. + +Example: + +.... +-- alice је позвао bob на #test +.... + +[[irc_ircv3_message_tags]] +===== message-tags + +Specification: https://ircv3.net/specs/extensions/message-tags + +This capability allows to add metadata in messages. + +These tags can be displayed using the command `/debug tags`. + +It must be enabled to use <<typing_notifications,typing notifications>>. + +[[irc_ircv3_monitor]] +===== monitor + +Specification: https://ircv3.net/specs/extensions/monitor + +This capability allows the server to send notifications when clients become +online/offline. + +WeeChat automatically uses this extension if available when using the +<<command_irc_notify,/notify>> command. + +[[irc_ircv3_multi_prefix]] +===== multi-prefix + +Specification: https://ircv3.net/specs/extensions/multi-prefix + +This capability allows the server to send all user modes at once in +<<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. + + +//// +Example: output of `/names`: + +.... +-- Надимци #test: [@%+alice bob +carol] +.... +//// + +[NOTE] +For now, WeeChat doesn't display all prefixes in the `/names` output, even if +they are received and properly saved internally. + +Example: output of `/whois alice`: + +.... +-- [alice] @%+#test +.... + +[[irc_ircv3_sasl]] +===== SASL + +Specification: https://ircv3.net/specs/extensions/sasl-3.2 + +See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>. + +[[irc_ircv3_server_time]] +===== server-time + +Specification: https://ircv3.net/specs/extensions/server-time + +This capability allows the server to send time for messages as message tag. + +When the time is received in a message, WeeChat uses it to display the message +(it can then be displayed with a past date). + +The <<relay_irc_proxy,IRC proxy>> in Relay plugin supports this capability, +so any IRC client of Relay should enable it to display the real message time +in the backlog sent upon connection. + +[[irc_ircv3_setname]] +===== setname + +Specification: https://ircv3.net/specs/extensions/setname + +This capability lets you change your real name by using the +<<command_irc_setname,/setname>> command. + +[[irc_ircv3_typing]] +===== typing + +Specification: https://ircv3.net/specs/client-tags/typing + +See the dedicated chapter <<typing_notifications,Typing notifications>>. + +[[irc_ircv3_userhost_in_names]] +===== userhost-in-names + +Specification: https://ircv3.net/specs/extensions/userhost-in-names + +This capability allows the server to send hostnames in <<command_irc_names,/names>> +responses. + +[NOTE] +WeeChat doesn't display hostnames in the `/names` output. + +Example of raw IRC messages received without the capability: + +.... +:irc.server 353 alice = #test :@alice bob +carol +.... + +Example of raw IRC messages received with the capability: + +.... +:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3 +.... + +[[irc_ircv3_whox]] +===== WHOX + +Specification: https://ircv3.net/specs/extensions/whox + +This capability lets you request additional fields in the WHO response +(via the <<command_irc_who,/who>> command). + +WeeChat displays all additional information received in the WHO output. + [[irc_sasl_authentication]] ==== SASL аутентификација @@ -3601,7 +3872,7 @@ include::includes/autogen_user_options.sr.adoc[tag=xfer_options] Користи га IRC додатак на баферима канала и на приватним баферима када је укључена „message-tags” могућност (што можете да проверите командом <<command_irc_cap,/cap>>). + Испод хаубе, користи се ознака клијент који куца, пратећи следећу спецификацију: -https://ircv3.net/specs/client-tags/typing.html. +https://ircv3.net/specs/client-tags/typing. [[typing_activation]] === Активација |