diff options
| -rw-r--r-- | doc/de/includes/autogen_user_options.de.adoc | 44 | ||||
| -rw-r--r-- | doc/de/weechat_user.de.adoc | 101 | ||||
| -rw-r--r-- | doc/en/includes/autogen_user_options.en.adoc | 44 | ||||
| -rw-r--r-- | doc/en/weechat_user.en.adoc | 99 | ||||
| -rw-r--r-- | doc/fr/includes/autogen_user_options.fr.adoc | 44 | ||||
| -rw-r--r-- | doc/fr/weechat_user.fr.adoc | 105 | ||||
| -rw-r--r-- | doc/it/includes/autogen_user_options.it.adoc | 44 | ||||
| -rw-r--r-- | doc/it/weechat_user.it.adoc | 101 | ||||
| -rw-r--r-- | doc/ja/includes/autogen_user_options.ja.adoc | 44 | ||||
| -rw-r--r-- | doc/ja/weechat_user.ja.adoc | 101 | ||||
| -rw-r--r-- | doc/pl/includes/autogen_user_options.pl.adoc | 44 | ||||
| -rw-r--r-- | doc/pl/weechat_user.pl.adoc | 101 | ||||
| -rw-r--r-- | doc/sr/includes/autogen_user_options.sr.adoc | 44 | ||||
| -rw-r--r-- | doc/sr/weechat_user.sr.adoc | 107 |
14 files changed, 1020 insertions, 3 deletions
diff --git a/doc/de/includes/autogen_user_options.de.adoc b/doc/de/includes/autogen_user_options.de.adoc index f47de91de..e65a5c865 100644 --- a/doc/de/includes/autogen_user_options.de.adoc +++ b/doc/de/includes/autogen_user_options.de.adoc @@ -1845,6 +1845,38 @@ ** Standardwert: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+` // end::fifo_options[] +// tag::typing_options[] +* [[option_typing.look.delay_purge_paused]] *typing.look.delay_purge_paused* +** Beschreibung: pass:none[number of seconds after paused status has been set: if reached, the typing status is removed] +** Typ: integer +** Werte: 1 .. 3600 +** Standardwert: `+30+` + +* [[option_typing.look.delay_purge_typing]] *typing.look.delay_purge_typing* +** Beschreibung: pass:none[number of seconds after typing status has been set: if reached, the typing status is removed] +** Typ: integer +** Werte: 1 .. 3600 +** Standardwert: `+6+` + +* [[option_typing.look.delay_set_paused]] *typing.look.delay_set_paused* +** Beschreibung: pass:none[number of seconds after typing last char: if reached, the typing status becomes "paused" and no more typing signals are sent] +** Typ: integer +** Werte: 1 .. 3600 +** Standardwert: `+10+` + +* [[option_typing.look.enabled_nicks]] *typing.look.enabled_nicks* +** Beschreibung: pass:none[typing enabled for other nicks (display typing info for nicks typing in the current buffer)] +** Typ: boolesch +** Werte: on, off +** Standardwert: `+off+` + +* [[option_typing.look.enabled_self]] *typing.look.enabled_self* +** Beschreibung: pass:none[typing enabled for self messages (send typing info to other users)] +** Typ: boolesch +** Werte: on, off +** Standardwert: `+off+` +// end::typing_options[] + // tag::xfer_options[] * [[option_xfer.color.status_aborted]] *xfer.color.status_aborted* ** Beschreibung: pass:none[Textfarbe für Status: "abgebrochen"] @@ -2520,6 +2552,18 @@ ** Werte: on, off ** Standardwert: `+off+` +* [[option_irc.look.typing_status_nicks]] *irc.look.typing_status_nicks* +** Beschreibung: pass:none[display nicks typing on the channel in bar item "typing" (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** Typ: boolesch +** Werte: on, off +** Standardwert: `+off+` + +* [[option_irc.look.typing_status_self]] *irc.look.typing_status_self* +** Beschreibung: pass:none[send self typing status to channels so that other users see when you are typing a message (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** Typ: boolesch +** Werte: on, off +** Standardwert: `+off+` + * [[option_irc.network.autoreconnect_delay_growing]] *irc.network.autoreconnect_delay_growing* ** Beschreibung: pass:none[Multiplikator für die Verzögerung bei der automatischen Wiederverbindung zum Server (1 = immer die selbe Verzögerung nutzen, 2 = Verzögerung*2 für jeden weiteren Versuch, usw.)] ** Typ: integer diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index af1353295..73f670c8e 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -291,6 +291,9 @@ Liste von häufig verwendeten Optionen: | ENABLE_TRIGGER | `ON`, `OFF` | ON | kompiliert <<trigger_plugin,Trigger Erweiterung>>. +| ENABLE_TYPING | `ON`, `OFF` | ON | + kompiliert <<typing_plugin,Typing Erweiterung>>. + | ENABLE_XFER | `ON`, `OFF` | ON | kompiliert <<xfer_plugin,Xfer Erweiterung>>. @@ -732,6 +735,7 @@ Folgende Dateien befinden sich im WeeChat-Heimatverzeichnis: | spell.conf | Konfiguration für _spell_-Erweiterung | Nein. | tcl.conf | Konfiguration für _tcl_-Erweiterung | Nein. | trigger.conf | Konfiguration für _trigger_-Erweiterung | möglich, hängt von den Triggern ab. +| typing.conf | Konfiguration für _typing_-Erweiterung | Nein. | xfer.conf | Konfiguration für _xfer_-Erweiterung | Nein. | weechat.log | WeeChat Logdateien | Nein. |=== @@ -2580,6 +2584,8 @@ Standarderweiterungen: | php | PHP-Skript API. | spell | Rechtschreibprüfung für Befehlszeile. | trigger | Veränderung von Text und Ausführen von Befehlen bei einem Ereignis, welche durch WeeChat oder eine Erweiterung ausgelöst werden. +// TRANSLATION MISSING +| typing | Display users currently writing messages. | xfer | Datentransfer und Direktchat. |=== @@ -4786,6 +4792,101 @@ Optionen: include::includes/autogen_user_options.de.adoc[tag=trigger_options] +// TRANSLATION MISSING +[[typing_plugin]] +=== Typing + +The typing plugin is used to inform other users you are typing messages and +show a list of users currently typing a message on the buffer. + +It is used by IRC plugin on channel and private buffers, when the "message-tags" +capability is enabled (you can check with <<command_irc_cap,/cap>> command). + +Under the hood, typing client tag is used, following this specification: +https://ircv3.net/specs/client-tags/typing.html. + +[[typing_activation]] +==== Activation + +For privacy considerations, the typing feature is disabled by default. + +If you want to use it, you must enable options in both typing and irc plugins: + +---- +/set typing.look.enabled_nicks on +/set typing.look.enabled_self on +/set irc.look.typing_status_nicks on +/set irc.look.typing_status_self on +---- + +Then you must add the "typing" bar item in a bar, for example in option +_weechat.bar.status.items_. + +Example of status bar with the "typing" item: "bob" is typing a message and +"alice" was typing a message but made a pause: + +.... +│[12:55] [6] [irc/libera] 3:#test(+n){4} [Typing: bob, (alice)] │ +│[@Flashy] █ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +.... + +[[typing_signals_sent]] +==== Signals sent + +When you are typing a message (not a command starting with `/`), the typing +plugin sends signals to inform other plugins (like IRC) that you are typing, +and these plugins can then send typing notifications to other users. + +The following signals are sent when you are typing messages: + +[width="100%",cols="1,1,5",options="header"] +|=== +| Signal | Arguments | Description +| typing_self_typing | Pointer: buffer. | You are typing a message. +| typing_self_paused | Pointer: buffer. | You made a pause while typing a message. +| typing_self_cleared | Pointer: buffer. | You cleared the command line without sending the message. +| typing_self_sent | Pointer: buffer. | You sent the message to the buffer. +|=== + +[[typing_signals_caught]] +==== Signals caught + +The typing plugin is catching some signals that can be sent by other plugins +(like IRC), to update internal hashtables used to store the typing state of +nicks on buffers. These hashtables are used to build the content of "typing" +bar item. + +The following signals are caught by the typing plugin: + +[width="100%",cols="1,4,3",options="header"] +|=== +| Signal | Arguments | Description + +| typing_set_nick | + String: buffer pointer + ";" + state (one of: "off", "typing", "paused", + "cleared") + ";" + nick. + + Example: "0x1234abcd;typing;alice". | + Set typing state for a nick on a buffer. + +| typing_reset_buffer | + Pointer: buffer. | + Remove typing state for all nicks on a buffer. +|=== + +[[typing_options]] +==== Optionen + +Sektionen in Datei _typing.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set typing.look.* | Erscheinungsbild. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=typing_options] + [[xfer_plugin]] === Xfer diff --git a/doc/en/includes/autogen_user_options.en.adoc b/doc/en/includes/autogen_user_options.en.adoc index 7f1a514df..44595721d 100644 --- a/doc/en/includes/autogen_user_options.en.adoc +++ b/doc/en/includes/autogen_user_options.en.adoc @@ -1845,6 +1845,38 @@ ** default value: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+` // end::fifo_options[] +// tag::typing_options[] +* [[option_typing.look.delay_purge_paused]] *typing.look.delay_purge_paused* +** description: pass:none[number of seconds after paused status has been set: if reached, the typing status is removed] +** type: integer +** values: 1 .. 3600 +** default value: `+30+` + +* [[option_typing.look.delay_purge_typing]] *typing.look.delay_purge_typing* +** description: pass:none[number of seconds after typing status has been set: if reached, the typing status is removed] +** type: integer +** values: 1 .. 3600 +** default value: `+6+` + +* [[option_typing.look.delay_set_paused]] *typing.look.delay_set_paused* +** description: pass:none[number of seconds after typing last char: if reached, the typing status becomes "paused" and no more typing signals are sent] +** type: integer +** values: 1 .. 3600 +** default value: `+10+` + +* [[option_typing.look.enabled_nicks]] *typing.look.enabled_nicks* +** description: pass:none[typing enabled for other nicks (display typing info for nicks typing in the current buffer)] +** type: boolean +** values: on, off +** default value: `+off+` + +* [[option_typing.look.enabled_self]] *typing.look.enabled_self* +** description: pass:none[typing enabled for self messages (send typing info to other users)] +** type: boolean +** values: on, off +** default value: `+off+` +// end::typing_options[] + // tag::xfer_options[] * [[option_xfer.color.status_aborted]] *xfer.color.status_aborted* ** description: pass:none[text color for "aborted" status] @@ -2520,6 +2552,18 @@ ** values: on, off ** default value: `+off+` +* [[option_irc.look.typing_status_nicks]] *irc.look.typing_status_nicks* +** description: pass:none[display nicks typing on the channel in bar item "typing" (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** type: boolean +** values: on, off +** default value: `+off+` + +* [[option_irc.look.typing_status_self]] *irc.look.typing_status_self* +** description: pass:none[send self typing status to channels so that other users see when you are typing a message (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** type: boolean +** values: on, off +** default value: `+off+` + * [[option_irc.network.autoreconnect_delay_growing]] *irc.network.autoreconnect_delay_growing* ** description: pass:none[growing factor for autoreconnect delay to server (1 = always same delay, 2 = delay*2 for each retry, etc.)] ** type: integer diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index bc5ac9498..40755ea49 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -283,6 +283,9 @@ List of commonly used options: | ENABLE_TRIGGER | `ON`, `OFF` | ON | Compile <<trigger_plugin,Trigger plugin>>. +| ENABLE_TYPING | `ON`, `OFF` | ON | + Compile <<typing_plugin,Typing plugin>>. + | ENABLE_XFER | `ON`, `OFF` | ON | Compile <<xfer_plugin,Xfer plugin>>. @@ -723,6 +726,7 @@ The files in the WeeChat home directory are: | tcl.conf | Configuration file for _tcl_ plugin | No. | spell.conf | Configuration file for _spell_ plugin | No. | trigger.conf | Configuration file for _trigger_ plugin | Possible, depends on triggers. +| typing.conf | Configuration file for _typing_ plugin | No. | xfer.conf | Configuration file for _xfer_ plugin | No. | weechat.log | WeeChat log file | No. |=== @@ -2533,6 +2537,7 @@ Default plugins are: | php | PHP scripting API. | spell | Spell checking for command line. | trigger | Text replacement and command execution on events triggered by WeeChat/plugins. +| typing | Display users currently writing messages. | xfer | File transfer and direct chat. |=== @@ -4694,6 +4699,100 @@ Options: include::includes/autogen_user_options.en.adoc[tag=trigger_options] +[[typing_plugin]] +=== Typing + +The typing plugin is used to inform other users you are typing messages and +show a list of users currently typing a message on the buffer. + +It is used by IRC plugin on channel and private buffers, when the "message-tags" +capability is enabled (you can check with <<command_irc_cap,/cap>> command). + +Under the hood, typing client tag is used, following this specification: +https://ircv3.net/specs/client-tags/typing.html. + +[[typing_activation]] +==== Activation + +For privacy considerations, the typing feature is disabled by default. + +If you want to use it, you must enable options in both typing and irc plugins: + +---- +/set typing.look.enabled_nicks on +/set typing.look.enabled_self on +/set irc.look.typing_status_nicks on +/set irc.look.typing_status_self on +---- + +Then you must add the "typing" bar item in a bar, for example in option +_weechat.bar.status.items_. + +Example of status bar with the "typing" item: "bob" is typing a message and +"alice" was typing a message but made a pause: + +.... +│[12:55] [6] [irc/libera] 3:#test(+n){4} [Typing: bob, (alice)] │ +│[@Flashy] █ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +.... + +[[typing_signals_sent]] +==== Signals sent + +When you are typing a message (not a command starting with `/`), the typing +plugin sends signals to inform other plugins (like IRC) that you are typing, +and these plugins can then send typing notifications to other users. + +The following signals are sent when you are typing messages: + +[width="100%",cols="1,1,5",options="header"] +|=== +| Signal | Arguments | Description +| typing_self_typing | Pointer: buffer. | You are typing a message. +| typing_self_paused | Pointer: buffer. | You made a pause while typing a message. +| typing_self_cleared | Pointer: buffer. | You cleared the command line without sending the message. +| typing_self_sent | Pointer: buffer. | You sent the message to the buffer. +|=== + +[[typing_signals_caught]] +==== Signals caught + +The typing plugin is catching some signals that can be sent by other plugins +(like IRC), to update internal hashtables used to store the typing state of +nicks on buffers. These hashtables are used to build the content of "typing" +bar item. + +The following signals are caught by the typing plugin: + +[width="100%",cols="1,4,3",options="header"] +|=== +| Signal | Arguments | Description + +| typing_set_nick | + String: buffer pointer + ";" + state (one of: "off", "typing", "paused", + "cleared") + ";" + nick. + + Example: "0x1234abcd;typing;alice". | + Set typing state for a nick on a buffer. + +| typing_reset_buffer | + Pointer: buffer. | + Remove typing state for all nicks on a buffer. +|=== + +[[typing_options]] +==== Options + +Sections in file _typing.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set typing.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=typing_options] + [[xfer_plugin]] === Xfer diff --git a/doc/fr/includes/autogen_user_options.fr.adoc b/doc/fr/includes/autogen_user_options.fr.adoc index 3bd094118..d89205520 100644 --- a/doc/fr/includes/autogen_user_options.fr.adoc +++ b/doc/fr/includes/autogen_user_options.fr.adoc @@ -1845,6 +1845,38 @@ ** valeur par défaut: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+` // end::fifo_options[] +// tag::typing_options[] +* [[option_typing.look.delay_purge_paused]] *typing.look.delay_purge_paused* +** description: pass:none[number of seconds after paused status has been set: if reached, the typing status is removed] +** type: entier +** valeurs: 1 .. 3600 +** valeur par défaut: `+30+` + +* [[option_typing.look.delay_purge_typing]] *typing.look.delay_purge_typing* +** description: pass:none[number of seconds after typing status has been set: if reached, the typing status is removed] +** type: entier +** valeurs: 1 .. 3600 +** valeur par défaut: `+6+` + +* [[option_typing.look.delay_set_paused]] *typing.look.delay_set_paused* +** description: pass:none[number of seconds after typing last char: if reached, the typing status becomes "paused" and no more typing signals are sent] +** type: entier +** valeurs: 1 .. 3600 +** valeur par défaut: `+10+` + +* [[option_typing.look.enabled_nicks]] *typing.look.enabled_nicks* +** description: pass:none[typing enabled for other nicks (display typing info for nicks typing in the current buffer)] +** type: booléen +** valeurs: on, off +** valeur par défaut: `+off+` + +* [[option_typing.look.enabled_self]] *typing.look.enabled_self* +** description: pass:none[typing enabled for self messages (send typing info to other users)] +** type: booléen +** valeurs: on, off +** valeur par défaut: `+off+` +// end::typing_options[] + // tag::xfer_options[] * [[option_xfer.color.status_aborted]] *xfer.color.status_aborted* ** description: pass:none[couleur du texte pour le statut "interrompu"] @@ -2520,6 +2552,18 @@ ** valeurs: on, off ** valeur par défaut: `+off+` +* [[option_irc.look.typing_status_nicks]] *irc.look.typing_status_nicks* +** description: pass:none[display nicks typing on the channel in bar item "typing" (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** type: booléen +** valeurs: on, off +** valeur par défaut: `+off+` + +* [[option_irc.look.typing_status_self]] *irc.look.typing_status_self* +** description: pass:none[send self typing status to channels so that other users see when you are typing a message (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** type: booléen +** valeurs: on, off +** valeur par défaut: `+off+` + * [[option_irc.network.autoreconnect_delay_growing]] *irc.network.autoreconnect_delay_growing* ** description: pass:none[facteur de croissance du délai d'auto-reconnexion au serveur (1 = toujours le même délai, 2 = délai*2 pour chaque tentative, etc.)] ** type: entier diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index f729a89b2..de0d818ac 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -288,6 +288,9 @@ Liste des options couramment utilisées : | ENABLE_TRIGGER | `ON`, `OFF` | ON | Compiler <<trigger_plugin,l'extension Trigger>>. +| ENABLE_TYPING | `ON`, `OFF` | ON | + Compiler <<typing_plugin,l'extension Typing>>. + | ENABLE_XFER | `ON`, `OFF` | ON | Compiler <<xfer_plugin,l'extension Xfer>>. @@ -742,6 +745,7 @@ Les fichiers dans le répertoire principal de WeeChat sont : | tcl.conf | Fichier de configuration de l'extension _tcl_ | Non. | spell.conf | Fichier de configuration de l'extension _spell_ | Non. | trigger.conf | Fichier de configuration de l'extension _trigger_ | Possible, cela dépend des triggers. +| typing.conf | Fichier de configuration de l'extension _typing_ | Non. | xfer.conf | Fichier de configuration de l'extension _xfer_ | Non. | weechat.log | Fichier de log WeeChat | Non. |=== @@ -2619,6 +2623,7 @@ Les extensions par défaut sont : | php | Interface (API) pour scripts PHP. | spell | Vérification orthographique de la ligne de commande. | trigger | Remplacement de texte et exécution de commande sur des évènements de WeeChat ou des extensions. +| typing | Affichage des utilisateurs qui sont en train d'écrire des messages. | xfer | Transfert de fichier et discussion directe. |=== @@ -4856,6 +4861,106 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=trigger_options] +[[typing_plugin]] +=== Typing + +L'extension typing est utilisée pour informer les autres utilisateurs quand +vous êtes en train d'écrire un message et afficher la liste des utilisateurs +qui écrivent actuellement un message sur un tampon. + +Elle est utilisée par l'extension IRC sur les tampons de canaux et privés, +lorsque la capacité "message-tags" est activée (vous pouvez vérifier avec la +commande <<command_irc_cap,/cap>>). + +Sous le capot, l'étiquette client typing est utilisée, en suivant cette +spécification : https://ircv3.net/specs/client-tags/typing.html. + +[[typing_activation]] +==== Activation + +Pour des considérations de confidentialité, la fonctionnalité typing est +désactivée par défaut. + +Si vous voulez l'utiliser, vous devez activer des options dans les extensions +typing et irc : + +---- +/set typing.look.enabled_nicks on +/set typing.look.enabled_self on +/set irc.look.typing_status_nicks on +/set irc.look.typing_status_self on +---- + +Puis vous devez ajouter l'objet de barre "typing" dans une barre, par exemple +dans l'option _weechat.bar.status.items_. + +Exemple de barre de statut avec l'objet "typing" : "bob" écrit un message et +"alice" était en train d'en écrire un mais a fait une pause : + +.... +│[12:55] [6] [irc/libera] 3:#test(+n){4} [Écrit : bob, (alice)] │ +│[@Flashy] █ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +.... + +[[typing_signals_sent]] +==== Signaux envoyés + +Lorsque vous écrivez un message (pas une commande commençant par `/`), l'extension +typing envoie des signaux pour informer les autres extensions (comme IRC) que +vous êtres en train d'écrire, et ces extensions peuvent alors envoyer des +notifications aux autres utilisateurs. + +Les signaux suivants sont envoyés quand vous écrivez des messages : + +[width="100%",cols="1,1,5",options="header"] +|=== +| Signal | Paramètres | Description +| typing_self_typing | Pointeur : tampon. | Vous écrivez un message. +| typing_self_paused | Pointeur : tampon. | Vous avez fait une pause dans l'écriture d'un message. +| typing_self_cleared | Pointeur : tampon. | Vous avez effacé la ligne de commande sans envoyée le message. +| typing_self_sent | Pointeur : tampon. | Vous avez envoyé le message au tampon. +|=== + +[[typing_signals_caught]] +==== Signaux captés + +L'extension typing capte des signaux qui peuvent être envoyés par d'autres +extensions (comme IRC), pour mettre à jour des tables de hachage internes +qui sont utilisées pour sauvegarder l'état d'écriture de message des pseudos +sur les tampons. Ces tables de hachages sont utilisées pour construire le +contenu de l'objet de barre "typing". + +Les signaux suivants sont captés par l'extension typing : + +[width="100%",cols="1,4,3",options="header"] +|=== +| Signal | Paramètres | Description + +| typing_set_nick | + Chaîne : pointeur tampon + ";" + état (un parmi ceux-ci : "off", "typing", + "paused", "cleared") + ";" + pseudo. + + Example: "0x1234abcd;typing;alice". | + Définir l'état de la saisie du pseudo sur le tampon. + +| typing_reset_buffer | + Pointeur : tampon. | + Supprimer l'état de saisir pour tous les pseudos d'un tampon. +|=== + +[[typing_options]] +==== Options + +Sections dans le fichier _typing.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set typing.look.* | Aspect/présentation. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=typing_options] + [[xfer_plugin]] === Xfer diff --git a/doc/it/includes/autogen_user_options.it.adoc b/doc/it/includes/autogen_user_options.it.adoc index 9c9beea50..b16a84092 100644 --- a/doc/it/includes/autogen_user_options.it.adoc +++ b/doc/it/includes/autogen_user_options.it.adoc @@ -1845,6 +1845,38 @@ ** valore predefinito: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+` // end::fifo_options[] +// tag::typing_options[] +* [[option_typing.look.delay_purge_paused]] *typing.look.delay_purge_paused* +** descrizione: pass:none[number of seconds after paused status has been set: if reached, the typing status is removed] +** tipo: intero +** valori: 1 .. 3600 +** valore predefinito: `+30+` + +* [[option_typing.look.delay_purge_typing]] *typing.look.delay_purge_typing* +** descrizione: pass:none[number of seconds after typing status has been set: if reached, the typing status is removed] +** tipo: intero +** valori: 1 .. 3600 +** valore predefinito: `+6+` + +* [[option_typing.look.delay_set_paused]] *typing.look.delay_set_paused* +** descrizione: pass:none[number of seconds after typing last char: if reached, the typing status becomes "paused" and no more typing signals are sent] +** tipo: intero +** valori: 1 .. 3600 +** valore predefinito: `+10+` + +* [[option_typing.look.enabled_nicks]] *typing.look.enabled_nicks* +** descrizione: pass:none[typing enabled for other nicks (display typing info for nicks typing in the current buffer)] +** tipo: bool +** valori: on, off +** valore predefinito: `+off+` + +* [[option_typing.look.enabled_self]] *typing.look.enabled_self* +** descrizione: pass:none[typing enabled for self messages (send typing info to other users)] +** tipo: bool +** valori: on, off +** valore predefinito: `+off+` +// end::typing_options[] + // tag::xfer_options[] * [[option_xfer.color.status_aborted]] *xfer.color.status_aborted* ** descrizione: pass:none[colore del testo per lo status "annullato"] @@ -2520,6 +2552,18 @@ ** valori: on, off ** valore predefinito: `+off+` +* [[option_irc.look.typing_status_nicks]] *irc.look.typing_status_nicks* +** descrizione: pass:none[display nicks typing on the channel in bar item "typing" (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** tipo: bool +** valori: on, off +** valore predefinito: `+off+` + +* [[option_irc.look.typing_status_self]] *irc.look.typing_status_self* +** descrizione: pass:none[send self typing status to channels so that other users see when you are typing a message (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** tipo: bool +** valori: on, off +** valore predefinito: `+off+` + * [[option_irc.network.autoreconnect_delay_growing]] *irc.network.autoreconnect_delay_growing* ** descrizione: pass:none[growing factor for autoreconnect delay to server (1 = always same delay, 2 = delay*2 for each retry, etc.)] ** tipo: intero diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index a21ea9f3b..375d8f24e 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -322,6 +322,9 @@ List of commonly used options: | ENABLE_TRIGGER | `ON`, `OFF` | ON | Compile <<trigger_plugin,Trigger plugin>>. +| ENABLE_TYPING | `ON`, `OFF` | ON | + Compile <<typing_plugin,Typing plugin>>. + | ENABLE_XFER | `ON`, `OFF` | ON | Compile <<xfer_plugin,Xfer plugin>>. @@ -789,6 +792,7 @@ The files in the WeeChat home directory are: | spell.conf | Configuration file for _spell_ plugin | No. | tcl.conf | Configuration file for _tcl_ plugin | No. | trigger.conf | Configuration file for _trigger_ plugin | Possible, depends on triggers. +| typing.conf | Configuration file for _typing_ plugin | No. | xfer.conf | Configuration file for _xfer_ plugin | No. | weechat.log | WeeChat log file | No. |=== @@ -2724,6 +2728,8 @@ I plugin predefiniti sono: | spell | Controllo ortografico per la riga di comando. // TRANSLATION MISSING | trigger | Text replacement and command execution on events triggered by WeeChat/plugins. +// TRANSLATION MISSING +| typing | Display users currently writing messages. | xfer | Trasferimento file e chat diretta. |=== @@ -5033,6 +5039,101 @@ Options: include::includes/autogen_user_options.it.adoc[tag=trigger_options] +// TRANSLATION MISSING +[[typing_plugin]] +=== Typing + +The typing plugin is used to inform other users you are typing messages and +show a list of users currently typing a message on the buffer. + +It is used by IRC plugin on channel and private buffers, when the "message-tags" +capability is enabled (you can check with <<command_irc_cap,/cap>> command). + +Under the hood, typing client tag is used, following this specification: +https://ircv3.net/specs/client-tags/typing.html. + +[[typing_activation]] +==== Activation + +For privacy considerations, the typing feature is disabled by default. + +If you want to use it, you must enable options in both typing and irc plugins: + +---- +/set typing.look.enabled_nicks on +/set typing.look.enabled_self on +/set irc.look.typing_status_nicks on +/set irc.look.typing_status_self on +---- + +Then you must add the "typing" bar item in a bar, for example in option +_weechat.bar.status.items_. + +Example of status bar with the "typing" item: "bob" is typing a message and +"alice" was typing a message but made a pause: + +.... +│[12:55] [6] [irc/libera] 3:#test(+n){4} [Typing: bob, (alice)] │ +│[@Flashy] █ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +.... + +[[typing_signals_sent]] +==== Signals sent + +When you are typing a message (not a command starting with `/`), the typing +plugin sends signals to inform other plugins (like IRC) that you are typing, +and these plugins can then send typing notifications to other users. + +The following signals are sent when you are typing messages: + +[width="100%",cols="1,1,5",options="header"] +|=== +| Signal | Arguments | Description +| typing_self_typing | Pointer: buffer. | You are typing a message. +| typing_self_paused | Pointer: buffer. | You made a pause while typing a message. +| typing_self_cleared | Pointer: buffer. | You cleared the command line without sending the message. +| typing_self_sent | Pointer: buffer. | You sent the message to the buffer. +|=== + +[[typing_signals_caught]] +==== Signals caught + +The typing plugin is catching some signals that can be sent by other plugins +(like IRC), to update internal hashtables used to store the typing state of +nicks on buffers. These hashtables are used to build the content of "typing" +bar item. + +The following signals are caught by the typing plugin: + +[width="100%",cols="1,4,3",options="header"] +|=== +| Signal | Arguments | Description + +| typing_set_nick | + String: buffer pointer + ";" + state (one of: "off", "typing", "paused", + "cleared") + ";" + nick. + + Example: "0x1234abcd;typing;alice". | + Set typing state for a nick on a buffer. + +| typing_reset_buffer | + Pointer: buffer. | + Remove typing state for all nicks on a buffer. +|=== + +[[typing_options]] +==== Opzioni + +Sections in file _typing.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set typing.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.it.adoc[tag=typing_options] + [[xfer_plugin]] === Xfer diff --git a/doc/ja/includes/autogen_user_options.ja.adoc b/doc/ja/includes/autogen_user_options.ja.adoc index 8556c5abf..44ad2f5ff 100644 --- a/doc/ja/includes/autogen_user_options.ja.adoc +++ b/doc/ja/includes/autogen_user_options.ja.adoc @@ -1845,6 +1845,38 @@ ** デフォルト値: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+` // end::fifo_options[] +// tag::typing_options[] +* [[option_typing.look.delay_purge_paused]] *typing.look.delay_purge_paused* +** 説明: pass:none[number of seconds after paused status has been set: if reached, the typing status is removed] +** タイプ: 整数 +** 値: 1 .. 3600 +** デフォルト値: `+30+` + +* [[option_typing.look.delay_purge_typing]] *typing.look.delay_purge_typing* +** 説明: pass:none[number of seconds after typing status has been set: if reached, the typing status is removed] +** タイプ: 整数 +** 値: 1 .. 3600 +** デフォルト値: `+6+` + +* [[option_typing.look.delay_set_paused]] *typing.look.delay_set_paused* +** 説明: pass:none[number of seconds after typing last char: if reached, the typing status becomes "paused" and no more typing signals are sent] +** タイプ: 整数 +** 値: 1 .. 3600 +** デフォルト値: `+10+` + +* [[option_typing.look.enabled_nicks]] *typing.look.enabled_nicks* +** 説明: pass:none[typing enabled for other nicks (display typing info for nicks typing in the current buffer)] +** タイプ: ブール +** 値: on, off +** デフォルト値: `+off+` + +* [[option_typing.look.enabled_self]] *typing.look.enabled_self* +** 説明: pass:none[typing enabled for self messages (send typing info to other users)] +** タイプ: ブール +** 値: on, off +** デフォルト値: `+off+` +// end::typing_options[] + // tag::xfer_options[] * [[option_xfer.color.status_aborted]] *xfer.color.status_aborted* ** 説明: pass:none["中止" 状態のテキスト色] @@ -2520,6 +2552,18 @@ ** 値: on, off ** デフォルト値: `+off+` +* [[option_irc.look.typing_status_nicks]] *irc.look.typing_status_nicks* +** 説明: pass:none[display nicks typing on the channel in bar item "typing" (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** タイプ: ブール +** 値: on, off +** デフォルト値: `+off+` + +* [[option_irc.look.typing_status_self]] *irc.look.typing_status_self* +** 説明: pass:none[send self typing status to channels so that other users see when you are typing a message (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** タイプ: ブール +** 値: on, off +** デフォルト値: `+off+` + * [[option_irc.network.autoreconnect_delay_growing]] *irc.network.autoreconnect_delay_growing* ** 説明: pass:none[サーバに自動再接続する際の遅延間隔に関する増加係数 (1 = 遅延間隔は常に同じ, 2 = リトライごとに遅延間隔を 2 倍、など)] ** タイプ: 整数 diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index a3a7769cd..eb125c07e 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -294,6 +294,9 @@ CMake に対するオプションを指定するには、以下の書式を使 | ENABLE_TRIGGER | `ON`, `OFF` | ON | <<trigger_plugin,Trigger プラグイン>>のコンパイル。 +| ENABLE_TYPING | `ON`, `OFF` | ON | + <<typing_plugin,Typing プラグイン>>のコンパイル。 + | ENABLE_XFER | `ON`, `OFF` | ON | <<xfer_plugin,Xfer プラグイン>>のコンパイル。 @@ -755,6 +758,7 @@ WeeChat ホームディレクトリには以下のファイルが含まれます | spell.conf | _spell_ プラグイン用の設定ファイル | 保護されません | tcl.conf | _tcl_ プラグイン用の設定ファイル | 保護されません | trigger.conf | _trigger_ プラグイン用の設定ファイル | 保護される場合もあります、トリガに依存します +| typing.conf | _typing_ プラグイン用の設定ファイル | 保護されません | xfer.conf | _xfer_ プラグイン用の設定ファイル | 保護されません | weechat.log | WeeChat ログファイル | 保護されません |=== @@ -2614,6 +2618,8 @@ When a plugin is unloaded, WeeChat removes: | php | PHP スクリプト API | spell | コマンドラインのスペルチェック | trigger | WeeChat およびプラグインが発生させたイベントに対するテキスト置換とコマンド実行 +// TRANSLATION MISSING +| typing | Display users currently writing messages. | xfer | ファイル転送とダイレクトチャット |=== @@ -4798,6 +4804,101 @@ _trigger.conf_ ファイル内のセクション: include::includes/autogen_user_options.ja.adoc[tag=trigger_options] +// TRANSLATION MISSING +[[typing_plugin]] +=== Typing + +The typing plugin is used to inform other users you are typing messages and +show a list of users currently typing a message on the buffer. + +It is used by IRC plugin on channel and private buffers, when the "message-tags" +capability is enabled (you can check with <<command_irc_cap,/cap>> command). + +Under the hood, typing client tag is used, following this specification: +https://ircv3.net/specs/client-tags/typing.html. + +[[typing_activation]] +==== Activation + +For privacy considerations, the typing feature is disabled by default. + +If you want to use it, you must enable options in both typing and irc plugins: + +---- +/set typing.look.enabled_nicks on +/set typing.look.enabled_self on +/set irc.look.typing_status_nicks on +/set irc.look.typing_status_self on +---- + +Then you must add the "typing" bar item in a bar, for example in option +_weechat.bar.status.items_. + +Example of status bar with the "typing" item: "bob" is typing a message and +"alice" was typing a message but made a pause: + +.... +│[12:55] [6] [irc/libera] 3:#test(+n){4} [Typing: bob, (alice)] │ +│[@Flashy] █ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +.... + +[[typing_signals_sent]] +==== Signals sent + +When you are typing a message (not a command starting with `/`), the typing +plugin sends signals to inform other plugins (like IRC) that you are typing, +and these plugins can then send typing notifications to other users. + +The following signals are sent when you are typing messages: + +[width="100%",cols="1,1,5",options="header"] +|=== +| Signal | Arguments | Description +| typing_self_typing | Pointer: buffer. | You are typing a message. +| typing_self_paused | Pointer: buffer. | You made a pause while typing a message. +| typing_self_cleared | Pointer: buffer. | You cleared the command line without sending the message. +| typing_self_sent | Pointer: buffer. | You sent the message to the buffer. +|=== + +[[typing_signals_caught]] +==== Signals caught + +The typing plugin is catching some signals that can be sent by other plugins +(like IRC), to update internal hashtables used to store the typing state of +nicks on buffers. These hashtables are used to build the content of "typing" +bar item. + +The following signals are caught by the typing plugin: + +[width="100%",cols="1,4,3",options="header"] +|=== +| Signal | Arguments | Description + +| typing_set_nick | + String: buffer pointer + ";" + state (one of: "off", "typing", "paused", + "cleared") + ";" + nick. + + Example: "0x1234abcd;typing;alice". | + Set typing state for a nick on a buffer. + +| typing_reset_buffer | + Pointer: buffer. | + Remove typing state for all nicks on a buffer. +|=== + +[[typing_options]] +==== オプション + +_typing.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set typing.look.* | 外観 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=typing_options] + [[xfer_plugin]] === Xfer diff --git a/doc/pl/includes/autogen_user_options.pl.adoc b/doc/pl/includes/autogen_user_options.pl.adoc index 4e1aba587..7bf3a766b 100644 --- a/doc/pl/includes/autogen_user_options.pl.adoc +++ b/doc/pl/includes/autogen_user_options.pl.adoc @@ -1845,6 +1845,38 @@ ** domyślna wartość: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+` // end::fifo_options[] +// tag::typing_options[] +* [[option_typing.look.delay_purge_paused]] *typing.look.delay_purge_paused* +** opis: pass:none[number of seconds after paused status has been set: if reached, the typing status is removed] +** typ: liczba +** wartości: 1 .. 3600 +** domyślna wartość: `+30+` + +* [[option_typing.look.delay_purge_typing]] *typing.look.delay_purge_typing* +** opis: pass:none[number of seconds after typing status has been set: if reached, the typing status is removed] +** typ: liczba +** wartości: 1 .. 3600 +** domyślna wartość: `+6+` + +* [[option_typing.look.delay_set_paused]] *typing.look.delay_set_paused* +** opis: pass:none[number of seconds after typing last char: if reached, the typing status becomes "paused" and no more typing signals are sent] +** typ: liczba +** wartości: 1 .. 3600 +** domyślna wartość: `+10+` + +* [[option_typing.look.enabled_nicks]] *typing.look.enabled_nicks* +** opis: pass:none[typing enabled for other nicks (display typing info for nicks typing in the current buffer)] +** typ: bool +** wartości: on, off +** domyślna wartość: `+off+` + +* [[option_typing.look.enabled_self]] *typing.look.enabled_self* +** opis: pass:none[typing enabled for self messages (send typing info to other users)] +** typ: bool +** wartości: on, off +** domyślna wartość: `+off+` +// end::typing_options[] + // tag::xfer_options[] * [[option_xfer.color.status_aborted]] *xfer.color.status_aborted* ** opis: pass:none[kolor statusu "aborted"] @@ -2520,6 +2552,18 @@ ** wartości: on, off ** domyślna wartość: `+off+` +* [[option_irc.look.typing_status_nicks]] *irc.look.typing_status_nicks* +** opis: pass:none[display nicks typing on the channel in bar item "typing" (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** typ: bool +** wartości: on, off +** domyślna wartość: `+off+` + +* [[option_irc.look.typing_status_self]] *irc.look.typing_status_self* +** opis: pass:none[send self typing status to channels so that other users see when you are typing a message (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** typ: bool +** wartości: on, off +** domyślna wartość: `+off+` + * [[option_irc.network.autoreconnect_delay_growing]] *irc.network.autoreconnect_delay_growing* ** opis: pass:none[rosnący współczynnik opóźnienia ponownego połączenia z serwerem (1 = stała wartość, 2 = opóźnienie*2 dla każdej próby, etc.)] ** typ: liczba diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index 9f797ebbe..4bf92b792 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -289,6 +289,9 @@ Lista popularnych opcji: | ENABLE_TRIGGER | `ON`, `OFF` | ON | Kompilacja <<trigger_plugin,wtyczki trigger>>. +| ENABLE_TYPING | `ON`, `OFF` | ON | + Kompilacja <<typing_plugin,wtyczki typing>>. + | ENABLE_XFER | `ON`, `OFF` | ON | Kompilacja <<xfer_plugin,wtyczki xfer>>. @@ -731,6 +734,7 @@ Pliki tworzone w katalogu domowym WeeChat: | spell.conf | Plik konfiguracyjny wtyczki _spell_ | Nie. | tcl.conf | Plik konfiguracyjny wtyczki _tcl_ | Nie. | trigger.conf | Plik konfiguracyjny wtyczki _trigger_ | Możliwe, zależy od triggerów. +| typing.conf | Plik konfiguracyjny wtyczki _typing_ | Nie. | xfer.conf | Plik konfiguracyjny wtyczki _xfer_ | Nie. | weechat.log | Plik z logami WeeChat | Nie. |=== @@ -2549,6 +2553,8 @@ Domyślne wtyczki: | php | Wsparcie dla skryptów napisanych w PHP. | spell | Sprawdzanie pisowni w linii poleceń. | trigger | Zamiana tekstu i wykonywanie komend dla zdarzeń wywołanych przez WeeChat/wtyczki. +// TRANSLATION MISSING +| typing | Display users currently writing messages. | xfer | Przesyłanie plików i bezpośredni chat. |=== @@ -4721,6 +4727,101 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=trigger_options] +// TRANSLATION MISSING +[[typing_plugin]] +=== Typing + +The typing plugin is used to inform other users you are typing messages and +show a list of users currently typing a message on the buffer. + +It is used by IRC plugin on channel and private buffers, when the "message-tags" +capability is enabled (you can check with <<command_irc_cap,/cap>> command). + +Under the hood, typing client tag is used, following this specification: +https://ircv3.net/specs/client-tags/typing.html. + +[[typing_activation]] +==== Activation + +For privacy considerations, the typing feature is disabled by default. + +If you want to use it, you must enable options in both typing and irc plugins: + +---- +/set typing.look.enabled_nicks on +/set typing.look.enabled_self on +/set irc.look.typing_status_nicks on +/set irc.look.typing_status_self on +---- + +Then you must add the "typing" bar item in a bar, for example in option +_weechat.bar.status.items_. + +Example of status bar with the "typing" item: "bob" is typing a message and +"alice" was typing a message but made a pause: + +.... +│[12:55] [6] [irc/libera] 3:#test(+n){4} [Typing: bob, (alice)] │ +│[@Flashy] █ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +.... + +[[typing_signals_sent]] +==== Signals sent + +When you are typing a message (not a command starting with `/`), the typing +plugin sends signals to inform other plugins (like IRC) that you are typing, +and these plugins can then send typing notifications to other users. + +The following signals are sent when you are typing messages: + +[width="100%",cols="1,1,5",options="header"] +|=== +| Signal | Arguments | Description +| typing_self_typing | Pointer: buffer. | You are typing a message. +| typing_self_paused | Pointer: buffer. | You made a pause while typing a message. +| typing_self_cleared | Pointer: buffer. | You cleared the command line without sending the message. +| typing_self_sent | Pointer: buffer. | You sent the message to the buffer. +|=== + +[[typing_signals_caught]] +==== Signals caught + +The typing plugin is catching some signals that can be sent by other plugins +(like IRC), to update internal hashtables used to store the typing state of +nicks on buffers. These hashtables are used to build the content of "typing" +bar item. + +The following signals are caught by the typing plugin: + +[width="100%",cols="1,4,3",options="header"] +|=== +| Signal | Arguments | Description + +| typing_set_nick | + String: buffer pointer + ";" + state (one of: "off", "typing", "paused", + "cleared") + ";" + nick. + + Example: "0x1234abcd;typing;alice". | + Set typing state for a nick on a buffer. + +| typing_reset_buffer | + Pointer: buffer. | + Remove typing state for all nicks on a buffer. +|=== + +[[typing_options]] +==== Opcje + +Sekcje w pliku _typing.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set typing.look.* | Wygląd. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=typing_options] + [[xfer_plugin]] === Xfer diff --git a/doc/sr/includes/autogen_user_options.sr.adoc b/doc/sr/includes/autogen_user_options.sr.adoc index 90c063e0b..78fc587c7 100644 --- a/doc/sr/includes/autogen_user_options.sr.adoc +++ b/doc/sr/includes/autogen_user_options.sr.adoc @@ -1845,6 +1845,38 @@ ** подразумевана вредност: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+` // end::fifo_options[] +// tag::typing_options[] +* [[option_typing.look.delay_purge_paused]] *typing.look.delay_purge_paused* +** опис: pass:none[number of seconds after paused status has been set: if reached, the typing status is removed] +** тип: целобројна +** вредности: 1 .. 3600 +** подразумевана вредност: `+30+` + +* [[option_typing.look.delay_purge_typing]] *typing.look.delay_purge_typing* +** опис: pass:none[number of seconds after typing status has been set: if reached, the typing status is removed] +** тип: целобројна +** вредности: 1 .. 3600 +** подразумевана вредност: `+6+` + +* [[option_typing.look.delay_set_paused]] *typing.look.delay_set_paused* +** опис: pass:none[number of seconds after typing last char: if reached, the typing status becomes "paused" and no more typing signals are sent] +** тип: целобројна +** вредности: 1 .. 3600 +** подразумевана вредност: `+10+` + +* [[option_typing.look.enabled_nicks]] *typing.look.enabled_nicks* +** опис: pass:none[typing enabled for other nicks (display typing info for nicks typing in the current buffer)] +** тип: логичка +** вредности: on, off +** подразумевана вредност: `+off+` + +* [[option_typing.look.enabled_self]] *typing.look.enabled_self* +** опис: pass:none[typing enabled for self messages (send typing info to other users)] +** тип: логичка +** вредности: on, off +** подразумевана вредност: `+off+` +// end::typing_options[] + // tag::xfer_options[] * [[option_xfer.color.status_aborted]] *xfer.color.status_aborted* ** опис: pass:none[боја текста за „прекинут” статус] @@ -2520,6 +2552,18 @@ ** вредности: on, off ** подразумевана вредност: `+off+` +* [[option_irc.look.typing_status_nicks]] *irc.look.typing_status_nicks* +** опис: pass:none[display nicks typing on the channel in bar item "typing" (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** тип: логичка +** вредности: on, off +** подразумевана вредност: `+off+` + +* [[option_irc.look.typing_status_self]] *irc.look.typing_status_self* +** опис: pass:none[send self typing status to channels so that other users see when you are typing a message (option typing.look.enabled must be enabled and capability "message-tags" must be enabled on the server)] +** тип: логичка +** вредности: on, off +** подразумевана вредност: `+off+` + * [[option_irc.network.autoreconnect_delay_growing]] *irc.network.autoreconnect_delay_growing* ** опис: pass:none[фактор увећавања паузе пре аутоматског поновног повезивања са сервером (1 = увек иста пауза, 2 = пауза*2 за сваки наредни покушај, итд.)] ** тип: целобројна diff --git a/doc/sr/weechat_user.sr.adoc b/doc/sr/weechat_user.sr.adoc index 3b5e2d835..062db8619 100644 --- a/doc/sr/weechat_user.sr.adoc +++ b/doc/sr/weechat_user.sr.adoc @@ -267,6 +267,9 @@ $ make install | ENABLE_TRIGGER | `ON`, `OFF` | ON | Компајлира <<trigger_plugin,Trigger додатак>>. +| ENABLE_TYPING | `ON`, `OFF` | ON | + Компајлира <<typing_plugin,Typing додатак>>. + | ENABLE_XFER | `ON`, `OFF` | ON | Компајлира <<xfer_plugin,Xfer додатак>>. @@ -667,6 +670,7 @@ WeeChat подразумевано користи XDG директоријуме | tcl.conf | Конфигурациони фајл за _tcl_ додатак | Не. | spell.conf | Конфигурациони фајл за _spell_ додатак | Не. | trigger.conf | Конфигурациони фајл за _окидач_ додатак | Могуће, зависно од окидача. +| typing.conf | Конфигурациони фајл за _typing_ додатак | Не. | xfer.conf | Конфигурациони фајл за _xfer_ додатак | Не. | weechat.log | WeeChat лог фајл | Не. |=== @@ -2332,7 +2336,7 @@ include::includes/autogen_user_options.sr.adoc[tag=weechat_options] [width="100%", cols="1,5", options="header"] |=== | Додатак | Опис -| алијас | Дефиниција алијаса за команде. +| alias | Дефиниција алијаса за команде. | buflist | Ставка траке са листом бафера. | charset | Декодирање/кодирање у скуп карактера за бафере. | exec | Извршавање спољних команди из програма WeeChat. @@ -2340,7 +2344,7 @@ include::includes/autogen_user_options.sr.adoc[tag=weechat_options] | fset | Брзо постављање опција програма WeeChat и опција додатака. | irc | IRC чет протокол. | logger | Логовање бафера у фајлове. -| релеј | Релеј података преко мреже. +| relay | Релеј података преко мреже. | script | Управљач скриптама. | python | Python API . | perl | Perl API скриптовања. @@ -2351,7 +2355,9 @@ include::includes/autogen_user_options.sr.adoc[tag=weechat_options] | javascript | JavaScript API скриптовања. | php | PHP API скриптовања. | spell | Провера правописа за командну линију. -| окидач | Замена текста и извршавање команди приликом догађаја које окида програм WeeChat/додаци. +| trigger | Замена текста и извршавање команди приликом догађаја које окида програм WeeChat/додаци. +// TRANSLATION MISSING +| typing | Display users currently writing messages. | xfer | Пренос фајлова и директни разговор. |=== @@ -4362,6 +4368,101 @@ include::includes/autogen_user_commands.sr.adoc[tag=trigger_commands] include::includes/autogen_user_options.sr.adoc[tag=trigger_options] +// TRANSLATION MISSING +[[typing_plugin]] +=== Typing + +The typing plugin is used to inform other users you are typing messages and +show a list of users currently typing a message on the buffer. + +It is used by IRC plugin on channel and private buffers, when the "message-tags" +capability is enabled (you can check with <<command_irc_cap,/cap>> command). + +Under the hood, typing client tag is used, following this specification: +https://ircv3.net/specs/client-tags/typing.html. + +[[typing_activation]] +==== Activation + +For privacy considerations, the typing feature is disabled by default. + +If you want to use it, you must enable options in both typing and irc plugins: + +---- +/set typing.look.enabled_nicks on +/set typing.look.enabled_self on +/set irc.look.typing_status_nicks on +/set irc.look.typing_status_self on +---- + +Then you must add the "typing" bar item in a bar, for example in option +_weechat.bar.status.items_. + +Example of status bar with the "typing" item: "bob" is typing a message and +"alice" was typing a message but made a pause: + +.... +│[12:55] [6] [irc/libera] 3:#test(+n){4} [Typing: bob, (alice)] │ +│[@Flashy] █ │ +└─────────────────────────────────────────────────────────────────────────────────┘ +.... + +[[typing_signals_sent]] +==== Signals sent + +When you are typing a message (not a command starting with `/`), the typing +plugin sends signals to inform other plugins (like IRC) that you are typing, +and these plugins can then send typing notifications to other users. + +The following signals are sent when you are typing messages: + +[width="100%",cols="1,1,5",options="header"] +|=== +| Signal | Arguments | Description +| typing_self_typing | Pointer: buffer. | You are typing a message. +| typing_self_paused | Pointer: buffer. | You made a pause while typing a message. +| typing_self_cleared | Pointer: buffer. | You cleared the command line without sending the message. +| typing_self_sent | Pointer: buffer. | You sent the message to the buffer. +|=== + +[[typing_signals_caught]] +==== Signals caught + +The typing plugin is catching some signals that can be sent by other plugins +(like IRC), to update internal hashtables used to store the typing state of +nicks on buffers. These hashtables are used to build the content of "typing" +bar item. + +The following signals are caught by the typing plugin: + +[width="100%",cols="1,4,3",options="header"] +|=== +| Signal | Arguments | Description + +| typing_set_nick | + String: buffer pointer + ";" + state (one of: "off", "typing", "paused", + "cleared") + ";" + nick. + + Example: "0x1234abcd;typing;alice". | + Set typing state for a nick on a buffer. + +| typing_reset_buffer | + Pointer: buffer. | + Remove typing state for all nicks on a buffer. +|=== + +[[typing_options]] +==== Опције + +Одељци у фајлу _typing.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set typing.look.* | Изглед и осећај. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=typing_options] + [[xfer_plugin]] === Xfer |