doc: fix French translation of "callback"
This commit is contained in:
Sébastien Helleu
parent
5b9d40aca3
commit
768bceca36
@ -86,7 +86,7 @@
|
||||
|
||||
| trigger | trigger_hook_conditions | conditions par défaut pour un hook
|
||||
|
||||
| trigger | trigger_hook_rc | code retour par défaut pour un callback de hook
|
||||
| trigger | trigger_hook_rc | code retour par défaut pour une fonction de rappel de hook
|
||||
|
||||
| trigger | trigger_hook_regex | expression régulière par défaut pour le hook
|
||||
|
||||
|
||||
@ -41,7 +41,7 @@ listdefault : lister les triggers par défaut
|
||||
conditions : conditions évaluées pour le trigger
|
||||
regex : une ou plusieurs expressions régulières pour remplacer des chaînes dans les variables
|
||||
commande : commande à exécuter (plusieurs commandes peuvent être séparées par ";")
|
||||
code_retour : code retour dans le callback (ok (par défaut), ok_eat, error)
|
||||
code_retour : code retour dans la fonction de rappel (ok (par défaut), ok_eat, error)
|
||||
action_post : action à effectuer après l'exécution (none (par défaut), disable, delete)
|
||||
addinput : définir la ligne de commande avec les paramètres par défaut pour créer un trigger
|
||||
input : définir la ligne de commande utilisée pour créer le trigger
|
||||
@ -65,7 +65,7 @@ action_post : action à effectuer après l'exécution (none (par défaut), disa
|
||||
monitor : ouvrir le tampon moniteur des triggers
|
||||
filtre : filtrer les hooks/triggers à afficher (un hook doit commencer par "@", par exemple "@signal"), plusieurs filtres peuvent être séparés par des virgules ; le caractère joker "*" est autorisé dans chaque nom de trigger
|
||||
|
||||
Lorsqu'un callback de trigger est appelé, les actions suivantes sont exécutées, dans cet ordre :
|
||||
Lorsqu'une fonction de rappel de trigger est appelée, les actions suivantes sont exécutées, dans cet ordre :
|
||||
1. vérifier les conditions ; si faux, sortir
|
||||
2. remplacer le texte en utilisant une/des expression(s)s régulière(s)s POSIX étendue(s)s (si définie(s) dans le trigger)
|
||||
3. exécuter le(s) commande(s) (si définie(s) dans le trigger)
|
||||
|
||||
@ -293,7 +293,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|
||||
| trigger/ | Extension Trigger.
|
||||
| trigger.c | Fonctions principales de Trigger.
|
||||
| trigger-buffer.c | Tampon Trigger.
|
||||
| trigger-callback.c | Callbacks de Trigger.
|
||||
| trigger-callback.c | Fonctions de rappel de Trigger.
|
||||
| trigger-command.c | Commandes pour Trigger.
|
||||
| trigger-completion.c | Complétions pour Trigger.
|
||||
| trigger-config.c | Options de configuration pour Trigger (fichier trigger.conf).
|
||||
@ -740,7 +740,7 @@ s'exécuter très rapidement, et que les appels aux fonctions comme `sleep` sont
|
||||
extensions et les scripts).
|
||||
|
||||
Si pour une raison quelconque vous devez attendre un peu, utilisez `hook_timer`
|
||||
avec un "callback".
|
||||
avec une fonction de rappel.
|
||||
|
||||
[[doubly_linked_lists]]
|
||||
=== Listes doublement chaînées
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -59,8 +59,8 @@ l'API est la même pour les autres langages.
|
||||
* Vous devez définir _weechat_init_ et appeler _register_ dedans.
|
||||
* Les fonctions sont appelées par `Weechat.xxx(arg1, arg2, ...)`.
|
||||
* En raison d'une limitation de Ruby (15 paramètres maximum par fonction), la
|
||||
fonction `Weechat.config_new_option` reçoit les "callbacks" dans un tableau de
|
||||
6 chaînes de caractères (3 callbacks + 3 chaînes de données), donc un appel à
|
||||
fonction `Weechat.config_new_option` reçoit les fonctions de rappel dans un tableau de
|
||||
6 chaînes de caractères (3 fonctions de rappel + 3 chaînes de données), donc un appel à
|
||||
cette fonction ressemble à ceci :
|
||||
|
||||
[source,ruby]
|
||||
@ -245,7 +245,7 @@ test.py ─────► │ API script │ API C │ ─────► ║
|
||||
└────────────┴─────────┘ ╚═════════╧════════╝
|
||||
....
|
||||
|
||||
Quand WeeChat appelle un "callback" dans votre script _test.py_, le chemin
|
||||
Quand WeeChat appelle une fonction de rappel dans votre script _test.py_, le chemin
|
||||
est inversé :
|
||||
|
||||
....
|
||||
@ -286,17 +286,17 @@ vérifier que vous donnez un pointeur valide, sinon vous pourriez voir un joli
|
||||
rapport de crash ;)
|
||||
|
||||
[[callbacks]]
|
||||
=== Callbacks
|
||||
=== Fonctions de rappel
|
||||
|
||||
Tous les "callbacks" WeeChat doivent retourner WEECHAT_RC_OK ou
|
||||
WEECHAT_RC_ERROR (l'exception est le callback du modificateur, qui retourne une
|
||||
chaîne de caractères).
|
||||
Toutes les fonction de rappel WeeChat doivent retourner WEECHAT_RC_OK ou
|
||||
WEECHAT_RC_ERROR (l'exception est la fonction de rappel du modificateur, qui
|
||||
retourne une chaîne de caractères).
|
||||
|
||||
Les "callbacks" C utilisent un paramètre "data", qui est un pointeur. Dans
|
||||
l'API script, ce "data" est une chaîne de caractères avec n'importe quelle
|
||||
Les fonction de rappel C utilisent un paramètre "data", qui est un pointeur.
|
||||
Dans l'API script, ce "data" est une chaîne de caractères avec n'importe quelle
|
||||
valeur (ce n'est pas un pointeur).
|
||||
|
||||
Exemple de callback, pour chaque langage :
|
||||
Exemple de fonction de rappel, pour chaque langage :
|
||||
|
||||
* Python :
|
||||
|
||||
@ -766,20 +766,21 @@ weechat.command(buffer, "bonjour")
|
||||
Vous pouvez créer un nouveau tampon dans votre script, et l'utiliser pour
|
||||
afficher des messages.
|
||||
|
||||
Deux "callbacks" peuvent être appelés (ils sont optionnels) : un pour les données
|
||||
en entrée (quand vous tapez du texte et pressez [Enter] sur le tampon), l'autre
|
||||
est appelé lorsque le tampon est fermé (par exemple avec `/buffer close`).
|
||||
Deux fonctions de rappel peuvent être appelés (ils sont optionnels) : une pour
|
||||
les données en entrée (quand vous tapez du texte et pressez [Enter] sur le
|
||||
tampon), l'autre est appelée lorsque le tampon est fermé (par exemple avec
|
||||
`/buffer close`).
|
||||
|
||||
Exemple :
|
||||
|
||||
[source,python]
|
||||
----
|
||||
# callback pour les données reçues en entrée
|
||||
# fonction de rappel pour les données reçues en entrée
|
||||
def buffer_input_cb(data, buffer, input_data):
|
||||
# ...
|
||||
return weechat.WEECHAT_RC_OK
|
||||
|
||||
# callback appelé lorsque le tampon est fermé
|
||||
# fonction de rappel appelée lorsque le tampon est fermé
|
||||
def buffer_close_cb(data, buffer):
|
||||
# ...
|
||||
return weechat.WEECHAT_RC_OK
|
||||
@ -891,11 +892,11 @@ weechat.hook_timer(60 * 1000, 60, 0, "timer_cb", "")
|
||||
==== Lancer un processus en tâche de fond
|
||||
|
||||
Vous pouvez lancer un processus en tâche de fond avec `hook_process`. Votre
|
||||
"callback" sera appelé quand des données seront prêtes. Il peut être appelé
|
||||
plusieurs fois.
|
||||
fonction de rappel sera appelée quand des données seront prêtes. Elle peut être
|
||||
appelée plusieurs fois.
|
||||
|
||||
Pour le dernier appel à votre "callback", _rc_ est positionné à 0 ou une valeur
|
||||
positive, c'est le code retour de la commande.
|
||||
Pour le dernier appel à votre fonction de rappel, _rc_ est positionné à 0 ou
|
||||
une valeur positive, c'est le code retour de la commande.
|
||||
|
||||
Exemple :
|
||||
|
||||
@ -924,7 +925,7 @@ fonction `hook_process`, ou `hook_process_hashtable` si vous avez besoin
|
||||
d'options pour le transfert d'URL.
|
||||
|
||||
Exemple de transfert d'URL sans option : la page HTML sera reçue comme "out"
|
||||
dans le "callback" (sortie standard du processus) :
|
||||
dans la fonction de rappel (sortie standard du processus) :
|
||||
|
||||
[source,python]
|
||||
----
|
||||
|
||||
@ -3293,8 +3293,8 @@ Un trigger a les options suivantes (les noms sont
|
||||
|
||||
| regex | chaîne |
|
||||
Une ou plusieurs expressions régulières POSIX étendues, pour modifier les
|
||||
données reçues dans le callback du "hook" (et d'autres choses ajoutées par
|
||||
l'extension trigger), voir <<trigger_regex,expression régulière>>.
|
||||
données reçues dans la fonction de rappel du "hook" (et d'autres choses
|
||||
ajoutées par l'extension trigger), voir <<trigger_regex,expression régulière>>.
|
||||
|
||||
| command | chaîne |
|
||||
Commande à exécuter (plusieurs commandes peuvent être séparées par des
|
||||
@ -3302,8 +3302,9 @@ Un trigger a les options suivantes (les noms sont
|
||||
<<command_weechat_eval,/eval>>).
|
||||
|
||||
| return_code | `ok`, `ok_eat`, `error` |
|
||||
Le code retour du callback (`ok` par défaut, qui devrait être utilisé dans
|
||||
quasiment tous les triggers, les autres valeurs sont rarement utilisées).
|
||||
Le code retour de la fonction de rappel (`ok` par défaut, qui devrait être
|
||||
utilisé dans quasiment tous les triggers, les autres valeurs sont rarement
|
||||
utilisées).
|
||||
|
||||
| post_action | `none`, `disable`, `delete` |
|
||||
Action à effectuer sur le trigger après l'exécution (`none` par défaut, qui
|
||||
@ -3327,9 +3328,9 @@ trigger.trigger.beep.post_action = none
|
||||
[[trigger_execution]]
|
||||
==== Exécution
|
||||
|
||||
Lorsque le callback d'un trigger est appelé, les actions suivantes sont
|
||||
exécutées, dans cet ordre, si les triggers sont globalement activés et si le
|
||||
trigger lui-même est activé :
|
||||
Lorsque la fonction de rappel d'un trigger est appelée, les actions suivantes
|
||||
sont exécutées, dans cet ordre, si les triggers sont globalement activés et si
|
||||
le trigger lui-même est activé :
|
||||
|
||||
. vérifier les conditions du trigger : si faux, sortir
|
||||
. remplacer du texte dans le trigger en utilisant des expressions régulières
|
||||
@ -3419,9 +3420,10 @@ points-virgules.
|
||||
Les conditions sont utilisées pour continuer l'exécution du trigger, ou tout
|
||||
stopper.
|
||||
|
||||
Elles sont évaluées, et les données disponibles dans le callback peuvent être
|
||||
utilisées (voir <<trigger_callback_data,données dans les callbacks>> et la
|
||||
commande <<command_weechat_eval,/eval>>).
|
||||
Elles sont évaluées, et les données disponibles dans la fonction de rappel
|
||||
peuvent être utilisées (voir
|
||||
<<trigger_callback_data,données dans les callbacks>> et la commande
|
||||
<<command_weechat_eval,/eval>>).
|
||||
|
||||
Exemple : le trigger _beep_ par défaut utilise cette condition pour faire un
|
||||
beep seulement sur un highlight ou un message privé :
|
||||
@ -3433,8 +3435,8 @@ ${tg_highlight} || ${tg_msg_pv}
|
||||
[[trigger_regex]]
|
||||
==== Expression régulière
|
||||
|
||||
L'expression régulière est utilisée pour modifier des variables dans la table de
|
||||
hachage du callback.
|
||||
L'expression régulière est utilisée pour modifier des variables dans la table
|
||||
de hachage de la fonction de rappel.
|
||||
|
||||
Le format est : "/regex/remplacement" ou "/regex/remplacement/var" (où _var_ est
|
||||
une variable de la table de hachage). +
|
||||
@ -3506,10 +3508,11 @@ beep (BEL) :
|
||||
----
|
||||
|
||||
[[trigger_callback_data]]
|
||||
==== Données dans les callbacks
|
||||
==== Données dans les fonctions de rappel
|
||||
|
||||
Les données reçues dans les callbacks sont stockées dans des tables de hachage
|
||||
(pointeurs et chaînes) et peuvent être utilisées dans les options suivantes :
|
||||
Les données reçues dans les fonctions de rappel sont stockées dans des tables
|
||||
de hachage (pointeurs et chaînes) et peuvent être utilisées dans les options
|
||||
suivantes :
|
||||
|
||||
* _conditions_
|
||||
* _regex_
|
||||
@ -3527,7 +3530,8 @@ moniteur des triggers :
|
||||
[[trigger_data_signal]]
|
||||
===== Signal
|
||||
|
||||
Le callback "signal" définit les variables suivantes dans la table de hachage :
|
||||
La fonction de rappel "signal" définit les variables suivantes dans la table de
|
||||
hachage :
|
||||
|
||||
[width="100%",cols="3m,2,14",options="header"]
|
||||
|===
|
||||
@ -3568,7 +3572,8 @@ ${buffer[${tg_signal_data}].full_name}
|
||||
[[trigger_data_hsignal]]
|
||||
===== Hsignal
|
||||
|
||||
Le callback "hsignal" définit les variables suivantes dans la table de hachage :
|
||||
La fonction de rappel "hsignal" définit les variables suivantes dans la table
|
||||
de hachage :
|
||||
|
||||
[width="100%",cols="3m,2,14",options="header"]
|
||||
|===
|
||||
@ -3582,7 +3587,8 @@ reçue (type : chaîne/chaîne).
|
||||
[[trigger_data_modifier]]
|
||||
===== Modifier
|
||||
|
||||
Le callback "modifier" définit les variables suivantes dans la table de hachage :
|
||||
La fonction de rappel "modifier" définit les variables suivantes dans la table
|
||||
de hachage :
|
||||
|
||||
[width="100%",cols="3m,2,14",options="header"]
|
||||
|===
|
||||
@ -3616,7 +3622,8 @@ données supplémentaires sont ajoutées dans la table de hachage (voir le
|
||||
[[trigger_data_print]]
|
||||
===== Print
|
||||
|
||||
Le callback "print" définit les variables suivantes dans la table de hachage :
|
||||
La fonction de rappel "print" définit les variables suivantes dans la table de
|
||||
hachage :
|
||||
|
||||
[width="100%",cols="3m,2,14",options="header"]
|
||||
|===
|
||||
@ -3650,7 +3657,8 @@ pour le modificateur _weechat_print_) :
|
||||
[[trigger_data_command]]
|
||||
===== Command
|
||||
|
||||
Le callback "command" définit les variables suivantes dans la table de hachage :
|
||||
La fonction de rappel "command" définit les variables suivantes dans la table
|
||||
de hachage :
|
||||
|
||||
[width="100%",cols="3m,2,14",options="header"]
|
||||
|===
|
||||
@ -3663,8 +3671,8 @@ Le callback "command" définit les variables suivantes dans la table de hachage
|
||||
[[trigger_data_command_run]]
|
||||
===== Command_run
|
||||
|
||||
Le callback "command_run" définit les variables suivantes dans la table de
|
||||
hachage :
|
||||
La fonction de rappel "command_run" définit les variables suivantes dans la
|
||||
table de hachage :
|
||||
|
||||
[width="100%",cols="3m,2,14",options="header"]
|
||||
|===
|
||||
@ -3676,7 +3684,8 @@ hachage :
|
||||
[[trigger_data_timer]]
|
||||
===== Timer
|
||||
|
||||
Le callback "timer" définit les variables suivantes dans la table de hachage :
|
||||
La fonction de rappel "timer" définit les variables suivantes dans la table de
|
||||
hachage :
|
||||
|
||||
[width="100%",cols="3m,2,14",options="header"]
|
||||
|===
|
||||
@ -3688,7 +3697,8 @@ Le callback "timer" définit les variables suivantes dans la table de hachage :
|
||||
[[trigger_data_config]]
|
||||
===== Config
|
||||
|
||||
Le callback "config" définit les variables suivantes dans la table de hachage :
|
||||
La fonction de rappel "config" définit les variables suivantes dans la table de
|
||||
hachage :
|
||||
|
||||
[width="100%",cols="3m,2,14",options="header"]
|
||||
|===
|
||||
@ -3700,7 +3710,8 @@ Le callback "config" définit les variables suivantes dans la table de hachage
|
||||
[[trigger_data_focus]]
|
||||
===== Focus
|
||||
|
||||
Le callback "focus" définit les variables suivantes dans la table de hachage :
|
||||
La fonction de rappel "focus" définit les variables suivantes dans la table de
|
||||
hachage :
|
||||
|
||||
[width="100%",cols="3m,2,14",options="header"]
|
||||
|===
|
||||
@ -3772,8 +3783,8 @@ Vous pouvez sauvegarder automatiquement les fichiers de configuration
|
||||
|
||||
Les paramètres pour le minuteur sont :
|
||||
|
||||
* _3600000_ : 3600 * 1000 millisecondes, le callback est appelé toutes les
|
||||
heures
|
||||
* _3600000_ : 3600 * 1000 millisecondes, la fonction de rappel est appelée
|
||||
toutes les heures
|
||||
* _0_ : alignement sur la seconde (pas d'alignement ici)
|
||||
* _0_ : nombre maximum d'appels (0 = pas de fin pour le minuteur)
|
||||
|
||||
|
||||
20
po/fr.po
20
po/fr.po
@ -22,7 +22,7 @@ msgstr ""
|
||||
"Project-Id-Version: WeeChat\n"
|
||||
"Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
|
||||
"POT-Creation-Date: 2016-12-03 09:38+0100\n"
|
||||
"PO-Revision-Date: 2016-12-03 09:39+0100\n"
|
||||
"PO-Revision-Date: 2016-12-04 15:00+0100\n"
|
||||
"Last-Translator: Sébastien Helleu <flashcode@flashtux.org>\n"
|
||||
"Language-Team: weechat-dev <weechat-dev@nongnu.org>\n"
|
||||
"Language: fr\n"
|
||||
@ -12069,7 +12069,8 @@ msgstr ""
|
||||
"chaînes dans les variables\n"
|
||||
" commande : commande à exécuter (plusieurs commandes peuvent être séparées "
|
||||
"par \";\")\n"
|
||||
"code_retour : code retour dans le callback (ok (par défaut), ok_eat, error)\n"
|
||||
"code_retour : code retour dans la fonction de rappel (ok (par défaut), "
|
||||
"ok_eat, error)\n"
|
||||
"action_post : action à effectuer après l'exécution (none (par défaut), "
|
||||
"disable, delete)\n"
|
||||
" addinput : définir la ligne de commande avec les paramètres par défaut "
|
||||
@ -12106,8 +12107,8 @@ msgstr ""
|
||||
"par des virgules ; le caractère joker \"*\" est autorisé dans chaque nom de "
|
||||
"trigger\n"
|
||||
"\n"
|
||||
"Lorsqu'un callback de trigger est appelé, les actions suivantes sont "
|
||||
"exécutées, dans cet ordre :\n"
|
||||
"Lorsqu'une fonction de rappel de trigger est appelée, les actions suivantes "
|
||||
"sont exécutées, dans cet ordre :\n"
|
||||
" 1. vérifier les conditions ; si faux, sortir\n"
|
||||
" 2. remplacer le texte en utilisant une/des expression(s)s régulière(s)s "
|
||||
"POSIX étendue(s)s (si définie(s) dans le trigger)\n"
|
||||
@ -12165,7 +12166,7 @@ msgid "default command for a hook"
|
||||
msgstr "commande par défaut pour un hook"
|
||||
|
||||
msgid "default return codes for hook callback"
|
||||
msgstr "code retour par défaut pour un callback de hook"
|
||||
msgstr "code retour par défaut pour une fonction de rappel de hook"
|
||||
|
||||
msgid "trigger post actions"
|
||||
msgstr "actions \"post\" pour les triggers"
|
||||
@ -12200,8 +12201,9 @@ msgid ""
|
||||
"condition(s) for running the command (it is checked in hook callback) (note: "
|
||||
"content is evaluated when trigger is run, see /help eval)"
|
||||
msgstr ""
|
||||
"condition(s) pour lancer la commande (vérifiée dans le callback du hook) "
|
||||
"(note : le contenu est évalué lorsque le trigger est lancé, voir /help eval)"
|
||||
"condition(s) pour lancer la commande (vérifiée dans la fonction de rappel du "
|
||||
"hook) (note : le contenu est évalué lorsque le trigger est lancé, voir /help "
|
||||
"eval)"
|
||||
|
||||
msgid ""
|
||||
"replace text with a POSIX extended regular expression (it is done only if "
|
||||
@ -12241,8 +12243,8 @@ msgid ""
|
||||
"return code for hook callback (see plugin API reference to know where ok_eat/"
|
||||
"error can be used efficiently)"
|
||||
msgstr ""
|
||||
"code retour pour le callback du hook (voir la référence API extension pour "
|
||||
"savoir où ok_eat/error peuvent être utilisés efficacement)"
|
||||
"code retour pour la fonction de rappel du hook (voir la référence API "
|
||||
"extension pour savoir où ok_eat/error peuvent être utilisés efficacement)"
|
||||
|
||||
msgid "action to take on the trigger after execution"
|
||||
msgstr "action à effectuer sur le trigger après l'exécution"
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user