summaryrefslogtreecommitdiff
path: root/doc/fr
diff options
context:
space:
mode:
Diffstat (limited to 'doc/fr')
-rw-r--r--doc/fr/autogen/plugin_api/infos_hashtable.asciidoc2
-rw-r--r--doc/fr/autogen/user/alias_commands.asciidoc29
-rw-r--r--doc/fr/autogen/user/aspell_commands.asciidoc2
-rw-r--r--doc/fr/autogen/user/irc_commands.asciidoc17
-rw-r--r--doc/fr/autogen/user/irc_options.asciidoc6
-rw-r--r--doc/fr/autogen/user/logger_options.asciidoc2
-rw-r--r--doc/fr/autogen/user/script_options.asciidoc10
-rw-r--r--doc/fr/autogen/user/weechat_commands.asciidoc44
-rw-r--r--doc/fr/autogen/user/weechat_options.asciidoc35
-rw-r--r--doc/fr/autogen/user/xfer_options.asciidoc4
-rw-r--r--doc/fr/cmdline_options.fr.asciidoc2
-rw-r--r--doc/fr/weechat.1.fr.asciidoc1
-rw-r--r--doc/fr/weechat_dev.fr.asciidoc99
-rw-r--r--doc/fr/weechat_faq.fr.asciidoc15
-rw-r--r--doc/fr/weechat_plugin_api.fr.asciidoc309
-rw-r--r--doc/fr/weechat_quickstart.fr.asciidoc4
-rw-r--r--doc/fr/weechat_scripting.fr.asciidoc69
-rw-r--r--doc/fr/weechat_tester.fr.asciidoc2
-rw-r--r--doc/fr/weechat_user.fr.asciidoc152
19 files changed, 580 insertions, 224 deletions
diff --git a/doc/fr/autogen/plugin_api/infos_hashtable.asciidoc b/doc/fr/autogen/plugin_api/infos_hashtable.asciidoc
index a6c076e09..7d84565b5 100644
--- a/doc/fr/autogen/plugin_api/infos_hashtable.asciidoc
+++ b/doc/fr/autogen/plugin_api/infos_hashtable.asciidoc
@@ -6,7 +6,7 @@
|===
| Extension | Nom | Description | Table de hachage (entrée) | Table de hachage (sortie)
-| irc | irc_message_parse | analyse un message IRC | "message" : message IRC, "server" : nom du serveur (optionnel) | "tags" : étiquettes, "message_without_tags" : message sans les étiquettes, "nick" : pseudo, "host" : nom d'hôte, "command" : commande, "channel" : canal, "arguments" : paramètres (inclut le canal)
+| irc | irc_message_parse | analyse un message IRC | "message" : message IRC, "server" : nom du serveur (optionnel) | "tags" : étiquettes, "message_without_tags" : message sans les étiquettes, "nick" : pseudo, "host" : nom d'hôte, "command" : commande, "channel" : canal, "arguments" : paramètres (inclut le canal), "text" : texte (par exemple message utilisateur), "pos_text" : index du texte dans le message ("-1" si aucun texte n'a été trouvé)
| irc | irc_message_split | découper un message IRC (pour tenir dans les 512 octets) | "message" : message IRC, "server" : nom du serveur (optionnel) | "msg1" ... "msgN" : messages à envoyer (sans le "\r\n" final), "args1" ... "argsN" : paramètres des messages, "count" : nombre de messages
diff --git a/doc/fr/autogen/user/alias_commands.asciidoc b/doc/fr/autogen/user/alias_commands.asciidoc
index ba97cf0e1..345305967 100644
--- a/doc/fr/autogen/user/alias_commands.asciidoc
+++ b/doc/fr/autogen/user/alias_commands.asciidoc
@@ -3,17 +3,22 @@
// DO NOT EDIT BY HAND!
//
[[command_alias_alias]]
-[command]*`alias`* créer un alias pour une commande::
+[command]*`alias`* lister, ajouter ou retirer des alias de commande::
----
-/alias [-completion <complétion>] alias [<commande> [;<commande>...]]
+/alias list [<alias>]
+ add <alias> [<commande>[;<commande>...]]
+ addcompletion <complétion> <alias> [<commande>[;<commande>...]]
+ del <alias> [<alias>...]
-complétion : complétion pour l'alias (optionnel, par défaut la complétion se fait avec la commande cible)
- note : vous pouvez utiliser %%commande pour utiliser la complétion d'une commande existante
- alias : nom de l'alias (le caractère joker "*" est autorisé)
- commande : nom de la commande avec les paramètres (plusieurs commandes peuvent être séparées par des points-virgules)
-
-Sans paramètre, cette commande liste tous les alias définis.
+ list : afficher les alias (sans paramètre, cette liste est affichée)
+ add : ajouter un alias
+addcompletion : ajouter un alias avec une complétion personnalisée
+ del : supprimer un alias
+ complétion : complétion pour l'alias : par défaut la complétion se fait avec la commande cible
+ note : vous pouvez utiliser %%commande pour utiliser la complétion d'une commande existante
+ alias : nom de l'alias
+ commande : nom de la commande avec les paramètres (plusieurs commandes peuvent être séparées par des points-virgules)
Note : dans la commande, les variables spéciales sont remplacées :
$n : paramètre 'n' (entre 1 et 9)
@@ -25,14 +30,12 @@ Note : dans la commande, les variables spéciales sont remplacées :
$var : où "var" est une variable locale du tampon (voir /buffer localvar)
exemples : $nick, $channel, $server, $plugin, $name
-Pour supprimer un alias, utilisez la commande /unalias.
-
Exemples :
alias /split pour diviser la fenêtre horizontalement :
- /alias split /window splith
+ /alias add split /window splith
alias /hello pour dire "hello" sur tous les canaux mais pas sur #weechat :
- /alias hello /allchan -exclude=#weechat msg * hello
+ /alias add hello /allchan -exclude=#weechat msg * hello
alias /forcejoin pour envoyer la commande IRC "forcejoin" avec la complétion de /sajoin :
- /alias -completion %%sajoin forcejoin /quote forcejoin
+ /alias addcompletion %%sajoin forcejoin /quote forcejoin
----
diff --git a/doc/fr/autogen/user/aspell_commands.asciidoc b/doc/fr/autogen/user/aspell_commands.asciidoc
index cf12c2bd5..f2528f330 100644
--- a/doc/fr/autogen/user/aspell_commands.asciidoc
+++ b/doc/fr/autogen/user/aspell_commands.asciidoc
@@ -26,6 +26,8 @@ Pour activer aspell sur tous les tampons, utilisez l'option "default_dict", par
/set aspell.check.default_dict "en"
/aspell enable
+Pour afficher une liste des suggestions dans une barre, utilisez l'objet "aspell_suggest".
+
La touche par défaut pour activer/désactiver aspell est alt-s.
----
diff --git a/doc/fr/autogen/user/irc_commands.asciidoc b/doc/fr/autogen/user/irc_commands.asciidoc
index 1e1f8b177..182887601 100644
--- a/doc/fr/autogen/user/irc_commands.asciidoc
+++ b/doc/fr/autogen/user/irc_commands.asciidoc
@@ -92,10 +92,10 @@ Sans paramètre, cette commande affiche la liste des bannissements pour le canal
-all|-auto|-open [-nojoin] [-switch]
serveur : nom du serveur, qui peut être :
- - nom interne de serveur (créé par /server add, usage recommandé)
+ - nom interne de serveur (ajouté par /server add, usage recommandé)
- nom/port ou IP/port, le port par défaut est 6667
- URL avec le format : irc[6][s]://[pseudo[:mot_passe]@]irc.example.org[:port][/#canal1][,#canal2[...]]
- Note : pour une adresse/IP/URL, un serveur temporaire est créé (NON SAUVÉ), voir /help irc.look.temporary_servers
+ Note : pour une adresse/IP/URL, un serveur temporaire est ajouté (NON SAUVÉ), voir /help irc.look.temporary_servers
option : définir l'option pour le serveur (pour une option booléenne, la valeur peut être omise)
nooption : définir l'option booléenne à 'off' (par exemple : -nossl)
-all : se connecter à tous les serveurs définis dans la configuration
@@ -551,11 +551,12 @@ démon2 : faire suivre le message à ce démon
[command]*`query`* envoyer un message privé à un pseudo::
----
-/query [-server <serveur>] <pseudo>[,<pseudo>...] [<texte>]
+/query [-noswitch] [-server <serveur>] <pseudo>[,<pseudo>...] [<texte>]
-serveur : envoyer à ce serveur (nom interne)
- pseudo : pseudo
- texte : texte à envoyer
+-noswitch : ne pas basculer sur le nouveau tampon
+ serveur : envoyer à ce serveur (nom interne)
+ pseudo : pseudo
+ texte : texte à envoyer
----
[[command_irc_quiet]]
@@ -685,10 +686,10 @@ raison : raison
list : afficher les serveurs (sans paramètre, cette liste est affichée)
listfull : afficher les serveurs avec de l'info détaillée pour chaque
- add : créer un nouveau serveur
+ add : ajouter un nouveau serveur
serveur : nom du serveur, pour usage interne et affichage
nom : nom ou adresse IP du serveur avec port en option (défaut : 6667), plusieurs adresses peuvent être séparées par une virgule
- temp : créer un serveur temporaire (non sauvé)
+ temp : ajouter un serveur temporaire (non sauvé)
option : définir l'option pour le serveur (pour une option booléenne, la valeur peut être omise)
nooption : définir l'option booléenne à 'off' (par exemple : -nossl)
copy : dupliquer un serveur
diff --git a/doc/fr/autogen/user/irc_options.asciidoc b/doc/fr/autogen/user/irc_options.asciidoc
index 9eb784909..f357b574a 100644
--- a/doc/fr/autogen/user/irc_options.asciidoc
+++ b/doc/fr/autogen/user/irc_options.asciidoc
@@ -358,7 +358,7 @@
** valeurs: on, off (valeur par défaut: `on`)
* [[option_irc.look.temporary_servers]] *irc.look.temporary_servers*
-** description: `activer la création des serveurs temporaires avec la commande /connect`
+** description: `activer l'ajout automatique des serveurs temporaires avec la commande /connect`
** type: booléen
** valeurs: on, off (valeur par défaut: `off`)
@@ -543,7 +543,7 @@
** valeurs: toute chaîne (valeur par défaut: `""`)
* [[option_irc.server_default.nicks]] *irc.server_default.nicks*
-** description: `pseudos à utiliser sur le serveur (séparés par des virgules)`
+** description: `pseudos à utiliser sur le serveur (séparés par des virgules) (note : le contenu est évalué, voir /help eval)`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `""`)
@@ -613,7 +613,7 @@
** valeurs: 0 .. 2147483647 (valeur par défaut: `2048`)
* [[option_irc.server_default.ssl_fingerprint]] *irc.server_default.ssl_fingerprint*
-** description: `empreinte SHA1 du certificat qui est de confiance et accepté pour le serveur (elle doit avoir exactement 40 caractères hexadécimaux sans séparateurs) ; plusieurs empreintes peuvent être séparées par des virgules ; si cette option est définie, les autres vérifications sur les certificats ne sont PAS effectuées (option "ssl_verify")`
+** description: `empreinte du certificat qui est de confiance et accepté pour le serveur ; seuls les chiffres hexadécimaux sont autorisés (0-9, a-f) : 64 caractères pour SHA-512, 32 caractères pour SHA-256, 20 caractères pour SHA-1 (non sûr, non recommandé) ; plusieurs empreintes peuvent être séparées par des virgules ; si cette option est définie, les autres vérifications sur les certificats ne sont PAS effectuées (option "ssl_verify")`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `""`)
diff --git a/doc/fr/autogen/user/logger_options.asciidoc b/doc/fr/autogen/user/logger_options.asciidoc
index 0279e47f9..de76b9842 100644
--- a/doc/fr/autogen/user/logger_options.asciidoc
+++ b/doc/fr/autogen/user/logger_options.asciidoc
@@ -48,7 +48,7 @@
** valeurs: toute chaîne (valeur par défaut: `""`)
* [[option_logger.file.path]] *logger.file.path*
-** description: `chemin pour les fichiers de log WeeChat ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") ; les caractères de formatage de date sont autorisés (voir man strftime)`
+** description: `chemin pour les fichiers de log WeeChat ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") ; les caractères de formatage de date sont autorisés (voir man strftime) (note : le contenu est évalué, voir /help eval)`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `"%h/logs/"`)
diff --git a/doc/fr/autogen/user/script_options.asciidoc b/doc/fr/autogen/user/script_options.asciidoc
index be9ad6df1..b15305150 100644
--- a/doc/fr/autogen/user/script_options.asciidoc
+++ b/doc/fr/autogen/user/script_options.asciidoc
@@ -182,16 +182,16 @@
** type: entier
** valeurs: -1 .. 525600 (valeur par défaut: `1440`)
-* [[option_script.scripts.dir]] *script.scripts.dir*
-** description: `répertoire du cache local pour les scripts`
-** type: chaîne
-** valeurs: toute chaîne (valeur par défaut: `"%h/script"`)
-
* [[option_script.scripts.hold]] *script.scripts.hold*
** description: `scripts à "figer" : liste de scripts séparés par des virgules qui ne seront jamais mis à jour et ne peuvent pas être supprimés, par exemple : "buffers.pl,iset.pl"`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `""`)
+* [[option_script.scripts.path]] *script.scripts.path*
+** description: `répertoire du cache local pour les scripts ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") (note : le contenu est évalué, voir /help eval)`
+** type: chaîne
+** valeurs: toute chaîne (valeur par défaut: `"%h/script"`)
+
* [[option_script.scripts.url]] *script.scripts.url*
** description: `URL pour le fichier avec la liste des scripts ; par défaut HTTPS est forcé, voir l'option script.scripts.url_force_https`
** type: chaîne
diff --git a/doc/fr/autogen/user/weechat_commands.asciidoc b/doc/fr/autogen/user/weechat_commands.asciidoc
index 369df32b9..65132837b 100644
--- a/doc/fr/autogen/user/weechat_commands.asciidoc
+++ b/doc/fr/autogen/user/weechat_commands.asciidoc
@@ -194,6 +194,18 @@ Sans paramètre, cette commande active/désactive le mode curseur.
Lorsque la souris est activée (voir /help mouse), par défaut un clic du milieu démarre le mode curseur à ce point.
+Touches par défaut dans le mode curseur sur les messages de la zone de discussion :
+ m citer le message
+ q citer le préfixe + le message
+ Q citer l'heure + le préfixe + le message
+
+Touches par défaut dans le mode curseur sur la liste de pseudos :
+ b bannir le pseudo (/ban)
+ k éjecter le pseudo (/kick)
+ K éjecter et bannir le pseudo (/kickban)
+ q ouvrir une discussion privée avec le pseudo (/query)
+ w demander les informations sur l'utilisateur (/whois)
+
Exemples :
aller dans la liste des pseudos :
/cursor go nicklist
@@ -264,22 +276,28 @@ Pour forcer une comparaison de chaînes, ajoutez des guillemets autour de chaque
"50" > "100" ==> 1
Des variables sont remplacées dans l'expression, en utilisant le format ${variable}, la variable pouvant être, par ordre de priorité :
- 1. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
- 2. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
- 3. une couleur (format : "color:xxx")
- 4. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
- 5. une option (format : "fichier.section.option")
- 6. une variable locale du tampon
- 7. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
+ 1. une sous-chaîne évaluée (format : "eval:xxx")
+ 2. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
+ 3. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
+ 4. une couleur (format : "color:xxx")
+ 5. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
+ 6. la date/heure courante (format : "date" ou "date:format")
+ 7. une variable d'environnement (format : "env:XXX")
+ 8. une option (format : "fichier.section.option")
+ 9. une variable locale du tampon
+ 10. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
Le format du hdata peut être le suivant :
hdata.var1.var2... : démarrer avec un hdata (le pointeur doit être connu), et demander les variables l'une après l'autre (d'autres hdata peuvent être suivis)
- hdata[list].var1.var2... : démarrer avec un hdata en utilisant une liste, par exemple :
+ hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste, par exemple :
${buffer[gui_buffers].full_name} : nom complet du premier tampon dans la liste chaînée des tampons
${plugin[weechat_plugins].name} : nom de la première extension dans la liste chaînée des extensions
+ hdata[pointeur].var1.var2... : démarrer avec un hdata en utilisant un pointeur, par exemple :
+ ${buffer[0x1234abcd].full_name} : nom complet du tampon avec ce pointeur (peut être utilisé dans les triggers)
Pour le nom du hdata et des variables, voir la "Référence API extension", fonction "weechat_hdata_get".
Exemples (chaînes simples) :
/eval -n ${info:version} ==> 0.4.3
+ /eval -n ${env:HOME} ==> /home/user
/eval -n ${weechat.look.scroll_amount} ==> 3
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
@@ -287,6 +305,7 @@ Exemples (chaînes simples) :
/eval -n ${window.buffer.number} ==> 1
/eval -n ${\t} ==> <tab>
/eval -n ${hide:-,${relay.network.password}} ==> --------
+ /eval -n ${date:%H:%M:%S} ==> 07:46:40
Exemples (conditions) :
/eval -n -c ${window.buffer.number} > 2 ==> 0
@@ -660,12 +679,12 @@ mot_de_passe : mot de passe (optionnel)
valeur : nouvelle valeur pour l'option
Exemples :
- créer un proxy http, tournant en local, port 8888 :
+ ajouter un proxy http, tournant en local, port 8888 :
/proxy add local http 127.0.0.1 8888
- créer un proxy http en utilisant le protocole IPv6 :
+ ajouter un proxy http en utilisant le protocole IPv6 :
/proxy add local http ::1 8888
/proxy set local ipv6 on
- créer un proxy socks5 avec un utilisateur/mot de passe :
+ ajouter un proxy socks5 avec un utilisateur/mot de passe :
/proxy add myproxy socks5 sample.host.org 3128 myuser mypass
supprimer un proxy :
/proxy del myproxy
@@ -822,8 +841,9 @@ Exemples :
[command]*`upgrade`* mettre à jour WeeChat sans se déconnecter des serveurs::
----
-/upgrade [<chemin_vers_binaire>|-quit]
+/upgrade [-yes] [<chemin_vers_binaire>|-quit]
+ -yes : requis si l'option weechat.look.confirm_upgrade est activée
chemin_vers_binaire : chemin vers le binaire WeeChat (par défaut le binaire courant)
-dummy : ne rien faire (option utilisée pour éviter une complétion accidentelle avec "-quit")
-quit : fermer *TOUTES* les connexions, sauver la session et quitter, ce qui rend possible une restauration différée (voir ci-dessous)
diff --git a/doc/fr/autogen/user/weechat_options.asciidoc b/doc/fr/autogen/user/weechat_options.asciidoc
index d2e6967b8..e876a9041 100644
--- a/doc/fr/autogen/user/weechat_options.asciidoc
+++ b/doc/fr/autogen/user/weechat_options.asciidoc
@@ -542,6 +542,11 @@
** type: booléen
** valeurs: on, off (valeur par défaut: `off`)
+* [[option_weechat.look.confirm_upgrade]] *weechat.look.confirm_upgrade*
+** description: `si activé, la commande /upgrade doit être confirmée par le paramètre supplémentaire "-yes" (voir /help upgrade)`
+** type: booléen
+** valeurs: on, off (valeur par défaut: `off`)
+
* [[option_weechat.look.day_change]] *weechat.look.day_change*
** description: `affiche un message quand le jour change`
** type: booléen
@@ -712,6 +717,11 @@
** type: booléen
** valeurs: on, off (valeur par défaut: `on`)
+* [[option_weechat.look.key_grab_delay]] *weechat.look.key_grab_delay*
+** description: `délai par défaut (en millisecondes) pour capturer une touche (en utilisant la touche par défaut alt-k) ; ce délai peut être remplacé dans la commande /input (voir /help input)`
+** type: entier
+** valeurs: 1 .. 10000 (valeur par défaut: `800`)
+
* [[option_weechat.look.mouse]] *weechat.look.mouse*
** description: `activer le support de la souris`
** type: booléen
@@ -827,6 +837,21 @@
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `"|"`)
+* [[option_weechat.look.quote_nick_prefix]] *weechat.look.quote_nick_prefix*
+** description: `texte à afficher avant le pseudo dans la citation d'un message (voir /help cursor)`
+** type: chaîne
+** valeurs: toute chaîne (valeur par défaut: `"<"`)
+
+* [[option_weechat.look.quote_nick_suffix]] *weechat.look.quote_nick_suffix*
+** description: `texte à afficher après le pseudo dans la citation d'un message (voir /help cursor)`
+** type: chaîne
+** valeurs: toute chaîne (valeur par défaut: `">"`)
+
+* [[option_weechat.look.quote_time_format]] *weechat.look.quote_time_format*
+** description: `format de date/heure dans la citation d'un message (voir /help cursor)`
+** type: chaîne
+** valeurs: toute chaîne (valeur par défaut: `"%H:%M:%S"`)
+
* [[option_weechat.look.read_marker]] *weechat.look.read_marker*
** description: `utiliser un marqueur (ligne ou caractère) sur les tampons pour montrer la première ligne non lue`
** type: entier
@@ -912,6 +937,16 @@
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `"WeeChat ${info:version}"`)
+* [[option_weechat.look.word_chars_highlight]] *weechat.look.word_chars_highlight*
+** description: `liste de caractères (ou intervalle de caractères) séparés pas des virgules qui sont considérés comme faisant partie des mots pour les highlights ; chaque élément peut être un simple caractère, un intervalle de caractères (format : a-z), une classe de caractère large (par exemple "alnum", voir man wctype) ; un "!" avant un élément le rend négatif (c'est-à-dire le caractère ne fait PAS partie des mots) ; la valeur "*" correspond à n'importe quel caractère ; les caractères unicode sont autorisés avec le format \u1234, par exemple \u00A0 pour l'espace insécable (voir /help print pour les formats supportés)`
+** type: chaîne
+** valeurs: toute chaîne (valeur par défaut: `"!\u00A0,-,_,|,alnum"`)
+
+* [[option_weechat.look.word_chars_input]] *weechat.look.word_chars_input*
+** description: `liste de caractères (ou intervalle de caractères) séparés pas des virgules qui sont considérés comme faisant partie des mots pour la ligne de commande ; chaque élément peut être un simple caractère, un intervalle de caractères (format : a-z), une classe de caractère large (par exemple "alnum", voir man wctype) ; un "!" avant un élément le rend négatif (c'est-à-dire le caractère ne fait PAS partie des mots) ; la valeur "*" correspond à n'importe quel caractère ; les caractères unicode sont autorisés avec le format \u1234, par exemple \u00A0 pour l'espace insécable (voir /help print pour les formats supportés)`
+** type: chaîne
+** valeurs: toute chaîne (valeur par défaut: `"!\u00A0,-,_,|,alnum"`)
+
* [[option_weechat.network.connection_timeout]] *weechat.network.connection_timeout*
** description: `délai d'attente maximum (en secondes) pour la connexion à une machine distante (effectuée dans un processus fils)`
** type: entier
diff --git a/doc/fr/autogen/user/xfer_options.asciidoc b/doc/fr/autogen/user/xfer_options.asciidoc
index 28fbdc09d..007fe64ba 100644
--- a/doc/fr/autogen/user/xfer_options.asciidoc
+++ b/doc/fr/autogen/user/xfer_options.asciidoc
@@ -83,12 +83,12 @@
** valeurs: on, off (valeur par défaut: `on`)
* [[option_xfer.file.download_path]] *xfer.file.download_path*
-** description: `chemin où écrire les fichiers reçus ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")`
+** description: `chemin où écrire les fichiers reçus : "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") (note : le contenu est évalué, voir /help eval)`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `"%h/xfer"`)
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
-** description: `chemin pour lire les fichiers envoyés (quand aucun chemin n'est spécifié par l'utilisateur) ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")`
+** description: `chemin pour lire les fichiers envoyés (quand aucun chemin n'est spécifié par l'utilisateur) : "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") (note : le contenu est évalué, voir /help eval)`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `"~"`)
diff --git a/doc/fr/cmdline_options.fr.asciidoc b/doc/fr/cmdline_options.fr.asciidoc
index e0a35c86c..c90ecfa4c 100644
--- a/doc/fr/cmdline_options.fr.asciidoc
+++ b/doc/fr/cmdline_options.fr.asciidoc
@@ -9,6 +9,8 @@
(utilisé pour les fichiers de configuration, logs, extensions
et scripts de l'utilisateur), la valeur par défaut est '~/.weechat' (note :
le répertoire est créé s'il n'est pas trouvé par WeeChat).
+ Si cette option n'est pas donnée, la variable d'environnement WEECHAT_HOME
+ est utilisée (si non vide).
*-h*, *--help*::
Afficher l'aide.
diff --git a/doc/fr/weechat.1.fr.asciidoc b/doc/fr/weechat.1.fr.asciidoc
index 329ad9c84..5a65a7e63 100644
--- a/doc/fr/weechat.1.fr.asciidoc
+++ b/doc/fr/weechat.1.fr.asciidoc
@@ -17,7 +17,6 @@ weechat - le client de discussion extensible
== DESCRIPTION
-// TRANSLATION MISSING
WeeChat (Wee Enhanced Environment for Chat) est un client de discussion libre,
rapide et léger, conçu pour différents systèmes d'exploitation.
Il est hautement paramétrable et extensible avec des scripts.
diff --git a/doc/fr/weechat_dev.fr.asciidoc b/doc/fr/weechat_dev.fr.asciidoc
index 7928a8577..abc246afa 100644
--- a/doc/fr/weechat_dev.fr.asciidoc
+++ b/doc/fr/weechat_dev.fr.asciidoc
@@ -22,23 +22,36 @@ rapide et léger, conçu pour différents systèmes d'exploitation.
Ce manuel documente l'intérieur de WeeChat :
-* dépôt (sources, documentation, ...)
+* dépôts
* règles de développement
* le cœur
* les extensions
* comment contribuer à WeeChat.
-[[repository]]
-== Dépôt
+[[repositories]]
+== Dépôts
-WeeChat a deux dépôts principaux :
+Les dépôts de WeeChat sont dans l'organisation "weechat" de GitHub :
+https://github.com/weechat
-* dépôt principal : il contient le code source et la documentation, l'URL est :
- https://github.com/weechat/weechat
-* scripts : les scripts 'officiels' soumis sur weechat.org, l'URL est :
- https://github.com/weechat/scripts
+Liste des dépôts :
-Ce manuel documente seulement le dépôt principal.
+weechat::
+ dépôt principal avec le code source et la documentation
+
+scripts::
+ les scripts 'officiels' soumis sur weechat.org
+
+weechat.org::
+ le code source du site de WeeChat : https://weechat.org/
+
+weercd::
+ serveur de test IRC
+
+qweechat::
+ interface Qt distante pour WeeChat.
+
+Ce manuel documente seulement le dépôt 'weechat'.
[[overview]]
=== Vue d'ensemble
@@ -58,17 +71,17 @@ Les répertoires principaux de WeeChat sont :
| charset/ | Extension Charset
| exec/ | Extension Exec
| fifo/ | Extension Fifo (tube FIFO utilisé pour envoyer des commandes à WeeChat)
+| guile/ | API script Guile (scheme)
| irc/ | Extension IRC (Internet Relay Chat)
+| javascript/ | API script Javascript
| logger/ | Extension Logger (enregistrer les messages affichés dans des fichiers)
-| relay/ | Extension Relay (proxy IRC + relai pour interfaces distantes)
-| script/ | Gestionnaire de scripts
-| python/ | API script Python
+| lua/ | API script Lua
| perl/ | API script Perl
+| python/ | API script Python
+| relay/ | Extension Relay (proxy IRC + relai pour interfaces distantes)
| ruby/ | API script Ruby
-| lua/ | API script Lua
+| script/ | Gestionnaire de scripts
| tcl/ | API script Tcl
-| guile/ | API script Guile (scheme)
-| javascript/ | API script Javascript
| trigger/ | Extension Trigger
| xfer/ | Extension Xfer (IRC DCC fichier/discussion)
| tests/ | Tests
@@ -94,7 +107,6 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|===
| Chemin/fichier | Description
| core/ | Fonctions du cœur : point d'entrée, structures internes
-| weechat.c | Fonctions principales : options de ligne de commande, démarrage
| wee-arraylist.c | Listes avec tableau (« arraylists »)
| wee-backtrace.c | Afficher une trace après un plantage
| wee-command.c | Commandes du cœur de WeeChat
@@ -120,6 +132,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
| wee-utf8.c | Fonctions UTF-8
| wee-util.c | Quelques autres fonctions utilitaires
| wee-version.c | Fonctions pour la version de WeeChat
+| weechat.c | Fonctions principales : options de ligne de commande, démarrage
| gui/ | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces)
| gui-bar-item.c | Objets de barre
| gui-bar-window.c | Fenêtres de barre
@@ -168,6 +181,8 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
| weechat-plugin.h | En-tête destiné à être distribué avec les extensions WeeChat, pour les compiler
| alias/ | Extension Alias
| alias.c | Fonctions principales pour les alias
+| alias-command.c | Commandes Alias
+| alias-completion.c | Complétions pour Alias
| alias-config.c | Options de configuration des alias (fichier alias.conf)
| alias-info.c | Info/infolists/hdata pour les alias
| aspell/ | Extension Aspell
@@ -297,20 +312,21 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
[width="100%",cols="1v,5",options="header"]
|===
-| Chemin/fichier | Description
-| tests/ | Racine des tests
-| tests.cpp | Programme utilisé pour lancer les tests
-| unit/ | Racine des tests unitaires
-| core/ | Racine des tests unitaires pour le cœur
-| test-eval.cpp | Tests : évaluation d'expressions
-| test-hashtble.cpp | Tests : tables de hachage
-| test-hdata.cpp | Tests : hdata
-| test-infolist.cpp | Tests : infolists
-| test-list.cpp | Tests : listes
-| test-string.cpp | Tests : chaînes
-| test-url.cpp | Tests : URLs
-| test-utf8.cpp | Tests : UTF-8
-| test-util.cpp | Tests : fonctions utiles
+| Chemin/fichier | Description
+| tests/ | Racine des tests
+| tests.cpp | Programme utilisé pour lancer les tests
+| unit/ | Racine des tests unitaires
+| core/ | Racine des tests unitaires pour le cœur
+| test-arraylist.cpp | Tests : listes avec tableau (« arraylists »)
+| test-eval.cpp | Tests : évaluation d'expressions
+| test-hashtble.cpp | Tests : tables de hachage
+| test-hdata.cpp | Tests : hdata
+| test-infolist.cpp | Tests : infolists
+| test-list.cpp | Tests : listes
+| test-string.cpp | Tests : chaînes
+| test-url.cpp | Tests : URLs
+| test-utf8.cpp | Tests : UTF-8
+| test-util.cpp | Tests : fonctions utiles
|===
[[documentation_translations]]
@@ -326,16 +342,16 @@ Fichiers de documentation :
| asciidoc.css | Style Asciidoc
| docgen.py | Script Python pour construire les fichiers dans le répertoire 'autogen/' (voir ci-dessous)
| XX/ | Documentation pour la langue XX (langues : en, fr, de, it, ...)
+| cmdline_options.XX.asciidoc | Options de ligne de commande (fichier inclus dans la page de manuel et le guide utilisateur)
| weechat.1.XX.asciidoc | Page de manuel (`man weechat`)
-| weechat_quickstart.XX.asciidoc | Guide de démarrage
-| weechat_user.XX.asciidoc | Guide utilisateur
+| weechat_dev.XX.asciidoc | Guide du développeur (ce document)
| weechat_faq.XX.asciidoc | FAQ (questions fréquemment posées)
| weechat_plugin_api.XX.asciidoc | Référence API extension
+| weechat_quickstart.XX.asciidoc | Guide de démarrage
+| weechat_relay_protocol.XX.asciidoc | Protocole Relay (pour les interfaces distantes)
| weechat_scripting.XX.asciidoc | Guide pour scripts
| weechat_tester.XX.asciidoc | Guide du testeur
-| weechat_dev.XX.asciidoc | Guide du développeur (ce document)
-| weechat_relay_protocol.XX.asciidoc | Protocole Relay (pour les interfaces distantes)
-| cmdline_options.XX.asciidoc | Options de ligne de commande (fichier inclus dans la page de manuel et le guide utilisateur)
+| weechat_user.XX.asciidoc | Guide utilisateur
| autogen/ | Fichiers automatiquement générés avec le script docgen.py
| user/ | Fichiers automatiquement générés pour le guide utilisateur (ne *JAMAIS* les mettre à jour manuellement !)
| plugin_api/ | Fichiers automatiquement générés pour l'API extension (ne *JAMAIS* les mettre à jour manuellement !)
@@ -586,12 +602,13 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
[source,lisp]
----
-(add-hook 'c-mode-common-hook '(lambda ()
- (c-toggle-hungry-state t)
- (c-set-style "k&r")
- (setq c-basic-offset 4
- c-tab-always-indent t)
- (c-set-offset 'case-label '+)))
+(add-hook 'c-mode-common-hook
+ '(lambda ()
+ (c-toggle-hungry-state t)
+ (c-set-style "k&r")
+ (setq c-basic-offset 4)
+ (c-tab-always-indent t)
+ (c-set-offset 'case-label '+)))
----
[[coding_python_style]]
diff --git a/doc/fr/weechat_faq.fr.asciidoc b/doc/fr/weechat_faq.fr.asciidoc
index efde5c874..4d412161b 100644
--- a/doc/fr/weechat_faq.fr.asciidoc
+++ b/doc/fr/weechat_faq.fr.asciidoc
@@ -113,6 +113,19 @@ La locale UTF-8 est recommandée pour WeeChat. Si vous utilisez ISO ou une autre
locale, assurez-vous que *tout* soit configuré en ISO (terminal, screen, ...)
et *pas* en UTF-8.
+[[unicode_chars]]
+=== Certains caractères unicode sont affichés dans le terminal, mais pas dans WeeChat, pourquoi ?
+
+Cela peut être causé par un bug de la libc dans la fonction 'wcwidth' et
+devrait être corrigé dans la glibc 2.22 (peut-être pas encore disponible dans
+votre distribution).
+
+Il y a un moyen de contournement pour utiliser la fonction 'wcwidth' corrigée :
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat
+
+Voir ce rapport de bug pour plus d'informations :
+https://github.com/weechat/weechat/issues/79
+
[[bars_background]]
=== Des barres telles que le titre et le statut ne sont pas remplies, la couleur de fond s'arrête après le texte, pourquoi ?
@@ -559,7 +572,7 @@ Des serveurs tels que 'twitch' requièrent oauth pour se connecter.
L'oauth est simplement un mot de passe avec la valeur "oauth:XXXX".
-Vous pouvez créer un tel serveur et vous y connecter avec les commandes
+Vous pouvez ajouter un tel serveur et vous y connecter avec les commandes
suivantes (remplacez le nom et l'adresse par les valeurs appropriées) :
----
diff --git a/doc/fr/weechat_plugin_api.fr.asciidoc b/doc/fr/weechat_plugin_api.fr.asciidoc
index b08b19ce3..d24c4f53e 100644
--- a/doc/fr/weechat_plugin_api.fr.asciidoc
+++ b/doc/fr/weechat_plugin_api.fr.asciidoc
@@ -766,13 +766,15 @@ Cette fonction n'est pas disponible dans l'API script.
==== strcasestr
+_Mis à jour dans la 1.3._
+
Rechercher une chaîne indépendemment de la locale et de la casse.
Prototype :
[source,C]
----
-char *weechat_strcasestr (const char *string, const char *search);
+const char *weechat_strcasestr (const char *string, const char *search);
----
Paramètres :
@@ -783,12 +785,14 @@ Paramètres :
Valeur de retour :
* pointeur vers la chaîne trouvée, ou NULL si non trouvée
+ (_WeeChat ≥ 1.3_ : le pointeur retourné est un 'const char *' au lieu d'un
+ 'char *')
Exemple en C :
[source,C]
----
-char *pos = weechat_strcasestr ("aBcDeF", "de"); /* résultat : pointeur vers "DeF" */
+const char *pos = weechat_strcasestr ("aBcDeF", "de"); /* résultat : pointeur vers "DeF" */
----
[NOTE]
@@ -927,6 +931,64 @@ free (str);
[NOTE]
Cette fonction n'est pas disponible dans l'API script.
+==== string_eval_path_home
+
+_WeeChat ≥ 1.3._
+
+Évaluer un chemin en 3 étapes :
+
+. remplacer le `%h` du début par le répertoire maison de WeeChat,
+. remplacer le `~` du début par le répertoire maison de l'utilisateur (appel à
+ <<_string_expand_home,weechat_string_expand_home>>),
+. évaluer les variables
+ (voir <<_string_eval_expression,weechat_string_eval_expression>>).
+
+Prototype :
+
+[source,C]
+----
+char *weechat_string_eval_path_home (const char *path,
+ struct t_hashtable *pointers,
+ struct t_hashtable *extra_vars,
+ struct t_hashtable *options);
+----
+
+Paramètres :
+
+* 'path' : chemin
+* 'pointers' : table de hachage pour l'appel à la fonction
+ <<_string_eval_expression,weechat_string_eval_expression>>
+* 'extra_vars' : table de hachage pour l'appel à la fonction
+ <<_string_eval_expression,weechat_string_eval_expression>>
+* 'options' : table de hachage pour l'appel à la fonction
+ <<_string_eval_expression,weechat_string_eval_expression>>
+
+Valeur de retour :
+
+* chemin évalué (doit être supprimé par un appel à "free" après utilisation)
+
+Exemple en C :
+
+[source,C]
+----
+char *str = weechat_string_expand_home ("%h/test");
+/* result: "/home/xxx/.weechat/test" */
+/* ... */
+free (str);
+----
+
+Script (Python):
+
+[source,python]
+----
+# prototype
+path = weechat.string_eval_path_home(path, pointers, extra_vars, options)
+
+# exemple
+path = weechat.string_eval_path_home("%h/test", "", "", "")
+# path == "/home/xxx/.weechat/test"
+----
+
==== string_remove_quotes
Supprimer les apostrophes/guillemets au début et à la fin d'une chaîne (les
@@ -1877,7 +1939,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
==== string_eval_expression
-_WeeChat ≥ 0.4.0, mis à jour dans la 0.4.2 et 1.1._
+_WeeChat ≥ 0.4.0, mis à jour dans la 0.4.2, 1.0, 1.1, 1.2 et 1.3._
Évaluer l'expression et retourner le résultat sous forme de chaîne.
Les variables spéciales avec le format `${variable}` sont étendues (voir le
@@ -1935,13 +1997,20 @@ Valeur de retour :
Liste des variables étendues dans l'expression (par ordre de priorité, de la
première étendue à la dernière) :
-[width="100%",cols="2,8,3,3",options="header"]
+[width="100%",cols="2,8,4,4",options="header"]
|===
| Format | Description | Exemples | Résultats
| `${nom}` | Variable `nom` de la table de hachage 'extra_vars' |
`${nom}` | `valeur`
+| `${eval:xxx}` +
+ (_WeeChat ≥ 1.3_) |
+ Chaîne à évaluer |
+ `${eval:${date:${weechat.look.buffer_time_format}}}` |
+ `19:02:45` (avec des couleurs s'il y a des codes couleur dans l'option
+ weechat.look.buffer_time_format)
+
| `${esc:xxx}` +
`${\xxx}` | Chaîne avec caractères échappés |
`${esc:préfixe\tmessage}` +
@@ -1962,14 +2031,15 @@ première étendue à la dernière) :
`test`
| `${color:nom}` |
- Code couleur WeeChat (le nom de couleur a des attributs facultatifs) |
+ Code couleur WeeChat (le nom de couleur a des attributs facultatifs),
+ voir la fonction <<_color,weechat_color>> pour les formats supportés |
`${color:red}texte rouge` +
`${color:*214}texte orange gras` |
`texte rouge` (en rouge) +
`texte orange gras` (en orange gras)
-| `${info:name}` +
- `${indo:name,arguments}` |
+| `${info:nom}` +
+ `${info:nom,paramètres}` |
Info de WeeChat ou d'une extension, voir la fonction
<<_info_get,weechat_info_get>> |
`${info:version}` +
@@ -1977,12 +2047,28 @@ première étendue à la dernière) :
`1.0` +
`lightblue`
+| `${date}` +
+ `${date:xxx}` +
+ (_WeeChat ≥ 1.3_) |
+ La date/heure courante, avec un format personnalisé (voir `man strftime`),
+ le format par défaut est `%F %T` |
+ `${date}` +
+ `${date:%H:%M:%S}` |
+ `2015-06-30 19:02:45` +
+ `19:02:45`
+
+| `${env:NOM}` +
+ (_WeeChat ≥ 1.2_) |
+ Valeur de la variable d'environnement `NOM` |
+ `${env:HOME}` |
+ `/home/user`
+
| `${sec.data.nom}` |
Valeur de la donnée sécurisée `nom` |
`${sec.data.freenode_pass}` |
`mon_mot_de_passe`
-| `${file.section.option}` |
+| `${fichier.section.option}` |
Valeur de l'option |
`${weechat.look.buffer_time_format}` |
`%H:%M:%S`
@@ -2173,13 +2259,16 @@ Cette fonction n'est pas disponible dans l'API script.
==== utf8_prev_char
+_Mis à jour dans la 1.3._
+
Retourner un pointeur vers le caractère UTF-8 précédent dans une chaîne.
Prototype :
[source,C]
----
-char *weechat_utf8_prev_char (const char *string_start, const char *string);
+const char *weechat_utf8_prev_char (const char *string_start,
+ const char *string);
----
Paramètres :
@@ -2192,12 +2281,14 @@ Valeur de retour :
* pointeur vers le caractère UTF-8 précédent, NULL si non trouvé (début de
chaîne atteint)
+ (_WeeChat ≥ 1.3_ : le pointeur retourné est un 'const char *' au lieu d'un
+ 'char *')
Exemple en C :
[source,C]
----
-char *prev_char = weechat_utf8_prev_char (string, ptr_in_string);
+const char *prev_char = weechat_utf8_prev_char (string, ptr_in_string);
----
[NOTE]
@@ -2205,13 +2296,15 @@ Cette fonction n'est pas disponible dans l'API script.
==== utf8_next_char
+_Mis à jour dans la 1.3._
+
Retourner un pointeur vers le caractère UTF-8 suivant dans une chaîne.
Prototype :
[source,C]
----
-char *weechat_utf8_next_char (const char *string);
+const char *weechat_utf8_next_char (const char *string);
----
Paramètres :
@@ -2222,12 +2315,14 @@ Valeur de retour :
* pointeur vers le caractère UTF-8 suivant, NULL si non trouvé (fin de la
chaîne atteinte)
+ (_WeeChat ≥ 1.3_ : le pointeur retourné est un 'const char *' au lieu d'un
+ 'char *')
Exemple en C :
[source,C]
----
-char *next_char = weechat_utf8_next_char (string);
+const char *next_char = weechat_utf8_next_char (string);
----
[NOTE]
@@ -2481,13 +2576,15 @@ Cette fonction n'est pas disponible dans l'API script.
==== utf8_add_offset
+_Mis à jour dans la 1.3._
+
Avancer de N caractères dans une chaîne UTF-8.
Prototype :
[source,C]
----
-char *weechat_utf8_add_offset (const char *string, int offset);
+const char *weechat_utf8_add_offset (const char *string, int offset);
----
Paramètres :
@@ -2499,13 +2596,15 @@ Valeur de retour :
* pointeur vers la chaîne, N caractères après (NULL s'il est impossible
d'atteindre cette position dans la chaîne)
+ (_WeeChat ≥ 1.3_ : le pointeur retourné est un 'const char *' au lieu d'un
+ 'char *')
Exemple en C :
[source,C]
----
-char *str = "chêne";
-char *str2 = weechat_utf8_add_offset (str, 3); /* pointe vers "ne" */
+const char *str = "chêne";
+const char *str2 = weechat_utf8_add_offset (str, 3); /* pointe vers "ne" */
----
[NOTE]
@@ -2916,21 +3015,26 @@ Cette fonction n'est pas disponible dans l'API script.
==== util_get_time_string
-_WeeChat ≥ 0.3.2._
+_WeeChat ≥ 0.3.2, mise à jour dans la 1.3._
-Retourner la date/heure sous forme de chaîne construite avec "strftime".
+Retourner la date/heure sous forme de chaîne construite avec "strftime" et le
+format défini dans l'option 'weechat.look.time_format'.
Prototype :
[source,C]
----
-char *weechat_util_get_time_string (const time_t *date);
+const char *weechat_util_get_time_string (const time_t *date);
----
Paramètres :
* 'date' : pointeur vers la date
+Valeur de retour :
+
+* pointeur vers une chaîne contenant la date/heure
+
Exemple en C :
[source,C]
@@ -6587,7 +6691,10 @@ const char *weechat_color (const char *color_name);
Paramètres :
* 'color_name' : nom de la couleur, parmi :
-** une option WeeChat (de weechat.color.xxx), par exemple 'chat_delimiters'
+** le nom d'une option de couleur WeeChat (de weechat.color.xxx), par exemple
+ 'chat_delimiters'
+** le nom d'une option (format: fichier.section.option), par exemple
+ 'irc.color.message_quit' (_WeeChat ≥ 1.2_)
** une couleur avec des attributs/fond optionnels (voir ci-dessous)
** un attribut :
*** 'bold' : activer le gras
@@ -7245,6 +7352,8 @@ hook = weechat.hook_timer(20 * 1000, 0, 0, "my_timer_cb", "")
==== hook_fd
+_Mis à jour dans la 1.3._
+
Accrocher un descripteur de fichier (fichier ou socket).
Prototype :
@@ -7266,6 +7375,7 @@ Paramètres :
* 'flag_read' : 1 = intercepter un évènement de lecture, 0 = ignorer
* 'flag_write' : 1 = intercepter un évènement d'écriture, 0 = ignorer
* 'flag_exception' : 1 = intercepter un évènement d'exception, 0 = ignorer
+ (_WeeChat ≥ 1.3_ : ce paramètre est ignoré et n'est plus utilisé)
* 'callback' : fonction appelée lorsqu'un des évènements sélectionnés se
produit pour le fichier (ou le socket), paramètres et valeur de retour :
** 'void *data' : pointeur
@@ -8525,6 +8635,21 @@ Liste des signaux envoyés par WeeChat et les extensions :
Chaîne : paramètres pour le /quit |
La commande `/quit` a été exécutée par l'utilisateur
+| weechat | signal_sighup +
+ _(WeeChat ≥ 1.3)_ |
+ - |
+ Signal SIGHUP reçu
+
+| weechat | signal_sigquit +
+ _(WeeChat ≥ 1.2)_ |
+ - |
+ Signal SIGQUIT reçu (requête pour quitter avec une copie de la mémoire)
+
+| weechat | signal_sigterm +
+ _(WeeChat ≥ 1.2)_ |
+ - |
+ Signal SIGTERM reçu (arrêt propre du processus WeeChat)
+
| weechat | signal_sigwinch +
_(WeeChat ≥ 0.4.3)_ |
- |
@@ -10064,36 +10189,98 @@ de type "string") :
[width="100%",cols="5m,5,8,3",options="header"]
|===
-| Clé ^(1)^ | Description | Exemples de valeur | Valeur si non applicable
-| _x | Colonne sur l'écran 2+| "0" ... "n"
-| _y | Ligne sur l'écran 2+| "0" ... "n"
-| _key | Touche ou évènement souris 2+| "button1", "button2-gesture-left", ...
-| _window | Pointeur vers la fenêtre | "0x12345678" | ""
-| _window_number | Numéro de la fenêtre | "1" ... "n" | "*"
-| _buffer | Pointeur vers le tampon | "0x12345678" | ""
-| _buffer_number | Numéro du tampon | "1" ... "n" | "-1"
-| _buffer_plugin | Nom d'extension du tampon | "core", "irc", ... | ""
-| _buffer_name | Nom du tampon | "weechat", "freenode.#weechat", ... | ""
-| _buffer_full_name | Nom complet du tampon | "core.weechat", "irc.freenode.#weechat", ... | ""
-| _buffer_localvar_XXX ^(2)^ | Variables locales du tampon | toute chaîne | non défini
-| _chat | Indicateur zone "chat" | "0" ou "1" | "0"
-| _chat_line_x | Colonne de la ligne ^(3)^ | "0" ... "n" | "-1"
-| _chat_line_y | Numéro de ligne ^(3)^ | "0" ... "n" | "-1"
-| _chat_line_date | Date/heure de la ligne | "1313237175" | "0"
-| _chat_line_date_printed | Date/heure de la ligne ^(4)^ | "1313237175" | "0"
-| _chat_line_time | Heure affichée | "14:06:15" | ""
-| _chat_line_tags | Étiquettes de la ligne | "irc_privmsg,nick_flashy,log1" | ""
-| _chat_line_nick | Pseudo de la ligne | "FlashCode" | ""
-| _chat_line_prefix | Préfixe de la ligne | "@FlashCode" | ""
-| _chat_line_message | Message de la ligne | "Hello world!" | ""
-| _chat_word | Mot à la position (x,y) | "Hello" | ""
-| _chat_bol | Début de ligne ⇒ (x-1,y) | "He" | ""
-| _chat_eol | (x,y) ⇒ fin de ligne | "llo world!" | ""
-| _bar_name | Nom de la barre | "title", "nicklist", ... | ""
-| _bar_filling | Remplissage de la barre | "horizontal", "vertical", ... | ""
-| _bar_item_name | Nom de l'objet de barre | "buffer_nicklist", "hotlist", ... | ""
-| _bar_item_line | Ligne dans l'objet de barre | "0" ... "n" | "-1"
-| _bar_item_col | Colonne dans l'objet de barre | "0" ... "n" | "-1"
+| Clé ^(1)^ | Description | Exemples de valeur | Valeur si non applicable
+
+| _x | Colonne sur l'écran |
+ "0" ... "n" |
+
+| _y | Ligne sur l'écran |
+ "0" ... "n" |
+
+| _key | Touche ou évènement souris |
+ "button1", "button2-gesture-left", ... |
+
+| _window | Pointeur vers la fenêtre |
+ "0x12345678" | ""
+
+| _window_number | Numéro de la fenêtre |
+ "1" ... "n" | "*"
+
+| _buffer | Pointeur vers le tampon |
+ "0x12345678" | ""
+
+| _buffer_number | Numéro du tampon |
+ "1" ... "n" | "-1"
+
+| _buffer_plugin | Nom d'extension du tampon |
+ "core", "irc", ... | ""
+
+| _buffer_name | Nom du tampon |
+ "weechat", "freenode.#weechat", ... | ""
+
+| _buffer_full_name | Nom complet du tampon |
+ "core.weechat", "irc.freenode.#weechat", ... | ""
+
+| _buffer_localvar_XXX ^(2)^ | Variables locales du tampon |
+ toute chaîne | non défini
+
+| _chat | Indicateur zone "chat" |
+ "0" ou "1" | "0"
+
+| _chat_line | Pointeur vers la ligne +
+ _(WeeChat ≥ 1.2)_ |
+ "0x12345678" | ""
+
+| _chat_line_x | Colonne de la ligne ^(3)^ |
+ "0" ... "n" | "-1"
+
+| _chat_line_y | Numéro de ligne ^(3)^ |
+ "0" ... "n" | "-1"
+
+| _chat_line_date | Date/heure de la ligne |
+ "1313237175" | "0"
+
+| _chat_line_date_printed | Date/heure de la ligne ^(4)^ |
+ "1313237175" | "0"
+
+| _chat_line_time | Heure affichée |
+ "14:06:15" | ""
+
+| _chat_line_tags | Étiquettes de la ligne |
+ "irc_privmsg,nick_flashy,log1" | ""
+
+| _chat_line_nick | Pseudo de la ligne |
+ "FlashCode" | ""
+
+| _chat_line_prefix | Préfixe de la ligne |
+ "@FlashCode" | ""
+
+| _chat_line_message | Message de la ligne |
+ "Hello world!" | ""
+
+| _chat_word | Mot à la position (x,y) |
+ "Hello" | ""
+
+| _chat_bol | Début de ligne ⇒ (x-1,y) |
+ "He" | ""
+
+| _chat_eol | (x,y) ⇒ fin de ligne |
+ "llo world!" | ""
+
+| _bar_name | Nom de la barre |
+ "title", "nicklist", ... | ""
+
+| _bar_filling | Remplissage de la barre |
+ "horizontal", "vertical", ... | ""
+
+| _bar_item_name | Nom de l'objet de barre |
+ "buffer_nicklist", "hotlist", ... | ""
+
+| _bar_item_line | Ligne dans l'objet de barre |
+ "0" ... "n" | "-1"
+
+| _bar_item_col | Colonne dans l'objet de barre |
+ "0" ... "n" | "-1"
|===
[NOTE]
@@ -13006,23 +13193,33 @@ hashtable_in = weechat_hashtable_new (8,
NULL);
if (hashtable_in)
{
- weechat_hashtable_set (hashtable_in, "message",
- ":nick!user@host PRIVMSG #weechat :message ici");
+ weechat_hashtable_set (
+ hashtable_in,
+ "message",
+ "@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!");
hashtable_out = weechat_info_get_hashtable ("irc_message_parse",
hashtable_in);
/*
* maintenant hashtable_out a les clés/valeurs suivantes :
- * "nick" : "nick"
- * "host" : "nick!user@host"
- * "command" : "PRIVMSG"
- * "channel" : "#weechat"
- * "arguments": "#weechat :message ici"
+ * "tags" : "time=2015-06-27T16:40:35.000Z"
+ * "message_without_tags": ":nick!user@host PRIVMSG #weechat :hello!"
+ * "nick" : "nick"
+ * "host" : "nick!user@host"
+ * "command" : "PRIVMSG"
+ * "channel" : "#weechat"
+ * "arguments" : "#weechat :hello!"
+ * "text" : "hello!"
+ * "pos_text" : "65"
*/
weechat_hashtable_free (hashtable_in);
weechat_hashtable_free (hashtable_out);
}
----
+[NOTE]
+Voir le 'Guide pour Scripts WeeChat' pour plus d'infos sur la sortie de
+"irc_message_parse".
+
Script (Python) :
[source,python]
diff --git a/doc/fr/weechat_quickstart.fr.asciidoc b/doc/fr/weechat_quickstart.fr.asciidoc
index 68e0effc4..db4f8eda5 100644
--- a/doc/fr/weechat_quickstart.fr.asciidoc
+++ b/doc/fr/weechat_quickstart.fr.asciidoc
@@ -97,8 +97,8 @@ Tous les protocoles réseau comme IRC sont fournis sous forme d'extensions.
Utilisez la commande `/plugin` pour voir les extensions chargées, vous
devriez voir "irc" et d'autres extensions dans cette liste.
-[[create_irc_server]]
-== Créer un serveur IRC
+[[add_irc_server]]
+== Ajouter un serveur IRC
Vous pouvez ajouter un serveur IRC avec la commande `/server`, par exemple :
diff --git a/doc/fr/weechat_scripting.fr.asciidoc b/doc/fr/weechat_scripting.fr.asciidoc
index d5e3a08e7..bcbd659f6 100644
--- a/doc/fr/weechat_scripting.fr.asciidoc
+++ b/doc/fr/weechat_scripting.fr.asciidoc
@@ -402,7 +402,7 @@ Liste des fonctions de l'API script :
charset_set, iconv_to_internal, iconv_from_internal, gettext, ngettext, +
strlen_screen, string_match, string_has_highlight, string_has_highlight_regex,
string_mask_to_regex, string_remove_color, string_is_command_char,
- string_input_for_buffer, string_eval_expression
+ string_input_for_buffer, string_eval_expression, string_eval_path_home
| répertoires |
mkdir_home, mkdir, mkdir_parents
| listes triées |
@@ -922,14 +922,69 @@ _Nouveau dans la version 0.3.4._
Vous pouvez analyser un message IRC avec l'info_hashtable appelée
"irc_message_parse".
+Le résultat est une table de hachage avec les clés suivantes
+(les exemples de valeurs sont construits avec ce message :
+`@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!`):
+
+[width="100%",cols="1,^2,10,8",options="header"]
+|===
+| Clé | Version de WeeChat | Description | Exemple
+
+| tags | ≥ 0.4.0 |
+ Les étiquettes dans le message (peut être vide) |
+ `time=2015-06-27T16:40:35.000Z`
+
+| message_without_tags | ≥ 0.4.0 |
+ Le message sans les étiquettes (la même chose que le message s'il n'y a pas
+ d'étiquettes) |
+ `:nick!user@host PRIVMSG #weechat :hello!`
+
+| nick | ≥ 0.3.4 |
+ Le pseudo d'origine |
+ `nick`
+
+| host | ≥ 0.3.4 |
+ L'hôte d'origine (incluant le pseudo) |
+ `nick!user@host`
+
+| command | ≥ 0.3.4 |
+ La commande ('PRIVMSG', 'NOTICE', ...) |
+ `PRIVMSG`
+
+| channel | ≥ 0.3.4 |
+ Le canal cible |
+ `#weechat`
+
+| arguments | ≥ 0.3.4 |
+ Les paramètres de la commande (incluant le canal) |
+ `#weechat :hello!`
+
+| text | ≥ 1.3 |
+ Le texte (par exemple un message utilisateur) |
+ `hello!`
+
+| pos_text | ≥ 1.3 |
+ La position du texte dans le message ("-1" si le texte n'a pas été trouvé) |
+ `65`
+|===
+
[source,python]
----
-dict = weechat.info_get_hashtable("irc_message_parse",
- {"message": ":nick!user@host PRIVMSG #weechat :message ici"})
-weechat.prnt("", "dict: %s" % dict)
-
-# output:
-# dict: {'nick': 'nick', 'host': 'nick!user@host', 'command': 'PRIVMSG', 'arguments': '#weechat :message ici', 'channel': '#weechat'}
+dict = weechat.info_get_hashtable(
+ "irc_message_parse",
+ {"message": "@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!"})
+
+# dict == {
+# "tags": "time=2015-06-27T16:40:35.000Z",
+# "message_without_tags": ":nick!user@host PRIVMSG #weechat :hello!",
+# "nick": "nick",
+# "host": "nick!user@host",
+# "command": "PRIVMSG",
+# "channel": "#weechat",
+# "arguments": "#weechat :hello!",
+# "text": "hello!",
+# "pos_text": "65",
+# }
----
[[infos]]
diff --git a/doc/fr/weechat_tester.fr.asciidoc b/doc/fr/weechat_tester.fr.asciidoc
index c035d1ce7..6c51cb220 100644
--- a/doc/fr/weechat_tester.fr.asciidoc
+++ b/doc/fr/weechat_tester.fr.asciidoc
@@ -91,7 +91,7 @@ Pour compiler les sources, cmake est recommandé :
----
$ mkdir build
$ cd build
-$ cmake .. -DPREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug
+$ cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug
$ make
$ make install
----
diff --git a/doc/fr/weechat_user.fr.asciidoc b/doc/fr/weechat_user.fr.asciidoc
index 3d360e0a6..27a70f167 100644
--- a/doc/fr/weechat_user.fr.asciidoc
+++ b/doc/fr/weechat_user.fr.asciidoc
@@ -34,6 +34,7 @@ Ses principales fonctionnalités sont les suivantes :
http://tools.ietf.org/html/rfc2811[2811],
http://tools.ietf.org/html/rfc2812[2812] et
http://tools.ietf.org/html/rfc2813[2813]
+* proxy IRC et relai pour interfaces distantes
* multi plates-formes (GNU/Linux, *BSD, MacOS X, Windows et d'autres systèmes)
* 100% GPL, logiciel libre
@@ -65,6 +66,7 @@ Les paquets binaires sont disponibles pour beaucoup de distributions, dont :
* Arch Linux : `pacman -S weechat`
* Fedora Core : `yum install weechat`
* Sourcemage : `cast weechat`
+* Cygwin (Windows) : sélectionnez les paquets WeeChat dans setup.exe
Des paquets additionnels peuvent être utiles également, comme weechat-plugins.
@@ -88,78 +90,78 @@ Sous OS X, vous pouvez utiliser http://brew.sh/[Homebrew] :
Le tableau suivant liste les paquets qui sont requis ou optionnels pour
compiler WeeChat.
-[width="100%",cols="5,^3,^3,^3,.^13",options="header"]
+[width="100%",cols="5,^3,^3,.^13",options="header"]
|===
-| Paquet ^(1)^ | Version min | Version max | Requis | Fonctionnalité
+| Paquet ^(1)^ | Version | Requis | Fonctionnalité
-| cmake | | | *oui* |
+| cmake | | *oui* |
Construction (autotools toujours possible, mais cmake est recommandé)
-| pkg-config | | | *oui* |
+| pkg-config | | *oui* |
Détection des bibliothèques installées
-| libncursesw5-dev ^(2)^ | | | *oui* |
+| libncursesw5-dev ^(2)^ | | *oui* |
Interface ncurses
-| libcurl4-gnutls-dev | | | *oui* |
+| libcurl4-gnutls-dev | | *oui* |
Transfert d'URL
-| zlib1g-dev | | | *oui* |
+| zlib1g-dev | | *oui* |
Compression des paquets dans l'extension relay (protocole weechat),
extension script
-| libgcrypt20-dev | | | *oui* |
+| libgcrypt20-dev | | *oui* |
Données sécurisées, authentification IRC SASL (DH-BLOWFISH/DH-AES),
extension script
-| libgnutls28-dev | 2.2.0 ^(3)^ | | |
+| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | |
Connexion SSL au serveur IRC, support SSL dans l'extension relay,
authentification IRC SASL (ECDSA-NIST256P-CHALLENGE)
-| gettext | | | |
+| gettext | | |
Internationalisation (traduction des messages; la langue de base est
l'anglais)
-| ca-certificates | | | |
+| ca-certificates | | |
Certificats pour les connexions SSL
-| libaspell-dev ou libenchant-dev | | | |
+| libaspell-dev ou libenchant-dev | | |
Extension aspell
-| python-dev | 2.5 ^(4)^ | | |
+| python-dev | ≥ 2.5 ^(4)^ | |
Extension python
-| libperl-dev | | | |
+| libperl-dev | | |
Extension perl
-| ruby2.1-dev | 1.8 | | |
+| ruby2.1-dev | ≥ 1.8 | |
Extension ruby
-| liblua5.2-dev | | | |
+| liblua5.2-dev | | |
Extension lua
-| tcl-dev | 8.5 | | |
+| tcl-dev | ≥ 8.5 | |
Extension tcl
-| guile-2.0-dev | 2.0 | | |
+| guile-2.0-dev | ≥ 2.0 | |
Extension guile (scheme)
-| libv8-dev | | 3.24.3 | |
+| libv8-dev | ≤ 3.24.3 | |
Extension javascript
-| asciidoc | 8.5.0 | | |
+| asciidoc | ≥ 8.5.0 | |
Construction de la page man et de la documentation
-| source-highlight | | | |
+| source-highlight | | |
Coloration des sources dans la documentation
-| xsltproc, docbook-xml, docbook-xsl | | | |
+| xsltproc, docbook-xml, docbook-xsl | | |
Construction de la page de manuel
-| libcpputest-dev | 3.4 | | |
+| libcpputest-dev | ≥ 3.4 | |
Lancement des tests
-| C++ compiler | | | |
+| C++ compiler | | |
Lancement des tests, extension javascript
|===
@@ -191,7 +193,7 @@ $ make
----
$ mkdir build
$ cd build
-$ cmake .. -DPREFIX=/chemin/vers/répertoire
+$ cmake .. -DCMAKE_INSTALL_PREFIX=/chemin/vers/répertoire
$ make
$ make install
----
@@ -208,7 +210,7 @@ Liste des options couramment utilisées :
Type de construction: `Debug` (ou `RelWithDebInfo`) est recommandé si vous
utilisez une version de développement de WeeChat.
-| PREFIX | répertoire | /usr/local |
+| CMAKE_INSTALL_PREFIX | répertoire | /usr/local |
Le répertoire dans lequel WeeChat sera installé.
| WEECHAT_HOME | répertoire | ~/.weechat |
@@ -865,45 +867,45 @@ Les barres par défaut 'title', 'status' et 'input' ont un remplissage
Quelques exemples de remplissage pour la barre 'nicklist' :
....
-┌──────────────────────────────────────────────────┐
-│Welcome to #test, this is a test channel │
-│12:54:15 peter | hey! │@carl │
-│12:55:01 +Max | hello │@jessika│
-│ │@maddy │
-│ │%Diego │
-│ │%Melody │
-│ │+Max │
-│ │ celia │
-│ │ Eva │
-│ │ freddy │
-│ │ Harold^│
-│ │ henry4 │
-│ │ jimmy17│
-│ │ jodie ▼│
-│[12:55] [6] [irc/freenode] 3:#test(+n){24} │
-│[@carl] █ │
-└──────────────────────────────────────────────────┘
- filling_left_right = vertical ▲
-
-┌──────────────────────────────────────────────────┐
-│Welcome to #test, this is a test channel │
-│12:54:15 peter | hey! │@carl lee │
-│12:55:01 +Max | hello │@jessika louise │
-│ │@maddy mario │
-│ │%Diego mark │
-│ │%Melody peter │
-│ │+Max Rachel │
-│ │ celia richard│
-│ │ Eva sheryl │
-│ │ freddy Vince │
-│ │ Harold^ warren │
-│ │ henry4 zack │
-│ │ jimmy17 │
-│ │ jodie │
-│[12:55] [6] [irc/freenode] 3:#test(+n){24} │
-│[@carl] █ │
-└──────────────────────────────────────────────────┘
- filling_left_right = columns_vertical ▲
+┌───────────────────────────────────────────────────────────────────────┐
+│Welcome to #test, this is a test channel │
+│12:54:15 peter | hey! │@carl │
+│12:55:01 +Max | hello │@jessika│
+│ │@maddy │
+│ │%Diego │
+│ │%Melody │
+│ │+Max │
+│ │ celia │
+│ │ Eva │
+│ │ freddy │
+│ │ Harold^│
+│ │ henry4 │
+│ │ jimmy17│
+│ │ jodie ▼│
+│[12:55] [6] [irc/freenode] 3:#test(+n){24} │
+│[@carl] █ │
+└───────────────────────────────────────────────────────────────────────┘
+ filling_left_right = vertical ▲
+
+┌───────────────────────────────────────────────────────────────────────┐
+│Welcome to #test, this is a test channel │
+│12:54:15 peter | hey! │@carl lee │
+│12:55:01 +Max | hello │@jessika louise │
+│ │@maddy mario │
+│ │%Diego mark │
+│ │%Melody peter │
+│ │+Max Rachel │
+│ │ celia richard│
+│ │ Eva sheryl │
+│ │ freddy Vince │
+│ │ Harold^ warren │
+│ │ henry4 zack │
+│ │ jimmy17 │
+│ │ jodie │
+│[12:55] [6] [irc/freenode] 3:#test(+n){24} │
+│[@carl] █ │
+└───────────────────────────────────────────────────────────────────────┘
+ filling_left_right = columns_vertical ▲
┌───────────────────────────────────────────────────────────────────────┐
│@carl %Diego celia Harold^ jodie mario Rachel Vince │
@@ -1186,7 +1188,7 @@ commande `/buffer` :
| key[alt-j,alt-r] | Sauter au tampon IRC de données brutes | `/server raw`
| key[alt-j,alt-s] | Sauter au tampon IRC du serveur | `/server jump`
| key[alt-0...9] | Sauter au tampon qui porte ce numéro (0 = 10) | `/buffer *N`
-| key[alt-j,01...99] | Sauter au tampon qui porte ce numéro | `/buffer NN`
+| key[alt-j,01...99] | Sauter au tampon qui porte ce numéro | `/buffer *NN`
| key[alt-l] | Activer/désactiver le mode d'affichage dépouillé | `/window bare`
| key[alt-m] | Activer/désactiver la souris | `/mouse toggle`
| key[alt-n] | Se positionner sur le highlight suivant | `/window scroll_next_highlight`
@@ -2257,7 +2259,7 @@ $ wget -O ~/.weechat/ssl/CAs.pem http://www.spi-inc.org/ca/spi-cacert.crt
Note: il est possible de concaténer plusieurs certificats dans une le fichier
CAs.pem.
-* Sous WeeChat, avec le serveur "oftc" déjà créé :
+* Sous WeeChat, avec le serveur "oftc" déjà ajouté :
----
/connect oftc
@@ -2274,7 +2276,7 @@ $ cd ~/.weechat/ssl
$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
----
-* Sous WeeChat, avec le serveur "oftc" déjà créé :
+* Sous WeeChat, avec le serveur "oftc" déjà ajouté :
----
/set irc.server.oftc.ssl_cert "%h/ssl/nick.pem"
@@ -2366,14 +2368,14 @@ En premier lieu, installez TOR. Pour Debian (et dérivés) :
$ sudo apt-get install tor
----
-Sous WeeChat vous devez créer un proxy socks5 pour le service TOR (le nom/IP
+Sous WeeChat vous devez ajouter un proxy socks5 pour le service TOR (le nom/IP
et port dépend de votre configuration de TOR) :
----
/proxy add tor socks5 127.0.0.1 9050
----
-Maintenant, créez un nouveau serveur, par exemple :
+Maintenant, ajoutez un nouveau serveur, par exemple :
----
/server add freenode-tor p4fsi4ockecnea7l.onion
@@ -3338,8 +3340,18 @@ suivantes sont ajoutées dans la table de hachage :
| command | chaîne | Commande IRC (exemple : "PRIVMSG", "NOTICE", ...)
| channel | chaîne | Canal IRC
| arguments | chaîne | Paramètres de la commande (inclut la valeur de 'channel')
+| text | string | Texte (par exemple message utilisateur)
+| pos_text | string | L'index du texte dans le message ("-1" si le texte n'a pas été trouvé)
|===
+Lorsque la donnée est un pointeur, la variable `tg_signal_data` peut être
+utilisée comme ceci pour lire une propriété hdata (dans cet exemple il s'agit
+d'un pointeur sur un tampon) :
+
+----
+${buffer[${tg_signal_data}].full_name}
+----
+
[[trigger_data_hsignal]]
===== Hsignal
generated by cgit v1.2.3 (git 2.25.1) at 2024-11-01 09:40:29 +0000