summaryrefslogtreecommitdiff
path: root/doc/fr/weechat_user.fr.adoc
diff options
context:
space:
mode:
authorSébastien Helleu <flashcode@flashtux.org>2021-12-05 14:42:58 +0100
committerSébastien Helleu <flashcode@flashtux.org>2021-12-05 20:59:19 +0100
commit66384544b551e5bf61de786590a8dfa7efed53d7 (patch)
treed45ce320a853da909c3172ba6a08ed29ce25e354 /doc/fr/weechat_user.fr.adoc
parentc88428fb416fa1f0477e4a9f2542d06db239a749 (diff)
downloadweechat-66384544b551e5bf61de786590a8dfa7efed53d7.zip
doc: move section "IRC" at top level after "Configuration" (user's guide)
Diffstat (limited to 'doc/fr/weechat_user.fr.adoc')
-rw-r--r--doc/fr/weechat_user.fr.adoc366
1 files changed, 183 insertions, 183 deletions
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