1
0
mirror of https://github.com/weechat/weechat.git synced 2026-07-04 16:53:14 +02:00

doc/user: add a chapter on supported IRCv3 extensions

This commit is contained in:
Sébastien Helleu
2022-06-25 08:53:18 +02:00
parent 8788fcedc8
commit 42a0a19828
7 changed files with 1907 additions and 8 deletions
+272 -1
View File
@@ -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
+271 -1
View File
@@ -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
+276 -2
View File
@@ -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
+272 -1
View File
@@ -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
+272 -1
View File
@@ -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
+272 -1
View File
@@ -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
+272 -1
View File
@@ -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]]
=== Активација