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:
+351
-351
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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]]
|
||||
=== Канали
|
||||
|
||||
|
||||
Reference in New Issue
Block a user