diff options
author | Sébastien Helleu <flashcode@flashtux.org> | 2021-12-05 14:42:58 +0100 |
---|---|---|
committer | Sébastien Helleu <flashcode@flashtux.org> | 2021-12-05 20:59:19 +0100 |
commit | 66384544b551e5bf61de786590a8dfa7efed53d7 (patch) | |
tree | d45ce320a853da909c3172ba6a08ed29ce25e354 /doc | |
parent | c88428fb416fa1f0477e4a9f2542d06db239a749 (diff) | |
download | weechat-66384544b551e5bf61de786590a8dfa7efed53d7.zip |
doc: move section "IRC" at top level after "Configuration" (user's guide)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/de/weechat_user.de.adoc | 364 | ||||
-rw-r--r-- | doc/en/weechat_user.en.adoc | 358 | ||||
-rw-r--r-- | doc/fr/weechat_user.fr.adoc | 366 | ||||
-rw-r--r-- | doc/it/weechat_user.it.adoc | 388 | ||||
-rw-r--r-- | doc/ja/weechat_user.ja.adoc | 364 | ||||
-rw-r--r-- | doc/pl/weechat_user.pl.adoc | 364 | ||||
-rw-r--r-- | doc/sr/weechat_user.sr.adoc | 332 |
7 files changed, 1268 insertions, 1268 deletions
diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index decd1fa60..1612f7b67 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -237,7 +237,7 @@ Liste von häufig verwendeten Optionen: kompiliert <<scripts_plugins,Guile Erweiterung>> (Scheme). | ENABLE_IRC | `ON`, `OFF` | ON | - kompiliert <<irc_plugin,IRC Erweiterung>>. + kompiliert <<irc,IRC Erweiterung>>. | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF | kompiliert <<scripts_plugins,JavaScript Erweiterung>>. @@ -2840,169 +2840,8 @@ Optionen: include::includes/autogen_user_options.de.adoc[tag=weechat_options] -[[plugins]] -== Erweiterungen - -Eine WeeChat Erweiterung ist eine dynamische Bibliothek (library), die in C geschrieben -und kompiliert ist. Unter GNU/Linux besitzt eine Erweiterung als Dateiendung ".so", unter -Windows ".dll". - -Erweiterungen die gefunden werden, werden beim Start von WeeChat automatisch geladen. -Natürlich ist es möglich während einer laufenden Session von WeeChat Erweiterungen -nachträglich zu laden oder zu entfernen. - -Es ist wichtig zwischen _Erweiterung_ und _Skript_ zu unterscheiden. Eine Erweiterung -ist eine Binärdatei die kompiliert wurde und mit dem Befehl `/plugin` geladen wird. -Dem gegenüber ist ein _Skript_ eine Textdatei die durch eine Erweiterung z.B. _python_ -mittels dem Befehl `/python` geladen wird. - -Mit dem Befehl `/plugin` kann eine Erweiterung geladen bzw. entfernt werden. Auch können -mit dem Befehl alle installierten Erweiterungen aufgelistet werden. - -Sobald eine Erweiterung beendet wird, entfernt WeeChat: - -* Buffer -* Konfigurationsoptionen (Optionen die in Datein geschrieben wurden) -* alle Hooks: commands, modifiers, process, etc. -* Infos und Infolisten -* hdata -* Bar-Items. - -Beispiele wie man Erweiterungen lädt, entfernt und auflistet: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Standarderweiterungen: - -[width="100%",cols="1,5",options="header"] -|=== -| Erweiterung | Beschreibung -| alias | definiert Alias für Befehle. -| buflist | Bar-Item mit der Liste aller Buffern. -| charset | Zeichensatz (de)-kodierung in Buffern. -| exec | ausführen von externen Befehlen aus WeeChat heraus. -| fifo | FIFO Pipe die zur Fernsteuerung von WeeChat genutzt werden kann. -| fset | Optionen von WeeChat und Erweiterungen schnell anpassen. -| irc | IRC Chat-Protokoll. -| logger | erstellt Protokolldateien von Buffern. -| relay | Daten via Netzwerk übermitteln. -| script | Skripten-Manager. -| python | Python-Skript API. -| perl | Perl-Skript API. -| ruby | Ruby-Skript API. -| lua | Lua-Skript API. -| tcl | Tcl-Skript API. -| guile | Guile(scheme)-Skript API. -| javascript | JavaScript-Skript API. -| php | PHP-Skript API. -| spell | Rechtschreibprüfung für Befehlszeile. -| trigger | Veränderung von Text und Ausführen von Befehlen bei einem Ereignis, welche durch WeeChat oder eine Erweiterung ausgelöst werden. -| typing | Benutzer anzeigen, die gerade Nachrichten schreiben. -| xfer | Datentransfer und Direktchat. -|=== - -Um mehr über Erweiterungen- und Skriptenprogrammierung (mittels API) zu erfahren, -sollten Sie die link:weechat_plugin_api.en.html[Anleitung für API Erweiterung] (Englisch) oder -link:weechat_scripting.de.html[WeeChat scripting guide] lesen. - -[[exec_plugin]] -=== Exec - -Der `/exec` Befehl erlaubt es aus WeeChat heraus einen oder mehrere externe -Befehle auszuführen und eine Ausgabe im lokalen Buffer darzustellen oder in -einem Buffer auszugeben. - -[[exec_commands]] -==== Befehle - -include::includes/autogen_user_commands.de.adoc[tag=exec_commands] - -[[exec_options]] -==== Optionen - -Sektionen in Datei _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| command | /set exec.command.* | Optionen für Befehle. -| color | /set exec.color.* | Farben. -|=== - -Options: - -include::includes/autogen_user_options.de.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Sie können WeeChat fern steuern indem Sie Befehle oder einen Text an die FIFO Pipe -schicken (dazu muss die Option "fifo.file.enabled" aktiviert sein (standardmäßig -ist diese Option aktiviert). - -Die FIFO-Pipe befindet sich im WeeChat-Laufzeitverzeichnis und wird standardmäßig -_weechat_fifo_12345_ benannt (wobei _12345_ die WeeChat-Prozess-ID ist). - -Die Syntax der FIFO Pipe Befehle/Text sieht wie folgt aus: - -.... - plugin.buffer *hier Text oder Befehl - *hier Text oder Befehl -.... - -einige Beispiele: - -* Ändert den eigenen Nick auf dem IRC Server libera in "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Schickt eine Nachrich in den IRC #weechat Channel: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Schickt eine Nachricht in den aktuellen Buffer: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Sendet zwei Befehle um alle Python-Skripten zu entfernen und dann neu zu laden (die beiden Befehle müssen - mit "\n" getrennt werden): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Befehle - -include::includes/autogen_user_commands.de.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Optionen - -Sektionen in Datei _fifo.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sektion | Steuerbefehl | Beschreibung -| file | /set fifo.file.* | FIFO Pipe Optionen. -|=== - -Optionen: - -include::includes/autogen_user_options.de.adoc[tag=fifo_options] - -[[irc_plugin]] -=== IRC +[[irc]] +== IRC Die IRC Erweiterung ist konzipiert um mittels dem IRC Protokoll mit anderen Menschen zu chatten. @@ -3010,7 +2849,7 @@ Die Erweiterung ist Multi-Server fähig und verfügt über alle IRC Befehle, ein und Datenübertragung (via xfer Erweiterung, siehe <<xfer_plugin,Xfer Erweiterung>>). [[irc_command_line_options]] -==== Kommandozeilen Befehle +=== Kommandozeilen Befehle Es ist möglich eine oder mehrere URL von IRC Servern zu übergeben: @@ -3026,10 +2865,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr ---- [[irc_servers]] -==== Server +=== Server [[irc_servers_add]] -===== Server hinzufügen +==== Server hinzufügen Standardmäßig sind keine Server angelegt. Es gibt keine Begrenzung für die Anzahl von Servern. Server können mit dem Befehl <<command_irc_server,/server>> @@ -3072,7 +2911,7 @@ zu Problemen führen. In diesem Fall können Sie eine Befehlsverzögerung einste `/set irc.server.libera.command_delay 5`. [[irc_servers_options]] -===== Server-Optionen +==== Server-Optionen Serveroptinen haben folgenden Aufbau `irc.server.<server>.<option>` hierbei ist `<server>` der interne Name des Server und `<option>` ist der Name der Option. + @@ -3145,7 +2984,7 @@ geerbten Wert verwendet, der jetzt `on` anstelle des Standardwerts `off` ist: ---- [[irc_ssl_certificates]] -===== SSL Zertifikate +==== SSL Zertifikate Wenn eine Verbindung mittels SSL zu einem IRC Server hergestellt wird dann überprüft WeeChat immer ob dieser Verbindung sicher ist. @@ -3175,7 +3014,7 @@ die Verifizierung sehr streng genommen wird und dadurch vielleicht versagt. Auch die Verbindung mit einer vorherigen Version (<0.3.1) funktioniert hat. [[irc_connect_oftc_with_certificate]] -====== erstes Beispiel: Verbindung zu oftc und Überprüfung der Zertifikate +===== erstes Beispiel: Verbindung zu oftc und Überprüfung der Zertifikate * Importieren Sie die Zertifikate in einer Shell: @@ -3198,7 +3037,7 @@ Es ist möglich mehrere Zertifikate in der Datei CAs.pem zu verwenden. ---- [[irc_connect_oftc_with_certfp]] -====== zweites Beispiel: Verbindung zu oftc mittels CertFP +===== zweites Beispiel: Verbindung zu oftc mittels CertFP * Erstellen Sie ein Zertifikat in der Shell: @@ -3223,7 +3062,7 @@ das auch beispielsweise `~/.weechat` sein kann. Für weiterreichende Informationen lesen Sie bitte: https://www.oftc.net/NickServ/CertFP [[irc_sasl_authentication]] -===== SASL Authentifizierung +==== SASL Authentifizierung WeeChat unterstützt eine SASL Authentifikation, mittels verschiedener Mechanismen: @@ -3245,7 +3084,7 @@ Optionen für Server sind: _ecdsa-nist256p-challenge_ Mechanismus) [[irc_sasl_ecdsa_nist256p_challenge]] -====== SASL ECDSA-NIST256P-CHALLENGE +===== SASL ECDSA-NIST256P-CHALLENGE Es muss ein privater Schlüssel erstellt werden um sich mittels des ECDSA-NIST256P-CHALLENGE Mechanismus authentifizieren zu können (es wird @@ -3293,7 +3132,7 @@ Erneut mit dem Server verbinden: ---- [[irc_servers_connection]] -===== Verbindung zum Server +==== Verbindung zum Server Um sich mit einem Server zu Verbinden, nutzt man den <<command_irc_connect,/connect>> Befehl: @@ -3327,7 +3166,7 @@ um unabhängige Serverbuffer zu haben: ---- [[irc_tor_sasl]] -===== Connect with TOR and SASL +==== Connect with TOR and SASL Einige Server unterstützen eine Verbindungen mittels TOR (https://www.torproject.org/), dies ist ein Netzwerk mit virtueller Tunneln, durch welchen Personen und Gruppen ihre @@ -3376,7 +3215,7 @@ Abschließend, stellen Sie eine Verbindung zum Server her: ---- [[irc_channels]] -==== Kanäle +=== Kanäle Kanäle können mit dem Befehl <<command_irc_join,/join>> betreten werden: @@ -3414,7 +3253,7 @@ Schlüssel erfordert, aber nicht `#channel2`: Um eine Hilfe über das Format zu erhalten, siehe `/help irc.server.libera.autojoin`. [[irc_private_messages]] -==== private Nachrichten +=== private Nachrichten Sie können eine private Nachricht mit dem Befehl <<command_irc_query,/query>> senden, was einen separaten Buffer, für die Konversation, öffnet: @@ -3438,7 +3277,7 @@ privaten Buffer aus: ---- [[irc_smart_filter_join_part_quit]] -==== einfacher Filter für join/part/quit Nachrichten +=== einfacher Filter für join/part/quit Nachrichten Es existiert ein einfacher Filter für join/part/quit Nachrichten falls ein Nick für eine vorgegebene Zeit in einem Channel inaktiv gewesen ist. @@ -3476,7 +3315,7 @@ Falls ein Nick in den letzten fünf Minuten nicht aktiv gewesen ist werden seine join und/oder part/quit Nachrichten im Channel unterdrückt. [[irc_ctcp_replies]] -==== CTCP Antworten +=== CTCP Antworten Sie haben die Möglichkeit CTCP Antworten anzupassen oder aber bestimmte CTCP Anfragen zu sperren (es wird nicht darauf geantwortet). @@ -3554,7 +3393,7 @@ Falls CTCP Optionen nicht festgelegt sind, lauten die CTCP Antworten: |=== [[irc_target_buffer]] -==== Zielbuffer für IRC Nachrichten +=== Zielbuffer für IRC Nachrichten Sie können einen Zielbuffer einstellen in welchem IRC Nachrichten dargestellt werden sollen. Dazu dienen die Optionen `+irc.msgbuffer.*+`. @@ -3686,12 +3525,12 @@ einige Beispiele: ---- [[irc_commands]] -==== Befehle +=== Befehle include::includes/autogen_user_commands.de.adoc[tag=irc_commands] [[irc_options]] -==== Optionen +=== Optionen Sektionen in Datei _irc.conf_: @@ -3713,6 +3552,167 @@ Optionen: include::includes/autogen_user_options.de.adoc[tag=irc_options] +[[plugins]] +== Erweiterungen + +Eine WeeChat Erweiterung ist eine dynamische Bibliothek (library), die in C geschrieben +und kompiliert ist. Unter GNU/Linux besitzt eine Erweiterung als Dateiendung ".so", unter +Windows ".dll". + +Erweiterungen die gefunden werden, werden beim Start von WeeChat automatisch geladen. +Natürlich ist es möglich während einer laufenden Session von WeeChat Erweiterungen +nachträglich zu laden oder zu entfernen. + +Es ist wichtig zwischen _Erweiterung_ und _Skript_ zu unterscheiden. Eine Erweiterung +ist eine Binärdatei die kompiliert wurde und mit dem Befehl `/plugin` geladen wird. +Dem gegenüber ist ein _Skript_ eine Textdatei die durch eine Erweiterung z.B. _python_ +mittels dem Befehl `/python` geladen wird. + +Mit dem Befehl `/plugin` kann eine Erweiterung geladen bzw. entfernt werden. Auch können +mit dem Befehl alle installierten Erweiterungen aufgelistet werden. + +Sobald eine Erweiterung beendet wird, entfernt WeeChat: + +* Buffer +* Konfigurationsoptionen (Optionen die in Datein geschrieben wurden) +* alle Hooks: commands, modifiers, process, etc. +* Infos und Infolisten +* hdata +* Bar-Items. + +Beispiele wie man Erweiterungen lädt, entfernt und auflistet: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Standarderweiterungen: + +[width="100%",cols="1,5",options="header"] +|=== +| Erweiterung | Beschreibung +| alias | definiert Alias für Befehle. +| buflist | Bar-Item mit der Liste aller Buffern. +| charset | Zeichensatz (de)-kodierung in Buffern. +| exec | ausführen von externen Befehlen aus WeeChat heraus. +| fifo | FIFO Pipe die zur Fernsteuerung von WeeChat genutzt werden kann. +| fset | Optionen von WeeChat und Erweiterungen schnell anpassen. +| irc | IRC Chat-Protokoll. +| logger | erstellt Protokolldateien von Buffern. +| relay | Daten via Netzwerk übermitteln. +| script | Skripten-Manager. +| python | Python-Skript API. +| perl | Perl-Skript API. +| ruby | Ruby-Skript API. +| lua | Lua-Skript API. +| tcl | Tcl-Skript API. +| guile | Guile(scheme)-Skript API. +| javascript | JavaScript-Skript API. +| php | PHP-Skript API. +| spell | Rechtschreibprüfung für Befehlszeile. +| trigger | Veränderung von Text und Ausführen von Befehlen bei einem Ereignis, welche durch WeeChat oder eine Erweiterung ausgelöst werden. +| typing | Benutzer anzeigen, die gerade Nachrichten schreiben. +| xfer | Datentransfer und Direktchat. +|=== + +Um mehr über Erweiterungen- und Skriptenprogrammierung (mittels API) zu erfahren, +sollten Sie die link:weechat_plugin_api.en.html[Anleitung für API Erweiterung] (Englisch) oder +link:weechat_scripting.de.html[WeeChat scripting guide] lesen. + +[[exec_plugin]] +=== Exec + +Der `/exec` Befehl erlaubt es aus WeeChat heraus einen oder mehrere externe +Befehle auszuführen und eine Ausgabe im lokalen Buffer darzustellen oder in +einem Buffer auszugeben. + +[[exec_commands]] +==== Befehle + +include::includes/autogen_user_commands.de.adoc[tag=exec_commands] + +[[exec_options]] +==== Optionen + +Sektionen in Datei _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| command | /set exec.command.* | Optionen für Befehle. +| color | /set exec.color.* | Farben. +|=== + +Options: + +include::includes/autogen_user_options.de.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Sie können WeeChat fern steuern indem Sie Befehle oder einen Text an die FIFO Pipe +schicken (dazu muss die Option "fifo.file.enabled" aktiviert sein (standardmäßig +ist diese Option aktiviert). + +Die FIFO-Pipe befindet sich im WeeChat-Laufzeitverzeichnis und wird standardmäßig +_weechat_fifo_12345_ benannt (wobei _12345_ die WeeChat-Prozess-ID ist). + +Die Syntax der FIFO Pipe Befehle/Text sieht wie folgt aus: + +.... + plugin.buffer *hier Text oder Befehl + *hier Text oder Befehl +.... + +einige Beispiele: + +* Ändert den eigenen Nick auf dem IRC Server libera in "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Schickt eine Nachrich in den IRC #weechat Channel: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Schickt eine Nachricht in den aktuellen Buffer: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Sendet zwei Befehle um alle Python-Skripten zu entfernen und dann neu zu laden (die beiden Befehle müssen + mit "\n" getrennt werden): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Befehle + +include::includes/autogen_user_commands.de.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Optionen + +Sektionen in Datei _fifo.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sektion | Steuerbefehl | Beschreibung +| file | /set fifo.file.* | FIFO Pipe Optionen. +|=== + +Optionen: + +include::includes/autogen_user_options.de.adoc[tag=fifo_options] + [[logger_plugin]] === Logger diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index e81d1ba28..7dcfdf788 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -229,7 +229,7 @@ List of commonly used options: Compile <<scripts_plugins,Guile plugin>> (Scheme). | ENABLE_IRC | `ON`, `OFF` | ON | - Compile <<irc_plugin,IRC plugin>>. + Compile <<irc,IRC plugin>>. | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF | Compile <<scripts_plugins,JavaScript plugin>>. @@ -2762,166 +2762,8 @@ Options: include::includes/autogen_user_options.en.adoc[tag=weechat_options] -[[plugins]] -== Plugins - -A plugin is a dynamic library, written in C and compiled, which is loaded by -WeeChat. -Under GNU/Linux, the file has ".so" extension, ".dll" under Windows. - -Plugins found are automatically loaded when WeeChat is starting, and it is -possible to load or unload plugins while WeeChat is running. - -It's important to make difference between a _plugin_ and a _script_: a -_plugin_ is a binary file compiled and loaded with command `/plugin`, whereas -a _script_ is a text file loaded with a plugin like _python_ with command -`/python`. - -You can use command `/plugin` to load/unload a plugin, or list all loaded -plugins. - -When a plugin is unloaded, WeeChat removes: - -* buffers -* configuration options (options are written in files) -* all hooks: commands, modifiers, process, etc. -* infos and infolists -* hdata -* bar items. - -Examples to load, unload or list plugins: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Default plugins are: - -[width="100%",cols="1,5",options="header"] -|=== -| Plugin | Description -| alias | Define alias for commands. -| buflist | Bar item with list of buffers. -| charset | Charset decoding/encoding for buffers. -| exec | Execution of external commands in WeeChat. -| fifo | FIFO pipe used to remotely send commands to WeeChat. -| fset | Fast set of WeeChat and plugins options. -| irc | IRC chat protocol. -| logger | Log buffers to files. -| relay | Relay data via network. -| script | Script manager. -| python | Python scripting API. -| perl | Perl scripting API. -| ruby | Ruby scripting API. -| lua | Lua scripting API. -| tcl | Tcl scripting API. -| guile | Guile (scheme) scripting API. -| javascript | JavaScript scripting API. -| php | PHP scripting API. -| spell | Spell checking for command line. -| trigger | Text replacement and command execution on events triggered by WeeChat/plugins. -| typing | Display users currently writing messages. -| xfer | File transfer and direct chat. -|=== - -To learn more about plugin or script development (through API), please read the -link:weechat_plugin_api.en.html[WeeChat plugin API reference] or the -link:weechat_scripting.en.html[WeeChat scripting guide]. - -[[exec_plugin]] -=== Exec - -The `/exec` command lets you execute external commands inside WeeChat and -display the output locally, or send it to a buffer. - -[[exec_commands]] -==== Commands - -include::includes/autogen_user_commands.en.adoc[tag=exec_commands] - -[[exec_options]] -==== Options - -Sections in file _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| command | /set exec.command.* | Options for commands. -| color | /set exec.color.* | Colors. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -You can remote control WeeChat, by sending commands or text to a FIFO pipe (if -option "fifo.file.enabled" is enabled, it is by default). - -The FIFO pipe is located in WeeChat runtime directory and is called -_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). - -Syntax for the FIFO pipe commands/text is one of following: - -.... - plugin.buffer *text or command here - *text or command here -.... - -Some examples: - -* Change nick on IRC server libera to "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Send a message on IRC #weechat channel: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Send a message on current buffer: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Send two commands to unload/reload Python scripts (you have to separate them - with "\n"): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Commands - -include::includes/autogen_user_commands.en.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Options - -Sections in file _fifo.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| file | /set fifo.file.* | FIFO pipe control. -|=== - -Options: - -include::includes/autogen_user_options.en.adoc[tag=fifo_options] - -[[irc_plugin]] -=== IRC +[[irc]] +== IRC The IRC plugin is designed to chat through IRC protocol with other people. @@ -2929,7 +2771,7 @@ It is multi-servers, and offers all supported IRC commands including DCC chat and file transfer (via xfer plugin, see <<xfer_plugin,Xfer plugin>>). [[irc_command_line_options]] -==== Command line options +=== Command line options It is possible to give URL for one or many IRC servers, as follow: @@ -2945,10 +2787,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr ---- [[irc_servers]] -==== Servers +=== Servers [[irc_servers_add]] -===== Add a server +==== Add a server By default no servers are defined. You can add as many servers as you want with the <<command_irc_server,/server>> command. @@ -2988,7 +2830,7 @@ to join. In this case, you can set a command delay: `/set irc.server.libera.command_delay 5`. [[irc_servers_options]] -===== Server options +==== Server options Server options are named `irc.server.<server>.<option>` where `<server>` is the internal name of the server and `<option>` the name of an option. + @@ -3060,7 +2902,7 @@ value, which is now `on` instead of the default value `off`: ---- [[irc_ssl_certificates]] -===== SSL certificates +==== SSL certificates When connecting to IRC server with SSL, WeeChat checks by default that the connection is fully trusted. @@ -3089,7 +2931,7 @@ Option "ssl_verify" is on by default, so verification is strict and may fail, even if it was OK with versions prior to 0.3.1. [[irc_connect_oftc_with_certificate]] -====== First example: connect to oftc and check certificate +===== First example: connect to oftc and check certificate * Import certificate in shell: @@ -3112,7 +2954,7 @@ It is possible to concatenate many certificates in file CAs.pem. ---- [[irc_connect_oftc_with_certfp]] -====== Second example: connect to oftc using CertFP +===== Second example: connect to oftc using CertFP * Create certificate in shell: @@ -3137,7 +2979,7 @@ which can also be for example `~/.weechat`. For more information, look at https://www.oftc.net/NickServ/CertFP [[irc_sasl_authentication]] -===== SASL authentication +==== SASL authentication WeeChat supports SASL authentication, using different mechanisms: @@ -3159,7 +3001,7 @@ Options in servers are: _ecdsa-nist256p-challenge_) [[irc_sasl_ecdsa_nist256p_challenge]] -====== SASL ECDSA-NIST256P-CHALLENGE +===== SASL ECDSA-NIST256P-CHALLENGE You must generate a private key in order to authentify with the ECDSA-NIST256P-CHALLENGE mechanism (no password is required on connection). @@ -3205,7 +3047,7 @@ Reconnect to the server: ---- [[irc_servers_connection]] -===== Connection +==== Connection You can connect to server with the <<command_irc_connect,/connect>> command: @@ -3236,7 +3078,7 @@ server buffers: ---- [[irc_tor_sasl]] -===== Connect with TOR and SASL +==== Connect with TOR and SASL Some servers support connections with TOR (https://www.torproject.org/), a network of virtual tunnels that allows people and groups to improve their @@ -3284,7 +3126,7 @@ And finally, connect to the server: ---- [[irc_channels]] -==== Channels +=== Channels You can join channels with the <<command_irc_join,/join>> command: @@ -3319,7 +3161,7 @@ for example if `#channel1` requires a key but not `#channel2`: For help on the format, see `/help irc.server.libera.autojoin`. [[irc_private_messages]] -==== Private messages +=== Private messages You can send a private message with the <<command_irc_query,/query>> command, which opens a separate buffer: @@ -3341,7 +3183,7 @@ To close the private buffer, you can do this command on the private buffer: ---- [[irc_smart_filter_join_part_quit]] -==== Smart filter for join/part/quit messages +=== Smart filter for join/part/quit messages A smart filter is available to filter join/part/quit messages when nick did not say something during past X minutes on channel. @@ -3378,7 +3220,7 @@ If a nick did not speak during last 5 minutes, its join and/or part/quit will be hidden on channel. [[irc_ctcp_replies]] -==== CTCP replies +=== CTCP replies It is possible to customize CTCP replies, or block some CTCP queries (do not reply). @@ -3453,7 +3295,7 @@ If CTCP options are not defined (by default), CTCP replies are: |=== [[irc_target_buffer]] -==== Target buffer for IRC messages +=== Target buffer for IRC messages It is possible to customize target buffer for IRC messages (buffer used to display message) with options `+irc.msgbuffer.*+`. @@ -3585,12 +3427,12 @@ Some examples: ---- [[irc_commands]] -==== Commands +=== Commands include::includes/autogen_user_commands.en.adoc[tag=irc_commands] [[irc_options]] -==== Options +=== Options Sections in file _irc.conf_: @@ -3612,6 +3454,164 @@ Options: include::includes/autogen_user_options.en.adoc[tag=irc_options] +[[plugins]] +== Plugins + +A plugin is a dynamic library, written in C and compiled, which is loaded by +WeeChat. +Under GNU/Linux, the file has ".so" extension, ".dll" under Windows. + +Plugins found are automatically loaded when WeeChat is starting, and it is +possible to load or unload plugins while WeeChat is running. + +It's important to make difference between a _plugin_ and a _script_: a +_plugin_ is a binary file compiled and loaded with command `/plugin`, whereas +a _script_ is a text file loaded with a plugin like _python_ with command +`/python`. + +You can use command `/plugin` to load/unload a plugin, or list all loaded +plugins. + +When a plugin is unloaded, WeeChat removes: + +* buffers +* configuration options (options are written in files) +* all hooks: commands, modifiers, process, etc. +* infos and infolists +* hdata +* bar items. + +Examples to load, unload or list plugins: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Default plugins are: + +[width="100%",cols="1,5",options="header"] +|=== +| Plugin | Description +| alias | Define alias for commands. +| buflist | Bar item with list of buffers. +| charset | Charset decoding/encoding for buffers. +| exec | Execution of external commands in WeeChat. +| fifo | FIFO pipe used to remotely send commands to WeeChat. +| fset | Fast set of WeeChat and plugins options. +| irc | IRC chat protocol. +| logger | Log buffers to files. +| relay | Relay data via network. +| script | Script manager. +| python | Python scripting API. +| perl | Perl scripting API. +| ruby | Ruby scripting API. +| lua | Lua scripting API. +| tcl | Tcl scripting API. +| guile | Guile (scheme) scripting API. +| javascript | JavaScript scripting API. +| php | PHP scripting API. +| spell | Spell checking for command line. +| trigger | Text replacement and command execution on events triggered by WeeChat/plugins. +| typing | Display users currently writing messages. +| xfer | File transfer and direct chat. +|=== + +To learn more about plugin or script development (through API), please read the +link:weechat_plugin_api.en.html[WeeChat plugin API reference] or the +link:weechat_scripting.en.html[WeeChat scripting guide]. + +[[exec_plugin]] +=== Exec + +The `/exec` command lets you execute external commands inside WeeChat and +display the output locally, or send it to a buffer. + +[[exec_commands]] +==== Commands + +include::includes/autogen_user_commands.en.adoc[tag=exec_commands] + +[[exec_options]] +==== Options + +Sections in file _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| command | /set exec.command.* | Options for commands. +| color | /set exec.color.* | Colors. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +You can remote control WeeChat, by sending commands or text to a FIFO pipe (if +option "fifo.file.enabled" is enabled, it is by default). + +The FIFO pipe is located in WeeChat runtime directory and is called +_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). + +Syntax for the FIFO pipe commands/text is one of following: + +.... + plugin.buffer *text or command here + *text or command here +.... + +Some examples: + +* Change nick on IRC server libera to "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Send a message on IRC #weechat channel: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Send a message on current buffer: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Send two commands to unload/reload Python scripts (you have to separate them + with "\n"): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Commands + +include::includes/autogen_user_commands.en.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Options + +Sections in file _fifo.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| file | /set fifo.file.* | FIFO pipe control. +|=== + +Options: + +include::includes/autogen_user_options.en.adoc[tag=fifo_options] + [[logger_plugin]] === Logger diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index 48eea35dd..b9cb70c73 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -233,7 +233,7 @@ Liste des options couramment utilisées : Compiler <<scripts_plugins,l'extension Guile>> (Scheme). | ENABLE_IRC | `ON`, `OFF` | ON | - Compiler <<irc_plugin,l'extension IRC>>. + Compiler <<irc,l'extension IRC>>. | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF | Compiler <<scripts_plugins,l'extension JavaScript>>. @@ -2857,170 +2857,8 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=weechat_options] -[[plugins]] -== Extensions - -Une extension est une bibliothèque dynamique, écrite en C et compilée, qui est -chargée par WeeChat. -Sous GNU/Linux, ce fichier a une extension ".so", et ".dll" sous Windows. - -Les extensions trouvées sont automatiquement chargées par WeeChat lorsqu'il -démarre, et il est possible de charger et décharger des extensions pendant que -WeeChat tourne. - -Il est important de bien faire la différence entre une _extension_ et un -_script_ : une _extension_ est un fichier binaire compilé et chargé avec la -commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une -extension comme _python_ par la commande `/python`. - -Vous pouvez utiliser la commande `/plugin` pour charger/décharger une -extension, ou afficher les extensions chargées. - -Quand une extension est déchargée, WeeChat supprime : - -* les tampons -* les options de configuration (les options sont écrites dans les fichiers) -* tous les "hooks" : commandes, modificateurs, processus, etc. -* les infos et infolists -* les "hdata" -* les objets de barre. - -Exemples pour charger, décharger et afficher les extensions : - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Les extensions par défaut sont : - -[width="100%",cols="1,5",options="header"] -|=== -| Extension | Description -| alias | Définition d'alias pour les commandes. -| buflist | Objet de barre avec la liste des tampons. -| charset | Encodage/encodage avec jeu de caractère sur les tampons. -| exec | Exécution de commandes externes dans WeeChat. -| fifo | Tube FIFO pour envoyer des commandes à distance vers WeeChat. -| fset | Modification rapide des options de WeeChat et des extensions. -| irc | Discussion avec le protocole IRC. -| logger | Enregistrement des tampons dans des fichiers. -| relay | Relai de données via le réseau. -| script | Gestionnaire de scripts. -| python | Interface (API) pour scripts Python. -| perl | Interface (API) pour scripts Perl. -| ruby | Interface (API) pour scripts Ruby. -| lua | Interface (API) pour scripts Lua. -| tcl | Interface (API) pour scripts Tcl. -| guile | Interface (API) pour scripts Guile (scheme). -| javascript | Interface (API) pour scripts JavaScript. -| php | Interface (API) pour scripts PHP. -| spell | Vérification orthographique de la ligne de commande. -| trigger | Remplacement de texte et exécution de commande sur des évènements de WeeChat ou des extensions. -| typing | Affichage des utilisateurs qui sont en train d'écrire des messages. -| xfer | Transfert de fichier et discussion directe. -|=== - -Pour en apprendre plus sur le développement d'extension ou de script (via -l'API), merci de consulter la -link:weechat_plugin_api.fr.html[Référence API extension WeeChat] ou le -link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. - -[[exec_plugin]] -=== Exec - -La commande `/exec` vous permet de lancer des commandes externes dans WeeChat et -d'afficher la sortie localement, ou de l'envoyer à un tampon. - -[[exec_commands]] -==== Commandes - -include::includes/autogen_user_commands.fr.adoc[tag=exec_commands] - -[[exec_options]] -==== Options - -Sections dans le fichier _exec.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| command | /set exec.command.* | Options pour les commandes. -| color | /set exec.color.* | Couleurs. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du -texte dans un tube FIFO (si l'option _fifo.file.enabled_ est activée, -elle l'est par défaut). - -Le tube FIFO est dans le répertoire WeeChat "runtime" et s'appelle -_weechat_fifo_12345_ par défaut (où _12345_ est le process id de WeeChat). - -La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est une -des suivantes : - -.... - plugin.buffer *texte ou commande ici - *texte ou commande ici -.... - -Quelques exemples : - -* Changer le pseudo sur libera en "autrepseudo" : - ----- -$ echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Envoyer un message sur le canal IRC #weechat : - ----- -$ echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Envoyer un message sur le tampon courant : - ----- -$ echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Envoyer deux commandes pour décharger/recharger les scripts Python (vous devez - les séparer par "\n") : - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Commandes - -include::includes/autogen_user_commands.fr.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Options - -Sections dans le fichier _fifo.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| file | /set fifo.file.* | Contrôle du tube FIFO. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=fifo_options] - -[[irc_plugin]] -=== IRC +[[irc]] +== IRC L'extension IRC permet de dialoguer avec d'autres personnes via le protocole IRC. @@ -3030,7 +2868,7 @@ compris la discussion directe (DCC chat) et le transfert de fichier DCC (via l'extension xfer, voir <<xfer_plugin,extension Xfer>>). [[irc_command_line_options]] -==== Options de ligne de commande +=== Options de ligne de commande Il est possible de passer une URL pour un ou plusieurs serveurs, comme suit : @@ -3046,10 +2884,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr ---- [[irc_servers]] -==== Serveurs +=== Serveurs [[irc_servers_add]] -===== Ajout d'un serveur +==== Ajout d'un serveur Par défaut aucun serveur n'est défini. Vous pouvez ajouter autant de serveurs que vous le souhaitez avec la commande <<command_irc_server,/server>>. @@ -3092,7 +2930,7 @@ vous obligent à être authentifié pour les rejoindre. Dans ce cas, vous pouvez définir un délai après la commande : `/set irc.server.libera.command_delay 5`. [[irc_servers_options]] -===== Options du serveur +==== Options du serveur Les options du serveur sont nommées `irc.server.<serveur>.<option>` où `<serveur>` est le nom interne du serveur et `<option>` le nom de l'option. + @@ -3164,7 +3002,7 @@ la valeur héritée, qui est maintenant `on` au lieu de la valeur par défaut `o ---- [[irc_ssl_certificates]] -===== Certificats SSL +==== Certificats SSL Lors de la connexion à un serveur IRC avec SSL, WeeChat vérifie par défaut que la connexion est entièrement de confiance. @@ -3195,7 +3033,7 @@ et peut échouer, même si cela pouvait être OK dans les versions inférieures 0.3.1. [[irc_connect_oftc_with_certificate]] -====== Premier exemple : se connecter à oftc en vérifiant le certificat +===== Premier exemple : se connecter à oftc en vérifiant le certificat * Importer le certificat sous le shell : @@ -3218,7 +3056,7 @@ Il est possible de concaténer plusieurs certificats dans le fichier CAs.pem. ---- [[irc_connect_oftc_with_certfp]] -====== Second exemple : se connecter à oftc en utilisant CertFP +===== Second exemple : se connecter à oftc en utilisant CertFP * Créer le certificat sous le shell : @@ -3243,7 +3081,7 @@ config WeeChat qui peut aussi être par exemple `~/.weechat`. Pour plus d'informations, consulter https://www.oftc.net/NickServ/CertFP [[irc_sasl_authentication]] -===== Authentification avec SASL +==== Authentification avec SASL WeeChat supporte l'authentification avec SASL, en utilisant différents mécanismes : @@ -3266,7 +3104,7 @@ Les options dans le serveur sont : _ecdsa-nist256p-challenge_) [[irc_sasl_ecdsa_nist256p_challenge]] -====== SASL ECDSA-NIST256P-CHALLENGE +===== SASL ECDSA-NIST256P-CHALLENGE Vous devez générer une clé privée pour vous authentifier avec le mécanisme ECDSA-NIST256P-CHALLENGE (aucun mot de passe n'est requis lors de la @@ -3313,7 +3151,7 @@ Reconnectez-vous au serveur : ---- [[irc_servers_connection]] -===== Connexion +==== Connexion Vous pouvez vous connecter au serveur avec la commande <<command_irc_connect,/connect>> : @@ -3346,7 +3184,7 @@ un tampon distinct par serveur : ---- [[irc_tor_sasl]] -===== Connexion avec TOR et SASL +==== Connexion avec TOR et SASL Quelques serveurs acceptent les connexions avec TOR (https://www.torproject.org/), un réseau de tunnels virtuels qui permet aux personnes et groupes d'améliorer @@ -3395,7 +3233,7 @@ Et enfin, connectez-vous au serveur : ---- [[irc_channels]] -==== Canaux +=== Canaux Vous pouvez rejoindre des canaux avec la commande <<command_irc_join,/join>> : @@ -3431,7 +3269,7 @@ des clés, par exemple si `#canal1` requiert une clé mais pas `#canal2`: Pour de l'aide sur le format, voir `/help irc.server.libera.autojoin`. [[irc_private_messages]] -==== Messages privés +=== Messages privés Vous pouvez envoyer un message privé avec la commande <<command_irc_query,/query>>, qui ouvre un tampon séparé : @@ -3455,7 +3293,7 @@ privé : ---- [[irc_smart_filter_join_part_quit]] -==== Filtre intelligent pour les messages join/part/quit +=== Filtre intelligent pour les messages join/part/quit Un filtre intelligent est disponible pour filtrer les messages join/part/quit lorsque le pseudo n'a rien dit durant les X dernières minutes sur le canal. @@ -3492,7 +3330,7 @@ Si le pseudo n'a pas parlé durant les 5 dernières minutes, ses join et/ou part/quit seront cachés sur le canal. [[irc_ctcp_replies]] -==== Réponses CTCP +=== Réponses CTCP Il est possible de personnaliser les réponses CTCP, ou de bloquer certaines demandes CTCP (ne pas y répondre). @@ -3569,7 +3407,7 @@ Si les options CTCP ne sont pas définies (par défaut), les réponses CTCP sont |=== [[irc_target_buffer]] -==== Tampon cible pour les messages IRC +=== Tampon cible pour les messages IRC Il est possible de personnaliser le tampon cible pour les messages IRC (le tampon utilisé pour afficher le message) avec les options `+irc.msgbuffer.*+`. @@ -3703,12 +3541,12 @@ seulement : ---- [[irc_commands]] -==== Commandes +=== Commandes include::includes/autogen_user_commands.fr.adoc[tag=irc_commands] [[irc_options]] -==== Options +=== Options Sections dans le fichier _irc.conf_ : @@ -3730,6 +3568,168 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=irc_options] +[[plugins]] +== Extensions + +Une extension est une bibliothèque dynamique, écrite en C et compilée, qui est +chargée par WeeChat. +Sous GNU/Linux, ce fichier a une extension ".so", et ".dll" sous Windows. + +Les extensions trouvées sont automatiquement chargées par WeeChat lorsqu'il +démarre, et il est possible de charger et décharger des extensions pendant que +WeeChat tourne. + +Il est important de bien faire la différence entre une _extension_ et un +_script_ : une _extension_ est un fichier binaire compilé et chargé avec la +commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une +extension comme _python_ par la commande `/python`. + +Vous pouvez utiliser la commande `/plugin` pour charger/décharger une +extension, ou afficher les extensions chargées. + +Quand une extension est déchargée, WeeChat supprime : + +* les tampons +* les options de configuration (les options sont écrites dans les fichiers) +* tous les "hooks" : commandes, modificateurs, processus, etc. +* les infos et infolists +* les "hdata" +* les objets de barre. + +Exemples pour charger, décharger et afficher les extensions : + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Les extensions par défaut sont : + +[width="100%",cols="1,5",options="header"] +|=== +| Extension | Description +| alias | Définition d'alias pour les commandes. +| buflist | Objet de barre avec la liste des tampons. +| charset | Encodage/encodage avec jeu de caractère sur les tampons. +| exec | Exécution de commandes externes dans WeeChat. +| fifo | Tube FIFO pour envoyer des commandes à distance vers WeeChat. +| fset | Modification rapide des options de WeeChat et des extensions. +| irc | Discussion avec le protocole IRC. +| logger | Enregistrement des tampons dans des fichiers. +| relay | Relai de données via le réseau. +| script | Gestionnaire de scripts. +| python | Interface (API) pour scripts Python. +| perl | Interface (API) pour scripts Perl. +| ruby | Interface (API) pour scripts Ruby. +| lua | Interface (API) pour scripts Lua. +| tcl | Interface (API) pour scripts Tcl. +| guile | Interface (API) pour scripts Guile (scheme). +| javascript | Interface (API) pour scripts JavaScript. +| php | Interface (API) pour scripts PHP. +| spell | Vérification orthographique de la ligne de commande. +| trigger | Remplacement de texte et exécution de commande sur des évènements de WeeChat ou des extensions. +| typing | Affichage des utilisateurs qui sont en train d'écrire des messages. +| xfer | Transfert de fichier et discussion directe. +|=== + +Pour en apprendre plus sur le développement d'extension ou de script (via +l'API), merci de consulter la +link:weechat_plugin_api.fr.html[Référence API extension WeeChat] ou le +link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. + +[[exec_plugin]] +=== Exec + +La commande `/exec` vous permet de lancer des commandes externes dans WeeChat et +d'afficher la sortie localement, ou de l'envoyer à un tampon. + +[[exec_commands]] +==== Commandes + +include::includes/autogen_user_commands.fr.adoc[tag=exec_commands] + +[[exec_options]] +==== Options + +Sections dans le fichier _exec.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| command | /set exec.command.* | Options pour les commandes. +| color | /set exec.color.* | Couleurs. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du +texte dans un tube FIFO (si l'option _fifo.file.enabled_ est activée, +elle l'est par défaut). + +Le tube FIFO est dans le répertoire WeeChat "runtime" et s'appelle +_weechat_fifo_12345_ par défaut (où _12345_ est le process id de WeeChat). + +La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est une +des suivantes : + +.... + plugin.buffer *texte ou commande ici + *texte ou commande ici +.... + +Quelques exemples : + +* Changer le pseudo sur libera en "autrepseudo" : + +---- +$ echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Envoyer un message sur le canal IRC #weechat : + +---- +$ echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Envoyer un message sur le tampon courant : + +---- +$ echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Envoyer deux commandes pour décharger/recharger les scripts Python (vous devez + les séparer par "\n") : + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Commandes + +include::includes/autogen_user_commands.fr.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Options + +Sections dans le fichier _fifo.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| file | /set fifo.file.* | Contrôle du tube FIFO. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=fifo_options] + [[logger_plugin]] === Logger diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index cfc6f644a..0c9abe41e 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -267,7 +267,7 @@ List of commonly used options: Compile <<scripts_plugins,Guile plugin>> (Scheme). | ENABLE_IRC | `ON`, `OFF` | ON | - Compile <<irc_plugin,IRC plugin>>. + Compile <<irc,IRC plugin>>. | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF | Compile <<scripts_plugins,JavaScript plugin>>. @@ -2994,181 +2994,8 @@ Options: include::includes/autogen_user_options.it.adoc[tag=weechat_options] -[[plugins]] -== Plugin - -Un plugin è una libreria dinamica, scritta in C e compilata, che viene caricata -da WeeChat. -In GNU/Linux, il file ha estensione ".so", ".dll" in Windows. - -I plugin trovati vengono caricati automaticamente all'avvio di WeeChat, ed -è possibile caricare o scaricare i plugin durante l'esecuzione del programma. - -È importante evidenziare la differenza tra un _plugin_ ed uno _script_: un -_plugin_ è un file binario compilato e caricato con il comando `/plugin`, -mentre uno _script_ è un file di testo caricato con un plugin come _python_ -con il comando `/python`. - -È possibile utilizzare il comando `/plugin` per caricare/scaricare un plugin, -oppure elencare tutti i plugin caricati. - -// TRANSLATION MISSING -When a plugin is unloaded, WeeChat removes: - -* buffers -* configuration options (options are written in files) -* all hooks: commands, modifiers, process, etc. -* infos and infolists -* hdata -* bar items. - -Esempi per caricare, scaricare oppure elencare i plugin: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -I plugin predefiniti sono: - -[width="100%",cols="1,5",options="header"] -|=== -| Plugin | Descrizione -| alias | Definisce gli alias per i comandi. -// TRANSLATION MISSING -| buflist | Bar item with list of buffers. -| charset | Set di caratteri per la codifica/decodifica nei buffer. -// TRANSLATION MISSING -| exec | Execution of external commands in WeeChat. -| fifo | pipe FIFO utilizzata per inviare comandi da remoto su WeeChat. -// TRANSLATION MISSING -| fset | Fast set of WeeChat and plugins options. -| irc | protocollo chat per IRC. -| logger | Registra i buffer su file. -| relay | Relay dei dati via rete. -| script | Gestore script. -| python | API per lo scripting in Python. -| perl | API per lo scripting in Perl. -| ruby | API per lo scripting in Ruby. -| lua | API per lo scripting in Lua. -| tcl | API per lo scripting in TCL. -| guile | API per lo scripting in Guile (scheme). -| javascript | API per lo scripting in JavaScript. -| php | API per lo scripting in PHP. -| spell | Controllo ortografico per la riga di comando. -// TRANSLATION MISSING -| trigger | Text replacement and command execution on events triggered by WeeChat/plugins. -// TRANSLATION MISSING -| typing | Display users currently writing messages. -| xfer | Trasferimento file e chat diretta. -|=== - -Per saperne di più riguardo lo sviluppo di plugin o script (tramite le API), per -favore consultare link:weechat_plugin_api.it.html[Riferimento API dei Plugin per WeeChat] -oppure link:weechat_scripting.it.html[Guida allo Scripting di WeeChat]. - -// TRANSLATION MISSING -[[exec_plugin]] -=== Exec - -The `/exec` command lets you execute external commands inside WeeChat and -display the output locally, or send it to a buffer. - -[[exec_commands]] -==== Comandi - -include::includes/autogen_user_commands.it.adoc[tag=exec_commands] - -[[exec_options]] -==== Opzioni - -// TRANSLATION MISSING -Sections in file _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| command | /set exec.command.* | Options for commands. -| color | /set exec.color.* | Colors. -|=== - -Options: - -include::includes/autogen_user_options.it.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -È possibile controllare da remoto WeeChat, inviando comandi o del testo ad una -pipe FIFO (se l'opzione "fifo.file.enabled" è abilitata, e lo è per default). - -// TRANSLATION MISSING -The FIFO pipe is located in WeeChat runtime directory and is called -_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). - -La sintassi per i comandi/testo della pipe FIFO è una delle seguenti: - -.... - plugin.buffer *testo o comando qui - *testo o comando qui -.... - -Alcuni esempi: - -// TRANSLATION MISSING -* Change nick on IRC server libera to "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -// TRANSLATION MISSING -* Send a message on IRC #weechat channel: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -// TRANSLATION MISSING -* Send a message on current buffer: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Inviare due comandi per scaricare/caricare gli script Python (è necessario - separarli con "\n"): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Comandi - -include::includes/autogen_user_commands.it.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Opzioni - -// TRANSLATION MISSING -Sections in file _fifo.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| file | /set fifo.file.* | FIFO pipe control. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=fifo_options] - -[[irc_plugin]] -=== IRC +[[irc]] +== IRC Il plugin IRC è realizzato per chattare tramite protocollo IRC con altre persone. @@ -3176,7 +3003,7 @@ Il plugin IRC è realizzato per chattare tramite protocollo IRC con altre person trasferimento file (tramite plugin xfer, consultare <<xfer_plugin,plugin Xfer>>). [[irc_command_line_options]] -==== Opzioni a riga di comando +=== Opzioni a riga di comando È possibile fornire un URL per uno o più server IRC, come segue: @@ -3193,10 +3020,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr // TRANSLATION MISSING [[irc_servers]] -==== Servers +=== Servers [[irc_servers_add]] -===== Add a server +==== Add a server By default no servers are defined. You can add as many servers as you want with the <<command_irc_server,/server>> command. @@ -3236,7 +3063,7 @@ to join. In this case, you can set a command delay: `/set irc.server.libera.command_delay 5`. [[irc_servers_options]] -===== Server options +==== Server options Server options are named `irc.server.<server>.<option>` where `<server>` is the internal name of the server and `<option>` the name of an option. + @@ -3308,7 +3135,7 @@ value, which is now `on` instead of the default value `off`: ---- [[irc_ssl_certificates]] -===== Certificati SSL +==== Certificati SSL Al momento della connessione al server IRC con SSL, WeeChat verifica in maniera predefinita che la connessione sia completamente fidata. @@ -3341,7 +3168,7 @@ e potrebbe fallire, anche se funziona senza problemi con versioni precedenti la 0.3.1. [[irc_connect_oftc_with_certificate]] -====== Primo esempio: connessione a otfc e verifica del certificato +===== Primo esempio: connessione a otfc e verifica del certificato * Importare certificati nella shell: @@ -3367,7 +3194,7 @@ E possibile concatenare più certificati nel file CAs.pem. ---- [[irc_connect_oftc_with_certfp]] -====== Secondo esempio: connessione a otfc con CertFP +===== Secondo esempio: connessione a otfc con CertFP * Creare un certificato nella shell: @@ -3394,7 +3221,7 @@ which can also be for example `~/.weechat`. Per maggiori informazioni consultare https://www.oftc.net/NickServ/CertFP [[irc_sasl_authentication]] -===== Autenticazione SASL +==== Autenticazione SASL // TRANSLATION MISSING WeeChat supports SASL authentication, using different mechanisms: @@ -3426,7 +3253,7 @@ Le opzioni nel server sono: // TRANSLATION MISSING [[irc_sasl_ecdsa_nist256p_challenge]] -====== SASL ECDSA-NIST256P-CHALLENGE +===== SASL ECDSA-NIST256P-CHALLENGE You must generate a private key in order to authentify with the ECDSA-NIST256P-CHALLENGE mechanism (no password is required on connection). @@ -3473,7 +3300,7 @@ Reconnect to the server: // TRANSLATION MISSING [[irc_servers_connection]] -===== Connection +==== Connection You can connect to server with the <<command_irc_connect,/connect>> command: @@ -3505,7 +3332,7 @@ server buffers: // TRANSLATION MISSING [[irc_tor_sasl]] -===== Connect with TOR and SASL +==== Connect with TOR and SASL // TRANSLATION MISSING Some servers support connections with TOR (https://www.torproject.org/), @@ -3558,7 +3385,7 @@ And finally, connect to the server: // TRANSLATION MISSING [[irc_channels]] -==== Channels +=== Channels You can join channels with the <<command_irc_join,/join>> command: @@ -3593,7 +3420,7 @@ for example if `#channel1` requires a key but not `#channel2`: For help on the format, see `/help irc.server.libera.autojoin`. [[irc_private_messages]] -==== Private messages +=== Private messages You can send a private message with the <<command_irc_query,/query>> command, which opens a separate buffer: @@ -3615,7 +3442,7 @@ To close the private buffer, you can do this command on the private buffer: ---- [[irc_smart_filter_join_part_quit]] -==== Filtro smart per i messaggi di entrata/uscita/disconnessione +=== Filtro smart per i messaggi di entrata/uscita/disconnessione Un filtro smart è disponibile per filtrare i messaggi di entrata/uscita/disconnessione quando il nick non ha detto nulla durante @@ -3654,7 +3481,7 @@ Se un nick non ha parlato durante gli ultimi 5 minuti, i suoi ingressi e/o uscite/disconnessioni verranno nascosti sul canale. [[irc_ctcp_replies]] -==== Risposte CTCP +=== Risposte CTCP È possibile personalizzare le risposte CTCP, o bloccare alcune richieste CTCP (non rispondere). @@ -3735,7 +3562,7 @@ le risposte CTCP sono: |=== [[irc_target_buffer]] -==== Buffer di destinazione per i messaggi IRC +=== Buffer di destinazione per i messaggi IRC È possibile personalizzare il buffer di destinazione per i messaggi IRC (buffer usato per visualizzare messaggi) con l'opzione `+irc.msgbuffer.*+`. @@ -3876,12 +3703,12 @@ Alcuni esempi: ---- [[irc_commands]] -==== Comandi +=== Comandi include::includes/autogen_user_commands.it.adoc[tag=irc_commands] [[irc_options]] -==== Opzioni +=== Opzioni // TRANSLATION MISSING Sections in file _irc.conf_: @@ -3906,6 +3733,179 @@ Options: include::includes/autogen_user_options.it.adoc[tag=irc_options] +[[plugins]] +== Plugin + +Un plugin è una libreria dinamica, scritta in C e compilata, che viene caricata +da WeeChat. +In GNU/Linux, il file ha estensione ".so", ".dll" in Windows. + +I plugin trovati vengono caricati automaticamente all'avvio di WeeChat, ed +è possibile caricare o scaricare i plugin durante l'esecuzione del programma. + +È importante evidenziare la differenza tra un _plugin_ ed uno _script_: un +_plugin_ è un file binario compilato e caricato con il comando `/plugin`, +mentre uno _script_ è un file di testo caricato con un plugin come _python_ +con il comando `/python`. + +È possibile utilizzare il comando `/plugin` per caricare/scaricare un plugin, +oppure elencare tutti i plugin caricati. + +// TRANSLATION MISSING +When a plugin is unloaded, WeeChat removes: + +* buffers +* configuration options (options are written in files) +* all hooks: commands, modifiers, process, etc. +* infos and infolists +* hdata +* bar items. + +Esempi per caricare, scaricare oppure elencare i plugin: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +I plugin predefiniti sono: + +[width="100%",cols="1,5",options="header"] +|=== +| Plugin | Descrizione +| alias | Definisce gli alias per i comandi. +// TRANSLATION MISSING +| buflist | Bar item with list of buffers. +| charset | Set di caratteri per la codifica/decodifica nei buffer. +// TRANSLATION MISSING +| exec | Execution of external commands in WeeChat. +| fifo | pipe FIFO utilizzata per inviare comandi da remoto su WeeChat. +// TRANSLATION MISSING +| fset | Fast set of WeeChat and plugins options. +| irc | protocollo chat per IRC. +| logger | Registra i buffer su file. +| relay | Relay dei dati via rete. +| script | Gestore script. +| python | API per lo scripting in Python. +| perl | API per lo scripting in Perl. +| ruby | API per lo scripting in Ruby. +| lua | API per lo scripting in Lua. +| tcl | API per lo scripting in TCL. +| guile | API per lo scripting in Guile (scheme). +| javascript | API per lo scripting in JavaScript. +| php | API per lo scripting in PHP. +| spell | Controllo ortografico per la riga di comando. +// TRANSLATION MISSING +| trigger | Text replacement and command execution on events triggered by WeeChat/plugins. +// TRANSLATION MISSING +| typing | Display users currently writing messages. +| xfer | Trasferimento file e chat diretta. +|=== + +Per saperne di più riguardo lo sviluppo di plugin o script (tramite le API), per +favore consultare link:weechat_plugin_api.it.html[Riferimento API dei Plugin per WeeChat] +oppure link:weechat_scripting.it.html[Guida allo Scripting di WeeChat]. + +// TRANSLATION MISSING +[[exec_plugin]] +=== Exec + +The `/exec` command lets you execute external commands inside WeeChat and +display the output locally, or send it to a buffer. + +[[exec_commands]] +==== Comandi + +include::includes/autogen_user_commands.it.adoc[tag=exec_commands] + +[[exec_options]] +==== Opzioni + +// TRANSLATION MISSING +Sections in file _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| command | /set exec.command.* | Options for commands. +| color | /set exec.color.* | Colors. +|=== + +Options: + +include::includes/autogen_user_options.it.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +È possibile controllare da remoto WeeChat, inviando comandi o del testo ad una +pipe FIFO (se l'opzione "fifo.file.enabled" è abilitata, e lo è per default). + +// TRANSLATION MISSING +The FIFO pipe is located in WeeChat runtime directory and is called +_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). + +La sintassi per i comandi/testo della pipe FIFO è una delle seguenti: + +.... + plugin.buffer *testo o comando qui + *testo o comando qui +.... + +Alcuni esempi: + +// TRANSLATION MISSING +* Change nick on IRC server libera to "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +// TRANSLATION MISSING +* Send a message on IRC #weechat channel: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +// TRANSLATION MISSING +* Send a message on current buffer: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Inviare due comandi per scaricare/caricare gli script Python (è necessario + separarli con "\n"): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Comandi + +include::includes/autogen_user_commands.it.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Opzioni + +// TRANSLATION MISSING +Sections in file _fifo.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| file | /set fifo.file.* | FIFO pipe control. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=fifo_options] + [[logger_plugin]] === Logger diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index 656bfdec2..eb5cdccff 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -239,7 +239,7 @@ CMake に対するオプションを指定するには、以下の書式を使 <<scripts_plugins,Guile プラグイン>> (Scheme) のコンパイル。 | ENABLE_IRC | `ON`, `OFF` | ON | - <<irc_plugin,IRC プラグイン>>のコンパイル + <<irc,IRC プラグイン>>のコンパイル | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF | <<scripts_plugins,JavaScript プラグイン>>のコンパイル。 @@ -2871,169 +2871,8 @@ _weechat.conf_ ファイル内のセクション: include::includes/autogen_user_options.ja.adoc[tag=weechat_options] -[[plugins]] -== プラグイン - -プラグインとは動的ライブラリのことで、C -言語で書かれてコンパイルされています。プラグインは WeeChat によって読み込まれます。GNU/Linux -の場合、プラグインファイルは ".so" という拡張子を持ち、Windows の場合、".dll" です。 - -見つかったプラグインは WeeChat の起動時に自動的に読み込まれます。WeeChat -の起動時にプラグインを読み込むか否かは選択可能です。 - -_プラグイン_ と _スクリプト_ の違いを明らかにすることは重要です: -_プラグイン_ とは `/plugin` コマンドで読み込まれるコンパイル済みバイナリファイルです。これに対して、 -_スクリプト_ とは `/python` 等のコマンドで _python_ -等のプラグインとともに読み込まれるテキストファイルです。 - -`/plugin` -コマンドを使うことで、プラグインのロード/アンロード、ロード済みプラグインの表示を行うことができます。 - -// TRANSLATION MISSING -When a plugin is unloaded, WeeChat removes: - -* buffers -* configuration options (options are written in files) -* all hooks: commands, modifiers, process, etc. -* infos and infolists -* hdata -* bar items. - -プラグインをロード、アンロード、ロード済みプラグインを表示する例: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -デフォルトプラグインのリスト: - -[width="100%",cols="1,5",options="header"] -|=== -| プラグイン | 説明 -| alias | コマンドの別名を定義 -| buflist | バッファリストを表示するためのバー要素 -| charset | バッファの文字コードに従ってデコード/エンコード -| exec | WeeChat 内部から外部コマンドを実行 -| fifo | 外部から WeeChat にコマンドを送信するための FIFO パイプ -| fset | WeeChat とプラグインのオプションを高速設定 -| irc | IRC チャットプロトコル -| logger | バッファの内容をファイルに保存 -| relay | ネットワーク経由でデータを中継 -| script | スクリプトマネージャ -| python | Python スクリプト API -| perl | Perl スクリプト API -| ruby | Ruby スクリプト API -| lua | Lua スクリプト API -| tcl | Tcl スクリプト API -| guile | Guile (scheme) スクリプト API -| javascript | JavaScript スクリプト API -| php | PHP スクリプト API -| spell | コマンドラインのスペルチェック -| trigger | WeeChat およびプラグインが発生させたイベントに対するテキスト置換とコマンド実行 -// TRANSLATION MISSING -| typing | Display users currently writing messages. -| xfer | ファイル転送とダイレクトチャット -|=== - -API を使ったプラグインやスクリプトの開発についてより詳しく学ぶには -link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス]または -link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド]を参照してください。 - -[[exec_plugin]] -=== Exec - -`/exec` コマンドを使うことで WeeChat -内部から外部コマンドを実行し、その結果を表示したりバッファに送信することが可能になります。 - -[[exec_commands]] -==== コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=exec_commands] - -[[exec_options]] -==== オプション - -_exec.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| command | /set exec.command.* | コマンドに対するオプション -| color | /set exec.color.* | 色 -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -外部から WeeChat を操作するには、FIFO パイプにコマンドやテキストを書き込んでください ("fifo.file.enabled" -オプションが有効化されている必要がありますが、デフォルトで有効化されているはずです)。 - -// TRANSLATION MISSING -The FIFO pipe is located in WeeChat runtime directory and is called -_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). - -FIFO パイプに書き込むコマンド/テキストの文法は以下の例の一つです: - -.... - plugin.buffer *テキストまたはコマンド - *テキストまたはコマンド -.... - -例: - -* IRC サーバ libera で使うニックネームを "newnick" に変更する: - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* IRC チャンネル #weechat に対してテキストを送信: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* 現在のバッファに対してテキストを送信: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Python スクリプトのアンロードとロードを行う 2 つのコマンドを送信 - (複数のコマンドは "\n" で分割してください): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== コマンド - -include::includes/autogen_user_commands.ja.adoc[tag=fifo_commands] - -[[fifo_options]] -==== オプション - -_fifo.conf_ ファイル内のセクション: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| セクション | 操作コマンド | 説明 -| file | /set fifo.file.* | FIFO パイプに関するオプション -|=== - -オプション: - -include::includes/autogen_user_options.ja.adoc[tag=fifo_options] - -[[irc_plugin]] -=== IRC +[[irc]] +== IRC IRC プラグインは IRC プロトコルに従って他の人と会話を行うために設計されています。 @@ -3041,7 +2880,7 @@ IRC プラグインは IRC プロトコルに従って他の人と会話を行 プラグインを使います。<<xfer_plugin,Xfer プラグイン>>を参照) を含む全ての IRC コマンドをサポートしています。 [[irc_command_line_options]] -==== コマンドラインオプション +=== コマンドラインオプション 以下のように 1 つ以上の IRC サーバに対応する URL を引数として与えることができます: @@ -3058,10 +2897,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr // TRANSLATION MISSING [[irc_servers]] -==== Servers +=== Servers [[irc_servers_add]] -===== Add a server +==== Add a server By default no servers are defined. You can add as many servers as you want with the <<command_irc_server,/server>> command. @@ -3101,7 +2940,7 @@ to join. In this case, you can set a command delay: `/set irc.server.libera.command_delay 5`. [[irc_servers_options]] -===== Server options +==== Server options Server options are named `irc.server.<server>.<option>` where `<server>` is the internal name of the server and `<option>` the name of an option. + @@ -3173,7 +3012,7 @@ value, which is now `on` instead of the default value `off`: ---- [[irc_ssl_certificates]] -===== SSL 証明書 +==== SSL 証明書 SSL を使って IRC サーバに接続する場合、WeeChat はデフォルトで接続が完全に信頼できるものかどうかを確認します。 @@ -3204,7 +3043,7 @@ irc.server.xxx.ssl_verify:: より前のバージョンでは信頼性の確認に成功していたものが失敗する場合もあります。 [[irc_connect_oftc_with_certificate]] -====== 最初の例: oftc に接続して、証明書を確認 +===== 最初の例: oftc に接続して、証明書を確認 * シェルを使って証明書をインポート: @@ -3228,7 +3067,7 @@ CAs.pem ファイル中で複数の証明書を連結することもできます ---- [[irc_connect_oftc_with_certfp]] -====== 2 番目の例: CertFP を使って oftc に接続 +===== 2 番目の例: CertFP を使って oftc に接続 * シェルで証明書を作成: @@ -3254,7 +3093,7 @@ which can also be for example `~/.weechat`. より詳しい情報は https://www.oftc.net/NickServ/CertFP を確認してください。 [[irc_sasl_authentication]] -===== SASL 認証 +==== SASL 認証 WeeChat は SASL 認証をサポートします、以下の認証メカニズムを利用できます: @@ -3279,7 +3118,7 @@ WeeChat は SASL 認証をサポートします、以下の認証メカニズム (_ecdsa-nist256p-challenge_ 用) [[irc_sasl_ecdsa_nist256p_challenge]] -====== SASL ECDSA-NIST256P-CHALLENGE 認証 +===== SASL ECDSA-NIST256P-CHALLENGE 認証 ECDSA-NIST256P-CHALLENGE を使って認証を行うためには、秘密鍵を作成してください (接続の際にパスワードは不要です)。 @@ -3327,7 +3166,7 @@ $ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem // TRANSLATION MISSING [[irc_servers_connection]] -===== Connection +==== Connection You can connect to server with the <<command_irc_connect,/connect>> command: @@ -3359,7 +3198,7 @@ server buffers: // TRANSLATION MISSING [[irc_tor_sasl]] -===== Connect with TOR and SASL +==== Connect with TOR and SASL // TRANSLATION MISSING Some servers support connections with TOR (https://www.torproject.org/), @@ -3410,7 +3249,7 @@ And finally, connect to the server: // TRANSLATION MISSING [[irc_channels]] -==== Channels +=== Channels You can join channels with the <<command_irc_join,/join>> command: @@ -3445,7 +3284,7 @@ for example if `#channel1` requires a key but not `#channel2`: For help on the format, see `/help irc.server.libera.autojoin`. [[irc_private_messages]] -==== Private messages +=== Private messages You can send a private message with the <<command_irc_query,/query>> command, which opens a separate buffer: @@ -3467,7 +3306,7 @@ To close the private buffer, you can do this command on the private buffer: ---- [[irc_smart_filter_join_part_quit]] -==== 参加/退出/終了メッセージに対するスマートフィルタ +=== 参加/退出/終了メッセージに対するスマートフィルタ チャンネル内での発言が過去 X 分間なかった場合に参加/退出/終了メッセージをフィルタリングするスマートフィルタが利用できます。 @@ -3503,7 +3342,7 @@ To close the private buffer, you can do this command on the private buffer: 分間あるニックネームからの発言が無かった場合、このニックネームに対する参加または退出/終了メッセージがチャンネルから隠されます。 [[irc_ctcp_replies]] -==== CTCP 応答 +=== CTCP 応答 CTCP 応答をカスタマイズしたり、いくつかの CTCP 要求をブロック (無応答) することができます。 @@ -3578,7 +3417,7 @@ CTCP オプションが設定されていない (デフォルトの) 場合、CT |=== [[irc_target_buffer]] -==== IRC メッセージのターゲットバッファ +=== IRC メッセージのターゲットバッファ `+irc.msgbuffer.*+` オプションを使えば、IRC メッセージに対するターゲットバッファ (メッセージを表示するバッファ) をカスタマイズすることができます。 @@ -3710,12 +3549,12 @@ weechat:: ---- [[irc_commands]] -==== コマンド +=== コマンド include::includes/autogen_user_commands.ja.adoc[tag=irc_commands] [[irc_options]] -==== オプション +=== オプション _irc.conf_ ファイル内のセクション: @@ -3737,6 +3576,167 @@ _irc.conf_ ファイル内のセクション: include::includes/autogen_user_options.ja.adoc[tag=irc_options] +[[plugins]] +== プラグイン + +プラグインとは動的ライブラリのことで、C +言語で書かれてコンパイルされています。プラグインは WeeChat によって読み込まれます。GNU/Linux +の場合、プラグインファイルは ".so" という拡張子を持ち、Windows の場合、".dll" です。 + +見つかったプラグインは WeeChat の起動時に自動的に読み込まれます。WeeChat +の起動時にプラグインを読み込むか否かは選択可能です。 + +_プラグイン_ と _スクリプト_ の違いを明らかにすることは重要です: +_プラグイン_ とは `/plugin` コマンドで読み込まれるコンパイル済みバイナリファイルです。これに対して、 +_スクリプト_ とは `/python` 等のコマンドで _python_ +等のプラグインとともに読み込まれるテキストファイルです。 + +`/plugin` +コマンドを使うことで、プラグインのロード/アンロード、ロード済みプラグインの表示を行うことができます。 + +// TRANSLATION MISSING +When a plugin is unloaded, WeeChat removes: + +* buffers +* configuration options (options are written in files) +* all hooks: commands, modifiers, process, etc. +* infos and infolists +* hdata +* bar items. + +プラグインをロード、アンロード、ロード済みプラグインを表示する例: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +デフォルトプラグインのリスト: + +[width="100%",cols="1,5",options="header"] +|=== +| プラグイン | 説明 +| alias | コマンドの別名を定義 +| buflist | バッファリストを表示するためのバー要素 +| charset | バッファの文字コードに従ってデコード/エンコード +| exec | WeeChat 内部から外部コマンドを実行 +| fifo | 外部から WeeChat にコマンドを送信するための FIFO パイプ +| fset | WeeChat とプラグインのオプションを高速設定 +| irc | IRC チャットプロトコル +| logger | バッファの内容をファイルに保存 +| relay | ネットワーク経由でデータを中継 +| script | スクリプトマネージャ +| python | Python スクリプト API +| perl | Perl スクリプト API +| ruby | Ruby スクリプト API +| lua | Lua スクリプト API +| tcl | Tcl スクリプト API +| guile | Guile (scheme) スクリプト API +| javascript | JavaScript スクリプト API +| php | PHP スクリプト API +| spell | コマンドラインのスペルチェック +| trigger | WeeChat およびプラグインが発生させたイベントに対するテキスト置換とコマンド実行 +// TRANSLATION MISSING +| typing | Display users currently writing messages. +| xfer | ファイル転送とダイレクトチャット +|=== + +API を使ったプラグインやスクリプトの開発についてより詳しく学ぶには +link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス]または +link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド]を参照してください。 + +[[exec_plugin]] +=== Exec + +`/exec` コマンドを使うことで WeeChat +内部から外部コマンドを実行し、その結果を表示したりバッファに送信することが可能になります。 + +[[exec_commands]] +==== コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=exec_commands] + +[[exec_options]] +==== オプション + +_exec.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| command | /set exec.command.* | コマンドに対するオプション +| color | /set exec.color.* | 色 +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +外部から WeeChat を操作するには、FIFO パイプにコマンドやテキストを書き込んでください ("fifo.file.enabled" +オプションが有効化されている必要がありますが、デフォルトで有効化されているはずです)。 + +// TRANSLATION MISSING +The FIFO pipe is located in WeeChat runtime directory and is called +_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). + +FIFO パイプに書き込むコマンド/テキストの文法は以下の例の一つです: + +.... + plugin.buffer *テキストまたはコマンド + *テキストまたはコマンド +.... + +例: + +* IRC サーバ libera で使うニックネームを "newnick" に変更する: + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* IRC チャンネル #weechat に対してテキストを送信: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* 現在のバッファに対してテキストを送信: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Python スクリプトのアンロードとロードを行う 2 つのコマンドを送信 + (複数のコマンドは "\n" で分割してください): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== コマンド + +include::includes/autogen_user_commands.ja.adoc[tag=fifo_commands] + +[[fifo_options]] +==== オプション + +_fifo.conf_ ファイル内のセクション: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| セクション | 操作コマンド | 説明 +| file | /set fifo.file.* | FIFO パイプに関するオプション +|=== + +オプション: + +include::includes/autogen_user_options.ja.adoc[tag=fifo_options] + [[logger_plugin]] === Logger diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index ae513b0a0..eec091478 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -235,7 +235,7 @@ Lista popularnych opcji: Kompilacja <<scripts_plugins,wtyczki guile>> (Scheme). | ENABLE_IRC | `ON`, `OFF` | ON | - Kompilacja <<irc_plugin,wtyczki IRC>>. + Kompilacja <<irc,wtyczki IRC>>. | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF | Kompilacja <<scripts_plugins,wtyczki javascript>>. @@ -2809,167 +2809,8 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=weechat_options] -[[plugins]] -== Wtyczki - -Wtyczka jest biblioteka dynamiczną, napisaną w C i skompilowaną, która jest -ładowana przez WeeChat. -W systemach GNU/Linux plik ma rozszerzenie ".so", w Windowsie ".dll". - -Znalezione wtyczki są automatycznie ładowane podczas uruchamiania WeeChat, -możliwe jest również ładowanie lub wyładowywanie wtyczek podczas pracy WeeChat. - -Ważne jest, aby odróżniać _wtyczkę_ od _skryptu_: _wtyczka_ jest to plik binarny -skompilowany i ładowany za pomocą polecenia `/plugin`, natomiast _skrypt_ to -plik tekstowy, ładowany za pomocą wtyczki jak na przykład _python_ za pomocą -polecenia `/python`. - -Możesz użyć komendy `/plugin` żeby załadować/wyładować wtyczkę, lub wyświetlić -wszystkie załadowane wtyczki. - -Podcza wyładowywania wtyczki WeeChat usówa: - -* bufory -* opcje konfiguracyjne (options są zapisywane w plikach) -* wszystkie hooki: komendy, modyfikatory, procesy, etc. -* infos i infolists -* hdata -* elementy pasków. - -Przykłady ładowania, wyładowywania i wyświetlania załadowanych wtyczek: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Domyślne wtyczki: - -[width="100%",cols="1,5",options="header"] -|=== -| Wtyczka | Opis -| alias | Definiuje aliasy dla komend. -| buflist | Element paska z listą buforów. -| charset | Ustawianie kodowania dla buforów. -| exec | Wykonuje zewnętrzną komendę z poziomu WeeChat. -| fifo | Kolejka FIFO używana do zdalnego wysyłania poleceń dla WeeChat. -| fset | Szybkie ustawianie opcji WeeChat i wtyczek. -| irc | Protokół IRC. -| logger | Logowanie zawartości buforów do plików. -| relay | Przekazuje dane przez sieć. -| script | Zarządzanie skryptami. -| python | Wsparcie dla skryptów napisanych w Pythonie. -| perl | Wsparcie dla skryptów napisanych w Perlu. -| ruby | Wsparcie dla skryptów napisanych w Ruby. -| lua | Wsparcie dla skryptów napisanych w Lua. -| tcl | Wsparcie dla skryptów napisanych w Tcl. -| guile | Wsparcie dla skryptów napisanych w Guile (scheme). -| javascript | Wsparcie dla skryptów napisanych w JavaScript. -| php | Wsparcie dla skryptów napisanych w PHP. -| spell | Sprawdzanie pisowni w linii poleceń. -| trigger | Zamiana tekstu i wykonywanie komend dla zdarzeń wywołanych przez WeeChat/wtyczki. -| typing | Pokazuje użytkowników obecnie piszących wiadomości. -| xfer | Przesyłanie plików i bezpośredni chat. -|=== - -Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleźć w -link:weechat_plugin_api.en.html[Opisie API wtyczek] (Angielski) i -link:weechat_scripting.pl.html[Poradniku pisania skryptów]. - -[[exec_plugin]] -=== Exec - -Komenda `/exec` pozwala wykonać zewnętrzne polecenie wewnątrz WeeChat i wyświetlić -jej wynik lokalnie lub wysłać do bufora. - -[[exec_commands]] -==== Komendy - -include::includes/autogen_user_commands.pl.adoc[tag=exec_commands] - -[[exec_options]] -==== Opcje - -Sekcje w pliku _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| command | /set exec.command.* | Opcje dla komend. -| color | /set exec.color.* | Kolory. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Możesz zdalnie kontrolować WeeChat, poprzez wysyłanie komend lub tekstu do -kolejki FIFO (jeśli opcja "fifo.file.enabled" jest włączona, domyślnie jest -włączona). - -Strumień FIFO jest zlokalizowany w katalogu uruchomieniowym WeeChat i ma -domyślnie nazwę weechat_fifo_12345_ (gdzie _12345_ to numer procesu WeeChat). - -Składnia dla komend/tekstu przekazywanego do kolejki FIFO wygląda następująco: - -.... - wtyczka.bufor *tekst lub komenda - *tekst lub komenda -.... - -Kilka przykładów: - -* Zmiana nicka na serwerze IRC libera na "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Wysłanie wiadomości na kanał IRC #weechat: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Wysłanie wiadomości do obecnego bufora: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Wysłanie dwóch komend do wyładowania/przeładowania skryptów Python (należy - oddzielić je za pomocą "\n"): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Komendy - -include::includes/autogen_user_commands.pl.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Opcje - -Sekcje w pliku _fifo.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Sekcja | Komenda | Opis -| plik | /set fifo.file.* | Kontrola kolejki FIFO. -|=== - -Opcje: - -include::includes/autogen_user_options.pl.adoc[tag=fifo_options] - -[[irc_plugin]] -=== IRC +[[irc]] +== IRC Wtyczka IRC jest zaprojektowana do prowadzenia rozmów z innymi osobami przez protokół IRC. @@ -2979,7 +2820,7 @@ rozmowami DCC i transferami plików (poprzez wtyczkę xfer, zobacz <<xfer_plugin,Wtyczka xfer>>). [[irc_command_line_options]] -==== Opcje z linii poleceń +=== Opcje z linii poleceń Możliwe jest podanie adresu URL do jednego lub wielu serwerów IRC: @@ -2995,10 +2836,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr ---- [[irc_servers]] -==== Serwery +=== Serwery [[irc_servers_add]] -===== Dodanie serwera +==== Dodanie serwera Domyślnie nie są zdefiniowane żadne serwery. Możesz dodać ich tyle ile chcesz za pomocą polecenia <<command_irc_server,/server>>. @@ -3040,7 +2881,7 @@ uwierzytelnione osoby. W takim przypadku możesz ustawić opóźnienie dla komendy: `/set irc.server.libera.command_delay 5`. [[irc_servers_options]] -===== Opcje serwerów +==== Opcje serwerów Opcje serwerów są nazywane w taki sposób `irc.server.<serwer>.<opcja>`, gdzie `<serwer>` to zdefiniowana nazwa serwera, `<opcja>` to nazwa opcji. + @@ -3106,14 +2947,14 @@ zrobić za pomocą: ---- Następnie możesz zresetować opcję serwera do jej domyślnej (dziedziczonej) -wartości, która teraz ma wartość `on` zamiast domyślnego `off`: +wartości, która teraz ma wartość `on` zamiast domyślnego `off`: ---- /unset irc.server.libera.autoconnect ---- [[irc_ssl_certificates]] -===== Certyfikaty SSL +==== Certyfikaty SSL Podczas łączenia się z serwerem IRC, WeeChat domyślnie sprawdza czy połączenie jest w pełni zaufane. @@ -3141,7 +2982,7 @@ Opcja "ssl_verify" jest domyślnie włączona, weryfikacja jest restrykcyjna i m się nie powieść, nawet jeśli wszystko było OK w wersjach przed 0.3.1. [[irc_connect_oftc_with_certificate]] -====== Pierwszy przykład: połączenie z oftc i sprawdzenie certyfikatu +===== Pierwszy przykład: połączenie z oftc i sprawdzenie certyfikatu * Import certyfikatu w kosoli: @@ -3164,7 +3005,7 @@ Możliwe jest umieszczenie wielu certyfikatów w pliku CAs.pem. ---- [[irc_connect_oftc_with_certfp]] -====== Drugi przykład: połączenie z oftc używając CertFP +===== Drugi przykład: połączenie z oftc używając CertFP * Tworzenie certyfikatu w konsoli: @@ -3189,7 +3030,7 @@ który może być ustawiony na przykład na `~/.weechat`. Więcej informacji można znaleźć pod adresem: https://www.oftc.net/NickServ/CertFP [[irc_sasl_authentication]] -===== Uwierzytelnianie SASL +==== Uwierzytelnianie SASL WeeChat wspiera uwierzytelnianie SASL, używając różnych mechanizmów: @@ -3211,7 +3052,7 @@ Opcje dla serwerów to: _ecdsa-nist256p-challenge_) [[irc_sasl_ecdsa_nist256p_challenge]] -====== SASL ECDSA-NIST256P-CHALLENGE +===== SASL ECDSA-NIST256P-CHALLENGE Musisz wygenerować klucz prywatny w celu uwierzytelnienia za pomocą mechanizmu ECDSA-NIST256P-CHALLENGE (hasło nie potrzebne do połączenia). @@ -3257,7 +3098,7 @@ Ponowne połączenie z serwerem: ---- [[irc_servers_connection]] -===== Łączenie się z serwerem +==== Łączenie się z serwerem Możesz połączyć się z serwerem za pomocą komendy <<command_irc_connect,/connect>>: @@ -3288,7 +3129,7 @@ oddzielnych buforów dla serwerów: ---- [[irc_tor_sasl]] -===== Połączenie za pomocą TORa i SASL +==== Połączenie za pomocą TORa i SASL Niekróre serwery wspierają połączenia z sieci TOR (https://www.torproject.org/), sieci wirtualnych tuneli, które umożliwają poprawienie swojej prywatności @@ -3337,7 +3178,7 @@ Teraz pozostaje już się tylko połączyć z serwerem: ---- [[irc_channels]] -==== Kanały +=== Kanały Możesz dołączać do kanałów za pomocą komendy <<command_irc_join,/join>>: @@ -3353,7 +3194,7 @@ Wyjście z kanału (zostawiając otwarty bufor): Kanały do których dołączyłeś nie są zapisywane. Jeśli chcesz automatycznie do nich dołączać podczas łączenia się z serwerem, należy ustawić opcje -serwera `autojoin`: +serwera `autojoin`: ---- /set irc.server.libera.autojoin "#weechat" @@ -3374,7 +3215,7 @@ nie: Informacje na temat formatu można uzyskać za pomocą `/help irc.server.libera.autojoin`. [[irc_private_messages]] -==== Prywatne wiadomości +=== Prywatne wiadomości Możesz wysłać prywatną wiadomość za pomocą polecenia <<command_irc_query,/query>>, co otwiera oddzielny bufor: @@ -3397,7 +3238,7 @@ W celu zamknięcia prywatnego buforu możesz wykonać to polecenie w prywatnym b ---- [[irc_smart_filter_join_part_quit]] -==== Inteligentne filtry dla wiadomości +=== Inteligentne filtry dla wiadomości Inteligentny filtr umożliwia filtrowanie informacji o wejściu/opuszczeniu/wyjściu z kanału, kiedy dany nick nie powiedział nic na kanale w ciągu ostatnich X minut. @@ -3434,7 +3275,7 @@ Jeśli osoba nie odzywała się w ciągu ostatnich 5 minut, jej wejście i/lub opuszczenie/wyjście zostanie ukryte na kanale. [[irc_ctcp_replies]] -==== Odpowiedzi CTCP +=== Odpowiedzi CTCP Możliwe jest dostosowywanie odpowiedzi CTCP, lub blokowanie niektórych zapytań CTCP (brak odpowiedzi). @@ -3510,7 +3351,7 @@ Jeśli opcje CTCP nie są zdefiniowane (domyślne), odpowiedzi CTCP to: |=== [[irc_target_buffer]] -==== Bufor dla wiadomości IRC +=== Bufor dla wiadomości IRC Jest możliwe dostosowanie buforu docelowego dla wiadomości IRC (bufor użyty do wyświetlania wiadomości) za pomocą opcji `+irc.msgbuffer.*+`. @@ -3642,12 +3483,12 @@ Kilka przykładów: ---- [[irc_commands]] -==== Komendy +=== Komendy include::includes/autogen_user_commands.pl.adoc[tag=irc_commands] [[irc_options]] -==== Opcje +=== Opcje Sekcje w pliku _irc.conf_: @@ -3669,6 +3510,165 @@ Opcje: include::includes/autogen_user_options.pl.adoc[tag=irc_options] +[[plugins]] +== Wtyczki + +Wtyczka jest biblioteka dynamiczną, napisaną w C i skompilowaną, która jest +ładowana przez WeeChat. +W systemach GNU/Linux plik ma rozszerzenie ".so", w Windowsie ".dll". + +Znalezione wtyczki są automatycznie ładowane podczas uruchamiania WeeChat, +możliwe jest również ładowanie lub wyładowywanie wtyczek podczas pracy WeeChat. + +Ważne jest, aby odróżniać _wtyczkę_ od _skryptu_: _wtyczka_ jest to plik binarny +skompilowany i ładowany za pomocą polecenia `/plugin`, natomiast _skrypt_ to +plik tekstowy, ładowany za pomocą wtyczki jak na przykład _python_ za pomocą +polecenia `/python`. + +Możesz użyć komendy `/plugin` żeby załadować/wyładować wtyczkę, lub wyświetlić +wszystkie załadowane wtyczki. + +Podcza wyładowywania wtyczki WeeChat usówa: + +* bufory +* opcje konfiguracyjne (options są zapisywane w plikach) +* wszystkie hooki: komendy, modyfikatory, procesy, etc. +* infos i infolists +* hdata +* elementy pasków. + +Przykłady ładowania, wyładowywania i wyświetlania załadowanych wtyczek: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Domyślne wtyczki: + +[width="100%",cols="1,5",options="header"] +|=== +| Wtyczka | Opis +| alias | Definiuje aliasy dla komend. +| buflist | Element paska z listą buforów. +| charset | Ustawianie kodowania dla buforów. +| exec | Wykonuje zewnętrzną komendę z poziomu WeeChat. +| fifo | Kolejka FIFO używana do zdalnego wysyłania poleceń dla WeeChat. +| fset | Szybkie ustawianie opcji WeeChat i wtyczek. +| irc | Protokół IRC. +| logger | Logowanie zawartości buforów do plików. +| relay | Przekazuje dane przez sieć. +| script | Zarządzanie skryptami. +| python | Wsparcie dla skryptów napisanych w Pythonie. +| perl | Wsparcie dla skryptów napisanych w Perlu. +| ruby | Wsparcie dla skryptów napisanych w Ruby. +| lua | Wsparcie dla skryptów napisanych w Lua. +| tcl | Wsparcie dla skryptów napisanych w Tcl. +| guile | Wsparcie dla skryptów napisanych w Guile (scheme). +| javascript | Wsparcie dla skryptów napisanych w JavaScript. +| php | Wsparcie dla skryptów napisanych w PHP. +| spell | Sprawdzanie pisowni w linii poleceń. +| trigger | Zamiana tekstu i wykonywanie komend dla zdarzeń wywołanych przez WeeChat/wtyczki. +| typing | Pokazuje użytkowników obecnie piszących wiadomości. +| xfer | Przesyłanie plików i bezpośredni chat. +|=== + +Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleźć w +link:weechat_plugin_api.en.html[Opisie API wtyczek] (Angielski) i +link:weechat_scripting.pl.html[Poradniku pisania skryptów]. + +[[exec_plugin]] +=== Exec + +Komenda `/exec` pozwala wykonać zewnętrzne polecenie wewnątrz WeeChat i wyświetlić +jej wynik lokalnie lub wysłać do bufora. + +[[exec_commands]] +==== Komendy + +include::includes/autogen_user_commands.pl.adoc[tag=exec_commands] + +[[exec_options]] +==== Opcje + +Sekcje w pliku _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| command | /set exec.command.* | Opcje dla komend. +| color | /set exec.color.* | Kolory. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Możesz zdalnie kontrolować WeeChat, poprzez wysyłanie komend lub tekstu do +kolejki FIFO (jeśli opcja "fifo.file.enabled" jest włączona, domyślnie jest +włączona). + +Strumień FIFO jest zlokalizowany w katalogu uruchomieniowym WeeChat i ma +domyślnie nazwę weechat_fifo_12345_ (gdzie _12345_ to numer procesu WeeChat). + +Składnia dla komend/tekstu przekazywanego do kolejki FIFO wygląda następująco: + +.... + wtyczka.bufor *tekst lub komenda + *tekst lub komenda +.... + +Kilka przykładów: + +* Zmiana nicka na serwerze IRC libera na "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Wysłanie wiadomości na kanał IRC #weechat: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Wysłanie wiadomości do obecnego bufora: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Wysłanie dwóch komend do wyładowania/przeładowania skryptów Python (należy + oddzielić je za pomocą "\n"): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Komendy + +include::includes/autogen_user_commands.pl.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Opcje + +Sekcje w pliku _fifo.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Sekcja | Komenda | Opis +| plik | /set fifo.file.* | Kontrola kolejki FIFO. +|=== + +Opcje: + +include::includes/autogen_user_options.pl.adoc[tag=fifo_options] + [[logger_plugin]] === Logger diff --git a/doc/sr/weechat_user.sr.adoc b/doc/sr/weechat_user.sr.adoc index 82eeafb4b..df9e6fe7d 100644 --- a/doc/sr/weechat_user.sr.adoc +++ b/doc/sr/weechat_user.sr.adoc @@ -213,7 +213,7 @@ $ make install Компајлира <<scripts_plugins,Guile додатак>> (Scheme). | ENABLE_IRC | `ON`, `OFF` | ON | - Компајлира <<irc_plugin,IRC додатак>>. + Компајлира <<irc,IRC додатак>>. | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF | Компајлира <<scripts_plugins,JavaScript додатак>>. @@ -2605,160 +2605,15 @@ include::includes/autogen_user_options.sr.adoc[tag=sec_options] include::includes/autogen_user_options.sr.adoc[tag=weechat_options] -[[plugins]] -== Додаци - -Додатак је динамичка библиотека коју учитава програм WeeChat, написана на језику C и компајлирана. На GNU/Linux систему, фајл има „.so” екстензију, а „.dll” на систему Windows. - -Додаци се аутоматски учитавају током покретања програма WeeChat, а могу да се учитавају или уклањају из меморије док се програм WeeChat извршава. - -Важно је да се направи разлика између _додатка_ и _скрипте_: _додатак_ је бинарни фајл који се компајлира и учитава командом `/plugin`, док је _скрипта_ текст фајл који се учитава додатком као што је _python_ командом `/python`. - -За учитавање/уклањање из меморије можете користити команду `/plugin`, или да прикажете листу свих учитаних додатака. - -Када се додатак уклони из меморије, програм WeeChat уклања: - -* бафере -* конфигурационе опције (опције се уписују у фајлове) -* све куке: команде, модификатори, процес, итд. -* инфо и инфолисте -* hdata -* ставке траке - -Примери учитавања, уклањања из меморије или приказа листе додатака: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Ово су подразумевани додаци: - -[width="100%", cols="1,5", options="header"] -|=== -| Додатак | Опис -| alias | Дефиниција алијаса за команде. -| buflist | Ставка траке са листом бафера. -| charset | Декодирање/кодирање у скуп карактера за бафере. -| exec | Извршавање спољних команди из програма WeeChat. -| fifo | FIFO пајп који се користи за удаљено слање команди програму WeeChat. -| fset | Брзо постављање опција програма WeeChat и опција додатака. -| irc | IRC чет протокол. -| logger | Логовање бафера у фајлове. -| relay | Релеј података преко мреже. -| script | Управљач скриптама. -| python | Python API . -| perl | Perl API скриптовања. -| ruby | Ruby API скриптовања. -| lua | Lua API скриптовања. -| tcl | Tcl API скриптовања. -| guile | Guile (scheme) API скриптовања. -| javascript | JavaScript API скриптовања. -| php | PHP API скриптовања. -| spell | Провера правописа за командну линију. -| trigger | Замена текста и извршавање команди приликом догађаја које окида програм WeeChat/додаци. -| typing | Приказује кориснике који тренутно пишу поруке. -| xfer | Пренос фајлова и директни разговор. -|=== - -За више информација о развоју додатака или скрипти (помоћу API), молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтно упутство за API додатака] или link:weechat_scripting.sr.html[WeeChat водич за скриптовање]. - -[[exec_plugin]] -=== Exec - -Команда `/exec` вам омогућава да извршите спољне команде из програма WeeChat и да локално прикажете њихов излаз, или да га пошаљете у бафер. - -[[exec_commands]] -==== Команде - -include::includes/autogen_user_commands.sr.adoc[tag=exec_commands] - -[[exec_options]] -==== Опције - -Одељци у фајлу _exec.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| command | /set exec.command.* | Опције за команде. -| color | /set exec.color.* | Боје. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Програм WeeChat можете даљински да контролишете слањем команди или текста у FIFO пајп (ако је укључена опција „fifo.file.enabled”, што је подразумевано). - -FIFO пајп се налази у WeeChat директоријуму за време извршавања (runtime) и подразумевано се зове _weechat_fifo_12345_ (где је _12345_ id процеса програма WeeChat). - -Синтакса за FIFO пајп команде/текст је једно од следећих: - -.... - plugin.buffer *овде иде текст или команда - *овде иде текст или команда -.... - -Неки примери: - -* Измена надимка на IRC серверу libera на „newnick”: - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Слање поруке на #weechat IRC канал: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Слање поруке у текући бафер: - ----- -$ echo '*здраво!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Слање две команде за уклањање из меморије/поновно учитавање Python скрипти (морате да их раздвојите са „\n”): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Команде - -include::includes/autogen_user_commands.sr.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Опције - -Одељци у фајлу _fifo.conf_: - -[width="100%", cols="3m,6m,16", options="header"] -|=== -| Одељак | Команда за контролу | Опис -| file | /set fifo.file.* | Контрола FIFO пајпа. -|=== - -Опције: - -include::includes/autogen_user_options.sr.adoc[tag=fifo_options] - -[[irc_plugin]] -=== IRC +[[irc]] +== IRC IRC додатак је дизајниран за чет са другим људима преко IRC протокола. Подржава више сервера и нуди све подржане IRC команде, укључујући DCC чет и пренос фајлова (преко xfer додатка, погледајте <<xfer_plugin,Xfer додатак>>). [[irc_command_line_options]] -==== Опције командне линије +=== Опције командне линије URL за један или више IRC сервера може да се зада на следећи начин: @@ -2773,10 +2628,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr ---- [[irc_servers]] -==== Сервери +=== Сервери [[irc_servers_add]] -===== Додавање сервера +==== Додавање сервера Подразумевано није дефинисан ниједан сервер. Командом <<command_irc_server,/server>> можете додати произвољан број сервера. @@ -2816,7 +2671,7 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr `/set irc.server.libera.command_delay 5`. [[irc_servers_options]] -===== Опције сервера +==== Опције сервера Опције сервера се називају `irc.server.<сервер>.<опција>` где је `<сервер>` интерно име сервера, а `<опција>` је име опције. + @@ -2888,7 +2743,7 @@ irc.server.libera.username string null -> "alice" ---- [[irc_ssl_certificates]] -===== SSL сертификати +==== SSL сертификати Када се са IRC серверима успоставља веза преко SSL, програм WeeChat подразумевано проверава да ли се вези потпуно верује. @@ -2913,7 +2768,7 @@ irc.server.xxx.ssl_verify:: Опција „ssl_verify” је подразумевано укључена, тако да је верификација стриктна и може да не успе, чак и када је била OK у верзијама пре 0.3.1. [[irc_connect_oftc_with_certificate]] -====== Први пример: повезивање на oftc и провера сертификата +===== Први пример: повезивање на oftc и провера сертификата * Увоз сертификата у командном окружењу: @@ -2935,7 +2790,7 @@ $ wget -O ~/.config/weechat/ssl/CAs.pem https://www.spi-inc.org/ca/spi-cacert.cr ---- [[irc_connect_oftc_with_certfp]] -====== Други пример: повезивање са oftc употребом CertFP +===== Други пример: повезивање са oftc употребом CertFP * Креирајте сертификат у командном окружењу: @@ -2959,7 +2814,7 @@ $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick За више информација, погледајте https://www.oftc.net/NickServ/CertFP [[irc_sasl_authentication]] -===== SASL аутентификација +==== SASL аутентификација Програм WeeChat подржава SASL аутентификацију, употребом различитих механизама: @@ -2980,7 +2835,7 @@ $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick * _sasl_key_: фајл са ECC приватним кључем (за механизам _ecdsa-nist256p-challenge_) [[irc_sasl_ecdsa_nist256p_challenge]] -====== SASL ECDSA-NIST256P-CHALLENGE +===== SASL ECDSA-NIST256P-CHALLENGE Да бисте могли да се аутентификујете ECDSA-NIST256P-CHALLENGE механизмом, морате да генеришете приватни кључ (није потребна лозинка за успостављање везе). @@ -3022,7 +2877,7 @@ $ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem ---- [[irc_servers_connection]] -===== Повезивање +==== Повезивање Командом <<command_irc_connect,/connect>> можете да се повежете са сервером: @@ -3053,7 +2908,7 @@ $ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem ---- [[irc_tor_sasl]] -===== Повезивање преко TOR и SASL +==== Повезивање преко TOR и SASL Неки сервери подржавају и везе са TOR (https://www.torproject.org/), мрежом виртуелних тунела који омогућавају људима и групама да унапреде своју приватност и безбедност на Интернету. @@ -3096,7 +2951,7 @@ $ sudo apt-get install tor ---- [[irc_channels]] -==== Канали +=== Канали Каналима приступате командом <<command_irc_join,/join>>: @@ -3131,7 +2986,7 @@ $ sudo apt-get install tor Помоћ у вези формата потражите помоћу `/help irc.server.libera.autojoin`. [[irc_private_messages]] -==== Приватне поруке +=== Приватне поруке Командом <<command_irc_query,/query>> можете да шаљете приватне поруке и она отвара посебан бафер: @@ -3153,7 +3008,7 @@ $ sudo apt-get install tor ---- [[irc_smart_filter_join_part_quit]] -==== Паметни филтер за join/part/quit поруке +=== Паметни филтер за join/part/quit поруке За филтрирање join/part/quit порука када надимак на каналу ништа није рекао у последњих X минута, можете употребити паметни филтер. @@ -3186,7 +3041,7 @@ $ sudo apt-get install tor Ако надимак није ништа рекао у последњих 5 минута, његове join и/или part/quit поруке ће бити скривене на каналу. [[irc_ctcp_replies]] -==== CTCP одговори +=== CTCP одговори CTCP одговори могу да се прилагоде, или неки CTCP упити могу да се блокирају (да се не пошаље одговор). @@ -3255,7 +3110,7 @@ CTCP може да се прилагоди само за један сервер |=== [[irc_target_buffer]] -==== Циљни бафер за IRC поруке +=== Циљни бафер за IRC поруке Могуће је прилагођавање циљног бафера за IRC поруке (бафер који се користи за приказ порука) опцијама `+irc.msgbuffer.*+`. @@ -3383,12 +3238,12 @@ weechat:: ---- [[irc_commands]] -==== Команде +=== Команде include::includes/autogen_user_commands.sr.adoc[tag=irc_commands] [[irc_options]] -==== Опције +=== Опције Одељци у фајлу _irc.conf_: @@ -3410,6 +3265,151 @@ include::includes/autogen_user_commands.sr.adoc[tag=irc_commands] include::includes/autogen_user_options.sr.adoc[tag=irc_options] +[[plugins]] +== Додаци + +Додатак је динамичка библиотека коју учитава програм WeeChat, написана на језику C и компајлирана. На GNU/Linux систему, фајл има „.so” екстензију, а „.dll” на систему Windows. + +Додаци се аутоматски учитавају током покретања програма WeeChat, а могу да се учитавају или уклањају из меморије док се програм WeeChat извршава. + +Важно је да се направи разлика између _додатка_ и _скрипте_: _додатак_ је бинарни фајл који се компајлира и учитава командом `/plugin`, док је _скрипта_ текст фајл који се учитава додатком као што је _python_ командом `/python`. + +За учитавање/уклањање из меморије можете користити команду `/plugin`, или да прикажете листу свих учитаних додатака. + +Када се додатак уклони из меморије, програм WeeChat уклања: + +* бафере +* конфигурационе опције (опције се уписују у фајлове) +* све куке: команде, модификатори, процес, итд. +* инфо и инфолисте +* hdata +* ставке траке + +Примери учитавања, уклањања из меморије или приказа листе додатака: + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Ово су подразумевани додаци: + +[width="100%", cols="1,5", options="header"] +|=== +| Додатак | Опис +| alias | Дефиниција алијаса за команде. +| buflist | Ставка траке са листом бафера. +| charset | Декодирање/кодирање у скуп карактера за бафере. +| exec | Извршавање спољних команди из програма WeeChat. +| fifo | FIFO пајп који се користи за удаљено слање команди програму WeeChat. +| fset | Брзо постављање опција програма WeeChat и опција додатака. +| irc | IRC чет протокол. +| logger | Логовање бафера у фајлове. +| relay | Релеј података преко мреже. +| script | Управљач скриптама. +| python | Python API . +| perl | Perl API скриптовања. +| ruby | Ruby API скриптовања. +| lua | Lua API скриптовања. +| tcl | Tcl API скриптовања. +| guile | Guile (scheme) API скриптовања. +| javascript | JavaScript API скриптовања. +| php | PHP API скриптовања. +| spell | Провера правописа за командну линију. +| trigger | Замена текста и извршавање команди приликом догађаја које окида програм WeeChat/додаци. +| typing | Приказује кориснике који тренутно пишу поруке. +| xfer | Пренос фајлова и директни разговор. +|=== + +За више информација о развоју додатака или скрипти (помоћу API), молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтно упутство за API додатака] или link:weechat_scripting.sr.html[WeeChat водич за скриптовање]. + +[[exec_plugin]] +=== Exec + +Команда `/exec` вам омогућава да извршите спољне команде из програма WeeChat и да локално прикажете њихов излаз, или да га пошаљете у бафер. + +[[exec_commands]] +==== Команде + +include::includes/autogen_user_commands.sr.adoc[tag=exec_commands] + +[[exec_options]] +==== Опције + +Одељци у фајлу _exec.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| command | /set exec.command.* | Опције за команде. +| color | /set exec.color.* | Боје. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Програм WeeChat можете даљински да контролишете слањем команди или текста у FIFO пајп (ако је укључена опција „fifo.file.enabled”, што је подразумевано). + +FIFO пајп се налази у WeeChat директоријуму за време извршавања (runtime) и подразумевано се зове _weechat_fifo_12345_ (где је _12345_ id процеса програма WeeChat). + +Синтакса за FIFO пајп команде/текст је једно од следећих: + +.... + plugin.buffer *овде иде текст или команда + *овде иде текст или команда +.... + +Неки примери: + +* Измена надимка на IRC серверу libera на „newnick”: + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Слање поруке на #weechat IRC канал: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Слање поруке у текући бафер: + +---- +$ echo '*здраво!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Слање две команде за уклањање из меморије/поновно учитавање Python скрипти (морате да их раздвојите са „\n”): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Команде + +include::includes/autogen_user_commands.sr.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Опције + +Одељци у фајлу _fifo.conf_: + +[width="100%", cols="3m,6m,16", options="header"] +|=== +| Одељак | Команда за контролу | Опис +| file | /set fifo.file.* | Контрола FIFO пајпа. +|=== + +Опције: + +include::includes/autogen_user_options.sr.adoc[tag=fifo_options] + [[logger_plugin]] === Logger |