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