diff options
Diffstat (limited to 'doc/de/weechat_user.de.adoc')
-rw-r--r-- | doc/de/weechat_user.de.adoc | 101 |
1 files changed, 101 insertions, 0 deletions
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 |