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

