diff options
Diffstat (limited to 'doc/de/weechat_user.de.adoc')
| -rw-r--r-- | doc/de/weechat_user.de.adoc | 364 |
1 files changed, 182 insertions, 182 deletions
diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index decd1fa60..1612f7b67 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -237,7 +237,7 @@ Liste von häufig verwendeten Optionen: kompiliert <<scripts_plugins,Guile Erweiterung>> (Scheme). | ENABLE_IRC | `ON`, `OFF` | ON | - kompiliert <<irc_plugin,IRC Erweiterung>>. + kompiliert <<irc,IRC Erweiterung>>. | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF | kompiliert <<scripts_plugins,JavaScript Erweiterung>>. @@ -2840,169 +2840,8 @@ Optionen: include::includes/autogen_user_options.de.adoc[tag=weechat_options] -[[plugins]] -== Erweiterungen - -Eine WeeChat Erweiterung ist eine dynamische Bibliothek (library), die in C geschrieben -und kompiliert ist. Unter GNU/Linux besitzt eine Erweiterung als Dateiendung ".so", unter -Windows ".dll". - -Erweiterungen die gefunden werden, werden beim Start von WeeChat automatisch geladen. -Natürlich ist es möglich während einer laufenden Session von WeeChat Erweiterungen -nachträglich zu laden oder zu entfernen. - -Es ist wichtig zwischen _Erweiterung_ und _Skript_ zu unterscheiden. Eine Erweiterung -ist eine Binärdatei die kompiliert wurde und mit dem Befehl `/plugin` geladen wird. -Dem gegenüber ist ein _Skript_ eine Textdatei die durch eine Erweiterung z.B. _python_ -mittels dem Befehl `/python` geladen wird. - -Mit dem Befehl `/plugin` kann eine Erweiterung geladen bzw. entfernt werden. Auch können -mit dem Befehl alle installierten Erweiterungen aufgelistet werden. - -Sobald eine Erweiterung beendet wird, entfernt WeeChat: - -* Buffer -* Konfigurationsoptionen (Optionen die in Datein geschrieben wurden) -* alle Hooks: commands, modifiers, process, etc. -* Infos und Infolisten -* hdata -* Bar-Items. - -Beispiele wie man Erweiterungen lädt, entfernt und auflistet: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Standarderweiterungen: - -[width="100%",cols="1,5",options="header"] -|=== -| Erweiterung | Beschreibung -| alias | definiert Alias für Befehle. -| buflist | Bar-Item mit der Liste aller Buffern. -| charset | Zeichensatz (de)-kodierung in Buffern. -| exec | ausführen von externen Befehlen aus WeeChat heraus. -| fifo | FIFO Pipe die zur Fernsteuerung von WeeChat genutzt werden kann. -| fset | Optionen von WeeChat und Erweiterungen schnell anpassen. -| irc | IRC Chat-Protokoll. -| logger | erstellt Protokolldateien von Buffern. -| relay | Daten via Netzwerk übermitteln. -| script | Skripten-Manager. -| python | Python-Skript API. -| perl | Perl-Skript API. -| ruby | Ruby-Skript API. -| lua | Lua-Skript API. -| tcl | Tcl-Skript API. -| guile | Guile(scheme)-Skript API. -| javascript | JavaScript-Skript API. -| 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. -| typing | Benutzer anzeigen, die gerade Nachrichten schreiben. -| xfer | Datentransfer und Direktchat. -|=== - -Um mehr über Erweiterungen- und Skriptenprogrammierung (mittels API) zu erfahren, -sollten Sie die link:weechat_plugin_api.en.html[Anleitung für API Erweiterung] (Englisch) oder -link:weechat_scripting.de.html[WeeChat scripting guide] lesen. - -[[exec_plugin]] -=== Exec - -Der `/exec` Befehl erlaubt es aus WeeChat heraus einen oder mehrere externe -Befehle auszuführen und eine Ausgabe im lokalen Buffer darzustellen oder in -einem Buffer auszugeben. - -[[exec_commands]] -==== Befehle - -include::includes/autogen_user_commands.de.adoc[tag=exec_commands] - -[[exec_options]] -==== Optionen - -Sektionen in Datei _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| command | /set exec.command.* | Optionen für Befehle. -| color | /set exec.color.* | Farben. -|=== - -Options: - -include::includes/autogen_user_options.de.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Sie können WeeChat fern steuern indem Sie Befehle oder einen Text an die FIFO Pipe -schicken (dazu muss die Option "fifo.file.enabled" aktiviert sein (standardmäßig -ist diese Option aktiviert). - -Die FIFO-Pipe befindet sich im WeeChat-Laufzeitverzeichnis und wird standardmäßig -_weechat_fifo_12345_ benannt (wobei _12345_ die WeeChat-Prozess-ID ist). - -Die Syntax der FIFO Pipe Befehle/Text sieht wie folgt aus: - -.... - plugin.buffer *hier Text oder Befehl - *hier Text oder Befehl -.... - -einige Beispiele: - -* Ändert den eigenen Nick auf dem IRC Server libera in "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Schickt eine Nachrich in den IRC #weechat Channel: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Schickt eine Nachricht in den aktuellen Buffer: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Sendet zwei Befehle um alle Python-Skripten zu entfernen und dann neu zu laden (die beiden Befehle müssen - mit "\n" getrennt werden): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Befehle - -include::includes/autogen_user_commands.de.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Optionen - -Sektionen in Datei _fifo.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| file | /set fifo.file.* | FIFO Pipe Optionen. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=fifo_options] - -[[irc_plugin]] -=== IRC +[[irc]] +== IRC Die IRC Erweiterung ist konzipiert um mittels dem IRC Protokoll mit anderen Menschen zu chatten. @@ -3010,7 +2849,7 @@ Die Erweiterung ist Multi-Server fähig und verfügt über alle IRC Befehle, ein und Datenübertragung (via xfer Erweiterung, siehe <<xfer_plugin,Xfer Erweiterung>>). [[irc_command_line_options]] -==== Kommandozeilen Befehle +=== Kommandozeilen Befehle Es ist möglich eine oder mehrere URL von IRC Servern zu übergeben: @@ -3026,10 +2865,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr ---- [[irc_servers]] -==== Server +=== Server [[irc_servers_add]] -===== Server hinzufügen +==== Server hinzufügen Standardmäßig sind keine Server angelegt. Es gibt keine Begrenzung für die Anzahl von Servern. Server können mit dem Befehl <<command_irc_server,/server>> @@ -3072,7 +2911,7 @@ zu Problemen führen. In diesem Fall können Sie eine Befehlsverzögerung einste `/set irc.server.libera.command_delay 5`. [[irc_servers_options]] -===== Server-Optionen +==== Server-Optionen Serveroptinen haben folgenden Aufbau `irc.server.<server>.<option>` hierbei ist `<server>` der interne Name des Server und `<option>` ist der Name der Option. + @@ -3145,7 +2984,7 @@ geerbten Wert verwendet, der jetzt `on` anstelle des Standardwerts `off` ist: ---- [[irc_ssl_certificates]] -===== SSL Zertifikate +==== SSL Zertifikate Wenn eine Verbindung mittels SSL zu einem IRC Server hergestellt wird dann überprüft WeeChat immer ob dieser Verbindung sicher ist. @@ -3175,7 +3014,7 @@ die Verifizierung sehr streng genommen wird und dadurch vielleicht versagt. Auch die Verbindung mit einer vorherigen Version (<0.3.1) funktioniert hat. [[irc_connect_oftc_with_certificate]] -====== erstes Beispiel: Verbindung zu oftc und Überprüfung der Zertifikate +===== erstes Beispiel: Verbindung zu oftc und Überprüfung der Zertifikate * Importieren Sie die Zertifikate in einer Shell: @@ -3198,7 +3037,7 @@ Es ist möglich mehrere Zertifikate in der Datei CAs.pem zu verwenden. ---- [[irc_connect_oftc_with_certfp]] -====== zweites Beispiel: Verbindung zu oftc mittels CertFP +===== zweites Beispiel: Verbindung zu oftc mittels CertFP * Erstellen Sie ein Zertifikat in der Shell: @@ -3223,7 +3062,7 @@ das auch beispielsweise `~/.weechat` sein kann. Für weiterreichende Informationen lesen Sie bitte: https://www.oftc.net/NickServ/CertFP [[irc_sasl_authentication]] -===== SASL Authentifizierung +==== SASL Authentifizierung WeeChat unterstützt eine SASL Authentifikation, mittels verschiedener Mechanismen: @@ -3245,7 +3084,7 @@ Optionen für Server sind: _ecdsa-nist256p-challenge_ Mechanismus) [[irc_sasl_ecdsa_nist256p_challenge]] -====== SASL ECDSA-NIST256P-CHALLENGE +===== SASL ECDSA-NIST256P-CHALLENGE Es muss ein privater Schlüssel erstellt werden um sich mittels des ECDSA-NIST256P-CHALLENGE Mechanismus authentifizieren zu können (es wird @@ -3293,7 +3132,7 @@ Erneut mit dem Server verbinden: ---- [[irc_servers_connection]] -===== Verbindung zum Server +==== Verbindung zum Server Um sich mit einem Server zu Verbinden, nutzt man den <<command_irc_connect,/connect>> Befehl: @@ -3327,7 +3166,7 @@ um unabhängige Serverbuffer zu haben: ---- [[irc_tor_sasl]] -===== Connect with TOR and SASL +==== Connect with TOR and SASL Einige Server unterstützen eine Verbindungen mittels TOR (https://www.torproject.org/), dies ist ein Netzwerk mit virtueller Tunneln, durch welchen Personen und Gruppen ihre @@ -3376,7 +3215,7 @@ Abschließend, stellen Sie eine Verbindung zum Server her: ---- [[irc_channels]] -==== Kanäle +=== Kanäle Kanäle können mit dem Befehl <<command_irc_join,/join>> betreten werden: @@ -3414,7 +3253,7 @@ Schlüssel erfordert, aber nicht `#channel2`: Um eine Hilfe über das Format zu erhalten, siehe `/help irc.server.libera.autojoin`. [[irc_private_messages]] -==== private Nachrichten +=== private Nachrichten Sie können eine private Nachricht mit dem Befehl <<command_irc_query,/query>> senden, was einen separaten Buffer, für die Konversation, öffnet: @@ -3438,7 +3277,7 @@ privaten Buffer aus: ---- [[irc_smart_filter_join_part_quit]] -==== einfacher Filter für join/part/quit Nachrichten +=== einfacher Filter für join/part/quit Nachrichten Es existiert ein einfacher Filter für join/part/quit Nachrichten falls ein Nick für eine vorgegebene Zeit in einem Channel inaktiv gewesen ist. @@ -3476,7 +3315,7 @@ Falls ein Nick in den letzten fünf Minuten nicht aktiv gewesen ist werden seine join und/oder part/quit Nachrichten im Channel unterdrückt. [[irc_ctcp_replies]] -==== CTCP Antworten +=== CTCP Antworten Sie haben die Möglichkeit CTCP Antworten anzupassen oder aber bestimmte CTCP Anfragen zu sperren (es wird nicht darauf geantwortet). @@ -3554,7 +3393,7 @@ Falls CTCP Optionen nicht festgelegt sind, lauten die CTCP Antworten: |=== [[irc_target_buffer]] -==== Zielbuffer für IRC Nachrichten +=== Zielbuffer für IRC Nachrichten Sie können einen Zielbuffer einstellen in welchem IRC Nachrichten dargestellt werden sollen. Dazu dienen die Optionen `+irc.msgbuffer.*+`. @@ -3686,12 +3525,12 @@ einige Beispiele: ---- [[irc_commands]] -==== Befehle +=== Befehle include::includes/autogen_user_commands.de.adoc[tag=irc_commands] [[irc_options]] -==== Optionen +=== Optionen Sektionen in Datei _irc.conf_: @@ -3713,6 +3552,167 @@ Optionen: include::includes/autogen_user_options.de.adoc[tag=irc_options] +[[plugins]] +== Erweiterungen + +Eine WeeChat Erweiterung ist eine dynamische Bibliothek (library), die in C geschrieben +und kompiliert ist. Unter GNU/Linux besitzt eine Erweiterung als Dateiendung ".so", unter +Windows ".dll". + +Erweiterungen die gefunden werden, werden beim Start von WeeChat automatisch geladen. +Natürlich ist es möglich während einer laufenden Session von WeeChat Erweiterungen +nachträglich zu laden oder zu entfernen. + +Es ist wichtig zwischen _Erweiterung_ und _Skript_ zu unterscheiden. Eine Erweiterung +ist eine Binärdatei die kompiliert wurde und mit dem Befehl `/plugin` geladen wird. +Dem gegenüber ist ein _Skript_ eine Textdatei die durch eine Erweiterung z.B. _python_ +mittels dem Befehl `/python` geladen wird. + +Mit dem Befehl `/plugin` kann eine Erweiterung geladen bzw. entfernt werden. Auch können +mit dem Befehl alle installierten Erweiterungen aufgelistet werden. + +Sobald eine Erweiterung beendet wird, entfernt WeeChat: + +* Buffer +* Konfigurationsoptionen (Optionen die in Datein geschrieben wurden) +* alle Hooks: commands, modifiers, process, etc. +* Infos und Infolisten +* hdata +* Bar-Items. + +Beispiele wie man Erweiterungen lädt, entfernt und auflistet: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Standarderweiterungen: + +[width="100%",cols="1,5",options="header"] +|=== +| Erweiterung | Beschreibung +| alias | definiert Alias für Befehle. +| buflist | Bar-Item mit der Liste aller Buffern. +| charset | Zeichensatz (de)-kodierung in Buffern. +| exec | ausführen von externen Befehlen aus WeeChat heraus. +| fifo | FIFO Pipe die zur Fernsteuerung von WeeChat genutzt werden kann. +| fset | Optionen von WeeChat und Erweiterungen schnell anpassen. +| irc | IRC Chat-Protokoll. +| logger | erstellt Protokolldateien von Buffern. +| relay | Daten via Netzwerk übermitteln. +| script | Skripten-Manager. +| python | Python-Skript API. +| perl | Perl-Skript API. +| ruby | Ruby-Skript API. +| lua | Lua-Skript API. +| tcl | Tcl-Skript API. +| guile | Guile(scheme)-Skript API. +| javascript | JavaScript-Skript API. +| 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. +| typing | Benutzer anzeigen, die gerade Nachrichten schreiben. +| xfer | Datentransfer und Direktchat. +|=== + +Um mehr über Erweiterungen- und Skriptenprogrammierung (mittels API) zu erfahren, +sollten Sie die link:weechat_plugin_api.en.html[Anleitung für API Erweiterung] (Englisch) oder +link:weechat_scripting.de.html[WeeChat scripting guide] lesen. + +[[exec_plugin]] +=== Exec + +Der `/exec` Befehl erlaubt es aus WeeChat heraus einen oder mehrere externe +Befehle auszuführen und eine Ausgabe im lokalen Buffer darzustellen oder in +einem Buffer auszugeben. + +[[exec_commands]] +==== Befehle + +include::includes/autogen_user_commands.de.adoc[tag=exec_commands] + +[[exec_options]] +==== Optionen + +Sektionen in Datei _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| command | /set exec.command.* | Optionen für Befehle. +| color | /set exec.color.* | Farben. +|=== + +Options: + +include::includes/autogen_user_options.de.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Sie können WeeChat fern steuern indem Sie Befehle oder einen Text an die FIFO Pipe +schicken (dazu muss die Option "fifo.file.enabled" aktiviert sein (standardmäßig +ist diese Option aktiviert). + +Die FIFO-Pipe befindet sich im WeeChat-Laufzeitverzeichnis und wird standardmäßig +_weechat_fifo_12345_ benannt (wobei _12345_ die WeeChat-Prozess-ID ist). + +Die Syntax der FIFO Pipe Befehle/Text sieht wie folgt aus: + +.... + plugin.buffer *hier Text oder Befehl + *hier Text oder Befehl +.... + +einige Beispiele: + +* Ändert den eigenen Nick auf dem IRC Server libera in "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Schickt eine Nachrich in den IRC #weechat Channel: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Schickt eine Nachricht in den aktuellen Buffer: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Sendet zwei Befehle um alle Python-Skripten zu entfernen und dann neu zu laden (die beiden Befehle müssen + mit "\n" getrennt werden): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Befehle + +include::includes/autogen_user_commands.de.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Optionen + +Sektionen in Datei _fifo.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| file | /set fifo.file.* | FIFO Pipe Optionen. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=fifo_options] + [[logger_plugin]] === Logger |