From 160ffe8e11452a415f5e42916be4d369926fbc2b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= Date: Sun, 5 Dec 2021 17:43:33 +0100 Subject: doc: move sections "Exec", "Fifo" and "Trigger" at top level after "Relay" (user's guide) --- doc/fr/weechat_user.fr.adoc | 818 ++++++++++++++++++++++---------------------- 1 file changed, 409 insertions(+), 409 deletions(-) (limited to 'doc/fr') diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index ca15146a9..6cfe042a0 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -221,10 +221,10 @@ Liste des options couramment utilisées : Compiler <> avec Enchant. | ENABLE_EXEC | `ON`, `OFF` | ON | - Compiler <>. + Compiler <>. | ENABLE_FIFO | `ON`, `OFF` | ON | - Compiler <>. + Compiler <>. | ENABLE_FSET | `ON`, `OFF` | ON | Compiler <>. @@ -286,7 +286,7 @@ Liste des options couramment utilisées : Compiler <>. | ENABLE_TRIGGER | `ON`, `OFF` | ON | - Compiler <>. + Compiler <>. | ENABLE_TYPING | `ON`, `OFF` | ON | Compiler <>. @@ -4195,89 +4195,19 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=relay_options] -[[plugins]] -== Extensions - -Une extension est une bibliothèque dynamique, écrite en C et compilée, qui est -chargée par WeeChat. -Sous GNU/Linux, ce fichier a une extension ".so", et ".dll" sous Windows. - -Les extensions trouvées sont automatiquement chargées par WeeChat lorsqu'il -démarre, et il est possible de charger et décharger des extensions pendant que -WeeChat tourne. - -Il est important de bien faire la différence entre une _extension_ et un -_script_ : une _extension_ est un fichier binaire compilé et chargé avec la -commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une -extension comme _python_ par la commande `/python`. - -Vous pouvez utiliser la commande `/plugin` pour charger/décharger une -extension, ou afficher les extensions chargées. - -Quand une extension est déchargée, WeeChat supprime : - -* les tampons -* les options de configuration (les options sont écrites dans les fichiers) -* tous les "hooks" : commandes, modificateurs, processus, etc. -* les infos et infolists -* les "hdata" -* les objets de barre. - -Exemples pour charger, décharger et afficher les extensions : - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -Les extensions par défaut sont : - -[width="100%",cols="1,5",options="header"] -|=== -| Extension | Description -| alias | Définition d'alias pour les commandes. -| buflist | Objet de barre avec la liste des tampons. -| charset | Encodage/encodage avec jeu de caractère sur les tampons. -| exec | Exécution de commandes externes dans WeeChat. -| fifo | Tube FIFO pour envoyer des commandes à distance vers WeeChat. -| fset | Modification rapide des options de WeeChat et des extensions. -| irc | Discussion avec le protocole IRC. -| logger | Enregistrement des tampons dans des fichiers. -| relay | Relai de données via le réseau. -| script | Gestionnaire de scripts. -| python | Interface (API) pour scripts Python. -| perl | Interface (API) pour scripts Perl. -| ruby | Interface (API) pour scripts Ruby. -| lua | Interface (API) pour scripts Lua. -| tcl | Interface (API) pour scripts Tcl. -| guile | Interface (API) pour scripts Guile (scheme). -| javascript | Interface (API) pour scripts JavaScript. -| php | Interface (API) pour scripts PHP. -| spell | Vérification orthographique de la ligne de commande. -| trigger | Remplacement de texte et exécution de commande sur des évènements de WeeChat ou des extensions. -| typing | Affichage des utilisateurs qui sont en train d'écrire des messages. -| xfer | Transfert de fichier et discussion directe. -|=== - -Pour en apprendre plus sur le développement d'extension ou de script (via -l'API), merci de consulter la -link:weechat_plugin_api.fr.html[Référence API extension WeeChat] ou le -link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. - -[[exec_plugin]] -=== Exec +[[external_commands]] +== Commandes externes La commande `/exec` vous permet de lancer des commandes externes dans WeeChat et d'afficher la sortie localement, ou de l'envoyer à un tampon. [[exec_commands]] -==== Commandes +=== Commandes include::includes/autogen_user_commands.fr.adoc[tag=exec_commands] [[exec_options]] -==== Options +=== Options Sections dans le fichier _exec.conf_ : @@ -4292,8 +4222,8 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=exec_options] -[[fifo_plugin]] -=== Fifo +[[fifo_pipe]] +== Tube FIFO Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du texte dans un tube FIFO (si l'option _fifo.file.enabled_ est activée, @@ -4338,12 +4268,12 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/wee ---- [[fifo_commands]] -==== Commandes +=== Commandes include::includes/autogen_user_commands.fr.adoc[tag=fifo_commands] [[fifo_options]] -==== Options +=== Options Sections dans le fichier _fifo.conf_ : @@ -4357,345 +4287,146 @@ Options : include::includes/autogen_user_options.fr.adoc[tag=fifo_options] -[[scripts_plugins]] -=== Scripts - -WeeChat fournit 8 extensions pour scripts : Python, Perl, Ruby, Lua, Tcl, -Guile (scheme), JavaScript et PHP. -Ces extensions peuvent charger, exécuter et décharger des scripts pour ces -langages. +[[trigger]] +== Trigger -Une autre extension appelée "script" est un gestionnaire de scripts et est -utilisé pour charger/décharger des scripts pour n'importe quel langage, et -installer/supprimer des scripts du dépôt WeeChat, qui sont visibles à cette -URL : https://weechat.org/scripts +Trigger est le couteau suisse de WeeChat : il peut accrocher différentes choses +(signal, modificateur, print, ...), changer le contenu des données, et exécuter +une ou plusieurs commandes. Une condition peut être utilisée pour empêcher le +trigger de s'exécuter dans certaines circonstances. -Pour plus d'informations sur comment écrire des scripts, ou sur l'API -WeeChat pour les scripts, merci de lire le -link:weechat_scripting.fr.html[Guide pour scripts WeeChat]. +Utiliser les triggers nécessite de connaître le fonctionnement des signaux, +modificateurs, etc. Il peut être utile de lire la +link:weechat_plugin_api.fr.html#hooks[Référence API extension WeeChat / Hooks]. -[[script_commands]] -==== Commandes Script +[[trigger_default]] +=== Triggers par défaut -include::includes/autogen_user_commands.fr.adoc[tag=script_commands] +WeeChat créé 5 triggers par défaut, qui peuvent être désactivés, mis à jour ou +supprimés : -[[python_commands]] -==== Commandes Python +* un trigger _beep_ pour les notifications +* quatre autre triggers pour cacher les mots de passe à l'écran -include::includes/autogen_user_commands.fr.adoc[tag=python_commands] +Liste des triggers par défaut : -[[perl_commands]] -==== Commandes Perl +[width="100%",cols="5m,3,22",options="header"] +|=== +| Nom | Hook | Description -include::includes/autogen_user_commands.fr.adoc[tag=perl_commands] +| beep | print | + Faire un bip sur un message de highlight ou privé. -[[ruby_commands]] -==== Commandes Ruby +| cmd_pass | modifier | + Cacher le mot de passe dans les commandes : + `pass:[/msg nickserv id\|identify\|set password\|ghost\|release\|regain\|recover]`, + `pass:[/oper]`, + `pass:[/quote pass]`, + `pass:[/secure passphrase\|decrypt\|set]`. -include::includes/autogen_user_commands.fr.adoc[tag=ruby_commands] +| cmd_pass_register | modifier | + Cacher le mot de passe dans la commande `pass:[/msg nickserv register]`. -[[lua_commands]] -==== Commandes Lua +| msg_auth | modifier | + Cacher le mot de passe dans le message d'authentification IRC affiché + (message reçu du serveur après l'envoi de la commande par l'utilisateur). -include::includes/autogen_user_commands.fr.adoc[tag=lua_commands] +| server_pass | modifier | + Cacher le mot de passe du serveur dans les commandes `/server` et `/connect`. +|=== -[[tcl_commands]] -==== Commandes Tcl +[[trigger_anatomy]] +=== Anatomie d'un trigger -include::includes/autogen_user_commands.fr.adoc[tag=tcl_commands] +Un trigger a les options suivantes (les noms sont +`trigger.trigger..