diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/de/weechat_user.de.adoc | 348 | ||||
| -rw-r--r-- | doc/en/weechat_user.en.adoc | 342 | ||||
| -rw-r--r-- | doc/fr/weechat_user.fr.adoc | 350 | ||||
| -rw-r--r-- | doc/it/weechat_user.it.adoc | 372 | ||||
| -rw-r--r-- | doc/ja/weechat_user.ja.adoc | 348 | ||||
| -rw-r--r-- | doc/pl/weechat_user.pl.adoc | 344 | ||||
| -rw-r--r-- | doc/sr/weechat_user.sr.adoc | 316 |
7 files changed, 1210 insertions, 1210 deletions
diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index 7f0a8af57..09f783445 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -270,7 +270,7 @@ Liste von häufig verwendeten Optionen: kompiliert <<scripts_plugins,Python Erweiterung>> nutzt Python 2 anstelle von Python 3. | ENABLE_RELAY | `ON`, `OFF` | ON | - kompiliert <<relay_plugin,Relay Erweiterung>>. + kompiliert <<relay,Relay Erweiterung>>. | ENABLE_RUBY | `ON`, `OFF` | ON | kompiliert <<scripts_plugins,Ruby Erweiterung>>. @@ -3719,169 +3719,8 @@ 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] - -[[relay_plugin]] -=== Relay +[[relay]] +== Relay Die Relay-Erweiterung wird genutzt um Daten, mittels unterschiedlicher Protokolle, über ein Netzwerk zu übermitteln: @@ -3897,7 +3736,7 @@ Die Relay-Erweiterung wird genutzt um Daten, mittels unterschiedlicher Protokoll ** WeeCloud (JavaScript): https://github.com/eirikb/weecloud [[relay_password]] -==== Passwort +=== Passwort Es wird dringend empfohlen, mit diesen Befehlen ein Passwort für das Relay festzulegen: @@ -3910,7 +3749,7 @@ Dieses Passwort wird sowohl für das _irc_ als auch für das _weechat_ Protokoll verwendet. [[relay_totp]] -==== TOTP +=== TOTP TOTP (Time-based One-Time Passwort) ist eine Zwei-Faktor-Authentifizierung für das _weechat_ Protokoll, als Ergänzung zum eigentlichen Passwort. @@ -3939,7 +3778,7 @@ sind erlaubt, zum Beispiel: ---- [[relay_ssl]] -==== SSL +=== SSL Man kann SSL mittels eines selbst erstellten Zertifikates und eines privaten Schlüssels nutzen. Um SSL für die Verbindung zu aktivieren stellt man dem @@ -3969,7 +3808,7 @@ Schlüssel mittels folgendem Befehl nachträglich geladen werden: ---- [[relay_irc_proxy]] -==== IRC Proxy +=== IRC Proxy Die Relay Erweiterung kann wie ein IRC Proxy genutzt werden. Dabei simuliert die Erweiterung einen IRC Server und man kann sich mit jedem IRC Client zu WeeChat @@ -4011,13 +3850,13 @@ folgenden Befehlen einrichten: ---- [[relay_weechat_protocol]] -==== WeeChat Protokoll +=== WeeChat Protokoll Die Relay-Erweiterung kann Daten, mittels dem WeeChat Protokoll, an eine externe Oberfläche senden. Man kann sich mittels einer externen Oberfläche verbinden, für eine Liste -siehe <<relay_plugin>>. +siehe <<relay>>. [IMPORTANT] Eine WeeChat Instanz kann sich NICHT mit einer anderen WeeChat Instanz über @@ -4033,7 +3872,7 @@ Nun kann man über den Port 9000 mittels einer Oberfläche und dem Passwort "meinPasswort" eine Verbindung zu WeeChat herstellen. [[relay_websocket]] -==== WebSocket +=== WebSocket Das WebSocket Protokoll (https://tools.ietf.org/html/rfc6455[RFC 6455]) wird nun in der Relay Erweiterung unterstützt. @@ -4053,7 +3892,7 @@ Der Port (im Beispiel: 9000) ist der Port der in der Relay Erweiterung angegeben Die URI muss immer auf "/weechat" enden (_irc_ und _weechat_ Protokoll). [[relay_unix_socket]] -==== UNIX Domain Sockets +=== UNIX Domain Sockets Wenn man die Protokolloption "unix" mit dem Befehl `/relay add` nutzt, kann man jedes Protokoll zum Lauschen an einem UNIX Domain Socket nutzen, indem @@ -4078,12 +3917,12 @@ Dies leitet lokale relay Client Verbindungen von Port 9000 um, zu einer WeeChat Instanz welche auf "hostname" hört. [[relay_commands]] -==== Befehle +=== Befehle include::includes/autogen_user_commands.de.adoc[tag=relay_commands] [[relay_options]] -==== Optionen +=== Optionen Sektionen in Datei _relay.conf_: @@ -4102,6 +3941,167 @@ Optionen: include::includes/autogen_user_options.de.adoc[tag=relay_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] + [[scripts_plugins]] === Skripten diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index 690546228..a989a4487 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -262,7 +262,7 @@ List of commonly used options: Compile <<scripts_plugins,Python plugin>> using Python 2 instead of Python 3. | ENABLE_RELAY | `ON`, `OFF` | ON | - Compile <<relay_plugin,Relay plugin>>. + Compile <<relay,Relay plugin>>. | ENABLE_RUBY | `ON`, `OFF` | ON | Compile <<scripts_plugins,Ruby plugin>>. @@ -3613,166 +3613,8 @@ Options: include::includes/autogen_user_options.en.adoc[tag=irc_options] -[[plugins]] -== Plugins - -A plugin is a dynamic library, written in C and compiled, which is loaded by -WeeChat. -Under GNU/Linux, the file has ".so" extension, ".dll" under Windows. - -Plugins found are automatically loaded when WeeChat is starting, and it is -possible to load or unload plugins while WeeChat is running. - -It's important to make difference between a _plugin_ and a _script_: a -_plugin_ is a binary file compiled and loaded with command `/plugin`, whereas -a _script_ is a text file loaded with a plugin like _python_ with command -`/python`. - -You can use command `/plugin` to load/unload a plugin, or list all loaded -plugins. - -When a plugin is unloaded, WeeChat removes: - -* buffers -* configuration options (options are written in files) -* all hooks: commands, modifiers, process, etc. -* infos and infolists -* hdata -* bar items. - -Examples to load, unload or list plugins: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Default plugins are: - -[width="100%",cols="1,5",options="header"] -|=== -| Plugin | Description -| alias | Define alias for commands. -| buflist | Bar item with list of buffers. -| charset | Charset decoding/encoding for buffers. -| exec | Execution of external commands in WeeChat. -| fifo | FIFO pipe used to remotely send commands to WeeChat. -| fset | Fast set of WeeChat and plugins options. -| irc | IRC chat protocol. -| logger | Log buffers to files. -| relay | Relay data via network. -| script | Script manager. -| python | Python scripting API. -| perl | Perl scripting API. -| ruby | Ruby scripting API. -| lua | Lua scripting API. -| tcl | Tcl scripting API. -| guile | Guile (scheme) scripting API. -| javascript | JavaScript scripting API. -| 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. -|=== - -To learn more about plugin or script development (through API), please read the -link:weechat_plugin_api.en.html[WeeChat plugin API reference] or the -link:weechat_scripting.en.html[WeeChat scripting guide]. - -[[exec_plugin]] -=== Exec - -The `/exec` command lets you execute external commands inside WeeChat and -display the output locally, or send it to a buffer. - -[[exec_commands]] -==== Commands - -include::includes/autogen_user_commands.en.adoc[tag=exec_commands] - -[[exec_options]] -==== Options - -Sections in file _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| command | /set exec.command.* | Options for commands. -| color | /set exec.color.* | Colors. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -You can remote control WeeChat, by sending commands or text to a FIFO pipe (if -option "fifo.file.enabled" is enabled, it is by default). - -The FIFO pipe is located in WeeChat runtime directory and is called -_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). - -Syntax for the FIFO pipe commands/text is one of following: - -.... - plugin.buffer *text or command here - *text or command here -.... - -Some examples: - -* Change nick on IRC server libera to "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Send a message on IRC #weechat channel: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Send a message on current buffer: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Send two commands to unload/reload Python scripts (you have to separate them - with "\n"): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Commands - -include::includes/autogen_user_commands.en.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Options - -Sections in file _fifo.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| file | /set fifo.file.* | FIFO pipe control. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=fifo_options] - -[[relay_plugin]] -=== Relay +[[relay]] +== Relay The Relay plugin is used to relay data via network, using different protocols: @@ -3787,7 +3629,7 @@ The Relay plugin is used to relay data via network, using different protocols: ** WeeCloud (JavaScript): https://github.com/eirikb/weecloud [[relay_password]] -==== Password +=== Password It is highly recommended to set a password for relay, with these commands: @@ -3799,7 +3641,7 @@ It is highly recommended to set a password for relay, with these commands: This password is used for _irc_ and _weechat_ protocols. [[relay_totp]] -==== TOTP +=== TOTP TOTP (Time-based One-Time Password) can be used as secondary authentication factor for _weechat_ protocol, in addition to the password. @@ -3828,7 +3670,7 @@ for example: ---- [[relay_ssl]] -==== SSL +=== SSL You can use SSL by creating a certificate and private key, and by using prefix "ssl." in the name of protocol. @@ -3856,7 +3698,7 @@ with command: ---- [[relay_irc_proxy]] -==== IRC proxy +=== IRC proxy The Relay plugin can act as an IRC proxy: it will simulate an IRC server, and you can connect to WeeChat with any other IRC client (including WeeChat itself). @@ -3895,11 +3737,11 @@ commands: ---- [[relay_weechat_protocol]] -==== WeeChat protocol +=== WeeChat protocol The Relay plugin can send data to remote interface using WeeChat protocol. -You can connect with a remote interface, see the list in <<relay_plugin>>. +You can connect with a remote interface, see the list in <<relay>>. [IMPORTANT] WeeChat itself can NOT connect to another WeeChat with this protocol. @@ -3914,7 +3756,7 @@ Now you can connect on port 9000 with a remote interface using password "mypassword". [[relay_websocket]] -==== WebSocket +=== WebSocket WebSocket protocol (https://tools.ietf.org/html/rfc6455[RFC 6455]) is supported in Relay plugin for all protocols. @@ -3935,7 +3777,7 @@ The port (9000 in example) is the port defined in Relay plugin. The URI must always end with "/weechat" (for _irc_ and _weechat_ protocols). [[relay_unix_socket]] -==== UNIX domain sockets +=== UNIX domain sockets Using the protocol option "unix" with the `/relay add` command, you can listen using any protocol on a UNIX domain socket at a given path. For example: @@ -3958,12 +3800,12 @@ This redirects local relay clients connecting on port 9000 to the WeeChat instance running on "hostname". [[relay_commands]] -==== Commands +=== Commands include::includes/autogen_user_commands.en.adoc[tag=relay_commands] [[relay_options]] -==== Options +=== Options Sections in file _relay.conf_: @@ -3982,6 +3824,164 @@ Options: include::includes/autogen_user_options.en.adoc[tag=relay_options] +[[plugins]] +== Plugins + +A plugin is a dynamic library, written in C and compiled, which is loaded by +WeeChat. +Under GNU/Linux, the file has ".so" extension, ".dll" under Windows. + +Plugins found are automatically loaded when WeeChat is starting, and it is +possible to load or unload plugins while WeeChat is running. + +It's important to make difference between a _plugin_ and a _script_: a +_plugin_ is a binary file compiled and loaded with command `/plugin`, whereas +a _script_ is a text file loaded with a plugin like _python_ with command +`/python`. + +You can use command `/plugin` to load/unload a plugin, or list all loaded +plugins. + +When a plugin is unloaded, WeeChat removes: + +* buffers +* configuration options (options are written in files) +* all hooks: commands, modifiers, process, etc. +* infos and infolists +* hdata +* bar items. + +Examples to load, unload or list plugins: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Default plugins are: + +[width="100%",cols="1,5",options="header"] +|=== +| Plugin | Description +| alias | Define alias for commands. +| buflist | Bar item with list of buffers. +| charset | Charset decoding/encoding for buffers. +| exec | Execution of external commands in WeeChat. +| fifo | FIFO pipe used to remotely send commands to WeeChat. +| fset | Fast set of WeeChat and plugins options. +| irc | IRC chat protocol. +| logger | Log buffers to files. +| relay | Relay data via network. +| script | Script manager. +| python | Python scripting API. +| perl | Perl scripting API. +| ruby | Ruby scripting API. +| lua | Lua scripting API. +| tcl | Tcl scripting API. +| guile | Guile (scheme) scripting API. +| javascript | JavaScript scripting API. +| 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. +|=== + +To learn more about plugin or script development (through API), please read the +link:weechat_plugin_api.en.html[WeeChat plugin API reference] or the +link:weechat_scripting.en.html[WeeChat scripting guide]. + +[[exec_plugin]] +=== Exec + +The `/exec` command lets you execute external commands inside WeeChat and +display the output locally, or send it to a buffer. + +[[exec_commands]] +==== Commands + +include::includes/autogen_user_commands.en.adoc[tag=exec_commands] + +[[exec_options]] +==== Options + +Sections in file _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| command | /set exec.command.* | Options for commands. +| color | /set exec.color.* | Colors. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +You can remote control WeeChat, by sending commands or text to a FIFO pipe (if +option "fifo.file.enabled" is enabled, it is by default). + +The FIFO pipe is located in WeeChat runtime directory and is called +_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). + +Syntax for the FIFO pipe commands/text is one of following: + +.... + plugin.buffer *text or command here + *text or command here +.... + +Some examples: + +* Change nick on IRC server libera to "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Send a message on IRC #weechat channel: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Send a message on current buffer: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Send two commands to unload/reload Python scripts (you have to separate them + with "\n"): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Commands + +include::includes/autogen_user_commands.en.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Options + +Sections in file _fifo.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| file | /set fifo.file.* | FIFO pipe control. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=fifo_options] + [[scripts_plugins]] === Scripts diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index 9636aed8f..96f91525d 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -267,7 +267,7 @@ Liste des options couramment utilisées : Python 3. | ENABLE_RELAY | `ON`, `OFF` | ON | - Compiler <<relay_plugin,l'extension Relay>>. + Compiler <<relay,l'extension Relay>>. | ENABLE_RUBY | `ON`, `OFF` | ON | Compiler <<scripts_plugins,l'extension Ruby>>. @@ -3729,170 +3729,8 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=irc_options] -[[plugins]] -== Extensions - -Une extension est une bibliothèque dynamique, écrite en C et compilée, qui est -chargée par WeeChat. -Sous GNU/Linux, ce fichier a une extension ".so", et ".dll" sous Windows. - -Les extensions trouvées sont automatiquement chargées par WeeChat lorsqu'il -démarre, et il est possible de charger et décharger des extensions pendant que -WeeChat tourne. - -Il est important de bien faire la différence entre une _extension_ et un -_script_ : une _extension_ est un fichier binaire compilé et chargé avec la -commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une -extension comme _python_ par la commande `/python`. - -Vous pouvez utiliser la commande `/plugin` pour charger/décharger une -extension, ou afficher les extensions chargées. - -Quand une extension est déchargée, WeeChat supprime : - -* les tampons -* les options de configuration (les options sont écrites dans les fichiers) -* tous les "hooks" : commandes, modificateurs, processus, etc. -* les infos et infolists -* les "hdata" -* les objets de barre. - -Exemples pour charger, décharger et afficher les extensions : - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Les extensions par défaut sont : - -[width="100%",cols="1,5",options="header"] -|=== -| Extension | Description -| alias | Définition d'alias pour les commandes. -| buflist | Objet de barre avec la liste des tampons. -| charset | Encodage/encodage avec jeu de caractère sur les tampons. -| exec | Exécution de commandes externes dans WeeChat. -| fifo | Tube FIFO pour envoyer des commandes à distance vers WeeChat. -| fset | Modification rapide des options de WeeChat et des extensions. -| irc | Discussion avec le protocole IRC. -| logger | Enregistrement des tampons dans des fichiers. -| relay | Relai de données via le réseau. -| script | Gestionnaire de scripts. -| python | Interface (API) pour scripts Python. -| perl | Interface (API) pour scripts Perl. -| ruby | Interface (API) pour scripts Ruby. -| lua | Interface (API) pour scripts Lua. -| tcl | Interface (API) pour scripts Tcl. -| guile | Interface (API) pour scripts Guile (scheme). -| javascript | Interface (API) pour scripts JavaScript. -| 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. -|=== - -Pour en apprendre plus sur le développement d'extension ou de script (via -l'API), merci de consulter la -link:weechat_plugin_api.fr.html[Référence API extension WeeChat] ou le -link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. - -[[exec_plugin]] -=== Exec - -La commande `/exec` vous permet de lancer des commandes externes dans WeeChat et -d'afficher la sortie localement, ou de l'envoyer à un tampon. - -[[exec_commands]] -==== Commandes - -include::includes/autogen_user_commands.fr.adoc[tag=exec_commands] - -[[exec_options]] -==== Options - -Sections dans le fichier _exec.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| command | /set exec.command.* | Options pour les commandes. -| color | /set exec.color.* | Couleurs. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du -texte dans un tube FIFO (si l'option _fifo.file.enabled_ est activée, -elle l'est par défaut). - -Le tube FIFO est dans le répertoire WeeChat "runtime" et s'appelle -_weechat_fifo_12345_ par défaut (où _12345_ est le process id de WeeChat). - -La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est une -des suivantes : - -.... - plugin.buffer *texte ou commande ici - *texte ou commande ici -.... - -Quelques exemples : - -* Changer le pseudo sur libera en "autrepseudo" : - ----- -$ echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Envoyer un message sur le canal IRC #weechat : - ----- -$ echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Envoyer un message sur le tampon courant : - ----- -$ echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Envoyer deux commandes pour décharger/recharger les scripts Python (vous devez - les séparer par "\n") : - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Commandes - -include::includes/autogen_user_commands.fr.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Options - -Sections dans le fichier _fifo.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| file | /set fifo.file.* | Contrôle du tube FIFO. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=fifo_options] - -[[relay_plugin]] -=== Relay +[[relay]] +== Relay L'extension Relay est utilisée pour relayer des données via le réseau, en utilisant divers protocoles : @@ -3907,7 +3745,7 @@ utilisant divers protocoles : ** WeeCloud (JavaScript) : https://github.com/eirikb/weecloud [[relay_password]] -==== Mot de passe +=== Mot de passe Il est fortement recommandé de définir un mot de passe pour le relai, avec ces commandes : @@ -3920,7 +3758,7 @@ commandes : Ce mot de passe sera utilisé pour les protocoles _irc_ et _weechat_. [[relay_totp]] -==== TOTP +=== TOTP TOTP (« Time-based One-Time Password » : mot de passe à usage unique basé sur le temps) peut être utilisé comme second facteur d'authentification pour le protocole @@ -3951,7 +3789,7 @@ chiffres de 2 à 7, par exemple : ---- [[relay_ssl]] -==== SSL +=== SSL Vous pouvez utiliser SSL en créant un certificat et clé privée et en utilisant le préfixe "ssl." dans le nom du protocole. @@ -3979,7 +3817,7 @@ commande : ---- [[relay_irc_proxy]] -==== IRC proxy +=== IRC proxy L'extension Relay peut agir comme un proxy IRC : elle simulera un serveur IRC, et vous pourrez vous connecter sur WeeChat avec n'importe quel autre client IRC @@ -4022,13 +3860,13 @@ avec ces commandes : ---- [[relay_weechat_protocol]] -==== Protocole WeeChat +=== Protocole WeeChat L'extension Relay peut envoyer les données à une interface distante en utilisant le protocole WeeChat. Vous pouvez vous connecter avec une interface distante, voir la liste dans -<<relay_plugin>>. +<<relay>>. [IMPORTANT] WeeChat lui-même ne peut PAS se connecter sur un autre WeeChat avec ce @@ -4044,7 +3882,7 @@ Maintenant vous pouvez vous connecter sur le port 9000 avec une interface distante en utilisant le mot de passe "motdepasse". [[relay_websocket]] -==== WebSocket +=== WebSocket Le protocole WebSocket (https://tools.ietf.org/html/rfc6455[RFC 6455]) est supporté dans l'extension Relay pour tous les protocoles. @@ -4067,7 +3905,7 @@ L'URI doit toujours se terminer par "/weechat" (pour les protocoles _irc_ et _weechat_). [[relay_unix_socket]] -==== UNIX domain sockets +=== UNIX domain sockets En utilisant l'option de protocole "unix" avec la commande `/relay add`, vous pouvez écouter avec n'importe quel protocole sur un socket UNIX et un @@ -4092,12 +3930,12 @@ Cela redirige les clients relay locaux qui se connectent au port 9000 vers l'instance de WeeChat qui tourne sur "hostname". [[relay_commands]] -==== Commandes +=== Commandes include::includes/autogen_user_commands.fr.adoc[tag=relay_commands] [[relay_options]] -==== Options +=== Options Sections dans le fichier _relay.conf_ : @@ -4116,6 +3954,168 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=relay_options] +[[plugins]] +== Extensions + +Une extension est une bibliothèque dynamique, écrite en C et compilée, qui est +chargée par WeeChat. +Sous GNU/Linux, ce fichier a une extension ".so", et ".dll" sous Windows. + +Les extensions trouvées sont automatiquement chargées par WeeChat lorsqu'il +démarre, et il est possible de charger et décharger des extensions pendant que +WeeChat tourne. + +Il est important de bien faire la différence entre une _extension_ et un +_script_ : une _extension_ est un fichier binaire compilé et chargé avec la +commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une +extension comme _python_ par la commande `/python`. + +Vous pouvez utiliser la commande `/plugin` pour charger/décharger une +extension, ou afficher les extensions chargées. + +Quand une extension est déchargée, WeeChat supprime : + +* les tampons +* les options de configuration (les options sont écrites dans les fichiers) +* tous les "hooks" : commandes, modificateurs, processus, etc. +* les infos et infolists +* les "hdata" +* les objets de barre. + +Exemples pour charger, décharger et afficher les extensions : + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Les extensions par défaut sont : + +[width="100%",cols="1,5",options="header"] +|=== +| Extension | Description +| alias | Définition d'alias pour les commandes. +| buflist | Objet de barre avec la liste des tampons. +| charset | Encodage/encodage avec jeu de caractère sur les tampons. +| exec | Exécution de commandes externes dans WeeChat. +| fifo | Tube FIFO pour envoyer des commandes à distance vers WeeChat. +| fset | Modification rapide des options de WeeChat et des extensions. +| irc | Discussion avec le protocole IRC. +| logger | Enregistrement des tampons dans des fichiers. +| relay | Relai de données via le réseau. +| script | Gestionnaire de scripts. +| python | Interface (API) pour scripts Python. +| perl | Interface (API) pour scripts Perl. +| ruby | Interface (API) pour scripts Ruby. +| lua | Interface (API) pour scripts Lua. +| tcl | Interface (API) pour scripts Tcl. +| guile | Interface (API) pour scripts Guile (scheme). +| javascript | Interface (API) pour scripts JavaScript. +| 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. +|=== + +Pour en apprendre plus sur le développement d'extension ou de script (via +l'API), merci de consulter la +link:weechat_plugin_api.fr.html[Référence API extension WeeChat] ou le +link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. + +[[exec_plugin]] +=== Exec + +La commande `/exec` vous permet de lancer des commandes externes dans WeeChat et +d'afficher la sortie localement, ou de l'envoyer à un tampon. + +[[exec_commands]] +==== Commandes + +include::includes/autogen_user_commands.fr.adoc[tag=exec_commands] + +[[exec_options]] +==== Options + +Sections dans le fichier _exec.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| command | /set exec.command.* | Options pour les commandes. +| color | /set exec.color.* | Couleurs. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du +texte dans un tube FIFO (si l'option _fifo.file.enabled_ est activée, +elle l'est par défaut). + +Le tube FIFO est dans le répertoire WeeChat "runtime" et s'appelle +_weechat_fifo_12345_ par défaut (où _12345_ est le process id de WeeChat). + +La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est une +des suivantes : + +.... + plugin.buffer *texte ou commande ici + *texte ou commande ici +.... + +Quelques exemples : + +* Changer le pseudo sur libera en "autrepseudo" : + +---- +$ echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Envoyer un message sur le canal IRC #weechat : + +---- +$ echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Envoyer un message sur le tampon courant : + +---- +$ echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Envoyer deux commandes pour décharger/recharger les scripts Python (vous devez + les séparer par "\n") : + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Commandes + +include::includes/autogen_user_commands.fr.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Options + +Sections dans le fichier _fifo.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| file | /set fifo.file.* | Contrôle du tube FIFO. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=fifo_options] + [[scripts_plugins]] === Scripts diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index 5e2b20c13..82d0ad53c 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -301,7 +301,7 @@ List of commonly used options: Compile <<scripts_plugins,Python plugin>> using Python 2 instead of Python 3. | ENABLE_RELAY | `ON`, `OFF` | ON | - Compile <<relay_plugin,Relay plugin>>. + Compile <<relay,Relay plugin>>. | ENABLE_RUBY | `ON`, `OFF` | ON | Compile <<scripts_plugins,Ruby plugin>>. @@ -3900,181 +3900,8 @@ Options: include::includes/autogen_user_options.it.adoc[tag=irc_options] -[[plugins]] -== Plugin - -Un plugin è una libreria dinamica, scritta in C e compilata, che viene caricata -da WeeChat. -In GNU/Linux, il file ha estensione ".so", ".dll" in Windows. - -I plugin trovati vengono caricati automaticamente all'avvio di WeeChat, ed -è possibile caricare o scaricare i plugin durante l'esecuzione del programma. - -È importante evidenziare la differenza tra un _plugin_ ed uno _script_: un -_plugin_ è un file binario compilato e caricato con il comando `/plugin`, -mentre uno _script_ è un file di testo caricato con un plugin come _python_ -con il comando `/python`. - -È possibile utilizzare il comando `/plugin` per caricare/scaricare un plugin, -oppure elencare tutti i plugin caricati. - -// TRANSLATION MISSING -When a plugin is unloaded, WeeChat removes: - -* buffers -* configuration options (options are written in files) -* all hooks: commands, modifiers, process, etc. -* infos and infolists -* hdata -* bar items. - -Esempi per caricare, scaricare oppure elencare i plugin: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -I plugin predefiniti sono: - -[width="100%",cols="1,5",options="header"] -|=== -| Plugin | Descrizione -| alias | Definisce gli alias per i comandi. -// TRANSLATION MISSING -| buflist | Bar item with list of buffers. -| charset | Set di caratteri per la codifica/decodifica nei buffer. -// TRANSLATION MISSING -| exec | Execution of external commands in WeeChat. -| fifo | pipe FIFO utilizzata per inviare comandi da remoto su WeeChat. -// TRANSLATION MISSING -| fset | Fast set of WeeChat and plugins options. -| irc | protocollo chat per IRC. -| logger | Registra i buffer su file. -| relay | Relay dei dati via rete. -| script | Gestore script. -| python | API per lo scripting in Python. -| perl | API per lo scripting in Perl. -| ruby | API per lo scripting in Ruby. -| lua | API per lo scripting in Lua. -| tcl | API per lo scripting in TCL. -| guile | API per lo scripting in Guile (scheme). -| javascript | API per lo scripting in JavaScript. -| php | API per lo scripting in PHP. -| 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. -|=== - -Per saperne di più riguardo lo sviluppo di plugin o script (tramite le API), per -favore consultare link:weechat_plugin_api.it.html[Riferimento API dei Plugin per WeeChat] -oppure link:weechat_scripting.it.html[Guida allo Scripting di WeeChat]. - -// TRANSLATION MISSING -[[exec_plugin]] -=== Exec - -The `/exec` command lets you execute external commands inside WeeChat and -display the output locally, or send it to a buffer. - -[[exec_commands]] -==== Comandi - -include::includes/autogen_user_commands.it.adoc[tag=exec_commands] - -[[exec_options]] -==== Opzioni - -// TRANSLATION MISSING -Sections in file _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| command | /set exec.command.* | Options for commands. -| color | /set exec.color.* | Colors. -|=== - -Options: - -include::includes/autogen_user_options.it.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -È possibile controllare da remoto WeeChat, inviando comandi o del testo ad una -pipe FIFO (se l'opzione "fifo.file.enabled" è abilitata, e lo è per default). - -// TRANSLATION MISSING -The FIFO pipe is located in WeeChat runtime directory and is called -_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). - -La sintassi per i comandi/testo della pipe FIFO è una delle seguenti: - -.... - plugin.buffer *testo o comando qui - *testo o comando qui -.... - -Alcuni esempi: - -// TRANSLATION MISSING -* Change nick on IRC server libera to "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -// TRANSLATION MISSING -* Send a message on IRC #weechat channel: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -// TRANSLATION MISSING -* Send a message on current buffer: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Inviare due comandi per scaricare/caricare gli script Python (è necessario - separarli con "\n"): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Comandi - -include::includes/autogen_user_commands.it.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Opzioni - -// TRANSLATION MISSING -Sections in file _fifo.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| file | /set fifo.file.* | FIFO pipe control. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=fifo_options] - -[[relay_plugin]] -=== Relay +[[relay]] +== Relay Il plugin Relay viene utilizzato per inoltrare i dati via rete, facendo uso di protocolli differenti: @@ -4091,7 +3918,7 @@ protocolli differenti: // TRANSLATION MISSING [[relay_password]] -==== Password +=== Password It is highly recommended to set a password for relay, with these commands: @@ -4104,7 +3931,7 @@ This password is used for _irc_ and _weechat_ protocols. // TRANSLATION MISSING [[relay_totp]] -==== TOTP +=== TOTP TOTP (Time-based One-Time Password) can be used as secondary authentication factor for _weechat_ protocol, in addition to the password. @@ -4133,7 +3960,7 @@ for example: ---- [[relay_ssl]] -==== SSL +=== SSL È possibile usare SSL creando un certificato e una chiave privata, e usando il prefisso "ssl." nel nome del protocollo. @@ -4164,7 +3991,7 @@ chiave privata con il comando: // TRANSLATION MISSING [[relay_irc_proxy]] -==== Proxy IRC +=== Proxy IRC The Relay plugin can act as an IRC proxy: it will simulate an IRC server, and you can connect to WeeChat with any other IRC client (including WeeChat itself). @@ -4203,13 +4030,13 @@ commands: ---- [[relay_weechat_protocol]] -==== Protocollo WeeChat +=== Protocollo WeeChat Il plugin Relay può inviare dati alle interfacce remote usando il protocollo WeeChat. // TRANSLATION MISSING -You can connect with a remote interface, see the list in <<relay_plugin>>. +You can connect with a remote interface, see the list in <<relay>>. [IMPORTANT] // TRANSLATION MISSING @@ -4226,7 +4053,7 @@ password "miapass". // TRANSLATION MISSING [[relay_websocket]] -==== WebSocket +=== WebSocket WebSocket protocol (https://tools.ietf.org/html/rfc6455[RFC 6455]) is supported in Relay plugin for all protocols. @@ -4248,7 +4075,7 @@ The URI must always end with "/weechat" (for _irc_ and _weechat_ protocols). // TRANSLATION MISSING [[relay_unix_socket]] -==== UNIX domain sockets +=== UNIX domain sockets Using the protocol option "unix" with the `/relay add` command, you can listen using any protocol on a UNIX domain socket at a given path. For example: @@ -4271,12 +4098,12 @@ This redirects local relay clients connecting on port 9000 to the WeeChat instance running on "hostname". [[relay_commands]] -==== Comandi +=== Comandi include::includes/autogen_user_commands.it.adoc[tag=relay_commands] [[relay_options]] -==== Opzioni +=== Opzioni // TRANSLATION MISSING Sections in file _relay.conf_: @@ -4298,6 +4125,179 @@ Options: include::includes/autogen_user_options.it.adoc[tag=relay_options] +[[plugins]] +== Plugin + +Un plugin è una libreria dinamica, scritta in C e compilata, che viene caricata +da WeeChat. +In GNU/Linux, il file ha estensione ".so", ".dll" in Windows. + +I plugin trovati vengono caricati automaticamente all'avvio di WeeChat, ed +è possibile caricare o scaricare i plugin durante l'esecuzione del programma. + +È importante evidenziare la differenza tra un _plugin_ ed uno _script_: un +_plugin_ è un file binario compilato e caricato con il comando `/plugin`, +mentre uno _script_ è un file di testo caricato con un plugin come _python_ +con il comando `/python`. + +È possibile utilizzare il comando `/plugin` per caricare/scaricare un plugin, +oppure elencare tutti i plugin caricati. + +// TRANSLATION MISSING +When a plugin is unloaded, WeeChat removes: + +* buffers +* configuration options (options are written in files) +* all hooks: commands, modifiers, process, etc. +* infos and infolists +* hdata +* bar items. + +Esempi per caricare, scaricare oppure elencare i plugin: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +I plugin predefiniti sono: + +[width="100%",cols="1,5",options="header"] +|=== +| Plugin | Descrizione +| alias | Definisce gli alias per i comandi. +// TRANSLATION MISSING +| buflist | Bar item with list of buffers. +| charset | Set di caratteri per la codifica/decodifica nei buffer. +// TRANSLATION MISSING +| exec | Execution of external commands in WeeChat. +| fifo | pipe FIFO utilizzata per inviare comandi da remoto su WeeChat. +// TRANSLATION MISSING +| fset | Fast set of WeeChat and plugins options. +| irc | protocollo chat per IRC. +| logger | Registra i buffer su file. +| relay | Relay dei dati via rete. +| script | Gestore script. +| python | API per lo scripting in Python. +| perl | API per lo scripting in Perl. +| ruby | API per lo scripting in Ruby. +| lua | API per lo scripting in Lua. +| tcl | API per lo scripting in TCL. +| guile | API per lo scripting in Guile (scheme). +| javascript | API per lo scripting in JavaScript. +| php | API per lo scripting in PHP. +| 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. +|=== + +Per saperne di più riguardo lo sviluppo di plugin o script (tramite le API), per +favore consultare link:weechat_plugin_api.it.html[Riferimento API dei Plugin per WeeChat] +oppure link:weechat_scripting.it.html[Guida allo Scripting di WeeChat]. + +// TRANSLATION MISSING +[[exec_plugin]] +=== Exec + +The `/exec` command lets you execute external commands inside WeeChat and +display the output locally, or send it to a buffer. + +[[exec_commands]] +==== Comandi + +include::includes/autogen_user_commands.it.adoc[tag=exec_commands] + +[[exec_options]] +==== Opzioni + +// TRANSLATION MISSING +Sections in file _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| command | /set exec.command.* | Options for commands. +| color | /set exec.color.* | Colors. +|=== + +Options: + +include::includes/autogen_user_options.it.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +È possibile controllare da remoto WeeChat, inviando comandi o del testo ad una +pipe FIFO (se l'opzione "fifo.file.enabled" è abilitata, e lo è per default). + +// TRANSLATION MISSING +The FIFO pipe is located in WeeChat runtime directory and is called +_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). + +La sintassi per i comandi/testo della pipe FIFO è una delle seguenti: + +.... + plugin.buffer *testo o comando qui + *testo o comando qui +.... + +Alcuni esempi: + +// TRANSLATION MISSING +* Change nick on IRC server libera to "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +// TRANSLATION MISSING +* Send a message on IRC #weechat channel: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +// TRANSLATION MISSING +* Send a message on current buffer: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Inviare due comandi per scaricare/caricare gli script Python (è necessario + separarli con "\n"): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Comandi + +include::includes/autogen_user_commands.it.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Opzioni + +// TRANSLATION MISSING +Sections in file _fifo.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| file | /set fifo.file.* | FIFO pipe control. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=fifo_options] + // TRANSLATION MISSING [[scripts_plugins]] === Scripts diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index c422bd4bf..e03d5ec87 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -273,7 +273,7 @@ CMake に対するオプションを指定するには、以下の書式を使 Compile <<scripts_plugins,Python plugin>> using Python 2 instead of Python 3. | ENABLE_RELAY | `ON`, `OFF` | ON | - <<relay_plugin,リレープラグイン>>のコンパイル。 + <<relay,リレープラグイン>>のコンパイル。 | ENABLE_RUBY | `ON`, `OFF` | ON | <<scripts_plugins,Ruby プラグイン>>のコンパイル。 @@ -3738,169 +3738,8 @@ _irc.conf_ ファイル内のセクション: include::includes/autogen_user_options.ja.adoc[tag=irc_options] -[[plugins]] -== プラグイン - -プラグインとは動的ライブラリのことで、C -言語で書かれてコンパイルされています。プラグインは WeeChat によって読み込まれます。GNU/Linux -の場合、プラグインファイルは ".so" という拡張子を持ち、Windows の場合、".dll" です。 - -見つかったプラグインは WeeChat の起動時に自動的に読み込まれます。WeeChat -の起動時にプラグインを読み込むか否かは選択可能です。 - -_プラグイン_ と _スクリプト_ の違いを明らかにすることは重要です: -_プラグイン_ とは `/plugin` コマンドで読み込まれるコンパイル済みバイナリファイルです。これに対して、 -_スクリプト_ とは `/python` 等のコマンドで _python_ -等のプラグインとともに読み込まれるテキストファイルです。 - -`/plugin` -コマンドを使うことで、プラグインのロード/アンロード、ロード済みプラグインの表示を行うことができます。 - -// TRANSLATION MISSING -When a plugin is unloaded, WeeChat removes: - -* buffers -* configuration options (options are written in files) -* all hooks: commands, modifiers, process, etc. -* infos and infolists -* hdata -* bar items. - -プラグインをロード、アンロード、ロード済みプラグインを表示する例: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -デフォルトプラグインのリスト: - -[width="100%",cols="1,5",options="header"] -|=== -| プラグイン | 説明 -| alias | コマンドの別名を定義 -| buflist | バッファリストを表示するためのバー要素 -| charset | バッファの文字コードに従ってデコード/エンコード -| exec | WeeChat 内部から外部コマンドを実行 -| fifo | 外部から WeeChat にコマンドを送信するための FIFO パイプ -| fset | WeeChat とプラグインのオプションを高速設定 -| irc | IRC チャットプロトコル -| logger | バッファの内容をファイルに保存 -| relay | ネットワーク経由でデータを中継 -| script | スクリプトマネージャ -| python | Python スクリプト API -| perl | Perl スクリプト API -| ruby | Ruby スクリプト API -| lua | Lua スクリプト API -| tcl | Tcl スクリプト API -| guile | Guile (scheme) スクリプト API -| javascript | JavaScript スクリプト API -| php | PHP スクリプト API -| spell | コマンドラインのスペルチェック -| trigger | WeeChat およびプラグインが発生させたイベントに対するテキスト置換とコマンド実行 -// TRANSLATION MISSING -| typing | Display users currently writing messages. -| xfer | ファイル転送とダイレクトチャット -|=== - -API を使ったプラグインやスクリプトの開発についてより詳しく学ぶには -link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス]または -link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド]を参照してください。 - -[[exec_plugin]] -=== Exec - -`/exec` コマンドを使うことで WeeChat -内部から外部コマンドを実行し、その結果を表示したりバッファに送信することが可能になります。 - -[[exec_commands]] -==== コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=exec_commands] - -[[exec_options]] -==== オプション - -_exec.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| command | /set exec.command.* | コマンドに対するオプション -| color | /set exec.color.* | 色 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -外部から WeeChat を操作するには、FIFO パイプにコマンドやテキストを書き込んでください ("fifo.file.enabled" -オプションが有効化されている必要がありますが、デフォルトで有効化されているはずです)。 - -// TRANSLATION MISSING -The FIFO pipe is located in WeeChat runtime directory and is called -_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). - -FIFO パイプに書き込むコマンド/テキストの文法は以下の例の一つです: - -.... - plugin.buffer *テキストまたはコマンド - *テキストまたはコマンド -.... - -例: - -* IRC サーバ libera で使うニックネームを "newnick" に変更する: - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* IRC チャンネル #weechat に対してテキストを送信: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* 現在のバッファに対してテキストを送信: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Python スクリプトのアンロードとロードを行う 2 つのコマンドを送信 - (複数のコマンドは "\n" で分割してください): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=fifo_commands] - -[[fifo_options]] -==== オプション - -_fifo.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| file | /set fifo.file.* | FIFO パイプに関するオプション -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=fifo_options] - -[[relay_plugin]] -=== Relay +[[relay]] +== Relay Relay プラグインはネットワークを介して異なるプロトコルを用いてデータを中継するために利用します: @@ -3915,7 +3754,7 @@ Relay プラグインはネットワークを介して異なるプロトコル ** WeeCloud (JavaScript): https://github.com/eirikb/weecloud [[relay_password]] -==== パスワード +=== パスワード // TRANSLATION MISSING It is highly recommended to set a password for relay, with these commands: @@ -3928,7 +3767,7 @@ secure set relay mypassword このパスワードは _irc_ と _weechat_ プロトコルで利用されます。 [[relay_totp]] -==== TOTP +=== TOTP _weechat_ プロトコルでは、パスワードに加えて、二要素認証の TOTP (時間ベースのワンタイムパスワード) を使うことが可能です。 @@ -3957,7 +3796,7 @@ TOTP の secret は base32 でエンコードされた文字列 ---- [[relay_ssl]] -==== SSL +=== SSL 証明書と秘密鍵を作り、プロトコル名の最初に "ssl." を付けることで SSL 経由でリレーを利用することができます。 @@ -3987,7 +3826,7 @@ WeeChat ---- [[relay_irc_proxy]] -==== IRC プロキシ +=== IRC プロキシ Relay プラグインは IRC プロキシとしても使えます: Relay プラグインは IRC サーバのふりをして、他の IRC クライアント (WeeChat 自身も) は WeeChat に接続できます。 @@ -4029,11 +3868,11 @@ commands: ---- [[relay_weechat_protocol]] -==== WeeChat プロトコル +=== WeeChat プロトコル Relay プラグインは WeeChat プロトコルを使ってリモートインターフェースに対してデータを送信できます。 -リモートインターフェースを使って接続できます、<<relay_plugin>> のリストを参照してください。 +リモートインターフェースを使って接続できます、<<relay>> のリストを参照してください。 [IMPORTANT] このプロトコルを使った場合 WeeChat から他の WeeChat に接続することはできません。 @@ -4048,7 +3887,7 @@ Relay プラグインは WeeChat プロトコルを使ってリモートイン 番ポートに対して、パスワード "mypass" で接続することができます。 [[relay_websocket]] -==== WebSocket +=== WebSocket Relay プラグインはすべてのプロトコルに対して WebSocket プロトコル (https://tools.ietf.org/html/rfc6455[RFC 6455]) をサポートします。 @@ -4069,7 +3908,7 @@ websocket = new WebSocket("ws://server.com:9000/weechat"); の最後には必ず "/weechat" をつけます (_irc_ と _weechat_ プロトコルの場合)。 [[relay_unix_socket]] -==== UNIX ドメインソケット +=== UNIX ドメインソケット `/relay add` コマンドにプロトコルオプション "unix" をつけることで、指定したパスで動作する UNIX ドメインソケット上の任意のプロトコルをリッスンできます。例: @@ -4092,12 +3931,12 @@ $ ssh -L 9000:.weechat/relay_socket user@hostname "hostname" 上で動作中の WeeChat インスタンスへ転送されます。 [[relay_commands]] -==== コマンド +=== コマンド include::includes/autogen_user_commands.ja.adoc[tag=relay_commands] [[relay_options]] -==== オプション +=== オプション _relay.conf_ ファイル内のセクション: @@ -4116,6 +3955,167 @@ _relay.conf_ ファイル内のセクション: include::includes/autogen_user_options.ja.adoc[tag=relay_options] +[[plugins]] +== プラグイン + +プラグインとは動的ライブラリのことで、C +言語で書かれてコンパイルされています。プラグインは WeeChat によって読み込まれます。GNU/Linux +の場合、プラグインファイルは ".so" という拡張子を持ち、Windows の場合、".dll" です。 + +見つかったプラグインは WeeChat の起動時に自動的に読み込まれます。WeeChat +の起動時にプラグインを読み込むか否かは選択可能です。 + +_プラグイン_ と _スクリプト_ の違いを明らかにすることは重要です: +_プラグイン_ とは `/plugin` コマンドで読み込まれるコンパイル済みバイナリファイルです。これに対して、 +_スクリプト_ とは `/python` 等のコマンドで _python_ +等のプラグインとともに読み込まれるテキストファイルです。 + +`/plugin` +コマンドを使うことで、プラグインのロード/アンロード、ロード済みプラグインの表示を行うことができます。 + +// TRANSLATION MISSING +When a plugin is unloaded, WeeChat removes: + +* buffers +* configuration options (options are written in files) +* all hooks: commands, modifiers, process, etc. +* infos and infolists +* hdata +* bar items. + +プラグインをロード、アンロード、ロード済みプラグインを表示する例: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +デフォルトプラグインのリスト: + +[width="100%",cols="1,5",options="header"] +|=== +| プラグイン | 説明 +| alias | コマンドの別名を定義 +| buflist | バッファリストを表示するためのバー要素 +| charset | バッファの文字コードに従ってデコード/エンコード +| exec | WeeChat 内部から外部コマンドを実行 +| fifo | 外部から WeeChat にコマンドを送信するための FIFO パイプ +| fset | WeeChat とプラグインのオプションを高速設定 +| irc | IRC チャットプロトコル +| logger | バッファの内容をファイルに保存 +| relay | ネットワーク経由でデータを中継 +| script | スクリプトマネージャ +| python | Python スクリプト API +| perl | Perl スクリプト API +| ruby | Ruby スクリプト API +| lua | Lua スクリプト API +| tcl | Tcl スクリプト API +| guile | Guile (scheme) スクリプト API +| javascript | JavaScript スクリプト API +| php | PHP スクリプト API +| spell | コマンドラインのスペルチェック +| trigger | WeeChat およびプラグインが発生させたイベントに対するテキスト置換とコマンド実行 +// TRANSLATION MISSING +| typing | Display users currently writing messages. +| xfer | ファイル転送とダイレクトチャット +|=== + +API を使ったプラグインやスクリプトの開発についてより詳しく学ぶには +link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス]または +link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド]を参照してください。 + +[[exec_plugin]] +=== Exec + +`/exec` コマンドを使うことで WeeChat +内部から外部コマンドを実行し、その結果を表示したりバッファに送信することが可能になります。 + +[[exec_commands]] +==== コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=exec_commands] + +[[exec_options]] +==== オプション + +_exec.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| command | /set exec.command.* | コマンドに対するオプション +| color | /set exec.color.* | 色 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +外部から WeeChat を操作するには、FIFO パイプにコマンドやテキストを書き込んでください ("fifo.file.enabled" +オプションが有効化されている必要がありますが、デフォルトで有効化されているはずです)。 + +// TRANSLATION MISSING +The FIFO pipe is located in WeeChat runtime directory and is called +_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). + +FIFO パイプに書き込むコマンド/テキストの文法は以下の例の一つです: + +.... + plugin.buffer *テキストまたはコマンド + *テキストまたはコマンド +.... + +例: + +* IRC サーバ libera で使うニックネームを "newnick" に変更する: + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* IRC チャンネル #weechat に対してテキストを送信: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* 現在のバッファに対してテキストを送信: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Python スクリプトのアンロードとロードを行う 2 つのコマンドを送信 + (複数のコマンドは "\n" で分割してください): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=fifo_commands] + +[[fifo_options]] +==== オプション + +_fifo.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| file | /set fifo.file.* | FIFO パイプに関するオプション +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=fifo_options] + [[scripts_plugins]] === スクリプト diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index c4fd26d70..0350d21c2 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -268,7 +268,7 @@ Lista popularnych opcji: Kompilacja <<scripts_plugins,wtyczki Python>> z użyciem Pythona 2 zamiast Pythona 3. | ENABLE_RELAY | `ON`, `OFF` | ON | - Kompilacja <<relay_plugin,wtyczki relay>>. + Kompilacja <<relay,wtyczki relay>>. | ENABLE_RUBY | `ON`, `OFF` | ON | Kompilacja <<scripts_plugins,wtyczki ruby>>. @@ -3673,167 +3673,8 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=irc_options] -[[plugins]] -== Wtyczki - -Wtyczka jest biblioteka dynamiczną, napisaną w C i skompilowaną, która jest -ładowana przez WeeChat. -W systemach GNU/Linux plik ma rozszerzenie ".so", w Windowsie ".dll". - -Znalezione wtyczki są automatycznie ładowane podczas uruchamiania WeeChat, -możliwe jest również ładowanie lub wyładowywanie wtyczek podczas pracy WeeChat. - -Ważne jest, aby odróżniać _wtyczkę_ od _skryptu_: _wtyczka_ jest to plik binarny -skompilowany i ładowany za pomocą polecenia `/plugin`, natomiast _skrypt_ to -plik tekstowy, ładowany za pomocą wtyczki jak na przykład _python_ za pomocą -polecenia `/python`. - -Możesz użyć komendy `/plugin` żeby załadować/wyładować wtyczkę, lub wyświetlić -wszystkie załadowane wtyczki. - -Podcza wyładowywania wtyczki WeeChat usówa: - -* bufory -* opcje konfiguracyjne (options są zapisywane w plikach) -* wszystkie hooki: komendy, modyfikatory, procesy, etc. -* infos i infolists -* hdata -* elementy pasków. - -Przykłady ładowania, wyładowywania i wyświetlania załadowanych wtyczek: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Domyślne wtyczki: - -[width="100%",cols="1,5",options="header"] -|=== -| Wtyczka | Opis -| alias | Definiuje aliasy dla komend. -| buflist | Element paska z listą buforów. -| charset | Ustawianie kodowania dla buforów. -| exec | Wykonuje zewnętrzną komendę z poziomu WeeChat. -| fifo | Kolejka FIFO używana do zdalnego wysyłania poleceń dla WeeChat. -| fset | Szybkie ustawianie opcji WeeChat i wtyczek. -| irc | Protokół IRC. -| logger | Logowanie zawartości buforów do plików. -| relay | Przekazuje dane przez sieć. -| script | Zarządzanie skryptami. -| python | Wsparcie dla skryptów napisanych w Pythonie. -| perl | Wsparcie dla skryptów napisanych w Perlu. -| ruby | Wsparcie dla skryptów napisanych w Ruby. -| lua | Wsparcie dla skryptów napisanych w Lua. -| tcl | Wsparcie dla skryptów napisanych w Tcl. -| guile | Wsparcie dla skryptów napisanych w Guile (scheme). -| javascript | Wsparcie dla skryptów napisanych w JavaScript. -| 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. -| typing | Pokazuje użytkowników obecnie piszących wiadomości. -| xfer | Przesyłanie plików i bezpośredni chat. -|=== - -Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleźć w -link:weechat_plugin_api.en.html[Opisie API wtyczek] (Angielski) i -link:weechat_scripting.pl.html[Poradniku pisania skryptów]. - -[[exec_plugin]] -=== Exec - -Komenda `/exec` pozwala wykonać zewnętrzne polecenie wewnątrz WeeChat i wyświetlić -jej wynik lokalnie lub wysłać do bufora. - -[[exec_commands]] -==== Komendy - -include::includes/autogen_user_commands.pl.adoc[tag=exec_commands] - -[[exec_options]] -==== Opcje - -Sekcje w pliku _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| command | /set exec.command.* | Opcje dla komend. -| color | /set exec.color.* | Kolory. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Możesz zdalnie kontrolować WeeChat, poprzez wysyłanie komend lub tekstu do -kolejki FIFO (jeśli opcja "fifo.file.enabled" jest włączona, domyślnie jest -włączona). - -Strumień FIFO jest zlokalizowany w katalogu uruchomieniowym WeeChat i ma -domyślnie nazwę weechat_fifo_12345_ (gdzie _12345_ to numer procesu WeeChat). - -Składnia dla komend/tekstu przekazywanego do kolejki FIFO wygląda następująco: - -.... - wtyczka.bufor *tekst lub komenda - *tekst lub komenda -.... - -Kilka przykładów: - -* Zmiana nicka na serwerze IRC libera na "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Wysłanie wiadomości na kanał IRC #weechat: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Wysłanie wiadomości do obecnego bufora: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Wysłanie dwóch komend do wyładowania/przeładowania skryptów Python (należy - oddzielić je za pomocą "\n"): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Komendy - -include::includes/autogen_user_commands.pl.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Opcje - -Sekcje w pliku _fifo.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| plik | /set fifo.file.* | Kontrola kolejki FIFO. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=fifo_options] - -[[relay_plugin]] -=== Relay +[[relay]] +== Relay Wtyczka relay jest używana do przekazywania danych przez sieć, z użyciem różnych protokołów: @@ -3849,7 +3690,7 @@ protokołów: ** WeeCloud (JavaScript): https://github.com/eirikb/weecloud [[relay_password]] -==== Hasło +=== Hasło Zaleca się ustawenia hasła dla pośrednika za pomocą poniższych komend: @@ -3861,7 +3702,7 @@ Zaleca się ustawenia hasła dla pośrednika za pomocą poniższych komend: Hasło to używane jest przez protokoły _irc_ i _weechat_. [[relay_totp]] -==== TOTP +=== TOTP TOTP (Time-based One-Time Password) może zostać użyte jako drugi stopień uwierzytelnienia dla protokołu _weechat_, poza normalnym hasłem. @@ -3890,7 +3731,7 @@ na przykład: ---- [[relay_ssl]] -==== SSL +=== SSL Możesz używać SSL poprzez utworzenie certyfikatu i klucza prywatnego, oraz użycie prefiksu "ssl." w nazwie protokołu. @@ -3918,7 +3759,7 @@ za pomocą polecenia: ---- [[relay_irc_proxy]] -==== IRC proxy +=== IRC proxy Wtyczka relay może zachowywać się jak proxy dla IRC: będzie symulować serwer IRC, możesz się połączyć do niego za pomocą dowolnego klienta IRC (w tym WeeChat). @@ -3959,12 +3800,12 @@ za pomocą tych komend: ---- [[relay_weechat_protocol]] -==== Protokół WeeChat +=== Protokół WeeChat Wtyczka relay może wysyłać dane do zdalnego interfejsu korzystając z protokołu WeeChat. -Możesz połączyć się zdalnym inrerfejsem, listę znajdziesz w <<relay_plugin>>. +Możesz połączyć się zdalnym inrerfejsem, listę znajdziesz w <<relay>>. [IMPORTANT] WeeChat NIE MOŻE się połączyć z innym WeeChat za pomocą tego protokołu. @@ -3979,7 +3820,7 @@ Teraz możesz się połączyć zdalnym interfejsem na porcie 9000 za pomocą has "moje_hasło". [[relay_websocket]] -==== WebSocket +=== WebSocket Protokół WebSocket (https://tools.ietf.org/html/rfc6455[RFC 6455]) jest wspierany dla wszystkich protokołów. @@ -4000,7 +3841,7 @@ Port (9000 w przykładzie) to port zdefiniowany we wtyczce relay. Adres URL musi się zawsze kończyć "/weechat" (dla protokołów _irc_ i _weechat_). [[relay_unix_socket]] -==== Sockety UNIXowe +=== Sockety UNIXowe Używając opcji protokołu "unix" razem z komendą `/relay`, można nasłuchiwać dowolnego protokołu za pomocą socketu UNIXowego w podanej ścieżce. Na przykład: @@ -4023,12 +3864,12 @@ Przekerowuje to połączenia lokalnych klientów łączących się na port 9000 WeeChat uruchomionej na "hostname". [[relay_commands]] -==== Komendy +=== Komendy include::includes/autogen_user_commands.pl.adoc[tag=relay_commands] [[relay_options]] -==== Opcje +=== Opcje Sekcje w pliku _relay.conf_: @@ -4047,6 +3888,165 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=relay_options] +[[plugins]] +== Wtyczki + +Wtyczka jest biblioteka dynamiczną, napisaną w C i skompilowaną, która jest +ładowana przez WeeChat. +W systemach GNU/Linux plik ma rozszerzenie ".so", w Windowsie ".dll". + +Znalezione wtyczki są automatycznie ładowane podczas uruchamiania WeeChat, +możliwe jest również ładowanie lub wyładowywanie wtyczek podczas pracy WeeChat. + +Ważne jest, aby odróżniać _wtyczkę_ od _skryptu_: _wtyczka_ jest to plik binarny +skompilowany i ładowany za pomocą polecenia `/plugin`, natomiast _skrypt_ to +plik tekstowy, ładowany za pomocą wtyczki jak na przykład _python_ za pomocą +polecenia `/python`. + +Możesz użyć komendy `/plugin` żeby załadować/wyładować wtyczkę, lub wyświetlić +wszystkie załadowane wtyczki. + +Podcza wyładowywania wtyczki WeeChat usówa: + +* bufory +* opcje konfiguracyjne (options są zapisywane w plikach) +* wszystkie hooki: komendy, modyfikatory, procesy, etc. +* infos i infolists +* hdata +* elementy pasków. + +Przykłady ładowania, wyładowywania i wyświetlania załadowanych wtyczek: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Domyślne wtyczki: + +[width="100%",cols="1,5",options="header"] +|=== +| Wtyczka | Opis +| alias | Definiuje aliasy dla komend. +| buflist | Element paska z listą buforów. +| charset | Ustawianie kodowania dla buforów. +| exec | Wykonuje zewnętrzną komendę z poziomu WeeChat. +| fifo | Kolejka FIFO używana do zdalnego wysyłania poleceń dla WeeChat. +| fset | Szybkie ustawianie opcji WeeChat i wtyczek. +| irc | Protokół IRC. +| logger | Logowanie zawartości buforów do plików. +| relay | Przekazuje dane przez sieć. +| script | Zarządzanie skryptami. +| python | Wsparcie dla skryptów napisanych w Pythonie. +| perl | Wsparcie dla skryptów napisanych w Perlu. +| ruby | Wsparcie dla skryptów napisanych w Ruby. +| lua | Wsparcie dla skryptów napisanych w Lua. +| tcl | Wsparcie dla skryptów napisanych w Tcl. +| guile | Wsparcie dla skryptów napisanych w Guile (scheme). +| javascript | Wsparcie dla skryptów napisanych w JavaScript. +| 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. +| typing | Pokazuje użytkowników obecnie piszących wiadomości. +| xfer | Przesyłanie plików i bezpośredni chat. +|=== + +Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleźć w +link:weechat_plugin_api.en.html[Opisie API wtyczek] (Angielski) i +link:weechat_scripting.pl.html[Poradniku pisania skryptów]. + +[[exec_plugin]] +=== Exec + +Komenda `/exec` pozwala wykonać zewnętrzne polecenie wewnątrz WeeChat i wyświetlić +jej wynik lokalnie lub wysłać do bufora. + +[[exec_commands]] +==== Komendy + +include::includes/autogen_user_commands.pl.adoc[tag=exec_commands] + +[[exec_options]] +==== Opcje + +Sekcje w pliku _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| command | /set exec.command.* | Opcje dla komend. +| color | /set exec.color.* | Kolory. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Możesz zdalnie kontrolować WeeChat, poprzez wysyłanie komend lub tekstu do +kolejki FIFO (jeśli opcja "fifo.file.enabled" jest włączona, domyślnie jest +włączona). + +Strumień FIFO jest zlokalizowany w katalogu uruchomieniowym WeeChat i ma +domyślnie nazwę weechat_fifo_12345_ (gdzie _12345_ to numer procesu WeeChat). + +Składnia dla komend/tekstu przekazywanego do kolejki FIFO wygląda następująco: + +.... + wtyczka.bufor *tekst lub komenda + *tekst lub komenda +.... + +Kilka przykładów: + +* Zmiana nicka na serwerze IRC libera na "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Wysłanie wiadomości na kanał IRC #weechat: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Wysłanie wiadomości do obecnego bufora: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Wysłanie dwóch komend do wyładowania/przeładowania skryptów Python (należy + oddzielić je za pomocą "\n"): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Komendy + +include::includes/autogen_user_commands.pl.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Opcje + +Sekcje w pliku _fifo.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| plik | /set fifo.file.* | Kontrola kolejki FIFO. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=fifo_options] + [[scripts_plugins]] === Skryptowe diff --git a/doc/sr/weechat_user.sr.adoc b/doc/sr/weechat_user.sr.adoc index 208f5ff63..bf65b6fda 100644 --- a/doc/sr/weechat_user.sr.adoc +++ b/doc/sr/weechat_user.sr.adoc @@ -246,7 +246,7 @@ $ make install Компајлира <<scripts_plugins,Python додатак>> користећи Python 2 уместо Python 3. | ENABLE_RELAY | `ON`, `OFF` | ON | - Компајлира <<relay_plugin,Relay додатак>>. + Компајлира <<relay,Relay додатак>>. | ENABLE_RUBY | `ON`, `OFF` | ON | Компајлира <<scripts_plugins,Ruby додатак>>. @@ -3414,153 +3414,8 @@ include::includes/autogen_user_commands.sr.adoc[tag=irc_commands] include::includes/autogen_user_options.sr.adoc[tag=irc_options] -[[plugins]] -== Додаци - -Додатак је динамичка библиотека коју учитава програм WeeChat, написана на језику C и компајлирана. На GNU/Linux систему, фајл има „.so” екстензију, а „.dll” на систему Windows. - -Додаци се аутоматски учитавају током покретања програма WeeChat, а могу да се учитавају или уклањају из меморије док се програм WeeChat извршава. - -Важно је да се направи разлика између _додатка_ и _скрипте_: _додатак_ је бинарни фајл који се компајлира и учитава командом `/plugin`, док је _скрипта_ текст фајл који се учитава додатком као што је _python_ командом `/python`. - -За учитавање/уклањање из меморије можете користити команду `/plugin`, или да прикажете листу свих учитаних додатака. - -Када се додатак уклони из меморије, програм WeeChat уклања: - -* бафере -* конфигурационе опције (опције се уписују у фајлове) -* све куке: команде, модификатори, процес, итд. -* инфо и инфолисте -* hdata -* ставке траке - -Примери учитавања, уклањања из меморије или приказа листе додатака: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Ово су подразумевани додаци: - -[width="100%", cols="1,5", options="header"] -|=== -| Додатак | Опис -| alias | Дефиниција алијаса за команде. -| buflist | Ставка траке са листом бафера. -| charset | Декодирање/кодирање у скуп карактера за бафере. -| exec | Извршавање спољних команди из програма WeeChat. -| fifo | FIFO пајп који се користи за удаљено слање команди програму WeeChat. -| fset | Брзо постављање опција програма WeeChat и опција додатака. -| irc | IRC чет протокол. -| logger | Логовање бафера у фајлове. -| relay | Релеј података преко мреже. -| script | Управљач скриптама. -| python | Python API . -| perl | Perl API скриптовања. -| ruby | Ruby API скриптовања. -| lua | Lua API скриптовања. -| tcl | Tcl API скриптовања. -| guile | Guile (scheme) API скриптовања. -| javascript | JavaScript API скриптовања. -| php | PHP API скриптовања. -| spell | Провера правописа за командну линију. -| trigger | Замена текста и извршавање команди приликом догађаја које окида програм WeeChat/додаци. -| typing | Приказује кориснике који тренутно пишу поруке. -| xfer | Пренос фајлова и директни разговор. -|=== - -За више информација о развоју додатака или скрипти (помоћу API), молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтно упутство за API додатака] или link:weechat_scripting.sr.html[WeeChat водич за скриптовање]. - -[[exec_plugin]] -=== Exec - -Команда `/exec` вам омогућава да извршите спољне команде из програма WeeChat и да локално прикажете њихов излаз, или да га пошаљете у бафер. - -[[exec_commands]] -==== Команде - -include::includes/autogen_user_commands.sr.adoc[tag=exec_commands] - -[[exec_options]] -==== Опције - -Одељци у фајлу _exec.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| command | /set exec.command.* | Опције за команде. -| color | /set exec.color.* | Боје. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Програм WeeChat можете даљински да контролишете слањем команди или текста у FIFO пајп (ако је укључена опција „fifo.file.enabled”, што је подразумевано). - -FIFO пајп се налази у WeeChat директоријуму за време извршавања (runtime) и подразумевано се зове _weechat_fifo_12345_ (где је _12345_ id процеса програма WeeChat). - -Синтакса за FIFO пајп команде/текст је једно од следећих: - -.... - plugin.buffer *овде иде текст или команда - *овде иде текст или команда -.... - -Неки примери: - -* Измена надимка на IRC серверу libera на „newnick”: - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Слање поруке на #weechat IRC канал: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Слање поруке у текући бафер: - ----- -$ echo '*здраво!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Слање две команде за уклањање из меморије/поновно учитавање Python скрипти (морате да их раздвојите са „\n”): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Команде - -include::includes/autogen_user_commands.sr.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Опције - -Одељци у фајлу _fifo.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| file | /set fifo.file.* | Контрола FIFO пајпа. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=fifo_options] - -[[relay_plugin]] -=== Релеј +[[relay]] +== Релеј Релеј додатак се користи за релеј података преко мреже, употребом различитих протокола: @@ -3573,7 +3428,7 @@ include::includes/autogen_user_options.sr.adoc[tag=fifo_options] ** WeeCloud (JavaScript): https://github.com/eirikb/weecloud [[relay_password]] -==== Лозинка +=== Лозинка Топло се препоручује постављање лозинке за релеј следећим командама: @@ -3585,7 +3440,7 @@ include::includes/autogen_user_options.sr.adoc[tag=fifo_options] Ова лозинка се користи и за _irc_ и за _weechat_ протокол. [[relay_totp]] -==== TOTP +=== TOTP TOTP (Time-based One-Time Password) може уз лозинку да се користи као секундарни фактор аутентификације за _weechat_ протокол. @@ -3606,7 +3461,7 @@ TOTP тајна мора да се постави у програму WeeChat и ---- [[relay_ssl]] -==== SSL +=== SSL SSL можете да користите креирањем сертификата и приватног кључа и употребом префикса „ssl.” у имену протокола. @@ -3630,7 +3485,7 @@ $ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out rel ---- [[relay_irc_proxy]] -==== IRC прокси +=== IRC прокси Релеј додатак може да се понаша као IRC прокси: симулираће IRC сервер, па можете да се повежете са програмом WeeChat помоћу било ког другог IRC клијента (укључујући и сам WeeChat). @@ -3664,11 +3519,11 @@ PASS сервер:лозинка ---- [[relay_weechat_protocol]] -==== WeeChat протокол +=== WeeChat протокол Релеј додатак може да шаље податке удаљеном интерфејсу користећи WeeChat протокол. -Можете да се повежете употребом удаљеног интерфејса, погледајте листу <<relay_plugin,релеј додатак>>. +Можете да се повежете употребом удаљеног интерфејса, погледајте листу <<relay,релеј додатак>>. [IMPORTANT] Сам програм WeeChat НЕ може да се повеже на други програм WeeChat преко овог протокола. @@ -3682,7 +3537,7 @@ PASS сервер:лозинка Сада можете да се повежете са удаљеног интерфејса преко порта 9000 користећи лозинку „мојалозинка”. [[relay_websocket]] -==== ВебСокет +=== ВебСокет Релеј додатак подржава ВебСокет протокол (https://tools.ietf.org/html/rfc6455[RFC 6455]) за све протоколе. @@ -3698,7 +3553,7 @@ websocket = new WebSocket("ws://server.com:9000/weechat"); Порт (9000 у примеру) је порт који је дефинисан у Релеј додатку. URI увек мора да се завршава са „/weechat” (и за _irc_ и за _weechat_ протокол). [[relay_unix_socket]] -==== UNIX доменски сокети +=== UNIX доменски сокети Ако у `/relay add` команди употребите опцију протокола „unix”, можете да ослушкујете било којим протоколом на UNIX доменском сокету на задатој путањи. На пример: @@ -3717,12 +3572,12 @@ $ ssh -L 9000:.weechat/relay_socket корисник@имехоста Ово преусмерава локалне релеј клијенте који се повезују на порт 9000 на инстанцу програма WeeChat која се извршава на машини „имехоста”. [[relay_commands]] -==== Команде +=== Команде include::includes/autogen_user_commands.sr.adoc[tag=relay_commands] [[relay_options]] -==== Опције +=== Опције Одељци у фајлу _relay.conf_: @@ -3741,6 +3596,151 @@ include::includes/autogen_user_commands.sr.adoc[tag=relay_commands] include::includes/autogen_user_options.sr.adoc[tag=relay_options] +[[plugins]] +== Додаци + +Додатак је динамичка библиотека коју учитава програм WeeChat, написана на језику C и компајлирана. На GNU/Linux систему, фајл има „.so” екстензију, а „.dll” на систему Windows. + +Додаци се аутоматски учитавају током покретања програма WeeChat, а могу да се учитавају или уклањају из меморије док се програм WeeChat извршава. + +Важно је да се направи разлика између _додатка_ и _скрипте_: _додатак_ је бинарни фајл који се компајлира и учитава командом `/plugin`, док је _скрипта_ текст фајл који се учитава додатком као што је _python_ командом `/python`. + +За учитавање/уклањање из меморије можете користити команду `/plugin`, или да прикажете листу свих учитаних додатака. + +Када се додатак уклони из меморије, програм WeeChat уклања: + +* бафере +* конфигурационе опције (опције се уписују у фајлове) +* све куке: команде, модификатори, процес, итд. +* инфо и инфолисте +* hdata +* ставке траке + +Примери учитавања, уклањања из меморије или приказа листе додатака: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Ово су подразумевани додаци: + +[width="100%", cols="1,5", options="header"] +|=== +| Додатак | Опис +| alias | Дефиниција алијаса за команде. +| buflist | Ставка траке са листом бафера. +| charset | Декодирање/кодирање у скуп карактера за бафере. +| exec | Извршавање спољних команди из програма WeeChat. +| fifo | FIFO пајп који се користи за удаљено слање команди програму WeeChat. +| fset | Брзо постављање опција програма WeeChat и опција додатака. +| irc | IRC чет протокол. +| logger | Логовање бафера у фајлове. +| relay | Релеј података преко мреже. +| script | Управљач скриптама. +| python | Python API . +| perl | Perl API скриптовања. +| ruby | Ruby API скриптовања. +| lua | Lua API скриптовања. +| tcl | Tcl API скриптовања. +| guile | Guile (scheme) API скриптовања. +| javascript | JavaScript API скриптовања. +| php | PHP API скриптовања. +| spell | Провера правописа за командну линију. +| trigger | Замена текста и извршавање команди приликом догађаја које окида програм WeeChat/додаци. +| typing | Приказује кориснике који тренутно пишу поруке. +| xfer | Пренос фајлова и директни разговор. +|=== + +За више информација о развоју додатака или скрипти (помоћу API), молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтно упутство за API додатака] или link:weechat_scripting.sr.html[WeeChat водич за скриптовање]. + +[[exec_plugin]] +=== Exec + +Команда `/exec` вам омогућава да извршите спољне команде из програма WeeChat и да локално прикажете њихов излаз, или да га пошаљете у бафер. + +[[exec_commands]] +==== Команде + +include::includes/autogen_user_commands.sr.adoc[tag=exec_commands] + +[[exec_options]] +==== Опције + +Одељци у фајлу _exec.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| command | /set exec.command.* | Опције за команде. +| color | /set exec.color.* | Боје. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Програм WeeChat можете даљински да контролишете слањем команди или текста у FIFO пајп (ако је укључена опција „fifo.file.enabled”, што је подразумевано). + +FIFO пајп се налази у WeeChat директоријуму за време извршавања (runtime) и подразумевано се зове _weechat_fifo_12345_ (где је _12345_ id процеса програма WeeChat). + +Синтакса за FIFO пајп команде/текст је једно од следећих: + +.... + plugin.buffer *овде иде текст или команда + *овде иде текст или команда +.... + +Неки примери: + +* Измена надимка на IRC серверу libera на „newnick”: + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Слање поруке на #weechat IRC канал: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Слање поруке у текући бафер: + +---- +$ echo '*здраво!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Слање две команде за уклањање из меморије/поновно учитавање Python скрипти (морате да их раздвојите са „\n”): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Команде + +include::includes/autogen_user_commands.sr.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Опције + +Одељци у фајлу _fifo.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| file | /set fifo.file.* | Контрола FIFO пајпа. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=fifo_options] + [[scripts_plugins]] === Скрипте |