From 66384544b551e5bf61de786590a8dfa7efed53d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= <flashcode@flashtux.org>
Date: Sun, 5 Dec 2021 14:42:58 +0100
Subject: doc: move section "IRC" at top level after "Configuration" (user's
 guide)

---
 doc/fr/weechat_user.fr.adoc | 366 ++++++++++++++++++++++----------------------
 1 file changed, 183 insertions(+), 183 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 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
 
-- 
cgit v1.2.3

