From 7cb5147e74ef0e8d2eaf39b312051b54d0cf1ba2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= Date: Sun, 5 Dec 2021 14:58:56 +0100 Subject: doc: move section "Relay" at top level after "IRC" (user's guide) --- doc/fr/weechat_user.fr.adoc | 350 ++++++++++++++++++++++---------------------- 1 file changed, 175 insertions(+), 175 deletions(-) (limited to 'doc/fr/weechat_user.fr.adoc') diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index 9636aed8f..96f91525d 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -267,7 +267,7 @@ Liste des options couramment utilisées : Python 3. | ENABLE_RELAY | `ON`, `OFF` | ON | - Compiler <>. + Compiler <>. | ENABLE_RUBY | `ON`, `OFF` | ON | Compiler <>. @@ -3729,170 +3729,8 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=irc_options] -[[plugins]] -== Extensions - -Une extension est une bibliothèque dynamique, écrite en C et compilée, qui est -chargée par WeeChat. -Sous GNU/Linux, ce fichier a une extension ".so", et ".dll" sous Windows. - -Les extensions trouvées sont automatiquement chargées par WeeChat lorsqu'il -démarre, et il est possible de charger et décharger des extensions pendant que -WeeChat tourne. - -Il est important de bien faire la différence entre une _extension_ et un -_script_ : une _extension_ est un fichier binaire compilé et chargé avec la -commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une -extension comme _python_ par la commande `/python`. - -Vous pouvez utiliser la commande `/plugin` pour charger/décharger une -extension, ou afficher les extensions chargées. - -Quand une extension est déchargée, WeeChat supprime : - -* les tampons -* les options de configuration (les options sont écrites dans les fichiers) -* tous les "hooks" : commandes, modificateurs, processus, etc. -* les infos et infolists -* les "hdata" -* les objets de barre. - -Exemples pour charger, décharger et afficher les extensions : - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Les extensions par défaut sont : - -[width="100%",cols="1,5",options="header"] -|=== -| Extension | Description -| alias | Définition d'alias pour les commandes. -| buflist | Objet de barre avec la liste des tampons. -| charset | Encodage/encodage avec jeu de caractère sur les tampons. -| exec | Exécution de commandes externes dans WeeChat. -| fifo | Tube FIFO pour envoyer des commandes à distance vers WeeChat. -| fset | Modification rapide des options de WeeChat et des extensions. -| irc | Discussion avec le protocole IRC. -| logger | Enregistrement des tampons dans des fichiers. -| relay | Relai de données via le réseau. -| script | Gestionnaire de scripts. -| python | Interface (API) pour scripts Python. -| perl | Interface (API) pour scripts Perl. -| ruby | Interface (API) pour scripts Ruby. -| lua | Interface (API) pour scripts Lua. -| tcl | Interface (API) pour scripts Tcl. -| guile | Interface (API) pour scripts Guile (scheme). -| javascript | Interface (API) pour scripts JavaScript. -| php | Interface (API) pour scripts PHP. -| spell | Vérification orthographique de la ligne de commande. -| trigger | Remplacement de texte et exécution de commande sur des évènements de WeeChat ou des extensions. -| typing | Affichage des utilisateurs qui sont en train d'écrire des messages. -| xfer | Transfert de fichier et discussion directe. -|=== - -Pour en apprendre plus sur le développement d'extension ou de script (via -l'API), merci de consulter la -link:weechat_plugin_api.fr.html[Référence API extension WeeChat] ou le -link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. - -[[exec_plugin]] -=== Exec - -La commande `/exec` vous permet de lancer des commandes externes dans WeeChat et -d'afficher la sortie localement, ou de l'envoyer à un tampon. - -[[exec_commands]] -==== Commandes - -include::includes/autogen_user_commands.fr.adoc[tag=exec_commands] - -[[exec_options]] -==== Options - -Sections dans le fichier _exec.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| command | /set exec.command.* | Options pour les commandes. -| color | /set exec.color.* | Couleurs. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du -texte dans un tube FIFO (si l'option _fifo.file.enabled_ est activée, -elle l'est par défaut). - -Le tube FIFO est dans le répertoire WeeChat "runtime" et s'appelle -_weechat_fifo_12345_ par défaut (où _12345_ est le process id de WeeChat). - -La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est une -des suivantes : - -.... - plugin.buffer *texte ou commande ici - *texte ou commande ici -.... - -Quelques exemples : - -* Changer le pseudo sur libera en "autrepseudo" : - ----- -$ echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Envoyer un message sur le canal IRC #weechat : - ----- -$ echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Envoyer un message sur le tampon courant : - ----- -$ echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Envoyer deux commandes pour décharger/recharger les scripts Python (vous devez - les séparer par "\n") : - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Commandes - -include::includes/autogen_user_commands.fr.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Options - -Sections dans le fichier _fifo.conf_ : - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Commande de contrôle | Description -| file | /set fifo.file.* | Contrôle du tube FIFO. -|=== - -Options : - -include::includes/autogen_user_options.fr.adoc[tag=fifo_options] - -[[relay_plugin]] -=== Relay +[[relay]] +== Relay L'extension Relay est utilisée pour relayer des données via le réseau, en utilisant divers protocoles : @@ -3907,7 +3745,7 @@ utilisant divers protocoles : ** WeeCloud (JavaScript) : https://github.com/eirikb/weecloud [[relay_password]] -==== Mot de passe +=== Mot de passe Il est fortement recommandé de définir un mot de passe pour le relai, avec ces commandes : @@ -3920,7 +3758,7 @@ commandes : Ce mot de passe sera utilisé pour les protocoles _irc_ et _weechat_. [[relay_totp]] -==== TOTP +=== TOTP TOTP (« Time-based One-Time Password » : mot de passe à usage unique basé sur le temps) peut être utilisé comme second facteur d'authentification pour le protocole @@ -3951,7 +3789,7 @@ chiffres de 2 à 7, par exemple : ---- [[relay_ssl]] -==== SSL +=== SSL Vous pouvez utiliser SSL en créant un certificat et clé privée et en utilisant le préfixe "ssl." dans le nom du protocole. @@ -3979,7 +3817,7 @@ commande : ---- [[relay_irc_proxy]] -==== IRC proxy +=== IRC proxy L'extension Relay peut agir comme un proxy IRC : elle simulera un serveur IRC, et vous pourrez vous connecter sur WeeChat avec n'importe quel autre client IRC @@ -4022,13 +3860,13 @@ avec ces commandes : ---- [[relay_weechat_protocol]] -==== Protocole WeeChat +=== Protocole WeeChat L'extension Relay peut envoyer les données à une interface distante en utilisant le protocole WeeChat. Vous pouvez vous connecter avec une interface distante, voir la liste dans -<>. +<>. [IMPORTANT] WeeChat lui-même ne peut PAS se connecter sur un autre WeeChat avec ce @@ -4044,7 +3882,7 @@ Maintenant vous pouvez vous connecter sur le port 9000 avec une interface distante en utilisant le mot de passe "motdepasse". [[relay_websocket]] -==== WebSocket +=== WebSocket Le protocole WebSocket (https://tools.ietf.org/html/rfc6455[RFC 6455]) est supporté dans l'extension Relay pour tous les protocoles. @@ -4067,7 +3905,7 @@ L'URI doit toujours se terminer par "/weechat" (pour les protocoles _irc_ et _weechat_). [[relay_unix_socket]] -==== UNIX domain sockets +=== UNIX domain sockets En utilisant l'option de protocole "unix" avec la commande `/relay add`, vous pouvez écouter avec n'importe quel protocole sur un socket UNIX et un @@ -4092,12 +3930,12 @@ Cela redirige les clients relay locaux qui se connectent au port 9000 vers l'instance de WeeChat qui tourne sur "hostname". [[relay_commands]] -==== Commandes +=== Commandes include::includes/autogen_user_commands.fr.adoc[tag=relay_commands] [[relay_options]] -==== Options +=== Options Sections dans le fichier _relay.conf_ : @@ -4116,6 +3954,168 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=relay_options] +[[plugins]] +== Extensions + +Une extension est une bibliothèque dynamique, écrite en C et compilée, qui est +chargée par WeeChat. +Sous GNU/Linux, ce fichier a une extension ".so", et ".dll" sous Windows. + +Les extensions trouvées sont automatiquement chargées par WeeChat lorsqu'il +démarre, et il est possible de charger et décharger des extensions pendant que +WeeChat tourne. + +Il est important de bien faire la différence entre une _extension_ et un +_script_ : une _extension_ est un fichier binaire compilé et chargé avec la +commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une +extension comme _python_ par la commande `/python`. + +Vous pouvez utiliser la commande `/plugin` pour charger/décharger une +extension, ou afficher les extensions chargées. + +Quand une extension est déchargée, WeeChat supprime : + +* les tampons +* les options de configuration (les options sont écrites dans les fichiers) +* tous les "hooks" : commandes, modificateurs, processus, etc. +* les infos et infolists +* les "hdata" +* les objets de barre. + +Exemples pour charger, décharger et afficher les extensions : + +---- +/plugin load irc +/plugin unload irc +/plugin list +---- + +Les extensions par défaut sont : + +[width="100%",cols="1,5",options="header"] +|=== +| Extension | Description +| alias | Définition d'alias pour les commandes. +| buflist | Objet de barre avec la liste des tampons. +| charset | Encodage/encodage avec jeu de caractère sur les tampons. +| exec | Exécution de commandes externes dans WeeChat. +| fifo | Tube FIFO pour envoyer des commandes à distance vers WeeChat. +| fset | Modification rapide des options de WeeChat et des extensions. +| irc | Discussion avec le protocole IRC. +| logger | Enregistrement des tampons dans des fichiers. +| relay | Relai de données via le réseau. +| script | Gestionnaire de scripts. +| python | Interface (API) pour scripts Python. +| perl | Interface (API) pour scripts Perl. +| ruby | Interface (API) pour scripts Ruby. +| lua | Interface (API) pour scripts Lua. +| tcl | Interface (API) pour scripts Tcl. +| guile | Interface (API) pour scripts Guile (scheme). +| javascript | Interface (API) pour scripts JavaScript. +| php | Interface (API) pour scripts PHP. +| spell | Vérification orthographique de la ligne de commande. +| trigger | Remplacement de texte et exécution de commande sur des évènements de WeeChat ou des extensions. +| typing | Affichage des utilisateurs qui sont en train d'écrire des messages. +| xfer | Transfert de fichier et discussion directe. +|=== + +Pour en apprendre plus sur le développement d'extension ou de script (via +l'API), merci de consulter la +link:weechat_plugin_api.fr.html[Référence API extension WeeChat] ou le +link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. + +[[exec_plugin]] +=== Exec + +La commande `/exec` vous permet de lancer des commandes externes dans WeeChat et +d'afficher la sortie localement, ou de l'envoyer à un tampon. + +[[exec_commands]] +==== Commandes + +include::includes/autogen_user_commands.fr.adoc[tag=exec_commands] + +[[exec_options]] +==== Options + +Sections dans le fichier _exec.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| command | /set exec.command.* | Options pour les commandes. +| color | /set exec.color.* | Couleurs. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du +texte dans un tube FIFO (si l'option _fifo.file.enabled_ est activée, +elle l'est par défaut). + +Le tube FIFO est dans le répertoire WeeChat "runtime" et s'appelle +_weechat_fifo_12345_ par défaut (où _12345_ est le process id de WeeChat). + +La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est une +des suivantes : + +.... + plugin.buffer *texte ou commande ici + *texte ou commande ici +.... + +Quelques exemples : + +* Changer le pseudo sur libera en "autrepseudo" : + +---- +$ echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Envoyer un message sur le canal IRC #weechat : + +---- +$ echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Envoyer un message sur le tampon courant : + +---- +$ echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Envoyer deux commandes pour décharger/recharger les scripts Python (vous devez + les séparer par "\n") : + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Commandes + +include::includes/autogen_user_commands.fr.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Options + +Sections dans le fichier _fifo.conf_ : + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Commande de contrôle | Description +| file | /set fifo.file.* | Contrôle du tube FIFO. +|=== + +Options : + +include::includes/autogen_user_options.fr.adoc[tag=fifo_options] + [[scripts_plugins]] === Scripts -- cgit v1.2.3