1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-12 14:14:48 +02:00

doc/user: move IRCv3 chapter outside "Servers"

This commit is contained in:
Sébastien Helleu
2023-05-23 21:42:51 +02:00
parent 64c3f3f0cd
commit ad1ae12321
7 changed files with 2471 additions and 2471 deletions
+351 -351
View File
@@ -3453,357 +3453,6 @@ das auch beispielsweise `~/.weechat` sein kann.
Weitere Informationen finden Sie unter
https://www.oftc.net/NickServ/CertFP/[this page ^↗^,window=_blank].
[[irc_ircv3_support]]
==== IRCv3 support
WeeChat unterstützt folgende https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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>>
Standardmäßig werden alle vom Server und WeeChat unterstützten Funktionen automatisch aktiviert
(siehe Option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Mehrere Tabellen mit Auflistung verschiedener IRC-Clients, einschließlich WeeChat, sind verfügbar
auf https://ircv3.net/software/clients[this page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
===== account-notify
Spezifikation: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Nachrichten zu senden, wenn Benutzer sich auf dem
Server identifizieren oder diese zurück ziehen. +
WeeChat zeigt solche Nachrichten an, wenn die Option
<<option_irc.look.display_account_message,irc.look.display_account_message>>
aktiviert ist (Standardwert).
Beispiele:
....
-- alice wurde identifiziert als Alice01
-- alice hat sich nicht identifiziert
....
[[irc_ircv3_account_tag]]
===== account-tag
Spezifikation: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
Diese Fähigkeit ermöglicht es dem Server, einen Account als Nachrichten-Tag an Befehle zu hängen,
die an den Client gesendet werden. +
WeeChat analysiert dieses Tag und speichert es in der Nachricht, aber es wird nicht verwendet oder
angezeigt. Mit dem <<command_filter,/filter>> Befehl kann man diese Nachrichten explizit filtern,
in dem die Accounts nutzt.
Beispiel einer empfangenen IRC-Rohnachricht:
....
@account=Alice01 :user@example.com PRIVMSG #test :Hello!
....
Nachricht wie sie im Kanal angezeigt wird:
....
<alice> Hello!
....
Nachricht, mit 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
Spezifikation: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Abwesenheits-Benachrichtigungen für Benutzer zu versenden,
die die selben Kanälen besuchen, wie Sie.
Wenn der Abwesenheitsstatus für einen Benutzer geändert wird (abwesend oder zurück), wird dies mit
einer bestimmten Farbe in der Nickliste dargestellt. Siehe folgende Optionen:
* <<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_batch]]
===== batch
Spezifikation: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Batch-Ereignisse (Gruppe von mehreren
Nachrichten, die zusammengehören) zu senden.
Im Moment speichert WeeChat nur Nachrichten, die in einem Stapel empfangen werden,
und verarbeitet sie wie gewohnt später, wenn der Stapel endet.
[[irc_ircv3_cap_notify]]
===== cap-notify
Spezifikation: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
Diese Fähigkeit ermöglicht es dem Server, neue oder entfernte Fähigkeiten anzubieten, über die
der Server verfügt (mittels der Befehle `CAP NEW` und `CAP DEL`).
Beispiele:
....
-- irc: Clientfähigkeit, nicht verfügbar: sasl
-- irc: Clientfähigkeit, entfernt: sasl
....
[[irc_ircv3_chghost]]
===== chghost
Spezifikation: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Nachrichten zu senden, wenn Benutzer den Namen oder den Host ändern. +
Wenn die Option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
aktiviert ist (Standardwert), werden die Host-Änderungen automatisch ausgeblendet, falls der Nick
mehrere Minuten nicht aktiv gewesen ist. +
Die Farbe der Change-Host-Meldung wird durch die Option
<<option_irc.color.message_chghost,irc.color.message_chghost>>
kontrolliert.
Beispiele:
....
-- alice (user@example.com) hat den Host nach test.com geändert
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
===== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
===== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
===== extended-join
Spezifikation: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, sowohl Account und den Realnamen des Users zu senden,
wenn diese einen Kanal betreten. +
WeeChat zeigt diese zusätzlichen Informationen in Join-Nachrichten an, wenn die Option
<<option_irc.look.display_extended_join,irc.look.display_extended_join>>
aktiviert ist (Standardwert).
Beispiele:
....
--> john [John01] (John Doe) (~user@example.com) hat den Kanal #test betreten
....
[[irc_ircv3_invite_notify]]
===== invite-notify
Spezifikation: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Einladungsnachrichten zu senden, wenn Benutzer zu
Kanälen eingeladen werden.
Beispiele:
....
-- alice hat bob in den Kanal #test eingeladen
....
[[irc_ircv3_message_tags]]
===== message-tags
Spezifikation: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
Diese Funktion ermöglicht das Hinzufügen von Metadaten zu Nachrichten. +
Diese Tags können mit dem Befehl `/debug tags` angezeigt werden.
Um diese Funktion zu verwenden, muss sie aktiviert werden: <<typing_notifications,typing notifications>>.
[[irc_ircv3_monitor]]
===== monitor
Spezifikation: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Benachrichtigungen zu senden, wenn Clients
Online/Offline gehen. +
WeeChat verwendet diese Erweiterung automatisch, sofern verfügbar, wenn der
<<command_irc_notify,/notify>> Befehl genutzt wird.
[[irc_ircv3_multi_prefix]]
===== multi-prefix
Spezifikation: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
Diese Fähigkeit ermöglicht es dem Server, alle Benutzermodi auf einmal zu senden, wenn
die Befehle <<command_irc_names,/names>> und <<command_irc_whois,/whois>> genutzt werden. +
////
Beispiele: Ausgabe von `/names`:
....
-- Nicks #test: [@%+alice bob +carol]
....
////
[NOTE]
Momentan zeigt WeeChat nicht alle Präfixe in der Ausgabe von `/names` an, selbst wenn
diese empfangen und intern ordnungsgemäß verarbeitet werden.
Beispiele: Ausgabe von `/whois alice`:
....
-- [alice] @%+#test
....
[[irc_ircv3_sasl]]
===== SASL
Spezifikation: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
Siehe das entsprechende Kapitel <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
===== server-time
Spezifikation: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
Diese Fähigkeit ermöglicht es dem Server, die Zeit für Nachrichten als Nachrichten-Tag zu senden. +
Wenn die Zeit in einer Nachricht empfangen wird, verwendet WeeChat diese, um die Nachricht anzuzeigen
(diese Nachricht kann dann mit einem zurückliegenden Datum angezeigt werden).
Der <<relay_irc_proxy,IRC-Proxy>> der Relay-Erweiterung unterstützt diese Funktion,
deshalb sollte jeder IRC-Client der mit dem Relay verbunden ist, diese Funktion aktivieren,
um die korrekte Uhrzeit der Nachricht im Verlaufsspeicher anzuzeigen.
[[irc_ircv3_setname]]
===== setname
Spezifikation: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
Mit dieser Funktion können Sie Ihren richtigen Namen ändern, indem Sie den
<<command_irc_setname,/setname>> Befehl nutzen.
[[irc_ircv3_typing]]
===== typing
Spezifikation: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
Siehe das entsprechende Kapitel <<typing_notifications,Typing notifications>>.
[[irc_ircv3_userhost_in_names]]
===== userhost-in-names
Spezifikation: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Hostnamen bei <<command_irc_names,/names>> zu senden.
[NOTE]
WeeChat zeigt keine Hostnamen in der Aushabe des `/names` Befehls an.
Beispiel für unverarbeitete IRC-Nachrichten, die ohne die Fähigkeit empfangen wurden:
....
:irc.server 353 alice = #test :@alice bob +carol
....
Beispiel für unverarbeitete IRC-Nachrichten, die mit der Funktion empfangen wurden:
....
:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3
....
[[irc_ircv3_whox]]
===== WHOX
Spezifikation: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
Mit dieser Funktion können Sie zusätzliche Felder in der WHO-Antwort anfordern
(mit dem Befehl <<command_irc_who,/who>>). +
WeeChat zeigt alle empfangenen Zusatzinformationen in der WHO-Ausgabe an.
[[irc_sasl_authentication]]
==== SASL Authentifizierung
@@ -3957,6 +3606,357 @@ Abschließend, stellen Sie eine Verbindung zum Server her:
/connect irc-tor
----
[[irc_ircv3_support]]
=== IRCv3 support
WeeChat unterstützt folgende https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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>>
Standardmäßig werden alle vom Server und WeeChat unterstützten Funktionen automatisch aktiviert
(siehe Option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Mehrere Tabellen mit Auflistung verschiedener IRC-Clients, einschließlich WeeChat, sind verfügbar
auf https://ircv3.net/software/clients[this page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
==== account-notify
Spezifikation: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Nachrichten zu senden, wenn Benutzer sich auf dem
Server identifizieren oder diese zurück ziehen. +
WeeChat zeigt solche Nachrichten an, wenn die Option
<<option_irc.look.display_account_message,irc.look.display_account_message>>
aktiviert ist (Standardwert).
Beispiele:
....
-- alice wurde identifiziert als Alice01
-- alice hat sich nicht identifiziert
....
[[irc_ircv3_account_tag]]
==== account-tag
Spezifikation: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
Diese Fähigkeit ermöglicht es dem Server, einen Account als Nachrichten-Tag an Befehle zu hängen,
die an den Client gesendet werden. +
WeeChat analysiert dieses Tag und speichert es in der Nachricht, aber es wird nicht verwendet oder
angezeigt. Mit dem <<command_filter,/filter>> Befehl kann man diese Nachrichten explizit filtern,
in dem die Accounts nutzt.
Beispiel einer empfangenen IRC-Rohnachricht:
....
@account=Alice01 :user@example.com PRIVMSG #test :Hello!
....
Nachricht wie sie im Kanal angezeigt wird:
....
<alice> Hello!
....
Nachricht, mit 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
Spezifikation: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Abwesenheits-Benachrichtigungen für Benutzer zu versenden,
die die selben Kanälen besuchen, wie Sie.
Wenn der Abwesenheitsstatus für einen Benutzer geändert wird (abwesend oder zurück), wird dies mit
einer bestimmten Farbe in der Nickliste dargestellt. Siehe folgende Optionen:
* <<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_batch]]
==== batch
Spezifikation: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Batch-Ereignisse (Gruppe von mehreren
Nachrichten, die zusammengehören) zu senden.
Im Moment speichert WeeChat nur Nachrichten, die in einem Stapel empfangen werden,
und verarbeitet sie wie gewohnt später, wenn der Stapel endet.
[[irc_ircv3_cap_notify]]
==== cap-notify
Spezifikation: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
Diese Fähigkeit ermöglicht es dem Server, neue oder entfernte Fähigkeiten anzubieten, über die
der Server verfügt (mittels der Befehle `CAP NEW` und `CAP DEL`).
Beispiele:
....
-- irc: Clientfähigkeit, nicht verfügbar: sasl
-- irc: Clientfähigkeit, entfernt: sasl
....
[[irc_ircv3_chghost]]
==== chghost
Spezifikation: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Nachrichten zu senden, wenn Benutzer den Namen oder den Host ändern. +
Wenn die Option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
aktiviert ist (Standardwert), werden die Host-Änderungen automatisch ausgeblendet, falls der Nick
mehrere Minuten nicht aktiv gewesen ist. +
Die Farbe der Change-Host-Meldung wird durch die Option
<<option_irc.color.message_chghost,irc.color.message_chghost>>
kontrolliert.
Beispiele:
....
-- alice (user@example.com) hat den Host nach test.com geändert
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
==== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
==== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
==== extended-join
Spezifikation: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, sowohl Account und den Realnamen des Users zu senden,
wenn diese einen Kanal betreten. +
WeeChat zeigt diese zusätzlichen Informationen in Join-Nachrichten an, wenn die Option
<<option_irc.look.display_extended_join,irc.look.display_extended_join>>
aktiviert ist (Standardwert).
Beispiele:
....
--> john [John01] (John Doe) (~user@example.com) hat den Kanal #test betreten
....
[[irc_ircv3_invite_notify]]
==== invite-notify
Spezifikation: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Einladungsnachrichten zu senden, wenn Benutzer zu
Kanälen eingeladen werden.
Beispiele:
....
-- alice hat bob in den Kanal #test eingeladen
....
[[irc_ircv3_message_tags]]
==== message-tags
Spezifikation: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
Diese Funktion ermöglicht das Hinzufügen von Metadaten zu Nachrichten. +
Diese Tags können mit dem Befehl `/debug tags` angezeigt werden.
Um diese Funktion zu verwenden, muss sie aktiviert werden: <<typing_notifications,typing notifications>>.
[[irc_ircv3_monitor]]
==== monitor
Spezifikation: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Benachrichtigungen zu senden, wenn Clients
Online/Offline gehen. +
WeeChat verwendet diese Erweiterung automatisch, sofern verfügbar, wenn der
<<command_irc_notify,/notify>> Befehl genutzt wird.
[[irc_ircv3_multi_prefix]]
==== multi-prefix
Spezifikation: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
Diese Fähigkeit ermöglicht es dem Server, alle Benutzermodi auf einmal zu senden, wenn
die Befehle <<command_irc_names,/names>> und <<command_irc_whois,/whois>> genutzt werden. +
////
Beispiele: Ausgabe von `/names`:
....
-- Nicks #test: [@%+alice bob +carol]
....
////
[NOTE]
Momentan zeigt WeeChat nicht alle Präfixe in der Ausgabe von `/names` an, selbst wenn
diese empfangen und intern ordnungsgemäß verarbeitet werden.
Beispiele: Ausgabe von `/whois alice`:
....
-- [alice] @%+#test
....
[[irc_ircv3_sasl]]
==== SASL
Spezifikation: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
Siehe das entsprechende Kapitel <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
==== server-time
Spezifikation: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
Diese Fähigkeit ermöglicht es dem Server, die Zeit für Nachrichten als Nachrichten-Tag zu senden. +
Wenn die Zeit in einer Nachricht empfangen wird, verwendet WeeChat diese, um die Nachricht anzuzeigen
(diese Nachricht kann dann mit einem zurückliegenden Datum angezeigt werden).
Der <<relay_irc_proxy,IRC-Proxy>> der Relay-Erweiterung unterstützt diese Funktion,
deshalb sollte jeder IRC-Client der mit dem Relay verbunden ist, diese Funktion aktivieren,
um die korrekte Uhrzeit der Nachricht im Verlaufsspeicher anzuzeigen.
[[irc_ircv3_setname]]
==== setname
Spezifikation: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
Mit dieser Funktion können Sie Ihren richtigen Namen ändern, indem Sie den
<<command_irc_setname,/setname>> Befehl nutzen.
[[irc_ircv3_typing]]
==== typing
Spezifikation: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
Siehe das entsprechende Kapitel <<typing_notifications,Typing notifications>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
Spezifikation: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
Diese Funktion ermöglicht es dem Server, Hostnamen bei <<command_irc_names,/names>> zu senden.
[NOTE]
WeeChat zeigt keine Hostnamen in der Aushabe des `/names` Befehls an.
Beispiel für unverarbeitete IRC-Nachrichten, die ohne die Fähigkeit empfangen wurden:
....
:irc.server 353 alice = #test :@alice bob +carol
....
Beispiel für unverarbeitete IRC-Nachrichten, die mit der Funktion empfangen wurden:
....
:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3
....
[[irc_ircv3_whox]]
==== WHOX
Spezifikation: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
Mit dieser Funktion können Sie zusätzliche Felder in der WHO-Antwort anfordern
(mit dem Befehl <<command_irc_who,/who>>). +
WeeChat zeigt alle empfangenen Zusatzinformationen in der WHO-Ausgabe an.
[[irc_channels]]
=== Kanäle
+350 -350
View File
@@ -3390,356 +3390,6 @@ which can also be for example `~/.weechat`.
For more information, please look at
https://www.oftc.net/NickServ/CertFP/[this page ^↗^,window=_blank].
[[irc_ircv3_support]]
==== IRCv3 support
WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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 https://ircv3.net/software/clients[this page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
===== account-notify
Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
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[account-tag ^↗^,window=_blank]
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[away-notify ^↗^,window=_blank]
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_batch]]
===== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
===== cap-notify
Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
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[chghost ^↗^,window=_blank]
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_draft_multiline]]
===== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
[[irc_ircv3_echo_message]]
===== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
===== extended-join
Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
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[invite-notify ^↗^,window=_blank]
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[message-tags ^↗^,window=_blank]
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[monitor ^↗^,window=_blank]
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[multi-prefix ^↗^,window=_blank]
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[SASL 3.2 ^↗^,window=_blank]
See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
===== server-time
Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
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[setname ^↗^,window=_blank]
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[typing ^↗^,window=_blank]
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[userhost-in-names ^↗^,window=_blank]
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[WHOX ^↗^,window=_blank]
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
@@ -3887,6 +3537,356 @@ And finally, connect to the server:
/connect irc-tor
----
[[irc_ircv3_support]]
=== IRCv3 support
WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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 https://ircv3.net/software/clients[this page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
==== account-notify
Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
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[account-tag ^↗^,window=_blank]
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[away-notify ^↗^,window=_blank]
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_batch]]
==== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
==== cap-notify
Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
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[chghost ^↗^,window=_blank]
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_draft_multiline]]
==== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
[[irc_ircv3_echo_message]]
==== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
==== extended-join
Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
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[invite-notify ^↗^,window=_blank]
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[message-tags ^↗^,window=_blank]
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[monitor ^↗^,window=_blank]
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[multi-prefix ^↗^,window=_blank]
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[SASL 3.2 ^↗^,window=_blank]
See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
==== server-time
Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
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[setname ^↗^,window=_blank]
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[typing ^↗^,window=_blank]
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[userhost-in-names ^↗^,window=_blank]
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[WHOX ^↗^,window=_blank]
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_channels]]
=== Channels
+360 -360
View File
@@ -3494,366 +3494,6 @@ config WeeChat qui peut aussi être par exemple `~/.weechat`.
Pour plus d'informations, merci de consulter
https://www.oftc.net/NickServ/CertFP/[cette page ^↗^,window=_blank].
[[irc_ircv3_support]]
==== Support IRCv3
WeeChat supporte les https://ircv3.net/irc/[extensions IRCv3 ^↗^,window=_blank] suivantes :
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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 https://ircv3.net/software/clients[cette page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
===== account-notify
Spécification : https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
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[account-tag ^↗^,window=_blank]
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[away-notify ^↗^,window=_blank]
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_batch]]
===== batch
Spécification : https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
Cette capacité autorise le serveur à envoyer des évènements "batch" (regroupement
de plusieurs messages qui sont liés).
Pour l'instant, WeeChat stocke seulement ces messages reçus dans un "batch"
et les traite plus tard comme d'habitude, lorsque le "batch" prend fin.
[[irc_ircv3_cap_notify]]
===== cap-notify
Spécification : https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
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[chghost ^↗^,window=_blank]
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_draft_multiline]]
===== draft/multiline
Spécification : https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
Cette capacité autorise le client et le serveur à envoyer des messages avec
plusieurs lignes, en utilisant la capacité <<irc_ircv3_batch,batch>>, qui doit
être activée également.
Il y a des limites en terme d'octets ou nombre de lignes dans un message
multi-lignes qui sont données dans la capacité envoyée par le serveur,
par exemple :
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
Cela fixe la limite à 4096 octets et 24 lignes pour un contenu "batch"
multi-lignes.
Si les limites ne sont pas envoyées par le serveur, celles par défaut dans
WeeChat sont :
* max octets : 4096
* max lignes : 24
Seuls les messages standards et ceux envoyés avec la commande
<<command_irc_notice,/notice>> peuvent être multi-lignes. +
Les messages ACTION CTCP envoyés par avec la commande <<command_irc_me,/me>>
ne sont pas affectés par cette capacité. Cela signifie que les actions
multi-lignes sont envoyées sous forme de plusieurs actions.
[WARNING]
Comme la spécification est un brouillon (« draft »), elle peut changer et le
support "multiline" peut être cassé à tout moment dans WeeChat. +
La capacité est automatiquement activée si le serveur la supporte et peut être
désactivée avec cette commande :
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
Lorsque la capacité est désactivée, un message multi-lignes est envoyé sous
forme de plusieurs messages, comme s'ils avaient été envoyés séquentiellement
au serveur.
Exemple de messages IRC envoyés pour un message utilisateur avec deux lignes
(`ceci est un test` / `sur deux lignes`), envoyé au canal #test :
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :ceci est un test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :sur deux lignes
BATCH -i8Je7M7gquddoyC9
....
Affichage du message envoyé dans WeeChat :
....
19:01:45 alice | ceci est un test
| sur deux lignes
....
[[irc_ircv3_echo_message]]
===== echo-message
Spécification : https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
Cette capacité oblige le serveur à renvoyer les messages PRIVMSG, NOTICE et TAGMSG
à WeeChat.
WeeChat affiche seulement le message reçu et non pas le message envoyé, donc
un délai peut être perçu entre l'envoi et l'affichage. Lorsque le message est
affiché, cela signifie qu'il a bien été reçu par le serveur et également propagé
aux autres clients connectés sur le serveur.
[[irc_ircv3_extended_join]]
===== extended-join
Spécification : https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
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[invite-notify ^↗^,window=_blank]
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[message-tags ^↗^,window=_blank]
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[monitor ^↗^,window=_blank]
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[multi-prefix ^↗^,window=_blank]
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[SASL 3.2 ^↗^,window=_blank]
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[server-time ^↗^,window=_blank]
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[setname ^↗^,window=_blank]
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[typing ^↗^,window=_blank]
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[userhost-in-names ^↗^,window=_blank]
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[WHOX ^↗^,window=_blank]
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
@@ -4007,6 +3647,366 @@ Et enfin, connectez-vous au serveur :
/connect irc-tor
----
[[irc_ircv3_support]]
=== Support IRCv3
WeeChat supporte les https://ircv3.net/irc/[extensions IRCv3 ^↗^,window=_blank] suivantes :
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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 https://ircv3.net/software/clients[cette page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
==== account-notify
Spécification : https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
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[account-tag ^↗^,window=_blank]
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[away-notify ^↗^,window=_blank]
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_batch]]
==== batch
Spécification : https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
Cette capacité autorise le serveur à envoyer des évènements "batch" (regroupement
de plusieurs messages qui sont liés).
Pour l'instant, WeeChat stocke seulement ces messages reçus dans un "batch"
et les traite plus tard comme d'habitude, lorsque le "batch" prend fin.
[[irc_ircv3_cap_notify]]
==== cap-notify
Spécification : https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
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[chghost ^↗^,window=_blank]
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_draft_multiline]]
==== draft/multiline
Spécification : https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
Cette capacité autorise le client et le serveur à envoyer des messages avec
plusieurs lignes, en utilisant la capacité <<irc_ircv3_batch,batch>>, qui doit
être activée également.
Il y a des limites en terme d'octets ou nombre de lignes dans un message
multi-lignes qui sont données dans la capacité envoyée par le serveur,
par exemple :
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
Cela fixe la limite à 4096 octets et 24 lignes pour un contenu "batch"
multi-lignes.
Si les limites ne sont pas envoyées par le serveur, celles par défaut dans
WeeChat sont :
* max octets : 4096
* max lignes : 24
Seuls les messages standards et ceux envoyés avec la commande
<<command_irc_notice,/notice>> peuvent être multi-lignes. +
Les messages ACTION CTCP envoyés par avec la commande <<command_irc_me,/me>>
ne sont pas affectés par cette capacité. Cela signifie que les actions
multi-lignes sont envoyées sous forme de plusieurs actions.
[WARNING]
Comme la spécification est un brouillon (« draft »), elle peut changer et le
support "multiline" peut être cassé à tout moment dans WeeChat. +
La capacité est automatiquement activée si le serveur la supporte et peut être
désactivée avec cette commande :
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
Lorsque la capacité est désactivée, un message multi-lignes est envoyé sous
forme de plusieurs messages, comme s'ils avaient été envoyés séquentiellement
au serveur.
Exemple de messages IRC envoyés pour un message utilisateur avec deux lignes
(`ceci est un test` / `sur deux lignes`), envoyé au canal #test :
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :ceci est un test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :sur deux lignes
BATCH -i8Je7M7gquddoyC9
....
Affichage du message envoyé dans WeeChat :
....
19:01:45 alice | ceci est un test
| sur deux lignes
....
[[irc_ircv3_echo_message]]
==== echo-message
Spécification : https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
Cette capacité oblige le serveur à renvoyer les messages PRIVMSG, NOTICE et TAGMSG
à WeeChat.
WeeChat affiche seulement le message reçu et non pas le message envoyé, donc
un délai peut être perçu entre l'envoi et l'affichage. Lorsque le message est
affiché, cela signifie qu'il a bien été reçu par le serveur et également propagé
aux autres clients connectés sur le serveur.
[[irc_ircv3_extended_join]]
==== extended-join
Spécification : https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
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[invite-notify ^↗^,window=_blank]
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[message-tags ^↗^,window=_blank]
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[monitor ^↗^,window=_blank]
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[multi-prefix ^↗^,window=_blank]
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[SASL 3.2 ^↗^,window=_blank]
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[server-time ^↗^,window=_blank]
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[setname ^↗^,window=_blank]
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[typing ^↗^,window=_blank]
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[userhost-in-names ^↗^,window=_blank]
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[WHOX ^↗^,window=_blank]
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_channels]]
=== Canaux
+353 -353
View File
@@ -3678,359 +3678,6 @@ which can also be for example `~/.weechat`.
For more information, please look at
https://www.oftc.net/NickServ/CertFP/[this page ^↗^,window=_blank].
// TRANSLATION MISSING
[[irc_ircv3_support]]
==== IRCv3 support
WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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 https://ircv3.net/software/clients[this page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
===== account-notify
Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
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[account-tag ^↗^,window=_blank]
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[away-notify ^↗^,window=_blank]
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_batch]]
===== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
===== cap-notify
Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
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[chghost ^↗^,window=_blank]
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
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
===== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
===== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
===== extended-join
Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
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[invite-notify ^↗^,window=_blank]
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[message-tags ^↗^,window=_blank]
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[monitor ^↗^,window=_blank]
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[multi-prefix ^↗^,window=_blank]
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[SASL 3.2 ^↗^,window=_blank]
See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
===== server-time
Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
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[setname ^↗^,window=_blank]
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[typing ^↗^,window=_blank]
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[userhost-in-names ^↗^,window=_blank]
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[WHOX ^↗^,window=_blank]
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
@@ -4194,6 +3841,359 @@ And finally, connect to the server:
/connect irc-tor
----
// TRANSLATION MISSING
[[irc_ircv3_support]]
=== IRCv3 support
WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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 https://ircv3.net/software/clients[this page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
==== account-notify
Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
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[account-tag ^↗^,window=_blank]
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[away-notify ^↗^,window=_blank]
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_batch]]
==== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
==== cap-notify
Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
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[chghost ^↗^,window=_blank]
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
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
==== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
==== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
==== extended-join
Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
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[invite-notify ^↗^,window=_blank]
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[message-tags ^↗^,window=_blank]
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[monitor ^↗^,window=_blank]
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[multi-prefix ^↗^,window=_blank]
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[SASL 3.2 ^↗^,window=_blank]
See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
==== server-time
Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
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[setname ^↗^,window=_blank]
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[typing ^↗^,window=_blank]
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[userhost-in-names ^↗^,window=_blank]
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[WHOX ^↗^,window=_blank]
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.
// TRANSLATION MISSING
[[irc_channels]]
=== Channels
+354 -354
View File
@@ -3544,360 +3544,6 @@ which can also be for example `~/.weechat`.
For more information, please look at
https://www.oftc.net/NickServ/CertFP/[this page ^↗^,window=_blank].
// TRANSLATION MISSING
[[irc_ircv3_support]]
==== IRCv3 support
WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
* <<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_batch,batch>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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 https://ircv3.net/software/clients[this page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
===== account-notify
Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
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[account-tag ^↗^,window=_blank]
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[away-notify ^↗^,window=_blank]
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>>
// TRANSLATION MISSING
[[irc_ircv3_batch]]
===== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
===== cap-notify
Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
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[chghost ^↗^,window=_blank]
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 に変更しました
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
===== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
===== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
===== extended-join
Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
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[invite-notify ^↗^,window=_blank]
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[message-tags ^↗^,window=_blank]
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[monitor ^↗^,window=_blank]
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[multi-prefix ^↗^,window=_blank]
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[SASL 3.2 ^↗^,window=_blank]
See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
===== server-time
Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
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[setname ^↗^,window=_blank]
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[typing ^↗^,window=_blank]
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[userhost-in-names ^↗^,window=_blank]
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[WHOX ^↗^,window=_blank]
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 認証
@@ -4053,6 +3699,360 @@ And finally, connect to the server:
/connect irc-tor
----
// TRANSLATION MISSING
[[irc_ircv3_support]]
=== IRCv3 support
WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
* <<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_batch,batch>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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 https://ircv3.net/software/clients[this page ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
==== account-notify
Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
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[account-tag ^↗^,window=_blank]
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[away-notify ^↗^,window=_blank]
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>>
// TRANSLATION MISSING
[[irc_ircv3_batch]]
==== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
==== cap-notify
Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
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[chghost ^↗^,window=_blank]
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 に変更しました
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
==== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
==== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
==== extended-join
Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
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[invite-notify ^↗^,window=_blank]
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[message-tags ^↗^,window=_blank]
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[monitor ^↗^,window=_blank]
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[multi-prefix ^↗^,window=_blank]
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[SASL 3.2 ^↗^,window=_blank]
See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
==== server-time
Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
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[setname ^↗^,window=_blank]
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[typing ^↗^,window=_blank]
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[userhost-in-names ^↗^,window=_blank]
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[WHOX ^↗^,window=_blank]
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.
// TRANSLATION MISSING
[[irc_channels]]
=== Channels
+354 -354
View File
@@ -3433,360 +3433,6 @@ który może być ustawiony na przykład na `~/.weechat`.
Więcej informacji można znaleźć odwiedzając
https://www.oftc.net/NickServ/CertFP/[tą stronę ^↗^,window=_blank].
[[irc_ircv3_support]]
==== Wsparcie dla IRCv3
WeeChat wspiera następujące https://ircv3.net/irc/[rozszerzenia IRCv3 ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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>>
Domyślnie wszystkie możliwości wspierane przez serwer i WeeChat są
automatycznie włączone
(opcja <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Tabele z porównaniem różnych klientów IRC, także WeeChat, można znaleźć na
https://ircv3.net/software/clients[tej stronie ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
===== account-notify
Specyfikacja: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie wiadomości po tym jak użytkownik
zostanie zidentyfikwany lub niezidentyfikowany na serwerze. +
WeeChat wyświetla takie wiadomości jeśli opcja
<<option_irc.look.display_account_message,irc.look.display_account_message>>
jest włączona (domyślna wartość).
Przykłady:
....
-- alice zidentyfikował się jako Alice01
-- alice został niezidentyfikowany
....
[[irc_ircv3_account_tag]]
===== account-tag
Specyfikacja: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie komend konta jako tagów wiadomości
do komend wysyłanych do klienta. +
WeeChat parsuje te tagi i zapisuje je w wiadomości ale nie jest on używany ani
wyświetlany. Można ich użyć w komendzie <<command_filter,/filter>> do filtrowania
wiadmości pasujących do konkretnych kont:
Przykład otrzymanej nieprzetworzonej wiadomości:
....
@account=Alice01 :user@example.com PRIVMSG #test :Hello!
....
Wiadomość wyświetlana na kanale:
....
<alice> Hello!
....
Wiadomość z tagami:
....
<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
Specyfikacja: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie powiadomień o nieobecności do
użytkowników znajdujących się na tych samych kanałach co ty.
Kiedy status nieobecności zmienia się dla użytkownika, jest to odzwierciedlane
konkretnym kolorze na liście nicków, za pomocą następujących opcji:
* <<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>>
// TRANSLATION MISSING
[[irc_ircv3_batch]]
===== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
===== cap-notify
Specyfikacja: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na ogłaszanie nowych lub usuniętych możliwości
na serwerze (za pomocą komend `CAP NEW` i `CAP DEL`i).
Przykłady:
....
-- irc: możliwości klienta, teraz dostępne: sasl
-- irc: możliwości klienta, usunięte: sasl
....
[[irc_ircv3_chghost]]
===== chghost
Specyfikacja: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
Ta właściwośc pozwala serwerowi na wysyłanie wiadomości, kiedy użytkownik zmienia
nazwę lub hosta. Kiedy opcja <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
jest włączona (domyślna wartość), zmiany hosta są domyślnie ukrywane jeśli dany
nick nie odzywał się od kilku minut. +
Kolor wiadomości o zmianie hosta można ustawić za pomocą opcji
<<option_irc.color.message_chghost,irc.color.message_chghost>>.
Przykłady:
....
-- alice (user@example.com) zmienił hosta na test.com
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
===== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
===== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
===== extended-join
Specyfikacja: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie konta i prawdziwej nazwy,
kiedy użytkownicy wchodzą na kanały. +
WeeChat wyświetla te dodatkowe informacje jeśli opcja
<<option_irc.look.display_extended_join,irc.look.display_extended_join>>
jest włączona (domyślna wartość).
Przykład:
....
--> john [John01] (John Doe) (~user@example.com) wszedł na #test
....
[[irc_ircv3_invite_notify]]
===== invite-notify
Specyfikacja: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie wiadomości zaproszeń, kiedy
użytkownicy są zapraszani na kanały.
Przykłady:
....
-- alice zaprosił bob na #test
....
[[irc_ircv3_message_tags]]
===== message-tags
Specyfikacja: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
Ta właściwość pozwala dodawać metdane do wiadomości. +
Tagi te mogą być wyświetlone za pomocą komendy `/debug tags`.
Musi to być włączone, żeby używać <<typing_notifications,powiadomień o pisaniu>>.
[[irc_ircv3_monitor]]
===== monitor
Specyfikacja: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie powiadomień kiedy klient
stanie się online lub offline. +
WeeChat automatycznie użyje tego rozszerzenia jeśli jest dostępne podczas
użycia komendy <<command_irc_notify,/notify>>.
[[irc_ircv3_multi_prefix]]
===== multi-prefix
Specyfikacja: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie wszystkich trybów użytkownika
na raz w odpowiedziach na <<command_irc_names,/names>> i <<command_irc_whois,/whois>>. +
////
Przykład: wynik `/names`:
....
-- Nicki #test: [@%+alice bob +carol]
....
////
[NOTE]
Obecnie WeeChat nie wyświetla wszystkich prefuksów w wyniku komendy `/names`,
nawet jeśli zostały poprawnie otrzmane i zapisane wewnętrznie.
Przykład: wynik `/whois alice`:
....
-- [alice] @%+#test
....
[[irc_ircv3_sasl]]
===== SASL
Specyfikacja: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
Zobacz dedykowany rozdział <<irc_sasl_authentication,autentykacja SASL>>.
[[irc_ircv3_server_time]]
===== server-time
Specyfikacja: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie czasu dla wiadomości w tagach. +
Po otrzymaniu czasu w wiadomości WeeChat używa go do jej wyświetlenia
(może zostać wyświetlona z wrześniejszym czasem).
<<relay_irc_proxy,IRC proxy>> we wtyczce Relay wspiera tą właściwość,
każdy klient IRC połączony z Relay powinien włączyć tą właściwość jeśli
chce wyświetlać prawdziwi czas wysłania wiadomości.
[[irc_ircv3_setname]]
===== setname
Specyfikacja: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
Ta właściwość pozwala zmienić prawdziwą nazwę za pomocą komendy
<<command_irc_setname,/setname>>.
[[irc_ircv3_typing]]
===== typing
Specyfikacja: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
Zobacz dedykowany rozdział <<typing_notifications,Powiadomienia o pisaniu>>.
[[irc_ircv3_userhost_in_names]]
===== userhost-in-names
Specyfikacja: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie nazwy kostów w odpowiedzi na
komendę <<command_irc_names,/names>>.
[NOTE]
WeeChat nie wyświetla nazwy hostów w wyjściu komendy `/names`.
Przykład nieprzetworzonych wiadomości IRC otrzymanych bez tej właściwości:
....
:irc.server 353 alice = #test :@alice bob +carol
....
Przykład nieprzetworzonych wiadomości IRC z tą właściwością:
....
:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3
....
[[irc_ircv3_whox]]
===== WHOX
Specyfikacja: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
Ta właściwość pozwala na zarządanie dodatkowych pól w odpowiedzi na WHO
(przez komendę <<command_irc_who,/who>>). +
WeeChat wyświetla wszystkie dodatkowe informacje otrzymane w odpowiedzi
na WHO.
[[irc_sasl_authentication]]
==== Uwierzytelnianie SASL
@@ -3935,6 +3581,360 @@ Teraz pozostaje już się tylko połączyć z serwerem:
/connect irc-tor
----
[[irc_ircv3_support]]
=== Wsparcie dla IRCv3
WeeChat wspiera następujące https://ircv3.net/irc/[rozszerzenia IRCv3 ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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>>
Domyślnie wszystkie możliwości wspierane przez serwer i WeeChat są
automatycznie włączone
(opcja <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Tabele z porównaniem różnych klientów IRC, także WeeChat, można znaleźć na
https://ircv3.net/software/clients[tej stronie ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
==== account-notify
Specyfikacja: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie wiadomości po tym jak użytkownik
zostanie zidentyfikwany lub niezidentyfikowany na serwerze. +
WeeChat wyświetla takie wiadomości jeśli opcja
<<option_irc.look.display_account_message,irc.look.display_account_message>>
jest włączona (domyślna wartość).
Przykłady:
....
-- alice zidentyfikował się jako Alice01
-- alice został niezidentyfikowany
....
[[irc_ircv3_account_tag]]
==== account-tag
Specyfikacja: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie komend konta jako tagów wiadomości
do komend wysyłanych do klienta. +
WeeChat parsuje te tagi i zapisuje je w wiadomości ale nie jest on używany ani
wyświetlany. Można ich użyć w komendzie <<command_filter,/filter>> do filtrowania
wiadmości pasujących do konkretnych kont:
Przykład otrzymanej nieprzetworzonej wiadomości:
....
@account=Alice01 :user@example.com PRIVMSG #test :Hello!
....
Wiadomość wyświetlana na kanale:
....
<alice> Hello!
....
Wiadomość z tagami:
....
<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
Specyfikacja: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie powiadomień o nieobecności do
użytkowników znajdujących się na tych samych kanałach co ty.
Kiedy status nieobecności zmienia się dla użytkownika, jest to odzwierciedlane
konkretnym kolorze na liście nicków, za pomocą następujących opcji:
* <<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>>
// TRANSLATION MISSING
[[irc_ircv3_batch]]
==== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
==== cap-notify
Specyfikacja: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na ogłaszanie nowych lub usuniętych możliwości
na serwerze (za pomocą komend `CAP NEW` i `CAP DEL`i).
Przykłady:
....
-- irc: możliwości klienta, teraz dostępne: sasl
-- irc: możliwości klienta, usunięte: sasl
....
[[irc_ircv3_chghost]]
==== chghost
Specyfikacja: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
Ta właściwośc pozwala serwerowi na wysyłanie wiadomości, kiedy użytkownik zmienia
nazwę lub hosta. Kiedy opcja <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
jest włączona (domyślna wartość), zmiany hosta są domyślnie ukrywane jeśli dany
nick nie odzywał się od kilku minut. +
Kolor wiadomości o zmianie hosta można ustawić za pomocą opcji
<<option_irc.color.message_chghost,irc.color.message_chghost>>.
Przykłady:
....
-- alice (user@example.com) zmienił hosta na test.com
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
==== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
==== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
==== extended-join
Specyfikacja: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie konta i prawdziwej nazwy,
kiedy użytkownicy wchodzą na kanały. +
WeeChat wyświetla te dodatkowe informacje jeśli opcja
<<option_irc.look.display_extended_join,irc.look.display_extended_join>>
jest włączona (domyślna wartość).
Przykład:
....
--> john [John01] (John Doe) (~user@example.com) wszedł na #test
....
[[irc_ircv3_invite_notify]]
==== invite-notify
Specyfikacja: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie wiadomości zaproszeń, kiedy
użytkownicy są zapraszani na kanały.
Przykłady:
....
-- alice zaprosił bob na #test
....
[[irc_ircv3_message_tags]]
==== message-tags
Specyfikacja: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
Ta właściwość pozwala dodawać metdane do wiadomości. +
Tagi te mogą być wyświetlone za pomocą komendy `/debug tags`.
Musi to być włączone, żeby używać <<typing_notifications,powiadomień o pisaniu>>.
[[irc_ircv3_monitor]]
==== monitor
Specyfikacja: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie powiadomień kiedy klient
stanie się online lub offline. +
WeeChat automatycznie użyje tego rozszerzenia jeśli jest dostępne podczas
użycia komendy <<command_irc_notify,/notify>>.
[[irc_ircv3_multi_prefix]]
==== multi-prefix
Specyfikacja: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie wszystkich trybów użytkownika
na raz w odpowiedziach na <<command_irc_names,/names>> i <<command_irc_whois,/whois>>. +
////
Przykład: wynik `/names`:
....
-- Nicki #test: [@%+alice bob +carol]
....
////
[NOTE]
Obecnie WeeChat nie wyświetla wszystkich prefuksów w wyniku komendy `/names`,
nawet jeśli zostały poprawnie otrzmane i zapisane wewnętrznie.
Przykład: wynik `/whois alice`:
....
-- [alice] @%+#test
....
[[irc_ircv3_sasl]]
==== SASL
Specyfikacja: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
Zobacz dedykowany rozdział <<irc_sasl_authentication,autentykacja SASL>>.
[[irc_ircv3_server_time]]
==== server-time
Specyfikacja: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie czasu dla wiadomości w tagach. +
Po otrzymaniu czasu w wiadomości WeeChat używa go do jej wyświetlenia
(może zostać wyświetlona z wrześniejszym czasem).
<<relay_irc_proxy,IRC proxy>> we wtyczce Relay wspiera tą właściwość,
każdy klient IRC połączony z Relay powinien włączyć tą właściwość jeśli
chce wyświetlać prawdziwi czas wysłania wiadomości.
[[irc_ircv3_setname]]
==== setname
Specyfikacja: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
Ta właściwość pozwala zmienić prawdziwą nazwę za pomocą komendy
<<command_irc_setname,/setname>>.
[[irc_ircv3_typing]]
==== typing
Specyfikacja: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
Zobacz dedykowany rozdział <<typing_notifications,Powiadomienia o pisaniu>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
Specyfikacja: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
Ta właściwość pozwala serwerowi na wysyłanie nazwy kostów w odpowiedzi na
komendę <<command_irc_names,/names>>.
[NOTE]
WeeChat nie wyświetla nazwy hostów w wyjściu komendy `/names`.
Przykład nieprzetworzonych wiadomości IRC otrzymanych bez tej właściwości:
....
:irc.server 353 alice = #test :@alice bob +carol
....
Przykład nieprzetworzonych wiadomości IRC z tą właściwością:
....
:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3
....
[[irc_ircv3_whox]]
==== WHOX
Specyfikacja: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
Ta właściwość pozwala na zarządanie dodatkowych pól w odpowiedzi na WHO
(przez komendę <<command_irc_who,/who>>). +
WeeChat wyświetla wszystkie dodatkowe informacje otrzymane w odpowiedzi
na WHO.
[[irc_channels]]
=== Kanały
+349 -349
View File
@@ -3184,355 +3184,6 @@ $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick
За више информација, молимо вас да погледате
https://www.oftc.net/NickServ/CertFP/[ову страницу ^↗^,window=_blank].
[[irc_ircv3_support]]
==== IRCv3 подршка
WeeChat подржава следећа https://ircv3.net/irc/[IRCv3 проширења ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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>>
Подразумевно су укључене све могућности које подржавају и сервер и WeeChat (погледајте
опцију <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Табеле са поређењем различитих IRC клијената, укључујући и WeeChat, налазе се на
on https://ircv3.net/software/clients[овој страници ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
===== account-notify
Спецификација: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље поруке када се корисници идентификују на сервер или
када са сервера уклоне своју идентификацију. +
WeeChat такве поруке приказује ако је опција
<<option_irc.look.display_account_message,irc.look.display_account_message>>
укључена (што је подразумевана вредност).
Примери:
....
-- alice се идентификовао као Alice01
-- alice је уклонио идентификацију
....
[[irc_ircv3_account_tag]]
===== account-tag
Спецификација: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље налог као ознаку поруке у командама које шаље клијенту. +
WeeChat парсира ову ознаку у чува је у поруци, али се она не користи нити приказује. Може да се
користи у <<command_filter,/filter>> команди за филтрирање порука које се подударају са
одређеним налозима.
Пример примљене сирове IRC поруке:
....
@account=Alice01 :user@example.com PRIVMSG #test :Здраво!
....
Порука која се приказује у каналу:
....
<alice> Здраво!
....
Порука са ознакама:
....
<alice> Здраво! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1]
....
[[irc_ircv3_away_notify]]
===== away-notify
Спецификација: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
Ово могућност оспособљава сервер да шаље обавештења о одсуству за кориснике на истом каналу
на којем се и ви налазите.
Када се за корисника промени статус одсутности (одсутан или ту је), то се употребом
следећих опција осликава одређеном бојом у листи надимака:
* <<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>>
// TRANSLATION MISSING
[[irc_ircv3_batch]]
===== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
===== cap-notify
Спецификација: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
Ово могућност оспособљава сервер да објављује нове или уклоњене могућности сервера
(посредством `CAP NEW` и `CAP DEL` команди).
Примери:
....
-- irc: могућност клијента, сада је доступно: sasl
-- irc: могућност клијента, уклоњено: sasl
....
[[irc_ircv3_chghost]]
===== chghost
Спецификација: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље поруке када корисници промене име или хост. +
Када је опција <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
укључена (што је подразумевана вредност), промене хоста се аутоматски скривају ако
надимак није говорио неколико минута. +
Боја поруке о промени хоста се контролише опцијом
<<option_irc.color.message_chghost,irc.color.message_chghost>>.
Пример:
....
-- alice (user@example.com) је променио свој хост на test.com
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
===== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
===== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
===== extended-join
Спецификација: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље налог и право име када корисници приступе
каналима. +
WeeChat приказује ове додатне информације у порукама приступа ако је опција
<<option_irc.look.display_extended_join,irc.look.display_extended_join>>
укључена (што је подразумевана вредност).
Пример:
....
--> john [John01] (John Doe) (~user@example.com) је приступио у #test
....
[[irc_ircv3_invite_notify]]
===== invite-notify
Спецификација: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље позивне поруке када се корисници позову на канале.
Пример:
....
-- alice је позвао bob на #test
....
[[irc_ircv3_message_tags]]
===== message-tags
Спецификација: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
Ова могућност оспособљава додавање метаподатака у поруке. +
Ове ознаке могу да се прикажу командом `/debug tags`.
Она мора бити укључена да би се користила <<typing_notifications,обавештења о куцању>>.
[[irc_ircv3_monitor]]
===== monitor
Спецификација: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље обавештења када клијенти оду
ван мреже/повежу се на мрежу. +
Ако је доступно, WeeChat аутоматски користи ово проширење када користи команду
<<command_irc_notify,/notify>>.
[[irc_ircv3_multi_prefix]]
===== multi-prefix
Спецификација: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље све корисничке режиме одједном у
<<command_irc_names,/names>> и <<command_irc_whois,/whois>> одговорима. +
////
Пример: излаз команде `/names`:
....
-- Надимци #test: [@%+alice bob +carol]
....
////
[NOTE]
За сада WeeChat не приказује све префиксе у излазу команде `/names`, чак и ако се
пример и интерно сачувају исправно.
Пример: излаз команде `/whois alice`:
....
-- [alice] @%+#test
....
[[irc_ircv3_sasl]]
===== SASL
Спецификација: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
Погледајте посебно поглавље <<irc_sasl_authentication,SASL аутентификација>>.
[[irc_ircv3_server_time]]
===== server-time
Спецификација: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље време за поруке као ознаку поруке. +
Када се у поруци прими време, WeeChat то користи у приказу поруке (она тада
може да се прикаже са датумом у прошлости).
<<relay_irc_proxy,IRC прокси>> у Relay додатку подржава ову могућност, тако да
би сваки IRC клијент Релеја требало да је укључи како би се приликом повезивања
у дневнику пропуштених порука приказало реално време пристизања порука.
[[irc_ircv3_setname]]
===== setname
Спецификација: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
Ова могућност вам нуди опцију да промените своје реално име употребом
<<command_irc_setname,/setname>> команде.
[[irc_ircv3_typing]]
===== typing
Спецификација: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
Погледајте посебно поглавље <<typing_notifications,Обавештења о куцању>>.
[[irc_ircv3_userhost_in_names]]
===== userhost-in-names
Спецификација: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље имена хостова у <<command_irc_names,/names>> одговорима.
[NOTE]
WeeChat не приказује имена хостова у излазу команде `/names`.
Пример сирових IRC порука примљених без ове могућности:
....
:irc.server 353 alice = #test :@alice bob +carol
....
Пример сирових IRC порука примљених са овом могућношћу:
....
:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3
....
[[irc_ircv3_whox]]
===== WHOX
Спецификација: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
Ова могућност вас оспособљава да у WHO одговору захтевате додатна поља
(помоћу команде <<command_irc_who,/who>>). +
WeeChat приказује све додатне информације које се приме у WHO излазу.
[[irc_sasl_authentication]]
==== SASL аутентификација
@@ -3671,6 +3322,355 @@ $ sudo apt-get install tor
/connect irc-tor
----
[[irc_ircv3_support]]
=== IRCv3 подршка
WeeChat подржава следећа https://ircv3.net/irc/[IRCv3 проширења ^↗^,window=_blank]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
* <<irc_ircv3_away_notify,away-notify>>
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_echo_message,echo-message>>
* <<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>>
Подразумевно су укључене све могућности које подржавају и сервер и WeeChat (погледајте
опцију <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Табеле са поређењем различитих IRC клијената, укључујући и WeeChat, налазе се на
on https://ircv3.net/software/clients[овој страници ^↗^,window=_blank].
[[irc_ircv3_account_notify]]
==== account-notify
Спецификација: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље поруке када се корисници идентификују на сервер или
када са сервера уклоне своју идентификацију. +
WeeChat такве поруке приказује ако је опција
<<option_irc.look.display_account_message,irc.look.display_account_message>>
укључена (што је подразумевана вредност).
Примери:
....
-- alice се идентификовао као Alice01
-- alice је уклонио идентификацију
....
[[irc_ircv3_account_tag]]
==== account-tag
Спецификација: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље налог као ознаку поруке у командама које шаље клијенту. +
WeeChat парсира ову ознаку у чува је у поруци, али се она не користи нити приказује. Може да се
користи у <<command_filter,/filter>> команди за филтрирање порука које се подударају са
одређеним налозима.
Пример примљене сирове IRC поруке:
....
@account=Alice01 :user@example.com PRIVMSG #test :Здраво!
....
Порука која се приказује у каналу:
....
<alice> Здраво!
....
Порука са ознакама:
....
<alice> Здраво! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1]
....
[[irc_ircv3_away_notify]]
==== away-notify
Спецификација: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
Ово могућност оспособљава сервер да шаље обавештења о одсуству за кориснике на истом каналу
на којем се и ви налазите.
Када се за корисника промени статус одсутности (одсутан или ту је), то се употребом
следећих опција осликава одређеном бојом у листи надимака:
* <<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>>
// TRANSLATION MISSING
[[irc_ircv3_batch]]
==== batch
Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
This capability allows the server to send batched events (grouping of several
messages that are related).
For now, WeeChat only stores messages received in a batch and processes as usual
later, when the batch ends.
[[irc_ircv3_cap_notify]]
==== cap-notify
Спецификација: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
Ово могућност оспособљава сервер да објављује нове или уклоњене могућности сервера
(посредством `CAP NEW` и `CAP DEL` команди).
Примери:
....
-- irc: могућност клијента, сада је доступно: sasl
-- irc: могућност клијента, уклоњено: sasl
....
[[irc_ircv3_chghost]]
==== chghost
Спецификација: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље поруке када корисници промене име или хост. +
Када је опција <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
укључена (што је подразумевана вредност), промене хоста се аутоматски скривају ако
надимак није говорио неколико минута. +
Боја поруке о промени хоста се контролише опцијом
<<option_irc.color.message_chghost,irc.color.message_chghost>>.
Пример:
....
-- alice (user@example.com) је променио свој хост на test.com
....
// TRANSLATION MISSING
[[irc_ircv3_draft_multiline]]
==== draft/multiline
Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
There are limits in term of bytes or number of lines in a multiline message
that are given in the capability sent by the server, for example:
....
CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
....
This sets a limit of 4096 bytes and 24 lines for a multiline batched content.
If the limits are not given by the server, the default in WeeChat are:
* max bytes: 4096
* max lines: 24
Only standard messages and those send by the <<command_irc_notice,/notice>>
command can be multiline. +
ACTION CTCP messages sent with command <<command_irc_me,/me>> are not affected
by this capability. That means multiline actions are sent as multiple actions.
[WARNING]
As the specification is a "draft", it may change and the multiline support can
possibly break at any time in WeeChat. +
The capability is automatically enabled if the server supports it and can be
disabled with this command:
`/set irc.server_default.capabilities "*,!draft/multiline"`. +
When the capability is disabled, a multiline message is sent as multiple messages,
as if they were sent sequentially to the server.
Example of IRC messages sent for a user message with two lines (`this is a test`
/ `on two lines`), send to channel #test:
....
BATCH +i8Je7M7gquddoyC9 draft/multiline #test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :this is a test
@batch=i8Je7M7gquddoyC9 PRIVMSG #test :on two lines
BATCH -i8Je7M7gquddoyC9
....
Display of the message sent in WeeChat:
....
19:01:45 alice | this is a test
| on two lines
....
// TRANSLATION MISSING
[[irc_ircv3_echo_message]]
==== echo-message
Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
WeeChat displays only the message received and not the message sent, so a delay
can be noticed between the send and the display. When the message is displayed,
it means it has been properly received by the server and propagated to other
clients connected to the server as well.
[[irc_ircv3_extended_join]]
==== extended-join
Спецификација: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље налог и право име када корисници приступе
каналима. +
WeeChat приказује ове додатне информације у порукама приступа ако је опција
<<option_irc.look.display_extended_join,irc.look.display_extended_join>>
укључена (што је подразумевана вредност).
Пример:
....
--> john [John01] (John Doe) (~user@example.com) је приступио у #test
....
[[irc_ircv3_invite_notify]]
==== invite-notify
Спецификација: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље позивне поруке када се корисници позову на канале.
Пример:
....
-- alice је позвао bob на #test
....
[[irc_ircv3_message_tags]]
==== message-tags
Спецификација: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
Ова могућност оспособљава додавање метаподатака у поруке. +
Ове ознаке могу да се прикажу командом `/debug tags`.
Она мора бити укључена да би се користила <<typing_notifications,обавештења о куцању>>.
[[irc_ircv3_monitor]]
==== monitor
Спецификација: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље обавештења када клијенти оду
ван мреже/повежу се на мрежу. +
Ако је доступно, WeeChat аутоматски користи ово проширење када користи команду
<<command_irc_notify,/notify>>.
[[irc_ircv3_multi_prefix]]
==== multi-prefix
Спецификација: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље све корисничке режиме одједном у
<<command_irc_names,/names>> и <<command_irc_whois,/whois>> одговорима. +
////
Пример: излаз команде `/names`:
....
-- Надимци #test: [@%+alice bob +carol]
....
////
[NOTE]
За сада WeeChat не приказује све префиксе у излазу команде `/names`, чак и ако се
пример и интерно сачувају исправно.
Пример: излаз команде `/whois alice`:
....
-- [alice] @%+#test
....
[[irc_ircv3_sasl]]
==== SASL
Спецификација: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
Погледајте посебно поглавље <<irc_sasl_authentication,SASL аутентификација>>.
[[irc_ircv3_server_time]]
==== server-time
Спецификација: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље време за поруке као ознаку поруке. +
Када се у поруци прими време, WeeChat то користи у приказу поруке (она тада
може да се прикаже са датумом у прошлости).
<<relay_irc_proxy,IRC прокси>> у Relay додатку подржава ову могућност, тако да
би сваки IRC клијент Релеја требало да је укључи како би се приликом повезивања
у дневнику пропуштених порука приказало реално време пристизања порука.
[[irc_ircv3_setname]]
==== setname
Спецификација: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
Ова могућност вам нуди опцију да промените своје реално име употребом
<<command_irc_setname,/setname>> команде.
[[irc_ircv3_typing]]
==== typing
Спецификација: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
Погледајте посебно поглавље <<typing_notifications,Обавештења о куцању>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
Спецификација: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
Ова могућност оспособљава сервер да шаље имена хостова у <<command_irc_names,/names>> одговорима.
[NOTE]
WeeChat не приказује имена хостова у излазу команде `/names`.
Пример сирових IRC порука примљених без ове могућности:
....
:irc.server 353 alice = #test :@alice bob +carol
....
Пример сирових IRC порука примљених са овом могућношћу:
....
:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3
....
[[irc_ircv3_whox]]
==== WHOX
Спецификација: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
Ова могућност вас оспособљава да у WHO одговору захтевате додатна поља
(помоћу команде <<command_irc_who,/who>>). +
WeeChat приказује све додатне информације које се приме у WHO излазу.
[[irc_channels]]
=== Канали