diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/de/weechat_user.de.adoc | 614 | ||||
| -rw-r--r-- | doc/en/weechat_user.en.adoc | 608 | ||||
| -rw-r--r-- | doc/fr/weechat_user.fr.adoc | 618 | ||||
| -rw-r--r-- | doc/it/weechat_user.it.adoc | 699 | ||||
| -rw-r--r-- | doc/ja/weechat_user.ja.adoc | 612 | ||||
| -rw-r--r-- | doc/pl/weechat_user.pl.adoc | 612 | ||||
| -rw-r--r-- | doc/sr/weechat_user.sr.adoc | 582 |
7 files changed, 2177 insertions, 2168 deletions
diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index 7950d3cd4..203583128 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -225,10 +225,10 @@ Liste von häufig verwendeten Optionen: kompiliert <<spell_checking,Spell Erweiterung>> mittels Enchant. | ENABLE_EXEC | `ON`, `OFF` | ON | - kompiliert <<exec_plugin,Exec Erweiterung>>. + kompiliert <<external_commands,Exec Erweiterung>>. | ENABLE_FIFO | `ON`, `OFF` | ON | - kompiliert <<fifo_plugin,Fifo Erweiterung>>. + kompiliert <<fifo_pipe,Fifo Erweiterung>>. | ENABLE_FSET | `ON`, `OFF` | ON | kompiliert <<fset,Fset Erweiterung>>. @@ -289,7 +289,7 @@ Liste von häufig verwendeten Optionen: kompiliert <<scripts_plugins,Tcl Erweiterung>>. | ENABLE_TRIGGER | `ON`, `OFF` | ON | - kompiliert <<trigger_plugin,Trigger Erweiterung>>. + kompiliert <<trigger,Trigger Erweiterung>>. | ENABLE_TYPING | `ON`, `OFF` | ON | kompiliert <<typing_notifications,Typing Erweiterung>>. @@ -4184,89 +4184,21 @@ 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 +// TRANSLATION MISSING +[[external_commands]] +== External commands 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 +=== Befehle include::includes/autogen_user_commands.de.adoc[tag=exec_commands] [[exec_options]] -==== Optionen +=== Optionen Sektionen in Datei _exec.conf_: @@ -4281,8 +4213,9 @@ Options: include::includes/autogen_user_options.de.adoc[tag=exec_options] -[[fifo_plugin]] -=== Fifo +// TRANSLATION MISSING +[[fifo_pipe]] +== FIFO pipe 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 @@ -4326,12 +4259,12 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/wee ---- [[fifo_commands]] -==== Befehle +=== Befehle include::includes/autogen_user_commands.de.adoc[tag=fifo_commands] [[fifo_options]] -==== Optionen +=== Optionen Sektionen in Datei _fifo.conf_: @@ -4345,205 +4278,8 @@ Optionen: include::includes/autogen_user_options.de.adoc[tag=fifo_options] -[[scripts_plugins]] -=== Skripten - -WeeChat unterstützt Erweiterungen für insgesamt acht Skriptsprachen: -Python, Perl, Ruby, Lua, Tcl, Guile (scheme), JavaScript und PHP. -Mit jeder dieser Erweiterungen können Skripten geladen, ausgeführt und entfernt werden. - -Eine sinnvolle Erweiterung ist "script". Dabei handelt es sich um einen Skripten-Manager mit -dem es möglich ist, unabhängig von der Skript-Sprache Skripten zu laden und zu entfernen. -Des Weiteren können Skripten, aus dem Skript-Repositorium, installiert und deinstalliert werden. -Das Skript-Repositorium kann unter folgender URL eingesehen werden: https://weechat.org/scripts - -Sollten wir Ihr Interesse geweckt haben selber Skripten für WeeChat zu programmieren, dann lesen Sie -bitte die link:weechat_scripting.de.html[WeeChat scripting Guide]. - -[[script_commands]] -==== Skript Befehle - -include::includes/autogen_user_commands.de.adoc[tag=script_commands] - -[[python_commands]] -==== Python Befehle - -include::includes/autogen_user_commands.de.adoc[tag=python_commands] - -[[perl_commands]] -==== Perl Befehle - -include::includes/autogen_user_commands.de.adoc[tag=perl_commands] - -[[ruby_commands]] -==== Ruby Befehle - -include::includes/autogen_user_commands.de.adoc[tag=ruby_commands] - -[[lua_commands]] -==== Lua Befehle - -include::includes/autogen_user_commands.de.adoc[tag=lua_commands] - -[[tcl_commands]] -==== Tcl Befehle - -include::includes/autogen_user_commands.de.adoc[tag=tcl_commands] - -[[guile_commands]] -==== Guile Befehle - -include::includes/autogen_user_commands.de.adoc[tag=guile_commands] - -[[javascript_commands]] -==== JavaScript Befehle - -include::includes/autogen_user_commands.de.adoc[tag=javascript_commands] - -[[php_commands]] -==== PHP Befehle - -include::includes/autogen_user_commands.de.adoc[tag=php_commands] - -[[script_options]] -==== Script Optionen - -Sektionen in Datei _script.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| look | /set script.look.* | Erscheinungsbild. -| color | /set script.color.* | Farben. -| scripts | /set script.scripts.* | Optionen für den Download von Skripten. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=script_options] - -[[python_options]] -==== Python Optionen - -Sektionen in Datei _python.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| look | /set python.look.* | Erscheinungsbild. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=python_options] - -[[perl_options]] -==== Perl Optionen - -Sektionen in Datei _perl.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| look | /set perl.look.* | Erscheinungsbild. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=perl_options] - -[[ruby_options]] -==== Ruby Optionen - -Sektionen in Datei _ruby.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| look | /set ruby.look.* | Erscheinungsbild. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=ruby_options] - -[[lua_options]] -==== Lua Optionen - -Sektionen in Datei _lua.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| look | /set lua.look.* | Erscheinungsbild. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=lua_options] - -[[tcl_options]] -==== Tcl Optionen - -Sektionen in Datei _tcl.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| look | /set tcl.look.* | Erscheinungsbild. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=tcl_options] - -[[guile_options]] -==== Guile Optionen - -Sektionen in Datei _guile.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| look | /set guile.look.* | Erscheinungsbild. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=guile_options] - -[[javascript_options]] -==== Javascript Optionen - -Sektionen in Datei _javascript.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| look | /set javascript.look.* | Erscheinungsbild. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=javascript_options] - -[[php_options]] -==== PHP Optionen - -Sektionen in Datei _php.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| look | /set php.look.* | Erscheinungsbild. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=php_options] - -[[trigger_plugin]] -=== Trigger +[[trigger]] +== Trigger Trigger ist das Schweizer Armeemesser für WeeChat. Es können verschiedene Hooks überwacht werden (signal. modifier, print, ...), der Inhalt von @@ -4556,7 +4292,7 @@ modifiers, ... in WeeChat überhaupt funktionieren. Deshalb sollte man überlege ob man nicht folgende Anleitung lesen sollte link:weechat_plugin_api.en.html#hooks[Anleitung für API Erweiterung / Hooks] (Englisch). [[trigger_default]] -==== standardmäßige Trigger +=== standardmäßige Trigger WeeChat erstellt standardmäßig fünf Trigger, welche deaktiviert, angepasst oder gelöscht werden können: @@ -4592,7 +4328,7 @@ Liste der standardmäßigen Trigger: |=== [[trigger_anatomy]] -==== Aufbau eines Triggers +=== Aufbau eines Triggers Ein Trigger hat folgende Optionen (Benennung ist `trigger.trigger.<name>.<option>`): @@ -4650,7 +4386,7 @@ trigger.trigger.beep.post_action = none ---- [[trigger_execution]] -==== Ausführung +=== Ausführung Wenn ein Trigger-Callback aufgerufen wird, dann wird folgende Befehlskette abgearbeitet: @@ -4663,7 +4399,7 @@ abgearbeitet: . Aktion welche nach der Abarbeitung des Triggers ausgeführt werden soll (falls der Wert abweichend von `none` sein sollte). [[trigger_hook_arguments]] -==== Hook Argumente +=== Hook Argumente Die Argumente sind abhängig von dem genutzten Hook und werden durch ein Semikolon getrennt. @@ -4774,7 +4510,7 @@ ein Semikolon getrennt. |=== [[trigger_conditions]] -==== Bedingungen +=== Bedingungen Bedingungen werden benötigt um eine Ausführung am Laufen zu halten oder um diese zu stoppen. @@ -4792,7 +4528,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) ---- [[trigger_regex]] -==== reguläre Ausdrücke +=== reguläre Ausdrücke Reguläre Ausdrücke werden verwendet um Variablen in einem Callback Hashtable zu ändern. @@ -4862,7 +4598,7 @@ In diesem Beispiel wird "==" als Trennzeichen verwendet, da ein "/" in dem regulären Ausdruck genutzt wird. [[trigger_command]] -==== Befehl +=== Befehl Der Befehl wird erst ausgeführt nach dem mittels eines regulären Ausdruckes der Text verändert wurde. Mehrere Befehle können durch Semikolon voneinander @@ -4880,7 +4616,7 @@ Befehl um einen Ton (BEL) zu erzeugen. ---- [[trigger_callback_data]] -==== Daten in Callbacks +=== Daten in Callbacks Daten, die dem Callback übergeben werden, werden in einer Hashtable (Pointer und Strings) gesichert und können durch folgende Optionen genutzt werden: @@ -4907,7 +4643,7 @@ Alle Callbacks setzen folgende Variablen in das hashtable: |=== [[trigger_data_signal]] -===== Signale +==== Signale Der Callback von "signal" legt folgende Variablen in der Hashtable an: @@ -4950,7 +4686,7 @@ ${buffer[${tg_signal_data}].full_name} ---- [[trigger_data_hsignal]] -===== Hsignal +==== Hsignal Der Callback von "hsignal" legt folgende Variablen in der Hashtable an: @@ -4963,7 +4699,7 @@ Der Callback von "hsignal" legt folgende Variablen in der Hashtable an: Das Hashtable enthält alle Schlüssel/Werte (Typ: string/string). [[trigger_data_modifier]] -===== Modifier +==== Modifier Der Callback von "modifier" legt folgende Variablen in der Hashtable an: @@ -4995,7 +4731,7 @@ Sollte das Signal eine IRC Nachricht beinhalten, wird die Nachricht analysiert und die Daten in einer Hashtable gesichert (siehe <<trigger_data_signal,hook signal>>). [[trigger_data_line]] -===== Line +==== Line Der Callback von "line" legt folgende Variablen in der Hashtable an: @@ -5034,7 +4770,7 @@ Variablen die mittels Tags in der Nachricht gesetzt werden: |=== [[trigger_data_print]] -===== Print +==== Print Der Callback von "print" legt folgende Variablen in der Hashtable an: @@ -5067,7 +4803,7 @@ Variablen die mittels Tags in der Nachricht gesetzt werden: |=== [[trigger_data_command]] -===== Command +==== Command Der Callback von "command" legt folgende Variablen in der Hashtable an: @@ -5083,7 +4819,7 @@ Der Callback von "command" legt folgende Variablen in der Hashtable an: |=== [[trigger_data_command_run]] -===== Command_run +==== Command_run Der Callback von "command_run" legt folgende Variablen in der Hashtable an: @@ -5095,7 +4831,7 @@ Der Callback von "command_run" legt folgende Variablen in der Hashtable an: |=== [[trigger_data_timer]] -===== Timer +==== Timer Der Callback von "timer" legt folgende Variablen in der Hashtable an: @@ -5107,7 +4843,7 @@ Der Callback von "timer" legt folgende Variablen in der Hashtable an: |=== [[trigger_data_config]] -===== Config +==== Config Der Callback von "config" legt folgende Variablen in der Hashtable an: @@ -5119,7 +4855,7 @@ Der Callback von "config" legt folgende Variablen in der Hashtable an: |=== [[trigger_data_focus]] -===== Focus +==== Focus Der Callback von "focus" legt folgende Variablen in der Hashtable an: @@ -5133,7 +4869,7 @@ Der Callback von "focus" legt folgende Variablen in der Hashtable an: Das Hashtable enthält alle Schlüssel/Werte (Typ: string/string). [[trigger_data_info]] -===== Info +==== Info Der Callback von "info" legt folgende Variablen in der Hashtable an: @@ -5146,7 +4882,7 @@ Der Callback von "info" legt folgende Variablen in der Hashtable an: |=== [[trigger_data_info_hashtable]] -===== Info_hashtable +==== Info_hashtable Der Callback von "info_hashtable" legt folgende Variablen in der Hashtable an: @@ -5159,10 +4895,10 @@ Der Callback von "info_hashtable" legt folgende Variablen in der Hashtable an: Das Hashtable enthält alle Schlüssel/Werte (Typ: string/string). [[trigger_examples]] -==== Beispiele +=== Beispiele [[trigger_example_url_color]] -===== URLs werden eingefärbt +==== URLs werden eingefärbt Zeigt URLs in grün an: @@ -5175,7 +4911,7 @@ Dies ist ein einfacher regulärer Ausdruck der möglicherweise nicht alle URLs erkennt, dafür ist er aber wesentlich schneller als ein komplexer regulärer Ausdruck. [[trigger_example_auto_pong]] -===== automatisierte "pong" Antwort, bei einer "ping" Anfrage +==== automatisierte "pong" Antwort, bei einer "ping" Anfrage Wenn jemand eine "ping" Nachricht in einen privaten Buffer sendet, verschickt dieser Trigger automatisch eine `pong` Antwort: @@ -5185,7 +4921,7 @@ automatisch eine `pong` Antwort: ---- [[trigger_example_responsive_layout]] -===== reaktives layout +==== reaktives layout Der nachfolgende Trigger kann verwendet werden um Anpassungen vorzunehmen, falls sich die Größe des Terminalfensters verändert: @@ -5206,7 +4942,7 @@ Die Benutzerliste wird wieder angezeigt, sobald die Breite des Terminals größe gleich 100 Zeichen ist. [[trigger_example_config_save]] -===== automatisches speichern der Konfiguration +==== automatisches speichern der Konfiguration Die Konfigurationsdateien (`+*.conf+`), können automatisch jede Stunde gespeichert werden: @@ -5225,12 +4961,12 @@ Der Befehl `/mute /save` sorgt dafür, dass die Konfiguration ohne kommentarlos gespeichert wird (es findet keine Ausgabe im Core-Buffer statt). [[trigger_commands]] -==== Befehle +=== Befehle include::includes/autogen_user_commands.de.adoc[tag=trigger_commands] [[trigger_options]] -==== Optionen +=== Optionen Sektionen in Datei _trigger.conf_: @@ -5248,6 +4984,272 @@ Optionen: include::includes/autogen_user_options.de.adoc[tag=trigger_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. + +[[scripts_plugins]] +=== Skripten + +WeeChat unterstützt Erweiterungen für insgesamt acht Skriptsprachen: +Python, Perl, Ruby, Lua, Tcl, Guile (scheme), JavaScript und PHP. +Mit jeder dieser Erweiterungen können Skripten geladen, ausgeführt und entfernt werden. + +Eine sinnvolle Erweiterung ist "script". Dabei handelt es sich um einen Skripten-Manager mit +dem es möglich ist, unabhängig von der Skript-Sprache Skripten zu laden und zu entfernen. +Des Weiteren können Skripten, aus dem Skript-Repositorium, installiert und deinstalliert werden. +Das Skript-Repositorium kann unter folgender URL eingesehen werden: https://weechat.org/scripts + +Sollten wir Ihr Interesse geweckt haben selber Skripten für WeeChat zu programmieren, dann lesen Sie +bitte die link:weechat_scripting.de.html[WeeChat scripting Guide]. + +[[script_commands]] +==== Skript Befehle + +include::includes/autogen_user_commands.de.adoc[tag=script_commands] + +[[python_commands]] +==== Python Befehle + +include::includes/autogen_user_commands.de.adoc[tag=python_commands] + +[[perl_commands]] +==== Perl Befehle + +include::includes/autogen_user_commands.de.adoc[tag=perl_commands] + +[[ruby_commands]] +==== Ruby Befehle + +include::includes/autogen_user_commands.de.adoc[tag=ruby_commands] + +[[lua_commands]] +==== Lua Befehle + +include::includes/autogen_user_commands.de.adoc[tag=lua_commands] + +[[tcl_commands]] +==== Tcl Befehle + +include::includes/autogen_user_commands.de.adoc[tag=tcl_commands] + +[[guile_commands]] +==== Guile Befehle + +include::includes/autogen_user_commands.de.adoc[tag=guile_commands] + +[[javascript_commands]] +==== JavaScript Befehle + +include::includes/autogen_user_commands.de.adoc[tag=javascript_commands] + +[[php_commands]] +==== PHP Befehle + +include::includes/autogen_user_commands.de.adoc[tag=php_commands] + +[[script_options]] +==== Script Optionen + +Sektionen in Datei _script.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set script.look.* | Erscheinungsbild. +| color | /set script.color.* | Farben. +| scripts | /set script.scripts.* | Optionen für den Download von Skripten. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=script_options] + +[[python_options]] +==== Python Optionen + +Sektionen in Datei _python.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set python.look.* | Erscheinungsbild. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=python_options] + +[[perl_options]] +==== Perl Optionen + +Sektionen in Datei _perl.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set perl.look.* | Erscheinungsbild. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=perl_options] + +[[ruby_options]] +==== Ruby Optionen + +Sektionen in Datei _ruby.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set ruby.look.* | Erscheinungsbild. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=ruby_options] + +[[lua_options]] +==== Lua Optionen + +Sektionen in Datei _lua.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set lua.look.* | Erscheinungsbild. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=lua_options] + +[[tcl_options]] +==== Tcl Optionen + +Sektionen in Datei _tcl.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set tcl.look.* | Erscheinungsbild. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=tcl_options] + +[[guile_options]] +==== Guile Optionen + +Sektionen in Datei _guile.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set guile.look.* | Erscheinungsbild. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=guile_options] + +[[javascript_options]] +==== Javascript Optionen + +Sektionen in Datei _javascript.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set javascript.look.* | Erscheinungsbild. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=javascript_options] + +[[php_options]] +==== PHP Optionen + +Sektionen in Datei _php.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| look | /set php.look.* | Erscheinungsbild. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=php_options] + [[support]] == Unterstützung diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index 215107766..eadae84a9 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -217,10 +217,10 @@ List of commonly used options: Compile <<spell_checking,Spell plugin>> with Enchant. | ENABLE_EXEC | `ON`, `OFF` | ON | - Compile <<exec_plugin,Exec plugin>>. + Compile <<external_commands,Exec plugin>>. | ENABLE_FIFO | `ON`, `OFF` | ON | - Compile <<fifo_plugin,Fifo plugin>>. + Compile <<fifo_pipe,Fifo plugin>>. | ENABLE_FSET | `ON`, `OFF` | ON | Compile <<fset,Fset plugin>>. @@ -281,7 +281,7 @@ List of commonly used options: Compile <<scripts_plugins,Tcl plugin>>. | ENABLE_TRIGGER | `ON`, `OFF` | ON | - Compile <<trigger_plugin,Trigger plugin>>. + Compile <<trigger,Trigger plugin>>. | ENABLE_TYPING | `ON`, `OFF` | ON | Compile <<typing_notifications,Typing plugin>>. @@ -4057,87 +4057,19 @@ 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 +[[external_commands]] +== External commands The `/exec` command lets you execute external commands inside WeeChat and display the output locally, or send it to a buffer. [[exec_commands]] -==== Commands +=== Commands include::includes/autogen_user_commands.en.adoc[tag=exec_commands] [[exec_options]] -==== Options +=== Options Sections in file _exec.conf_: @@ -4152,8 +4084,8 @@ Options: include::includes/autogen_user_options.en.adoc[tag=exec_options] -[[fifo_plugin]] -=== Fifo +[[fifo_pipe]] +== FIFO pipe 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). @@ -4196,12 +4128,12 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/wee ---- [[fifo_commands]] -==== Commands +=== Commands include::includes/autogen_user_commands.en.adoc[tag=fifo_commands] [[fifo_options]] -==== Options +=== Options Sections in file _fifo.conf_: @@ -4215,204 +4147,8 @@ Options: include::includes/autogen_user_options.en.adoc[tag=fifo_options] -[[scripts_plugins]] -=== Scripts - -WeeChat provides 8 scripting plugins: Python, Perl, Ruby, Lua, Tcl, Guile -(scheme), JavaScript and PHP. -These plugins can load, execute and unload scripts for these languages. - -Another plugin called "script" is a script manager and is used to load/unload -scripts of any language, and install/remove scripts of WeeChat scripts -repository, which are visible at this URL: https://weechat.org/scripts - -For more information about how to write scripts, or WeeChat API for -scripts, please read the link:weechat_scripting.en.html[WeeChat scripting guide]. - -[[script_commands]] -==== Script commands - -include::includes/autogen_user_commands.en.adoc[tag=script_commands] - -[[python_commands]] -==== Python commands - -include::includes/autogen_user_commands.en.adoc[tag=python_commands] - -[[perl_commands]] -==== Perl commands - -include::includes/autogen_user_commands.en.adoc[tag=perl_commands] - -[[ruby_commands]] -==== Ruby commands - -include::includes/autogen_user_commands.en.adoc[tag=ruby_commands] - -[[lua_commands]] -==== Lua commands - -include::includes/autogen_user_commands.en.adoc[tag=lua_commands] - -[[tcl_commands]] -==== Tcl commands - -include::includes/autogen_user_commands.en.adoc[tag=tcl_commands] - -[[guile_commands]] -==== Guile commands - -include::includes/autogen_user_commands.en.adoc[tag=guile_commands] - -[[javascript_commands]] -==== JavaScript commands - -include::includes/autogen_user_commands.en.adoc[tag=javascript_commands] - -[[php_commands]] -==== PHP commands - -include::includes/autogen_user_commands.en.adoc[tag=php_commands] - -[[script_options]] -==== Script options - -Sections in file _script.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set script.look.* | Look and feel. -| color | /set script.color.* | Colors. -| scripts | /set script.scripts.* | Options for download of scripts. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=script_options] - -[[python_options]] -==== Python options - -Sections in file _python.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set python.look.* | Look and feel. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=python_options] - -[[perl_options]] -==== Perl options - -Sections in file _perl.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set perl.look.* | Look and feel. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=perl_options] - -[[ruby_options]] -==== Ruby options - -Sections in file _ruby.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set ruby.look.* | Look and feel. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=ruby_options] - -[[lua_options]] -==== Lua options - -Sections in file _lua.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set lua.look.* | Look and feel. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=lua_options] - -[[tcl_options]] -==== Tcl options - -Sections in file _tcl.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set tcl.look.* | Look and feel. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=tcl_options] - -[[guile_options]] -==== Guile options - -Sections in file _guile.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set guile.look.* | Look and feel. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=guile_options] - -[[javascript_options]] -==== Javascript options - -Sections in file _javascript.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set javascript.look.* | Look and feel. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=javascript_options] - -[[php_options]] -==== PHP options - -Sections in file _php.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set php.look.* | Look and feel. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=php_options] - -[[trigger_plugin]] -=== Trigger +[[trigger]] +== Trigger Trigger is the Swiss Army knife for WeeChat: it can hook many things (signal, modifier, print, etc.), change the content of data, and execute one or more @@ -4424,7 +4160,7 @@ So you might consider reading the link:weechat_plugin_api.en.html#hooks[WeeChat plugin API reference / Hooks]. [[trigger_default]] -==== Default triggers +=== Default triggers WeeChat creates 5 triggers by default, which can be disabled, updated or deleted: @@ -4460,7 +4196,7 @@ List of default triggers: |=== [[trigger_anatomy]] -==== Anatomy of a trigger +=== Anatomy of a trigger A trigger has the following options (names are `trigger.trigger.<name>.<option>`): @@ -4517,7 +4253,7 @@ trigger.trigger.beep.post_action = none ---- [[trigger_execution]] -==== Execution +=== Execution When a trigger callback is called, following actions are executed, in this order, if triggers are globally enabled and if the trigger itself is enabled: @@ -4530,7 +4266,7 @@ order, if triggers are globally enabled and if the trigger itself is enabled: . perform post action (if different from `none`). [[trigger_hook_arguments]] -==== Hook arguments +=== Hook arguments The arguments depend on the hook used. They are separated by semicolons. @@ -4640,7 +4376,7 @@ The arguments depend on the hook used. They are separated by semicolons. |=== [[trigger_conditions]] -==== Conditions +=== Conditions The conditions are used to continue processing in trigger, or stop everything. @@ -4656,7 +4392,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) ---- [[trigger_regex]] -==== Regular expression +=== Regular expression The regular expression is used to change variables in callback hashtable. @@ -4723,7 +4459,7 @@ In this example, the delimiter used is "==" because there is a "/" in the regular expression. [[trigger_command]] -==== Command +=== Command The command is executed after replacement of text with the regular expression. Many commands can be separated by semicolons. @@ -4738,7 +4474,7 @@ Example: default _beep_ trigger uses this command to make a beep (BEL): ---- [[trigger_callback_data]] -==== Data in callbacks +=== Data in callbacks Data received in callbacks are stored in hashtables (pointers and strings) and can be used in following options: @@ -4765,7 +4501,7 @@ All callbacks set following variables in hashtable: |=== [[trigger_data_signal]] -===== Signal +==== Signal The "signal" callback sets following variables in hashtable: @@ -4807,7 +4543,7 @@ ${buffer[${tg_signal_data}].full_name} ---- [[trigger_data_hsignal]] -===== Hsignal +==== Hsignal The "hsignal" callback sets following variables in hashtable: @@ -4821,7 +4557,7 @@ The hashtable contains all keys/values from hashtable received (type: string/string). [[trigger_data_modifier]] -===== Modifier +==== Modifier The "modifier" callback sets following variables in hashtable: @@ -4853,7 +4589,7 @@ If the modifier contains an IRC message, the message is parsed and extra data is added in hashtable (see <<trigger_data_signal,hook signal>>). [[trigger_data_line]] -===== Line +==== Line The "line" callback sets following variables in hashtable: @@ -4892,7 +4628,7 @@ Variables set using tags in message: |=== [[trigger_data_print]] -===== Print +==== Print The "print" callback sets following variables in hashtable: @@ -4925,7 +4661,7 @@ Variables set using tags in message: |=== [[trigger_data_command]] -===== Command +==== Command The "command" callback sets following variables in hashtable: @@ -4941,7 +4677,7 @@ The "command" callback sets following variables in hashtable: |=== [[trigger_data_command_run]] -===== Command_run +==== Command_run The "command_run" callback sets following variables in hashtable: @@ -4953,7 +4689,7 @@ The "command_run" callback sets following variables in hashtable: |=== [[trigger_data_timer]] -===== Timer +==== Timer The "timer" callback sets following variables in hashtable: @@ -4965,7 +4701,7 @@ The "timer" callback sets following variables in hashtable: |=== [[trigger_data_config]] -===== Config +==== Config The "config" callback sets following variables in hashtable: @@ -4977,7 +4713,7 @@ The "config" callback sets following variables in hashtable: |=== [[trigger_data_focus]] -===== Focus +==== Focus The "focus" callback sets following variables in hashtable: @@ -4992,7 +4728,7 @@ The hashtable contains all keys/values from hashtable received (type: string/string). [[trigger_data_info]] -===== Info +==== Info The "info" callback sets following variables in hashtable: @@ -5005,7 +4741,7 @@ The "info" callback sets following variables in hashtable: |=== [[trigger_data_info_hashtable]] -===== Info_hashtable +==== Info_hashtable The "info_hashtable" callback sets following variables in hashtable: @@ -5019,10 +4755,10 @@ The hashtable contains all keys/values from hashtable received (type: string/string). [[trigger_examples]] -==== Examples +=== Examples [[trigger_example_url_color]] -===== Color for URLs +==== Color for URLs Display URLs in green: @@ -5035,7 +4771,7 @@ The simple regex used to detect URL may not catch well all URLs, but it is faster than a complex regex. [[trigger_example_auto_pong]] -===== Auto pong on ping queries +==== Auto pong on ping queries When someone sends a "ping" in a private buffer, this trigger will auto-reply with `pong`: @@ -5045,7 +4781,7 @@ with `pong`: ---- [[trigger_example_responsive_layout]] -===== Responsive layout +==== Responsive layout Following triggers can be used to customize things displayed when the size of terminal is changed: @@ -5065,7 +4801,7 @@ In the example, when the terminal becomes small, the nicklist is hidden. And the bar is restored when the width is greater or equal to 100 chars. [[trigger_example_config_save]] -===== Automatic save of configuration +==== Automatic save of configuration You can automatically save configuration files (`+*.conf+`), for example each hour: @@ -5084,12 +4820,12 @@ The command `/mute /save` will silently save configuration files (nothing displayed on core buffer). [[trigger_commands]] -==== Commands +=== Commands include::includes/autogen_user_commands.en.adoc[tag=trigger_commands] [[trigger_options]] -==== Options +=== Options Sections in file _trigger.conf_: @@ -5107,6 +4843,270 @@ Options: include::includes/autogen_user_options.en.adoc[tag=trigger_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]. + +[[scripts_plugins]] +=== Scripts + +WeeChat provides 8 scripting plugins: Python, Perl, Ruby, Lua, Tcl, Guile +(scheme), JavaScript and PHP. +These plugins can load, execute and unload scripts for these languages. + +Another plugin called "script" is a script manager and is used to load/unload +scripts of any language, and install/remove scripts of WeeChat scripts +repository, which are visible at this URL: https://weechat.org/scripts + +For more information about how to write scripts, or WeeChat API for +scripts, please read the link:weechat_scripting.en.html[WeeChat scripting guide]. + +[[script_commands]] +==== Script commands + +include::includes/autogen_user_commands.en.adoc[tag=script_commands] + +[[python_commands]] +==== Python commands + +include::includes/autogen_user_commands.en.adoc[tag=python_commands] + +[[perl_commands]] +==== Perl commands + +include::includes/autogen_user_commands.en.adoc[tag=perl_commands] + +[[ruby_commands]] +==== Ruby commands + +include::includes/autogen_user_commands.en.adoc[tag=ruby_commands] + +[[lua_commands]] +==== Lua commands + +include::includes/autogen_user_commands.en.adoc[tag=lua_commands] + +[[tcl_commands]] +==== Tcl commands + +include::includes/autogen_user_commands.en.adoc[tag=tcl_commands] + +[[guile_commands]] +==== Guile commands + +include::includes/autogen_user_commands.en.adoc[tag=guile_commands] + +[[javascript_commands]] +==== JavaScript commands + +include::includes/autogen_user_commands.en.adoc[tag=javascript_commands] + +[[php_commands]] +==== PHP commands + +include::includes/autogen_user_commands.en.adoc[tag=php_commands] + +[[script_options]] +==== Script options + +Sections in file _script.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set script.look.* | Look and feel. +| color | /set script.color.* | Colors. +| scripts | /set script.scripts.* | Options for download of scripts. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=script_options] + +[[python_options]] +==== Python options + +Sections in file _python.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set python.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=python_options] + +[[perl_options]] +==== Perl options + +Sections in file _perl.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set perl.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=perl_options] + +[[ruby_options]] +==== Ruby options + +Sections in file _ruby.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set ruby.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=ruby_options] + +[[lua_options]] +==== Lua options + +Sections in file _lua.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set lua.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=lua_options] + +[[tcl_options]] +==== Tcl options + +Sections in file _tcl.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set tcl.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=tcl_options] + +[[guile_options]] +==== Guile options + +Sections in file _guile.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set guile.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=guile_options] + +[[javascript_options]] +==== Javascript options + +Sections in file _javascript.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set javascript.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=javascript_options] + +[[php_options]] +==== PHP options + +Sections in file _php.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set php.look.* | Look and feel. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=php_options] + [[support]] == Support diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index ca15146a9..6cfe042a0 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -221,10 +221,10 @@ Liste des options couramment utilisées : Compiler <<spell_checking,l'extension Spell>> avec Enchant. | ENABLE_EXEC | `ON`, `OFF` | ON | - Compiler <<exec_plugin,l'extension Exec>>. + Compiler <<external_commands,l'extension Exec>>. | ENABLE_FIFO | `ON`, `OFF` | ON | - Compiler <<fifo_plugin,l'extension Fifo>>. + Compiler <<fifo_pipe,l'extension Fifo>>. | ENABLE_FSET | `ON`, `OFF` | ON | Compiler <<fset,l'extension Fset>>. @@ -286,7 +286,7 @@ Liste des options couramment utilisées : Compiler <<scripts_plugins,l'extension Tcl>>. | ENABLE_TRIGGER | `ON`, `OFF` | ON | - Compiler <<trigger_plugin,l'extension Trigger>>. + Compiler <<trigger,l'extension Trigger>>. | ENABLE_TYPING | `ON`, `OFF` | ON | Compiler <<typing_notifications,l'extension Typing>>. @@ -4195,89 +4195,19 @@ 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 +[[external_commands]] +== Commandes externes 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 +=== Commandes include::includes/autogen_user_commands.fr.adoc[tag=exec_commands] [[exec_options]] -==== Options +=== Options Sections dans le fichier _exec.conf_ : @@ -4292,8 +4222,8 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=exec_options] -[[fifo_plugin]] -=== Fifo +[[fifo_pipe]] +== Tube 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, @@ -4338,12 +4268,12 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/wee ---- [[fifo_commands]] -==== Commandes +=== Commandes include::includes/autogen_user_commands.fr.adoc[tag=fifo_commands] [[fifo_options]] -==== Options +=== Options Sections dans le fichier _fifo.conf_ : @@ -4357,207 +4287,8 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=fifo_options] -[[scripts_plugins]] -=== Scripts - -WeeChat fournit 8 extensions pour scripts : Python, Perl, Ruby, Lua, Tcl, -Guile (scheme), JavaScript et PHP. -Ces extensions peuvent charger, exécuter et décharger des scripts pour ces -langages. - -Une autre extension appelée "script" est un gestionnaire de scripts et est -utilisé pour charger/décharger des scripts pour n'importe quel langage, et -installer/supprimer des scripts du dépôt WeeChat, qui sont visibles à cette -URL : https://weechat.org/scripts - -Pour plus d'informations sur comment écrire des scripts, ou sur l'API -WeeChat pour les scripts, merci de lire le -link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. - -[[script_commands]] -==== Commandes Script - -include::includes/autogen_user_commands.fr.adoc[tag=script_commands] - -[[python_commands]] -==== Commandes Python - -include::includes/autogen_user_commands.fr.adoc[tag=python_commands] - -[[perl_commands]] -==== Commandes Perl - -include::includes/autogen_user_commands.fr.adoc[tag=perl_commands] - -[[ruby_commands]] -==== Commandes Ruby - -include::includes/autogen_user_commands.fr.adoc[tag=ruby_commands] - -[[lua_commands]] -==== Commandes Lua - -include::includes/autogen_user_commands.fr.adoc[tag=lua_commands] - -[[tcl_commands]] -==== Commandes Tcl - -include::includes/autogen_user_commands.fr.adoc[tag=tcl_commands] - -[[guile_commands]] -==== Commandes Guile - -include::includes/autogen_user_commands.fr.adoc[tag=guile_commands] - -[[javascript_commands]] -==== Commandes JavaScript - -include::includes/autogen_user_commands.fr.adoc[tag=javascript_commands] - -[[php_commands]] -==== Commandes PHP - -include::includes/autogen_user_commands.fr.adoc[tag=php_commands] - -[[script_options]] -==== Options Script - -Sections dans le fichier _script.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| look | /set script.look.* | Aspect/présentation. -| color | /set script.color.* | Couleurs. -| scripts | /set script.scripts.* | Options pour le téléchargement des scripts. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=script_options] - -[[python_options]] -==== Options Python - -Sections dans le fichier _python.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| look | /set python.look.* | Aspect/présentation. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=python_options] - -[[perl_options]] -==== Options Perl - -Sections dans le fichier _perl.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| look | /set perl.look.* | Aspect/présentation. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=perl_options] - -[[ruby_options]] -==== Options Ruby - -Sections dans le fichier _ruby.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| look | /set ruby.look.* | Aspect/présentation. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=ruby_options] - -[[lua_options]] -==== Options Lua - -Sections dans le fichier _lua.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| look | /set lua.look.* | Aspect/présentation. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=lua_options] - -[[tcl_options]] -==== Options Tcl - -Sections dans le fichier _tcl.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| look | /set tcl.look.* | Aspect/présentation. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=tcl_options] - -[[guile_options]] -==== Options Guile - -Sections dans le fichier _guile.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| look | /set guile.look.* | Aspect/présentation. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=guile_options] - -[[javascript_options]] -==== Options Javascript - -Sections dans le fichier _javascript.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| look | /set javascript.look.* | Aspect/présentation. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=javascript_options] - -[[php_options]] -==== Options PHP - -Sections dans le fichier _php.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| look | /set php.look.* | Aspect/présentation. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=php_options] - -[[trigger_plugin]] -=== Trigger +[[trigger]] +== Trigger Trigger est le couteau suisse de WeeChat : il peut accrocher différentes choses (signal, modificateur, print, ...), changer le contenu des données, et exécuter @@ -4569,7 +4300,7 @@ modificateurs, etc. Il peut être utile de lire la link:weechat_plugin_api.fr.html#hooks[Référence API extension WeeChat / Hooks]. [[trigger_default]] -==== Triggers par défaut +=== Triggers par défaut WeeChat créé 5 triggers par défaut, qui peuvent être désactivés, mis à jour ou supprimés : @@ -4605,7 +4336,7 @@ Liste des triggers par défaut : |=== [[trigger_anatomy]] -==== Anatomie d'un trigger +=== Anatomie d'un trigger Un trigger a les options suivantes (les noms sont `trigger.trigger.<nom>.<option>`) : @@ -4665,7 +4396,7 @@ trigger.trigger.beep.post_action = none ---- [[trigger_execution]] -==== Exécution +=== Exécution Lorsque la fonction de rappel d'un trigger est appelée, les actions suivantes sont exécutées, dans cet ordre, si les triggers sont globalement activés et si @@ -4679,7 +4410,7 @@ le trigger lui-même est activé : . effectuer l'action "post" (si différente de `none`). [[trigger_hook_arguments]] -==== Paramètres du hook +=== Paramètres du hook Les paramètres dépendent du type de "hook" utilisé. Ils sont séparés par des points-virgules. @@ -4790,7 +4521,7 @@ points-virgules. |=== [[trigger_conditions]] -==== Conditions +=== Conditions Les conditions sont utilisées pour continuer l'exécution du trigger, ou tout stopper. @@ -4808,7 +4539,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) ---- [[trigger_regex]] -==== Expression régulière +=== Expression régulière L'expression régulière est utilisée pour modifier des variables dans la table de hachage de la fonction de rappel. @@ -4878,7 +4609,7 @@ Dans cet exemple, le séparateur utilisé est "==" car il y a "/" dans l'expression régulière. [[trigger_command]] -==== Commande +=== Commande La commande est exécutée après le remplacement du texte avec l'expression régulière. @@ -4895,7 +4626,7 @@ beep (BEL) : ---- [[trigger_callback_data]] -==== Données dans les fonctions de rappel +=== Données dans les fonctions de rappel Les données reçues dans les fonctions de rappel sont stockées dans des tables de hachage (pointeurs et chaînes) et peuvent être utilisées dans les options @@ -4924,7 +4655,7 @@ de hachage : |=== [[trigger_data_signal]] -===== Signal +==== Signal La fonction de rappel "signal" définit les variables suivantes dans la table de hachage : @@ -4968,7 +4699,7 @@ ${buffer[${tg_signal_data}].full_name} ---- [[trigger_data_hsignal]] -===== Hsignal +==== Hsignal La fonction de rappel "hsignal" définit les variables suivantes dans la table de hachage : @@ -4983,7 +4714,7 @@ La table de hachage contient toutes les clés/valeurs de la table de hachage reçue (type : chaîne/chaîne). [[trigger_data_modifier]] -===== Modifier +==== Modifier La fonction de rappel "modifier" définit les variables suivantes dans la table de hachage : @@ -5018,7 +4749,7 @@ données supplémentaires sont ajoutées dans la table de hachage (voir le <<trigger_data_signal,"hook" signal>>). [[trigger_data_line]] -===== Line +==== Line La fonction de rappel "line" définit les variables suivantes dans la table de hachage : @@ -5058,7 +4789,7 @@ Variables définies avec les étiquettes du message : |=== [[trigger_data_print]] -===== Print +==== Print La fonction de rappel "print" définit les variables suivantes dans la table de hachage : @@ -5092,7 +4823,7 @@ Variables définies avec les étiquettes du message : |=== [[trigger_data_command]] -===== Command +==== Command La fonction de rappel "command" définit les variables suivantes dans la table de hachage : @@ -5109,7 +4840,7 @@ de hachage : |=== [[trigger_data_command_run]] -===== Command_run +==== Command_run La fonction de rappel "command_run" définit les variables suivantes dans la table de hachage : @@ -5122,7 +4853,7 @@ table de hachage : |=== [[trigger_data_timer]] -===== Timer +==== Timer La fonction de rappel "timer" définit les variables suivantes dans la table de hachage : @@ -5135,7 +4866,7 @@ hachage : |=== [[trigger_data_config]] -===== Config +==== Config La fonction de rappel "config" définit les variables suivantes dans la table de hachage : @@ -5148,7 +4879,7 @@ hachage : |=== [[trigger_data_focus]] -===== Focus +==== Focus La fonction de rappel "focus" définit les variables suivantes dans la table de hachage : @@ -5164,7 +4895,7 @@ La table de hachage contient toutes les clés/valeurs de la table de hachage reçue (type : chaîne/chaîne). [[trigger_data_info]] -===== Info +==== Info La fonction de rappel "info" définit les variables suivantes dans la table de hachage : @@ -5178,7 +4909,7 @@ hachage : |=== [[trigger_data_info_hashtable]] -===== Info_hashtable +==== Info_hashtable La fonction de rappel "info_hashtable" définit les variables suivantes dans la table de hachage : @@ -5193,10 +4924,10 @@ La table de hachage contient toutes les clés/valeurs de la table de hachage reçue (type : chaîne/chaîne). [[trigger_examples]] -==== Exemples +=== Exemples [[trigger_example_url_color]] -===== Couleur pour les URLs +==== Couleur pour les URLs Afficher les URLs en vert : @@ -5210,7 +4941,7 @@ correctement toutes les URLs, mais elle est plus rapide qu'une expression régulière complexe. [[trigger_example_auto_pong]] -===== Pong auto sur les requêtes ping +==== Pong auto sur les requêtes ping Lorsque quelqu'un envoie un "ping" dans un tampon privé, le trigger répondra automatiquement avec un `pong` : @@ -5220,7 +4951,7 @@ automatiquement avec un `pong` : ---- [[trigger_example_responsive_layout]] -===== Disposition réceptive +==== Disposition réceptive Les triggers suivants peuvent être utilisées pour personnaliser l'affichage lorsque la taille du terminal change : @@ -5241,7 +4972,7 @@ Et la barre est restaurée lorsque la largeur du terminal est supérieure ou égale à 100 caractères. [[trigger_example_config_save]] -===== Sauvegarde automatique de la configuration +==== Sauvegarde automatique de la configuration Vous pouvez sauvegarder automatiquement les fichiers de configuration (`+*.conf+`), par example chaque heure : @@ -5261,12 +4992,12 @@ La commande `/mute /save` sauvegarde silencieusement les fichiers de configuration (rien n'est affiché sur le tampon "core"). [[trigger_commands]] -==== Commandes +=== Commandes include::includes/autogen_user_commands.fr.adoc[tag=trigger_commands] [[trigger_options]] -==== Options +=== Options Sections dans le fichier _trigger.conf_ : @@ -5284,6 +5015,275 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=trigger_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]. + +[[scripts_plugins]] +=== Scripts + +WeeChat fournit 8 extensions pour scripts : Python, Perl, Ruby, Lua, Tcl, +Guile (scheme), JavaScript et PHP. +Ces extensions peuvent charger, exécuter et décharger des scripts pour ces +langages. + +Une autre extension appelée "script" est un gestionnaire de scripts et est +utilisé pour charger/décharger des scripts pour n'importe quel langage, et +installer/supprimer des scripts du dépôt WeeChat, qui sont visibles à cette +URL : https://weechat.org/scripts + +Pour plus d'informations sur comment écrire des scripts, ou sur l'API +WeeChat pour les scripts, merci de lire le +link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. + +[[script_commands]] +==== Commandes Script + +include::includes/autogen_user_commands.fr.adoc[tag=script_commands] + +[[python_commands]] +==== Commandes Python + +include::includes/autogen_user_commands.fr.adoc[tag=python_commands] + +[[perl_commands]] +==== Commandes Perl + +include::includes/autogen_user_commands.fr.adoc[tag=perl_commands] + +[[ruby_commands]] +==== Commandes Ruby + +include::includes/autogen_user_commands.fr.adoc[tag=ruby_commands] + +[[lua_commands]] +==== Commandes Lua + +include::includes/autogen_user_commands.fr.adoc[tag=lua_commands] + +[[tcl_commands]] +==== Commandes Tcl + +include::includes/autogen_user_commands.fr.adoc[tag=tcl_commands] + +[[guile_commands]] +==== Commandes Guile + +include::includes/autogen_user_commands.fr.adoc[tag=guile_commands] + +[[javascript_commands]] +==== Commandes JavaScript + +include::includes/autogen_user_commands.fr.adoc[tag=javascript_commands] + +[[php_commands]] +==== Commandes PHP + +include::includes/autogen_user_commands.fr.adoc[tag=php_commands] + +[[script_options]] +==== Options Script + +Sections dans le fichier _script.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set script.look.* | Aspect/présentation. +| color | /set script.color.* | Couleurs. +| scripts | /set script.scripts.* | Options pour le téléchargement des scripts. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=script_options] + +[[python_options]] +==== Options Python + +Sections dans le fichier _python.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set python.look.* | Aspect/présentation. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=python_options] + +[[perl_options]] +==== Options Perl + +Sections dans le fichier _perl.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set perl.look.* | Aspect/présentation. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=perl_options] + +[[ruby_options]] +==== Options Ruby + +Sections dans le fichier _ruby.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set ruby.look.* | Aspect/présentation. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=ruby_options] + +[[lua_options]] +==== Options Lua + +Sections dans le fichier _lua.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set lua.look.* | Aspect/présentation. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=lua_options] + +[[tcl_options]] +==== Options Tcl + +Sections dans le fichier _tcl.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set tcl.look.* | Aspect/présentation. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=tcl_options] + +[[guile_options]] +==== Options Guile + +Sections dans le fichier _guile.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set guile.look.* | Aspect/présentation. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=guile_options] + +[[javascript_options]] +==== Options Javascript + +Sections dans le fichier _javascript.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set javascript.look.* | Aspect/présentation. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=javascript_options] + +[[php_options]] +==== Options PHP + +Sections dans le fichier _php.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| look | /set php.look.* | Aspect/présentation. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=php_options] + [[support]] == Support diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index 83dd5077e..e97e163eb 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -255,10 +255,10 @@ List of commonly used options: Compile <<spell_checking,Spell plugin>> with Enchant. | ENABLE_EXEC | `ON`, `OFF` | ON | - Compile <<exec_plugin,Exec plugin>>. + Compile <<external_commands,Exec plugin>>. | ENABLE_FIFO | `ON`, `OFF` | ON | - Compile <<fifo_plugin,Fifo plugin>>. + Compile <<fifo_pipe,Fifo plugin>>. | ENABLE_FSET | `ON`, `OFF` | ON | Compile <<fset,Fset plugin>>. @@ -320,7 +320,7 @@ List of commonly used options: Compile <<scripts_plugins,Tcl plugin>>. | ENABLE_TRIGGER | `ON`, `OFF` | ON | - Compile <<trigger_plugin,Trigger plugin>>. + Compile <<trigger,Trigger plugin>>. | ENABLE_TYPING | `ON`, `OFF` | ON | Compile <<typing_notifications,Typing plugin>>. @@ -4370,94 +4370,20 @@ 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 +[[external_commands]] +== External commands The `/exec` command lets you execute external commands inside WeeChat and display the output locally, or send it to a buffer. [[exec_commands]] -==== Comandi +=== Comandi include::includes/autogen_user_commands.it.adoc[tag=exec_commands] [[exec_options]] -==== Opzioni +=== Opzioni // TRANSLATION MISSING Sections in file _exec.conf_: @@ -4473,8 +4399,9 @@ Options: include::includes/autogen_user_options.it.adoc[tag=exec_options] -[[fifo_plugin]] -=== Fifo +// TRANSLATION MISSING +[[fifo_pipe]] +== FIFO pipe È 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). @@ -4521,12 +4448,12 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/wee ---- [[fifo_commands]] -==== Comandi +=== Comandi include::includes/autogen_user_commands.it.adoc[tag=fifo_commands] [[fifo_options]] -==== Opzioni +=== Opzioni // TRANSLATION MISSING Sections in file _fifo.conf_: @@ -4544,243 +4471,8 @@ Options: include::includes/autogen_user_options.it.adoc[tag=fifo_options] // TRANSLATION MISSING -[[scripts_plugins]] -=== Scripts - -WeeChat fornisce 8 plugin per lo scripting: Python, Perl, Ruby, Lua, Tcl, Guile -(scheme), JavaScript, PHP. -Questi plugin possono caricare, eseguire e scaricare gli script per questi -linguaggi. - -// TRANSLATION MISSING -Another plugin called "script" is a script manager and is used to load/unload -scripts of any language, and install/remove scripts of WeeChat scripts -repository, which are visible at this URL: https://weechat.org/scripts - -Per maggiori informazioni su come scrivere gli script, o le API WeeChat -per gli script, consultare la link:weechat_scripting.it.html[Guida allo Scripting di WeeChat]. - -[[script_commands]] -==== Comandi Script - -include::includes/autogen_user_commands.it.adoc[tag=script_commands] - -[[python_commands]] -==== Comandi Python - -include::includes/autogen_user_commands.it.adoc[tag=python_commands] - -[[perl_commands]] -==== Comandi Perl - -include::includes/autogen_user_commands.it.adoc[tag=perl_commands] - -[[ruby_commands]] -==== Comandi Ruby - -include::includes/autogen_user_commands.it.adoc[tag=ruby_commands] - -[[lua_commands]] -==== Comandi Lua - -include::includes/autogen_user_commands.it.adoc[tag=lua_commands] - -[[tcl_commands]] -==== Comandi Tcl - -include::includes/autogen_user_commands.it.adoc[tag=tcl_commands] - -[[guile_commands]] -==== Comandi Guile - -include::includes/autogen_user_commands.it.adoc[tag=guile_commands] - -[[javascript_commands]] -==== Comandi JavaScript - -include::includes/autogen_user_commands.it.adoc[tag=javascript_commands] - -[[php_commands]] -==== Comandi PHP - -include::includes/autogen_user_commands.it.adoc[tag=php_commands] - -// TRANSLATION MISSING -[[script_options]] -==== Script options - -// TRANSLATION MISSING -Sections in file _script.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set script.look.* | Look and feel. -| color | /set script.color.* | Colors. -| scripts | /set script.scripts.* | Options for download of scripts. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=script_options] - -// TRANSLATION MISSING -[[python_options]] -==== Python options - -// TRANSLATION MISSING -Sections in file _python.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set python.look.* | Look and feel. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=python_options] - -// TRANSLATION MISSING -[[perl_options]] -==== Perl options - -// TRANSLATION MISSING -Sections in file _perl.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set perl.look.* | Look and feel. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=perl_options] - -// TRANSLATION MISSING -[[ruby_options]] -==== Ruby options - -// TRANSLATION MISSING -Sections in file _ruby.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set ruby.look.* | Look and feel. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=ruby_options] - -// TRANSLATION MISSING -[[lua_options]] -==== Lua options - -// TRANSLATION MISSING -Sections in file _lua.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set lua.look.* | Look and feel. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=lua_options] - -// TRANSLATION MISSING -[[tcl_options]] -==== Tcl options - -// TRANSLATION MISSING -Sections in file _tcl.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set tcl.look.* | Look and feel. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=tcl_options] - -// TRANSLATION MISSING -[[guile_options]] -==== Guile options - -// TRANSLATION MISSING -Sections in file _guile.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set guile.look.* | Look and feel. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=guile_options] - -// TRANSLATION MISSING -[[javascript_options]] -==== Javascript options - -// TRANSLATION MISSING -Sections in file _javascript.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set javascript.look.* | Look and feel. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=javascript_options] - -// TRANSLATION MISSING -[[php_options]] -==== PHP options - -// TRANSLATION MISSING -Sections in file _php.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| look | /set php.look.* | Look and feel. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=php_options] - -// TRANSLATION MISSING -[[trigger_plugin]] -=== Trigger +[[trigger]] +== Trigger Trigger is the Swiss Army knife for WeeChat: it can hook many things (signal, modifier, print, ...), change the content of data, and execute one or more @@ -4792,7 +4484,7 @@ So you might consider reading the link:weechat_plugin_api.it.html#hooks[WeeChat plugin API reference / Hooks]. [[trigger_default]] -==== Default triggers +=== Default triggers WeeChat creates 5 triggers by default, which can be disabled, updated or deleted: @@ -4828,7 +4520,7 @@ List of default triggers: |=== [[trigger_anatomy]] -==== Anatomy of a trigger +=== Anatomy of a trigger A trigger has the following options (names are `trigger.trigger.<name>.<option>`): @@ -4885,7 +4577,7 @@ trigger.trigger.beep.post_action = none ---- [[trigger_execution]] -==== Execution +=== Execution When a trigger callback is called, following actions are executed, in this order, if triggers are globally enabled and if the trigger itself is enabled: @@ -4898,7 +4590,7 @@ order, if triggers are globally enabled and if the trigger itself is enabled: . perform post action (if different from `none`). [[trigger_hook_arguments]] -==== Hook arguments +=== Hook arguments The arguments depend on the hook used. They are separated by semicolons. @@ -5008,7 +4700,7 @@ The arguments depend on the hook used. They are separated by semicolons. |=== [[trigger_conditions]] -==== Conditions +=== Conditions The conditions are used to continue processing in trigger, or stop everything. @@ -5024,7 +4716,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) ---- [[trigger_regex]] -==== Regular expression +=== Regular expression The regular expression is used to change variables in callback hashtable. @@ -5092,7 +4784,7 @@ In this example, the delimiter used is "==" because there is a "/" in the regular expression. [[trigger_command]] -==== Command +=== Command The command is executed after replacement of text with the regular expression. Many commands can be separated by semicolons. @@ -5107,7 +4799,7 @@ Example: default _beep_ trigger uses this command to make a beep (BEL): ---- [[trigger_callback_data]] -==== Data in callbacks +=== Data in callbacks Data received in callbacks are stored in hashtables (pointers and strings) and can be used in following options: @@ -5136,7 +4828,7 @@ All callbacks set following variables in hashtable: |=== [[trigger_data_signal]] -===== Signal +==== Signal The "signal" callback sets following variables in hashtable: @@ -5178,7 +4870,7 @@ ${buffer[${tg_signal_data}].full_name} ---- [[trigger_data_hsignal]] -===== Hsignal +==== Hsignal The "hsignal" callback sets following variables in hashtable: @@ -5192,7 +4884,7 @@ The hashtable contains all keys/values from hashtable received (type: string/string). [[trigger_data_modifier]] -===== Modifier +==== Modifier The "modifier" callback sets following variables in hashtable: @@ -5224,7 +4916,7 @@ If the modifier contains an IRC message, the message is parsed and extra data is added in hashtable (see <<trigger_data_signal,hook signal>>). [[trigger_data_line]] -===== Line +==== Line The "line" callback sets following variables in hashtable: @@ -5264,7 +4956,7 @@ Variables set using tags in message: |=== [[trigger_data_print]] -===== Print +==== Print The "print" callback sets following variables in hashtable: @@ -5297,7 +4989,7 @@ Variables set using tags in message: |=== [[trigger_data_command]] -===== Command +==== Command The "command" callback sets following variables in hashtable: @@ -5315,7 +5007,7 @@ The "command" callback sets following variables in hashtable: |=== [[trigger_data_command_run]] -===== Command_run +==== Command_run The "command_run" callback sets following variables in hashtable: @@ -5327,7 +5019,7 @@ The "command_run" callback sets following variables in hashtable: |=== [[trigger_data_timer]] -===== Timer +==== Timer The "timer" callback sets following variables in hashtable: @@ -5339,7 +5031,7 @@ The "timer" callback sets following variables in hashtable: |=== [[trigger_data_config]] -===== Config +==== Config The "config" callback sets following variables in hashtable: @@ -5351,7 +5043,7 @@ The "config" callback sets following variables in hashtable: |=== [[trigger_data_focus]] -===== Focus +==== Focus The "focus" callback sets following variables in hashtable: @@ -5366,7 +5058,7 @@ The hashtable contains all keys/values from hashtable received (type: string/string). [[trigger_data_info]] -===== Info +==== Info The "info" callback sets following variables in hashtable: @@ -5379,7 +5071,7 @@ The "info" callback sets following variables in hashtable: |=== [[trigger_data_info_hashtable]] -===== Info_hashtable +==== Info_hashtable The "info_hashtable" callback sets following variables in hashtable: @@ -5393,10 +5085,10 @@ The hashtable contains all keys/values from hashtable received (type: string/string). [[trigger_examples]] -==== Examples +=== Examples [[trigger_example_url_color]] -===== Color for URLs +==== Color for URLs Display URLs in green: @@ -5409,7 +5101,7 @@ The simple regex used to detect URL may not catch well all URLs, but it is faster than a complex regex. [[trigger_example_auto_pong]] -===== Auto pong on ping queries +==== Auto pong on ping queries When someone sends a "ping" in a private buffer, this trigger will auto-reply with `pong`: @@ -5419,7 +5111,7 @@ with `pong`: ---- [[trigger_example_responsive_layout]] -===== Responsive layout +==== Responsive layout Following triggers can be used to customize things displayed when the size of terminal is changed: @@ -5439,7 +5131,7 @@ In the example, when the terminal becomes small, the nicklist is hidden. And the bar is restored when the width is greater or equal to 100 chars. [[trigger_example_config_save]] -===== Automatic save of configuration +==== Automatic save of configuration You can automatically save configuration files (`+*.conf+`), for example each hour: @@ -5458,12 +5150,12 @@ The command `/mute /save` will silently save configuration files (nothing displayed on core buffer). [[trigger_commands]] -==== Comandi +=== Comandi include::includes/autogen_user_commands.it.adoc[tag=trigger_commands] [[trigger_options]] -==== Opzioni +=== Opzioni Sections in file _trigger.conf_: @@ -5481,6 +5173,315 @@ Options: include::includes/autogen_user_options.it.adoc[tag=trigger_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 +[[scripts_plugins]] +=== Scripts + +WeeChat fornisce 8 plugin per lo scripting: Python, Perl, Ruby, Lua, Tcl, Guile +(scheme), JavaScript, PHP. +Questi plugin possono caricare, eseguire e scaricare gli script per questi +linguaggi. + +// TRANSLATION MISSING +Another plugin called "script" is a script manager and is used to load/unload +scripts of any language, and install/remove scripts of WeeChat scripts +repository, which are visible at this URL: https://weechat.org/scripts + +Per maggiori informazioni su come scrivere gli script, o le API WeeChat +per gli script, consultare la link:weechat_scripting.it.html[Guida allo Scripting di WeeChat]. + +[[script_commands]] +==== Comandi Script + +include::includes/autogen_user_commands.it.adoc[tag=script_commands] + +[[python_commands]] +==== Comandi Python + +include::includes/autogen_user_commands.it.adoc[tag=python_commands] + +[[perl_commands]] +==== Comandi Perl + +include::includes/autogen_user_commands.it.adoc[tag=perl_commands] + +[[ruby_commands]] +==== Comandi Ruby + +include::includes/autogen_user_commands.it.adoc[tag=ruby_commands] + +[[lua_commands]] +==== Comandi Lua + +include::includes/autogen_user_commands.it.adoc[tag=lua_commands] + +[[tcl_commands]] +==== Comandi Tcl + +include::includes/autogen_user_commands.it.adoc[tag=tcl_commands] + +[[guile_commands]] +==== Comandi Guile + +include::includes/autogen_user_commands.it.adoc[tag=guile_commands] + +[[javascript_commands]] +==== Comandi JavaScript + +include::includes/autogen_user_commands.it.adoc[tag=javascript_commands] + +[[php_commands]] +==== Comandi PHP + +include::includes/autogen_user_commands.it.adoc[tag=php_commands] + +// TRANSLATION MISSING +[[script_options]] +==== Script options + +// TRANSLATION MISSING +Sections in file _script.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set script.look.* | Look and feel. +| color | /set script.color.* | Colors. +| scripts | /set script.scripts.* | Options for download of scripts. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=script_options] + +// TRANSLATION MISSING +[[python_options]] +==== Python options + +// TRANSLATION MISSING +Sections in file _python.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set python.look.* | Look and feel. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=python_options] + +// TRANSLATION MISSING +[[perl_options]] +==== Perl options + +// TRANSLATION MISSING +Sections in file _perl.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set perl.look.* | Look and feel. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=perl_options] + +// TRANSLATION MISSING +[[ruby_options]] +==== Ruby options + +// TRANSLATION MISSING +Sections in file _ruby.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set ruby.look.* | Look and feel. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=ruby_options] + +// TRANSLATION MISSING +[[lua_options]] +==== Lua options + +// TRANSLATION MISSING +Sections in file _lua.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set lua.look.* | Look and feel. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=lua_options] + +// TRANSLATION MISSING +[[tcl_options]] +==== Tcl options + +// TRANSLATION MISSING +Sections in file _tcl.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set tcl.look.* | Look and feel. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=tcl_options] + +// TRANSLATION MISSING +[[guile_options]] +==== Guile options + +// TRANSLATION MISSING +Sections in file _guile.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set guile.look.* | Look and feel. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=guile_options] + +// TRANSLATION MISSING +[[javascript_options]] +==== Javascript options + +// TRANSLATION MISSING +Sections in file _javascript.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set javascript.look.* | Look and feel. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=javascript_options] + +// TRANSLATION MISSING +[[php_options]] +==== PHP options + +// TRANSLATION MISSING +Sections in file _php.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| look | /set php.look.* | Look and feel. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=php_options] + [[support]] == Supporto diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index d0a1074e6..50034787d 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -227,10 +227,10 @@ CMake に対するオプションを指定するには、以下の書式を使 Enchant と含めた <<spell_checking,Spell プラグイン>>のコンパイル。 | ENABLE_EXEC | `ON`, `OFF` | ON | - <<exec_plugin,Exec プラグイン>>のコンパイル。 + <<external_commands,Exec プラグイン>>のコンパイル。 | ENABLE_FIFO | `ON`, `OFF` | ON | - <<fifo_plugin,Fifo プラグイン>>のコンパイル。 + <<fifo_pipe,Fifo プラグイン>>のコンパイル。 | ENABLE_FSET | `ON`, `OFF` | ON | <<fset,Fset プラグイン>>のコンパイル。 @@ -292,7 +292,7 @@ CMake に対するオプションを指定するには、以下の書式を使 <<scripts_plugins,Tcl プラグイン>>のコンパイル。 | ENABLE_TRIGGER | `ON`, `OFF` | ON | - <<trigger_plugin,Trigger プラグイン>>のコンパイル。 + <<trigger,Trigger プラグイン>>のコンパイル。 | ENABLE_TYPING | `ON`, `OFF` | ON | <<typing_notifications,Typing プラグイン>>のコンパイル。 @@ -4188,89 +4188,20 @@ _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 +[[external_commands]] +== External commands `/exec` コマンドを使うことで WeeChat 内部から外部コマンドを実行し、その結果を表示したりバッファに送信することが可能になります。 [[exec_commands]] -==== コマンド +=== コマンド include::includes/autogen_user_commands.ja.adoc[tag=exec_commands] [[exec_options]] -==== オプション +=== オプション _exec.conf_ ファイル内のセクション: @@ -4285,8 +4216,9 @@ _exec.conf_ ファイル内のセクション: include::includes/autogen_user_options.ja.adoc[tag=exec_options] -[[fifo_plugin]] -=== Fifo +// TRANSLATION MISSING +[[fifo_pipe]] +== FIFO pipe 外部から WeeChat を操作するには、FIFO パイプにコマンドやテキストを書き込んでください ("fifo.file.enabled" オプションが有効化されている必要がありますが、デフォルトで有効化されているはずです)。 @@ -4330,12 +4262,12 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/wee ---- [[fifo_commands]] -==== コマンド +=== コマンド include::includes/autogen_user_commands.ja.adoc[tag=fifo_commands] [[fifo_options]] -==== オプション +=== オプション _fifo.conf_ ファイル内のセクション: @@ -4349,204 +4281,8 @@ _fifo.conf_ ファイル内のセクション: include::includes/autogen_user_options.ja.adoc[tag=fifo_options] -[[scripts_plugins]] -=== スクリプト - -WeeChat は 8 種類のスクリプトプラグインを備えています: -Python、Perl、Ruby、Lua、Tcl、Guile -(scheme)、JavaScript、PHP。これらのプラグインでそれぞれの言語で書かれたスクリプトのロード、実行、アンロードができます。 - -スクリプトマネージャを使えば、任意の言語で書かれたスクリプトをロード/アンロードしたり、WeeChat -スクリプトリポジトリ (https://weechat.org/scripts から参照可能) -のスクリプトをインストール/削除したりする事が可能です。 - -スクリプトの書き方やスクリプト用の WeeChat API についての詳しい情報は -link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド]を参照してください。 - -[[script_commands]] -==== Script コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=script_commands] - -[[python_commands]] -==== Python コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=python_commands] - -[[perl_commands]] -==== Perl コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=perl_commands] - -[[ruby_commands]] -==== Ruby コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=ruby_commands] - -[[lua_commands]] -==== Lua コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=lua_commands] - -[[tcl_commands]] -==== Tcl コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=tcl_commands] - -[[guile_commands]] -==== Guile コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=guile_commands] - -[[javascript_commands]] -==== JavaScript コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=javascript_commands] - -[[php_commands]] -==== PHP コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=php_commands] - -[[script_options]] -==== スクリプトオプション - -_script.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| look | /set script.look.* | 外観 -| color | /set script.color.* | 色 -| scripts | /set script.scripts.* | スクリプトのダウンロードに関するオプション -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=script_options] - -[[python_options]] -==== Python オプション - -_python.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| look | /set python.look.* | 外観 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=python_options] - -[[perl_options]] -==== Perl オプション - -_perl.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| look | /set perl.look.* | 外観 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=perl_options] - -[[ruby_options]] -==== Ruby オプション - -_ruby.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| look | /set ruby.look.* | 外観 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=ruby_options] - -[[lua_options]] -==== Lua オプション - -_lua.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| look | /set lua.look.* | 外観 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=lua_options] - -[[tcl_options]] -==== Tcl オプション - -_tcl.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| look | /set tcl.look.* | 外観 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=tcl_options] - -[[guile_options]] -==== Guile オプション - -_guile.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| look | /set guile.look.* | 外観 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=guile_options] - -[[javascript_options]] -==== Javascript オプション - -_javascript.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| look | /set javascript.look.* | 外観 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=javascript_options] - -[[php_options]] -==== PHP オプション - -_php.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| look | /set php.look.* | 外観 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=php_options] - -[[trigger_plugin]] -=== Trigger +[[trigger]] +== Trigger トリガは WeeChat の便利ツールです: 様々なもの @@ -4558,7 +4294,7 @@ include::includes/autogen_user_options.ja.adoc[tag=php_options] link:weechat_plugin_api.ja.html#hooks[WeeChat プラグイン API リファレンス / フック]を読むことをお勧めします。 [[trigger_default]] -==== デフォルトトリガ +=== デフォルトトリガ WeeChat はデフォルトで 5 つのトリガを作成しますが、これらを無効化、更新、削除することも可能です: @@ -4595,7 +4331,7 @@ WeeChat はデフォルトで 5 |=== [[trigger_anatomy]] -==== トリガの構造 +=== トリガの構造 トリガは以下のオプションをとります (名前は `trigger.trigger.<name>.<option>`): @@ -4652,7 +4388,7 @@ trigger.trigger.beep.post_action = none ---- [[trigger_execution]] -==== 実行 +=== 実行 トリガ機能が有効になっていてさらに対象のトリガが有効化されている場合に、トリガコールバックが呼び出されると、以下のアクションがこの順番で実行されます: @@ -4664,7 +4400,7 @@ trigger.trigger.beep.post_action = none . トリガ実行後の処遇を適用 (`none` 以外の場合)。 [[trigger_hook_arguments]] -==== フック引数 +=== フック引数 引数は使用するフックの種類に依存します。引数はセミコロンで区切ってください。 @@ -4775,7 +4511,7 @@ trigger.trigger.beep.post_action = none |=== [[trigger_conditions]] -==== 条件 +=== 条件 条件を指定することで、トリガ内で処理を継続するか完全に止めるかを制御できます。 @@ -4791,7 +4527,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) ---- [[trigger_regex]] -==== 正規表現 +=== 正規表現 正規表現はコールバックハッシュテーブル内の変数を変更するために使われます。 @@ -4858,7 +4594,7 @@ WeeChat によって使われる値に影響を及ぼします "/" を使うためです。 [[trigger_command]] -==== コマンド +=== コマンド コマンドは正規表現を使ったテキスト置換の後に実行されます。複数のコマンドを実行するにはセミコロンで区切ってください。 @@ -4872,7 +4608,7 @@ WeeChat によって使われる値に影響を及ぼします ---- [[trigger_callback_data]] -==== コールバック内におけるデータ +=== コールバック内におけるデータ コールバック内で受け取ったデータはハッシュテーブル (ポインタと文字列) の中に保存され、以下のオプションで使うことができます: @@ -4900,7 +4636,7 @@ All callbacks set following variables in hashtable: |=== [[trigger_data_signal]] -===== Signal +==== Signal "signal" コールバックは以下の変数をハッシュテーブルに格納します: @@ -4942,7 +4678,7 @@ ${buffer[${tg_signal_data}].full_name} ---- [[trigger_data_hsignal]] -===== Hsignal +==== Hsignal "hsignal" コールバックは以下の変数をハッシュテーブルに格納します: @@ -4956,7 +4692,7 @@ ${buffer[${tg_signal_data}].full_name} string/string) が含まれています。 [[trigger_data_modifier]] -===== Modifier +==== Modifier "modifier" コールバックは以下の変数をハッシュテーブルに格納します: @@ -4988,7 +4724,7 @@ _weechat_print_ 修飾子では、メッセージタグを使う変数 (下の (<<trigger_data_signal,Signal>> を参照)。 [[trigger_data_line]] -===== Line +==== Line "line" コールバックは以下の変数をハッシュテーブルに格納します: @@ -5028,7 +4764,7 @@ _weechat_print_ 修飾子では、メッセージタグを使う変数 (下の |=== [[trigger_data_print]] -===== Print +==== Print "print" コールバックは以下の変数をハッシュテーブルに格納します: @@ -5061,7 +4797,7 @@ _weechat_print_ 修飾子では、メッセージタグを使う変数 (下の |=== [[trigger_data_command]] -===== Command +==== Command "command" コールバックは以下の変数をハッシュテーブルに格納します: @@ -5082,7 +4818,7 @@ _weechat_print_ 修飾子では、メッセージタグを使う変数 (下の |=== [[trigger_data_command_run]] -===== Command_run +==== Command_run "command_run" コールバックは以下の変数をハッシュテーブルに格納します: @@ -5094,7 +4830,7 @@ _weechat_print_ 修飾子では、メッセージタグを使う変数 (下の |=== [[trigger_data_timer]] -===== Timer +==== Timer "timer" コールバックは以下の変数をハッシュテーブルに格納します: @@ -5106,7 +4842,7 @@ _weechat_print_ 修飾子では、メッセージタグを使う変数 (下の |=== [[trigger_data_config]] -===== Config +==== Config "config" コールバックは以下の変数をハッシュテーブルに格納します: @@ -5118,7 +4854,7 @@ _weechat_print_ 修飾子では、メッセージタグを使う変数 (下の |=== [[trigger_data_focus]] -===== Focus +==== Focus "focus" コールバックは以下の変数をハッシュテーブルに格納します: @@ -5133,7 +4869,7 @@ _weechat_print_ 修飾子では、メッセージタグを使う変数 (下の string/string) が含まれています。 [[trigger_data_info]] -===== Info +==== Info "info" コールバックは以下の変数をハッシュテーブルに格納します: @@ -5146,7 +4882,7 @@ string/string) が含まれています。 |=== [[trigger_data_info_hashtable]] -===== Info_hashtable +==== Info_hashtable "info_hashtable" コールバックは以下の変数をハッシュテーブルに格納します: @@ -5160,10 +4896,10 @@ string/string) が含まれています。 string/string) が含まれています。 [[trigger_examples]] -==== 例 +=== 例 [[trigger_example_url_color]] -===== URL の色 +==== URL の色 URL を緑色にする: @@ -5176,7 +4912,7 @@ URL を緑色にする: をうまく検出するものではありませんが、複雑な正規表現を使うよりも高速です。 [[trigger_example_auto_pong]] -===== ping クエリに対する自動応答 +==== ping クエリに対する自動応答 誰かがプライベートバッファで "ping" を送信した場合、このトリガは `pong` で自動的に応答します: @@ -5186,7 +4922,7 @@ URL を緑色にする: ---- [[trigger_example_responsive_layout]] -===== レスポンシブレイアウト +==== レスポンシブレイアウト 以下のトリガは端末のサイズが変更されたときに表示されている内容をカスタマイズするものです: @@ -5205,7 +4941,7 @@ WeeChat は SIGWINCH を受けとたった際 (端末のサイズが変更され 100 文字幅以上になった場合、ニックネームリストを表示します。 [[trigger_example_config_save]] -===== 設定の自動保存 +==== 設定の自動保存 例えば 1 時間ごとに、設定ファイル (`+*.conf+`) を自動的に保存することが可能です: @@ -5224,12 +4960,12 @@ timer フックに対する引数は: (core バッファに対して何も表示しません)。 [[trigger_commands]] -==== コマンド +=== コマンド include::includes/autogen_user_commands.ja.adoc[tag=trigger_commands] [[trigger_options]] -==== オプション +=== オプション _trigger.conf_ ファイル内のセクション: @@ -5247,6 +4983,272 @@ _trigger.conf_ ファイル内のセクション: include::includes/autogen_user_options.ja.adoc[tag=trigger_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 スクリプト作成ガイド]を参照してください。 + +[[scripts_plugins]] +=== スクリプト + +WeeChat は 8 種類のスクリプトプラグインを備えています: +Python、Perl、Ruby、Lua、Tcl、Guile +(scheme)、JavaScript、PHP。これらのプラグインでそれぞれの言語で書かれたスクリプトのロード、実行、アンロードができます。 + +スクリプトマネージャを使えば、任意の言語で書かれたスクリプトをロード/アンロードしたり、WeeChat +スクリプトリポジトリ (https://weechat.org/scripts から参照可能) +のスクリプトをインストール/削除したりする事が可能です。 + +スクリプトの書き方やスクリプト用の WeeChat API についての詳しい情報は +link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド]を参照してください。 + +[[script_commands]] +==== Script コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=script_commands] + +[[python_commands]] +==== Python コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=python_commands] + +[[perl_commands]] +==== Perl コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=perl_commands] + +[[ruby_commands]] +==== Ruby コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=ruby_commands] + +[[lua_commands]] +==== Lua コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=lua_commands] + +[[tcl_commands]] +==== Tcl コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=tcl_commands] + +[[guile_commands]] +==== Guile コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=guile_commands] + +[[javascript_commands]] +==== JavaScript コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=javascript_commands] + +[[php_commands]] +==== PHP コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=php_commands] + +[[script_options]] +==== スクリプトオプション + +_script.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set script.look.* | 外観 +| color | /set script.color.* | 色 +| scripts | /set script.scripts.* | スクリプトのダウンロードに関するオプション +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=script_options] + +[[python_options]] +==== Python オプション + +_python.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set python.look.* | 外観 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=python_options] + +[[perl_options]] +==== Perl オプション + +_perl.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set perl.look.* | 外観 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=perl_options] + +[[ruby_options]] +==== Ruby オプション + +_ruby.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set ruby.look.* | 外観 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=ruby_options] + +[[lua_options]] +==== Lua オプション + +_lua.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set lua.look.* | 外観 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=lua_options] + +[[tcl_options]] +==== Tcl オプション + +_tcl.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set tcl.look.* | 外観 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=tcl_options] + +[[guile_options]] +==== Guile オプション + +_guile.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set guile.look.* | 外観 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=guile_options] + +[[javascript_options]] +==== Javascript オプション + +_javascript.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set javascript.look.* | 外観 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=javascript_options] + +[[php_options]] +==== PHP オプション + +_php.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| look | /set php.look.* | 外観 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=php_options] + [[support]] == サポート diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index 0c8bec969..a36a9ee65 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -223,10 +223,10 @@ Lista popularnych opcji: Kompilacja <<spell_checking,wtyczki spell>> z Enchant. | ENABLE_EXEC | `ON`, `OFF` | ON | - Kompilacja <<exec_plugin,wtyczki exec>>. + Kompilacja <<external_commands,wtyczki exec>>. | ENABLE_FIFO | `ON`, `OFF` | ON | - Kompilacja <<fifo_plugin,wtyczki fifo>>. + Kompilacja <<fifo_pipe,wtyczki fifo>>. | ENABLE_FSET | `ON`, `OFF` | ON | Kompilacja <<fset,wtyczki fset>>. @@ -287,7 +287,7 @@ Lista popularnych opcji: Kompilacja <<scripts_plugins,wtyczki tcl>>. | ENABLE_TRIGGER | `ON`, `OFF` | ON | - Kompilacja <<trigger_plugin,wtyczki trigger>>. + Kompilacja <<trigger,wtyczki trigger>>. | ENABLE_TYPING | `ON`, `OFF` | ON | Kompilacja <<typing_notifications,wtyczki typing>>. @@ -4125,87 +4125,20 @@ 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 +// TRANSLATION MISSING +[[external_commands]] +== External commands Komenda `/exec` pozwala wykonać zewnętrzne polecenie wewnątrz WeeChat i wyświetlić jej wynik lokalnie lub wysłać do bufora. [[exec_commands]] -==== Komendy +=== Komendy include::includes/autogen_user_commands.pl.adoc[tag=exec_commands] [[exec_options]] -==== Opcje +=== Opcje Sekcje w pliku _exec.conf_: @@ -4220,8 +4153,9 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=exec_options] -[[fifo_plugin]] -=== Fifo +// TRANSLATION MISSING +[[fifo_pipe]] +== FIFO pipe 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 @@ -4265,12 +4199,12 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/wee ---- [[fifo_commands]] -==== Komendy +=== Komendy include::includes/autogen_user_commands.pl.adoc[tag=fifo_commands] [[fifo_options]] -==== Opcje +=== Opcje Sekcje w pliku _fifo.conf_: @@ -4284,205 +4218,8 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=fifo_options] -[[scripts_plugins]] -=== Skryptowe - -WeeChat posiada 8 wtyczek skryptowych: Python, Perl, Ruby, Lua, Tcl, Guile -(scheme), JavaScript i PHP. -Wtyczki te potrafią ładować, wykonywać i wyładowywać skrypty w tych językach. - -Inna wtyczka nazwana "script" jest managerem skryptów i jest używana do -ładowania/wyładowywania skryptów w dowolnym języku, oraz do instalacji/usuwania -skryptów z repozytorium skryptów WeeChat, dostępnego pod adresem: -https://weechat.org/scripts - -Więcej informacji o tym jak pisać skrypty lub o API WeeChat dla skryptów można -znaleźć w link:weechat_scripting.pl.html[Poradniku pisania skryptów]. - -[[script_commands]] -==== Komendy wtyczki script - -include::includes/autogen_user_commands.pl.adoc[tag=script_commands] - -[[python_commands]] -==== Komendy wtyczki python - -include::includes/autogen_user_commands.pl.adoc[tag=python_commands] - -[[perl_commands]] -==== Komendy wtyczki perl - -include::includes/autogen_user_commands.pl.adoc[tag=perl_commands] - -[[ruby_commands]] -==== Komendy wtyczki ruby - -include::includes/autogen_user_commands.pl.adoc[tag=ruby_commands] - -[[lua_commands]] -==== Komendy wtyczki lua - -include::includes/autogen_user_commands.pl.adoc[tag=lua_commands] - -[[tcl_commands]] -==== Komendy wtyczki tcl - -include::includes/autogen_user_commands.pl.adoc[tag=tcl_commands] - -[[guile_commands]] -==== Komendy wtyczki guile - -include::includes/autogen_user_commands.pl.adoc[tag=guile_commands] - -[[javascript_commands]] -==== Komendy wtyczki javascript - -include::includes/autogen_user_commands.pl.adoc[tag=javascript_commands] - -[[php_commands]] -==== Komendy wtyczki php - -include::includes/autogen_user_commands.pl.adoc[tag=php_commands] - -[[script_options]] -==== Opcje wtyczki script - -Sekcje w pliku _script.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| look | /set script.look.* | Wygląd. -| color | /set script.color.* | Kolory. -| scripts | /set script.scripts.* | Opcja dla pobierania skryptów. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=script_options] - -[[python_options]] -==== Opcje dla języka Python - -Sekcje w pliku _python.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| look | /set python.look.* | Wygląd. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=python_options] - -[[perl_options]] -==== Opcje dla języka Perl - -Sekcje w pliku _perl.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| look | /set perl.look.* | Wygląd. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=perl_options] - -[[ruby_options]] -==== Opcje dla języka Ruby - -Sekcje w pliku _ruby.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| look | /set ruby.look.* | Wygląd. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=ruby_options] - -[[lua_options]] -==== Opcje dla języka Lua - -Sekcje w pliku _lua.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| look | /set lua.look.* | Wygląd. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=lua_options] - -[[tcl_options]] -==== Opcje dla języka Tcl - -Sekcje w pliku _tcl.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| look | /set tcl.look.* | Wygląd. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=tcl_options] - -[[guile_options]] -==== Opcje dla języka Guile - -Sekcje w pliku _guile.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| look | /set guile.look.* | Wygląd. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=guile_options] - -[[javascript_options]] -==== Opcje dla języka Javascript - -Sekcje w pliku _javascript.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| look | /set javascript.look.* | Wygląd. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=javascript_options] - -[[php_options]] -==== Opcje dla języka PHP - -Sekcje w pliku _php.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| look | /set php.look.* | Wygląd. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=php_options] - -[[trigger_plugin]] -=== Trigger +[[trigger]] +== Trigger Trigger to scyzoryk szwajcarski dla WeeChat: może być podpięty do wielu rzeczy (sygnał, modyrikator, wyśiwrtlanie, ...), zmieniać zawartość danych, oraz wykonać @@ -4494,7 +4231,7 @@ Warto rozważyć przeczytanie link:weechat_plugin_api.en.html#hooks[Opisu Api wtyczek WeeChat / Hooks] (Angielski). [[trigger_default]] -==== Domyślne triggery +=== Domyślne triggery WeeChat tworzy domyślnie 5 triggerów, które mogą zostać wyłączone, zaktualizowane lub usunięte: @@ -4530,7 +4267,7 @@ Lista domyśłnych triggerów: |=== [[trigger_anatomy]] -==== Anatomia triggera +=== Anatomia triggera Trigger posiada następujące opcje (nazwy to `trigger.trigger.<nazwa>.<opcja>`): @@ -4586,7 +4323,7 @@ trigger.trigger.beep.post_action = none ---- [[trigger_execution]] -==== Wykonywanie +=== Wykonywanie Kiedy wywoływany jest trigger, następujące akcje są wykonywane, dokładnie w takiej kolejności, jeśli triggery są globalnie włączone i jeśli sam trigger jest włączony: @@ -4599,7 +4336,7 @@ kolejności, jeśli triggery są globalnie włączone i jeśli sam trigger jest . wykonanie akcji kończącej (jeśli inna niż `none`). [[trigger_hook_arguments]] -==== Argumenty uchwytów +=== Argumenty uchwytów Argumenty zależą od rodzaju uchwytu. Są oddzielane średnikami. @@ -4709,7 +4446,7 @@ Argumenty zależą od rodzaju uchwytu. Są oddzielane średnikami. |=== [[trigger_conditions]] -==== Warunki +=== Warunki Warunki są używane do kontynuowania przetwarzania w triggerze, lub zatrzymania wszystkiego. @@ -4726,7 +4463,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) ---- [[trigger_regex]] -==== Wyrażenia regularne +=== Wyrażenia regularne Wyrażenia regularne są używane do zmiany zmiennych w tablicy hashy callbacka. @@ -4791,7 +4528,7 @@ w komendach `/server` i `/connect` (znaki haseł są zastępowane przez `+*+`): W tym przykładzie, użyty jest separator "==" ponieważ w wyrażeniu występuje "/". [[trigger_command]] -==== Komenda +=== Komenda Komenda jest wykonywana po zastąpieniu tekstu przez wyrażenie regularne. Wiele komend może być oddzielonych średnikiem. @@ -4806,7 +4543,7 @@ Przykład: domyślny trigger _beep_ używa tej komendy do wydania dźwięku (BEL ---- [[trigger_callback_data]] -==== Dane w callbackach +=== Dane w callbackach Dane otrzymane w callbackach są przechowywane w tablicach hashy (wskaźniki i ciągi) i mogą zostać użyte w następujących opcjach: @@ -4833,7 +4570,7 @@ Wszystkie callbacki ustawiają następujące zmienne w tablicy hashy: |=== [[trigger_data_signal]] -===== Sygnał +==== Sygnał Callback "signal" ustawia następujące zmienne w tablicy hashy: @@ -4875,7 +4612,7 @@ ${buffer[${tg_signal_data}].full_name} ---- [[trigger_data_hsignal]] -===== Hsignal +==== Hsignal Callback "hsignal" ustawia następujące zmienne w tablicy hashy: @@ -4889,7 +4626,7 @@ Tablica zawiera wszystkie klucze/wartości z otrzymanej tablicy hashy (typ: ciąg/ciąg). [[trigger_data_modifier]] -===== Modyfikator +==== Modyfikator Callback "modifier" ustawia następujące zmienne w tablicy hashy: @@ -4921,7 +4658,7 @@ Jeśli modyfikator zawiera wiadomość IRC, wiadomość jest parsowana i dodawan dodatkowe dane do tablicy hashy (zobacz <<trigger_data_signal,hook signal>>). [[trigger_data_line]] -===== Line +==== Line Callback "line" ustawia następujące zmienne w tablicy hashy: @@ -4960,7 +4697,7 @@ Zmienne ustawiane za pomocą tagów w wiadomościach: |=== [[trigger_data_print]] -===== Print +==== Print Callback "print" ustawia następujące zmienne w tablicy hashy: @@ -4993,7 +4730,7 @@ Zmienne ustawiane za pomocą tagów w wiadomościach: |=== [[trigger_data_command]] -===== Command +==== Command Callback "command" ustawia następujące zmienne w tablicy hashy: @@ -5009,7 +4746,7 @@ Callback "command" ustawia następujące zmienne w tablicy hashy: |=== [[trigger_data_command_run]] -===== Command_run +==== Command_run Callback "command_run" ustawia następujące zmienne w tablicy hashy: @@ -5021,7 +4758,7 @@ Callback "command_run" ustawia następujące zmienne w tablicy hashy: |=== [[trigger_data_timer]] -===== Timer +==== Timer Callback "timer" ustawia następujące zmienne w tablicy hashy: @@ -5033,7 +4770,7 @@ Callback "timer" ustawia następujące zmienne w tablicy hashy: |=== [[trigger_data_config]] -===== Config +==== Config Callback "config" ustawia następujące zmienne w tablicy hashy: @@ -5045,7 +4782,7 @@ Callback "config" ustawia następujące zmienne w tablicy hashy: |=== [[trigger_data_focus]] -===== Focus +==== Focus Callback "focus" ustawia następujące zmienne w tablicy hashy: @@ -5060,7 +4797,7 @@ Tablica zawiera wszystkie klucze/wartości z otrzymanej tablicy hashy (typ: ciąg/ciąg). [[trigger_data_info]] -===== Info +==== Info Callback "info" ustawia następujące zmienne w tablicy hashy: @@ -5073,7 +4810,7 @@ Callback "info" ustawia następujące zmienne w tablicy hashy: |=== [[trigger_data_info_hashtable]] -===== Info_hashtable +==== Info_hashtable Callback "info_hashtable" ustawia następujące zmienne w tablicy hashy: @@ -5087,10 +4824,10 @@ Tablica zawiera wszystkie klucze/wartości z otrzymanej tablicy hashy (typ: ciąg/ciąg). [[trigger_examples]] -==== Przykłady +=== Przykłady [[trigger_example_url_color]] -===== Kolory dla URLi +==== Kolory dla URLi Wyświetlanie URLi na zielono: @@ -5103,7 +4840,7 @@ Proste wyrażenie użyte do wykrycia URLa może nie łapać wszstkich URLi, ale szybsze od złożonego wyrażenia. [[trigger_example_auto_pong]] -===== Automatyczna odpowiedz pong na zapytania ping +==== Automatyczna odpowiedz pong na zapytania ping Kiedy ktoś wyśle "ping" w prywatnym buforze, ten trigger odpowie automatycznie `pong`: @@ -5113,7 +4850,7 @@ Kiedy ktoś wyśle "ping" w prywatnym buforze, ten trigger odpowie automatycznie ---- [[trigger_example_responsive_layout]] -===== Responsywny układ +==== Responsywny układ Następujące triggery mogą zostać użyte do zmiany rzeczy wyświetlanych, kiedy nastąpi zmiana rozmiaru terminala: @@ -5133,7 +4870,7 @@ W przykładzie, kiedy terminal stanie się mały, ukrywana jest lista nicków. J ona przywracana, kiedy szerokość jest większa lub równa 100 znakom. [[trigger_example_config_save]] -===== Automatyczne zapisywanie konfiguracji +==== Automatyczne zapisywanie konfiguracji Możesz automatycznie zapisywać pliki konfiguracyjne (`+*.conf+`), na przykład co godzinę: @@ -5152,12 +4889,12 @@ Komenda `/mute /save` zapisze po cichu pliki konfiguracyjne (nic się nie wyświetli w buforze rdzenia). [[trigger_commands]] -==== Komendy +=== Komendy include::includes/autogen_user_commands.pl.adoc[tag=trigger_commands] [[trigger_options]] -==== Opcje +=== Opcje Sekcje w pliku _trigger.conf_: @@ -5175,6 +4912,271 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=trigger_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]. + +[[scripts_plugins]] +=== Skryptowe + +WeeChat posiada 8 wtyczek skryptowych: Python, Perl, Ruby, Lua, Tcl, Guile +(scheme), JavaScript i PHP. +Wtyczki te potrafią ładować, wykonywać i wyładowywać skrypty w tych językach. + +Inna wtyczka nazwana "script" jest managerem skryptów i jest używana do +ładowania/wyładowywania skryptów w dowolnym języku, oraz do instalacji/usuwania +skryptów z repozytorium skryptów WeeChat, dostępnego pod adresem: +https://weechat.org/scripts + +Więcej informacji o tym jak pisać skrypty lub o API WeeChat dla skryptów można +znaleźć w link:weechat_scripting.pl.html[Poradniku pisania skryptów]. + +[[script_commands]] +==== Komendy wtyczki script + +include::includes/autogen_user_commands.pl.adoc[tag=script_commands] + +[[python_commands]] +==== Komendy wtyczki python + +include::includes/autogen_user_commands.pl.adoc[tag=python_commands] + +[[perl_commands]] +==== Komendy wtyczki perl + +include::includes/autogen_user_commands.pl.adoc[tag=perl_commands] + +[[ruby_commands]] +==== Komendy wtyczki ruby + +include::includes/autogen_user_commands.pl.adoc[tag=ruby_commands] + +[[lua_commands]] +==== Komendy wtyczki lua + +include::includes/autogen_user_commands.pl.adoc[tag=lua_commands] + +[[tcl_commands]] +==== Komendy wtyczki tcl + +include::includes/autogen_user_commands.pl.adoc[tag=tcl_commands] + +[[guile_commands]] +==== Komendy wtyczki guile + +include::includes/autogen_user_commands.pl.adoc[tag=guile_commands] + +[[javascript_commands]] +==== Komendy wtyczki javascript + +include::includes/autogen_user_commands.pl.adoc[tag=javascript_commands] + +[[php_commands]] +==== Komendy wtyczki php + +include::includes/autogen_user_commands.pl.adoc[tag=php_commands] + +[[script_options]] +==== Opcje wtyczki script + +Sekcje w pliku _script.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set script.look.* | Wygląd. +| color | /set script.color.* | Kolory. +| scripts | /set script.scripts.* | Opcja dla pobierania skryptów. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=script_options] + +[[python_options]] +==== Opcje dla języka Python + +Sekcje w pliku _python.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set python.look.* | Wygląd. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=python_options] + +[[perl_options]] +==== Opcje dla języka Perl + +Sekcje w pliku _perl.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set perl.look.* | Wygląd. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=perl_options] + +[[ruby_options]] +==== Opcje dla języka Ruby + +Sekcje w pliku _ruby.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set ruby.look.* | Wygląd. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=ruby_options] + +[[lua_options]] +==== Opcje dla języka Lua + +Sekcje w pliku _lua.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set lua.look.* | Wygląd. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=lua_options] + +[[tcl_options]] +==== Opcje dla języka Tcl + +Sekcje w pliku _tcl.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set tcl.look.* | Wygląd. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=tcl_options] + +[[guile_options]] +==== Opcje dla języka Guile + +Sekcje w pliku _guile.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set guile.look.* | Wygląd. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=guile_options] + +[[javascript_options]] +==== Opcje dla języka Javascript + +Sekcje w pliku _javascript.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set javascript.look.* | Wygląd. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=javascript_options] + +[[php_options]] +==== Opcje dla języka PHP + +Sekcje w pliku _php.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| look | /set php.look.* | Wygląd. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=php_options] + [[support]] == Wsparcie diff --git a/doc/sr/weechat_user.sr.adoc b/doc/sr/weechat_user.sr.adoc index c26456a84..88bf559cb 100644 --- a/doc/sr/weechat_user.sr.adoc +++ b/doc/sr/weechat_user.sr.adoc @@ -201,10 +201,10 @@ $ make install Компајлира <<spell_checking,Spell додатак>> са Enchant. | ENABLE_EXEC | `ON`, `OFF` | ON | - Компајлира <<exec_plugin,Exec додатак>>. + Компајлира <<external_commands,Exec додатак>>. | ENABLE_FIFO | `ON`, `OFF` | ON | - Компајлира <<fifo_plugin,Fifo додатак>>. + Компајлира <<fifo_pipe,Fifo додатак>>. | ENABLE_FSET | `ON`, `OFF` | ON | Компајлира <<fset,Fset додатак>>. @@ -265,7 +265,7 @@ $ make install Компајлира <<scripts_plugins,Tcl додатак>>. | ENABLE_TRIGGER | `ON`, `OFF` | ON | - Компајлира <<trigger_plugin,Trigger додатак>>. + Компајлира <<trigger,Trigger додатак>>. | ENABLE_TYPING | `ON`, `OFF` | ON | Компајлира <<typing_notifications,Typing додатак>>. @@ -3821,77 +3821,19 @@ 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 +// TRANSLATION MISSING +[[external_commands]] +== External commands Команда `/exec` вам омогућава да извршите спољне команде из програма WeeChat и да локално прикажете њихов излаз, или да га пошаљете у бафер. [[exec_commands]] -==== Команде +=== Команде include::includes/autogen_user_commands.sr.adoc[tag=exec_commands] [[exec_options]] -==== Опције +=== Опције Одељци у фајлу _exec.conf_: @@ -3906,8 +3848,9 @@ include::includes/autogen_user_commands.sr.adoc[tag=exec_commands] include::includes/autogen_user_options.sr.adoc[tag=exec_options] -[[fifo_plugin]] -=== Fifo +// TRANSLATION MISSING +[[fifo_pipe]] +== FIFO pipe Програм WeeChat можете даљински да контролишете слањем команди или текста у FIFO пајп (ако је укључена опција „fifo.file.enabled”, што је подразумевано). @@ -3947,12 +3890,12 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/wee ---- [[fifo_commands]] -==== Команде +=== Команде include::includes/autogen_user_commands.sr.adoc[tag=fifo_commands] [[fifo_options]] -==== Опције +=== Опције Одељци у фајлу _fifo.conf_: @@ -3966,206 +3909,15 @@ include::includes/autogen_user_commands.sr.adoc[tag=fifo_commands] include::includes/autogen_user_options.sr.adoc[tag=fifo_options] -[[scripts_plugins]] -=== Скрипте - -Програм WeeChat нуди 8 додатака за скриптовање: Python, Perl, Ruby, Lua, Tcl, Guile (scheme), JavaScript и PHP. Ови додаци могу да учитају, изврше и уклоне из меморије скрипте за ове језике. - -Још један додатак, под именом „script” је менаџер скрипти и користи се за учитавање/уклањање из меморије скрипти на било ком језику, и инсталацију/брисање скрипти WeeChat репозиторијума, које су видљиве на следећој URL адреси: https://weechat.org/scripts - -За више информација о функцијама које постоје у API, молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat водич за скриптовање]. - -[[script_commands]] -==== Script команде - -include::includes/autogen_user_commands.sr.adoc[tag=script_commands] - -[[python_commands]] -==== Python команде - -include::includes/autogen_user_commands.sr.adoc[tag=python_commands] - -[[perl_commands]] -==== Perl команде - -include::includes/autogen_user_commands.sr.adoc[tag=perl_commands] - -[[ruby_commands]] -==== Ruby команде - -include::includes/autogen_user_commands.sr.adoc[tag=ruby_commands] - -[[lua_commands]] -==== Lua команде - -include::includes/autogen_user_commands.sr.adoc[tag=lua_commands] - -[[tcl_commands]] -==== Tcl команде - -include::includes/autogen_user_commands.sr.adoc[tag=tcl_commands] - -[[guile_commands]] -==== Guile команде - -include::includes/autogen_user_commands.sr.adoc[tag=guile_commands] - -[[javascript_commands]] -==== JavaScript команде - -include::includes/autogen_user_commands.sr.adoc[tag=javascript_commands] - -[[php_commands]] -==== PHP команде - -include::includes/autogen_user_commands.sr.adoc[tag=php_commands] - -[[script_options]] -==== Script опције - -Одељци у фајлу _script.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| look | /set script.look.* | Изглед и осећај. -| color | /set script.color.* | Боје. -| scripts | /set script.scripts.* | Опције за преузимање скрипти. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=script_options] - -[[python_options]] -==== Python опције - -Одељци у фајлу _python.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| look | /set python.look.* | Изглед и осећај. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=python_options] - -[[perl_options]] -==== Perl опције - -Одељци у фајлу _perl.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| look | /set perl.look.* | Изглед и осећај. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=perl_options] - -[[ruby_options]] -==== Ruby опције - -Одељци у фајлу _ruby.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| look | /set ruby.look.* | Изглед и осећај. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=ruby_options] - -[[lua_options]] -==== Lua опције - -Одељци у фајлу _lua.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| look | /set lua.look.* | Изглед и осећај. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=lua_options] - -[[tcl_options]] -==== Tcl опције - -Одељци у фајлу _tcl.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| look | /set tcl.look.* | Изглед и осећај. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=tcl_options] - -[[guile_options]] -==== Guile опције - -Одељци у фајлу _guile.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| look | /set guile.look.* | Изглед и осећај. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=guile_options] - -[[javascript_options]] -==== Javascript опције - -Одељци у фајлу _javascript.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| look | /set javascript.look.* | Изглед и осећај. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=javascript_options] - -[[php_options]] -==== PHP опције - -Одељци у фајлу _php.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| look | /set php.look.* | Изглед и осећај. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=php_options] - -[[trigger_plugin]] -=== Окидач +[[trigger]] +== Окидач Окидач је Швајцарски војни нож програма WeeChat: може да ухвати многе ствари (сигнал, модификатор, испис, итд.), измени садржај података, и изврши једну или више команди. Ако желите да спречите покретање окидача у неким околностима, можете употребити услов. За коришћење окидача је неопходно познавање начина на који функционишу сигнали, модификатори, ... Стога је пожељно да прочитате link:weechat_plugin_api.sr.html#hooks[WeeChat референтни приручник API додатака / Куке]. [[trigger_default]] -==== Подразумевани окидачи +=== Подразумевани окидачи Програм WeeChat подразумевано креира 5 окидача који могу да се искључе, ажурирају или обришу: @@ -4200,7 +3952,7 @@ include::includes/autogen_user_options.sr.adoc[tag=php_options] |=== [[trigger_anatomy]] -==== Анатомија окидача +=== Анатомија окидача Окидач има следеће опције (имена су `trigger.trigger.<име>.<опција>`): @@ -4255,7 +4007,7 @@ trigger.trigger.beep.post_action = none ---- [[trigger_execution]] -==== Извршавање +=== Извршавање Када се позове функција повратног позива окидача, извршавају се следеће акције, у наведеном редоследу, само ако су окидачи глобално укључени и ако је сам окидач укључен: @@ -4266,7 +4018,7 @@ trigger.trigger.beep.post_action = none . извршавање пост акције (ако није `none`). [[trigger_hook_arguments]] -==== Аргументи куке +=== Аргументи куке Аргументи куке зависе од употребљене куке. Раздвајају се са тачка запетама. @@ -4376,7 +4128,7 @@ link:weechat_plugin_api.sr.html#_hook_info[hook_info] |=== [[trigger_conditions]] -==== Услови +=== Услови За наставак обраде окидача, или за заустављање свега, користе се услови. @@ -4389,7 +4141,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) ---- [[trigger_regex]] -==== Регуларни израз +=== Регуларни израз Регуларни израз се користи за измену променљивих у хеш табели функције повратног позива. @@ -4445,7 +4197,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) У овом примеру се користи „==” као граничник јер у регуларном изразу постоји „/”. [[trigger_command]] -==== Команда +=== Команда Команда се извршава након замене текста регуларним изразом. Више команди може да се замени тачка запетама. @@ -4458,7 +4210,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) ---- [[trigger_callback_data]] -==== Подаци у функцијама повратног позива +=== Подаци у функцијама повратног позива Подаци који се приме у функцијама повратног позива се чувају у хеш табелама (показивачи и стрингови) и могу да се користе у следећим опцијама: @@ -4483,7 +4235,7 @@ ${tg_displayed} && (${tg_highlight} || ${tg_msg_pv}) |=== [[trigger_data_signal]] -===== Signal +==== Signal Функција повратног позива „signal” поставља следеће променљиве у хеш табелу: @@ -4523,7 +4275,7 @@ ${buffer[${tg_signal_data}].full_name} ---- [[trigger_data_hsignal]] -===== Hsignal +==== Hsignal Функција повратног позива „hsignal” поставља следеће променљиве у хеш табелу: @@ -4536,7 +4288,7 @@ ${buffer[${tg_signal_data}].full_name} Хеш табела садржи све кључеве/вредности из примљене хеш табеле (тип: стринг/стринг). [[trigger_data_modifier]] -===== Modifier +==== Modifier Функција повратног позива „modifier” поставља следеће променљиве у хеш табелу: @@ -4566,7 +4318,7 @@ ${buffer[${tg_signal_data}].full_name} Ако модификатор садржи IRC поруку, порука се парсира и у хеш табелу се додаје још података (погледајте <<trigger_data_signal,куку signal>>). [[trigger_data_line]] -===== Line +==== Line Функција повратног позива „line” поставља следеће променљиве у хеш табелу: @@ -4605,7 +4357,7 @@ ${buffer[${tg_signal_data}].full_name} |=== [[trigger_data_print]] -===== Print +==== Print Функција повратног позива „print” поставља следеће променљиве у хеш табелу: @@ -4638,7 +4390,7 @@ ${buffer[${tg_signal_data}].full_name} |=== [[trigger_data_command]] -===== Команда +==== Команда Функција повратног позива „command” поставља следеће променљиве у хеш табелу: @@ -4654,7 +4406,7 @@ ${buffer[${tg_signal_data}].full_name} |=== [[trigger_data_command_run]] -===== Command_run +==== Command_run Функција повратног позива „command_run” поставља следеће променљиве у хеш табелу: @@ -4666,7 +4418,7 @@ ${buffer[${tg_signal_data}].full_name} |=== [[trigger_data_timer]] -===== Timer +==== Timer Функција повратног позива „timer” поставља следеће променљиве у хеш табелу: @@ -4678,7 +4430,7 @@ ${buffer[${tg_signal_data}].full_name} |=== [[trigger_data_config]] -===== Config +==== Config Функција повратног позива „config” поставља следеће променљиве у хеш табелу: @@ -4690,7 +4442,7 @@ ${buffer[${tg_signal_data}].full_name} |=== [[trigger_data_focus]] -===== Focus +==== Focus Функција повратног позива „focus” поставља следеће променљиве у хеш табелу: @@ -4704,7 +4456,7 @@ ${buffer[${tg_signal_data}].full_name} Хеш табела садржи све кључеве/вредности из примљене хеш табеле (тип: стринг/стринг). [[trigger_data_info]] -===== Инфо +==== Инфо Функција повратног позива „info” поставља следеће променљиве у хеш табелу: @@ -4717,7 +4469,7 @@ ${buffer[${tg_signal_data}].full_name} |=== [[trigger_data_info_hashtable]] -===== Info_hashtable +==== Info_hashtable Функција повратног позива „info_hashtable” поставља следеће променљиве у хеш табелу: @@ -4730,10 +4482,10 @@ ${buffer[${tg_signal_data}].full_name} Хеш табела садржи све кључеве/вредности из примљене хеш табеле (тип: стринг/стринг). [[trigger_examples]] -==== Примери +=== Примери [[trigger_example_url_color]] -===== Боја за URL адресе +==== Боја за URL адресе URL адресе се приказују зеленом бојом: @@ -4745,7 +4497,7 @@ URL адресе се приказују зеленом бојом: Једноставни регизраз који се користи за детекцију URL адреса можда неће ухватити све URL адресе, али је бржи од комплексног регизраза. [[trigger_example_auto_pong]] -===== Ауто pong на ping упите +==== Ауто pong на ping упите Када неко у приватни бафер пошаље „ping”, овај окидач ће аутоматски одговорити са `pong`: @@ -4754,7 +4506,7 @@ URL адресе се приказују зеленом бојом: ---- [[trigger_example_responsive_layout]] -===== Респонзивни распоред +==== Респонзивни распоред Следећи окидачи могу да се употребе за прилагођавање ствари онда када се промени величина терминала: @@ -4770,7 +4522,7 @@ URL адресе се приказују зеленом бојом: Када у примеру терминал постане мали, листа надимака се сакрива. А трака се враћа у случају да ширина постане већа или једнака 100 карактера. [[trigger_example_config_save]] -===== Аутоматско чување конфигурације +==== Аутоматско чување конфигурације Можете аутоматски сачувати конфигурационе фајлове (`+*.conf+`), на пример, на сваки сат: @@ -4787,12 +4539,12 @@ URL адресе се приказују зеленом бојом: Команда `/mute /save` ће нечујно да сачува конфигурационе фајлове (ништа се не исписује у бафер језгра). [[trigger_commands]] -==== Команде +=== Команде include::includes/autogen_user_commands.sr.adoc[tag=trigger_commands] [[trigger_options]] -==== Опције +=== Опције Одељци у фајлу _trigger.conf_: @@ -4810,6 +4562,256 @@ include::includes/autogen_user_commands.sr.adoc[tag=trigger_commands] include::includes/autogen_user_options.sr.adoc[tag=trigger_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 водич за скриптовање]. + +[[scripts_plugins]] +=== Скрипте + +Програм WeeChat нуди 8 додатака за скриптовање: Python, Perl, Ruby, Lua, Tcl, Guile (scheme), JavaScript и PHP. Ови додаци могу да учитају, изврше и уклоне из меморије скрипте за ове језике. + +Још један додатак, под именом „script” је менаџер скрипти и користи се за учитавање/уклањање из меморије скрипти на било ком језику, и инсталацију/брисање скрипти WeeChat репозиторијума, које су видљиве на следећој URL адреси: https://weechat.org/scripts + +За више информација о функцијама које постоје у API, молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat водич за скриптовање]. + +[[script_commands]] +==== Script команде + +include::includes/autogen_user_commands.sr.adoc[tag=script_commands] + +[[python_commands]] +==== Python команде + +include::includes/autogen_user_commands.sr.adoc[tag=python_commands] + +[[perl_commands]] +==== Perl команде + +include::includes/autogen_user_commands.sr.adoc[tag=perl_commands] + +[[ruby_commands]] +==== Ruby команде + +include::includes/autogen_user_commands.sr.adoc[tag=ruby_commands] + +[[lua_commands]] +==== Lua команде + +include::includes/autogen_user_commands.sr.adoc[tag=lua_commands] + +[[tcl_commands]] +==== Tcl команде + +include::includes/autogen_user_commands.sr.adoc[tag=tcl_commands] + +[[guile_commands]] +==== Guile команде + +include::includes/autogen_user_commands.sr.adoc[tag=guile_commands] + +[[javascript_commands]] +==== JavaScript команде + +include::includes/autogen_user_commands.sr.adoc[tag=javascript_commands] + +[[php_commands]] +==== PHP команде + +include::includes/autogen_user_commands.sr.adoc[tag=php_commands] + +[[script_options]] +==== Script опције + +Одељци у фајлу _script.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set script.look.* | Изглед и осећај. +| color | /set script.color.* | Боје. +| scripts | /set script.scripts.* | Опције за преузимање скрипти. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=script_options] + +[[python_options]] +==== Python опције + +Одељци у фајлу _python.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set python.look.* | Изглед и осећај. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=python_options] + +[[perl_options]] +==== Perl опције + +Одељци у фајлу _perl.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set perl.look.* | Изглед и осећај. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=perl_options] + +[[ruby_options]] +==== Ruby опције + +Одељци у фајлу _ruby.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set ruby.look.* | Изглед и осећај. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=ruby_options] + +[[lua_options]] +==== Lua опције + +Одељци у фајлу _lua.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set lua.look.* | Изглед и осећај. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=lua_options] + +[[tcl_options]] +==== Tcl опције + +Одељци у фајлу _tcl.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set tcl.look.* | Изглед и осећај. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=tcl_options] + +[[guile_options]] +==== Guile опције + +Одељци у фајлу _guile.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set guile.look.* | Изглед и осећај. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=guile_options] + +[[javascript_options]] +==== Javascript опције + +Одељци у фајлу _javascript.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set javascript.look.* | Изглед и осећај. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=javascript_options] + +[[php_options]] +==== PHP опције + +Одељци у фајлу _php.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| look | /set php.look.* | Изглед и осећај. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=php_options] + [[support]] == Подршка |