diff options
author | Sébastien Helleu <flashcode@flashtux.org> | 2021-12-05 14:42:58 +0100 |
---|---|---|
committer | Sébastien Helleu <flashcode@flashtux.org> | 2021-12-05 20:59:19 +0100 |
commit | 66384544b551e5bf61de786590a8dfa7efed53d7 (patch) | |
tree | d45ce320a853da909c3172ba6a08ed29ce25e354 /doc/fr/weechat_user.fr.adoc | |
parent | c88428fb416fa1f0477e4a9f2542d06db239a749 (diff) | |
download | weechat-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.adoc | 366 |
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 |