diff options
Diffstat (limited to 'doc/fr/weechat_scripting.fr.adoc')
| -rw-r--r-- | doc/fr/weechat_scripting.fr.adoc | 84 |
1 files changed, 42 insertions, 42 deletions
diff --git a/doc/fr/weechat_scripting.fr.adoc b/doc/fr/weechat_scripting.fr.adoc index 6a61863e9..53273dcad 100644 --- a/doc/fr/weechat_scripting.fr.adoc +++ b/doc/fr/weechat_scripting.fr.adoc @@ -58,15 +58,15 @@ Le code d'un script est exécuté : Lorsque le code du script est exécuté, WeeChat attend la fin de l'exécution avant de continuer. Par conséquent, le script ne doit *PAS* faire d'opérations bloquantes comme des appels réseau sans utiliser une fonction API dédiée -telle que `hook_process`. +telle que `+hook_process+`. [IMPORTANT] Un script ne doit *JAMAIS* faire de "fork" ou créer des threads sans utiliser une fonction dédiée de l'API, cela pourrait provoquer un crash de WeeChat. + -Si quelque chose doit être lancé en arrière-plan, la fonction `hook_process` +Si quelque chose doit être lancé en arrière-plan, la fonction `+hook_process+` peut être utilisée. Voir l'exemple dans le chapitre <<hook_process,Lancer un processus en tâche de fond>> et la documentation sur -la fonction `hook_process` dans la +la fonction `+hook_process+` dans la link:weechat_plugin_api.en.html#_hook_process[Référence API extension WeeChat]. [[languages_specificities]] @@ -80,7 +80,7 @@ WeeChat définit un module `weechat` qui doit être importé avec `import weecha ===== Fonctions -Les fonctions sont appelées avec `weechat.xxx(arg1, arg2, ...)`. +Les fonctions sont appelées avec `+weechat.xxx(arg1, arg2, ...)+`. Les fonctions `+print*+` se nomment `+prnt*+` en python (car `print` était un mot clé réservé en Python 2). @@ -107,9 +107,9 @@ pas exhaustive) : pass:[irc_in_notice] | Un message reçu dans l'extension IRC, avant qu'il ne soit décodé vers UTF-8. + + - Il est recommandé d'utiliser plutôt le modificateur `irc_in2_yyy`, la chaîne + Il est recommandé d'utiliser plutôt le modificateur `+irc_in2_yyy+`, la chaîne reçue sera toujours valide UTF-8. + - Voir la fonction `hook_modifier` dans la + Voir la fonction `+hook_modifier+` dans la link:weechat_plugin_api.fr.html#_hook_modifier[Référence API extension WeeChat]. | hook_signal | @@ -123,9 +123,9 @@ pas exhaustive) : `encode` défini par l'utilisateur (si différent de `UTF-8`, qui est la valeur par défaut). + + - Il est recommandé d'utiliser plutôt le signal `xxx,irc_out1_yyy`, la chaîne + Il est recommandé d'utiliser plutôt le signal `+xxx,irc_out1_yyy+`, la chaîne reçue sera toujours valide UTF-8. + - Voir la fonction `hook_signal` dans la + Voir la fonction `+hook_signal+` dans la link:weechat_plugin_api.fr.html#_hook_signal[Référence API extension WeeChat]. | hook_process + @@ -145,7 +145,7 @@ des données invalides UTF-8, dans les cas mentionnés ci-dessus. ===== Fonctions -Les fonctions sont appelées par `weechat::xxx(arg1, arg2, ...);`. +Les fonctions sont appelées par `+weechat::xxx(arg1, arg2, ...);+`. ==== Ruby @@ -155,10 +155,10 @@ Vous devez définir _weechat_init_ et appeler _register_ dedans. ===== Fonctions -Les fonctions sont appelées par `Weechat.xxx(arg1, arg2, ...)`. +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 fonctions de rappel dans un +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 : @@ -172,19 +172,19 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt ===== Fonctions -Les fonctions sont appelées par `weechat.xxx(arg1, arg2, ...)`. +Les fonctions sont appelées par `+weechat.xxx(arg1, arg2, ...)+`. ==== Tcl ===== Fonctions -Les fonctions sont appelées par `weechat::xxx arg1 arg2 ...`. +Les fonctions sont appelées par `+weechat::xxx arg1 arg2 ...+`. ==== Guile (Scheme) ===== Fonctions -Les fonctions sont appelées par `(weechat:xxx arg1 arg2 ...)`. +Les fonctions sont appelées par `+(weechat:xxx arg1 arg2 ...)+`. Les fonctions suivantes prennent une liste de paramètres en entrée (au lieu de plusieurs paramètres pour les autres fonctions), car le nombre de paramètres @@ -198,13 +198,13 @@ excède la limite de Guile : ===== Fonctions -Les fonctions sont appelées par `weechat.xxx(arg1, arg2, ...);`. +Les fonctions sont appelées par `+weechat.xxx(arg1, arg2, ...);+`. ==== PHP ===== Fonctions -Les fonctions sont appelées par `weechat_xxx(arg1, arg2, ...);`. +Les fonctions sont appelées par `+weechat_xxx(arg1, arg2, ...);+`. [[register_function]] === Fonction register @@ -984,7 +984,7 @@ WeeChat : [[hook_command]] ==== Ajouter une nouvelle commande -Ajoutez une nouvelle commande avec `hook_command`. Vous pouvez utiliser une +Ajoutez une nouvelle commande avec `+hook_command+`. Vous pouvez utiliser une complétion personnalisée pour compléter les paramètres de votre commande. Exemple : @@ -1018,7 +1018,7 @@ Puis sous WeeChat : [[hook_timer]] ==== Ajouter un minuteur -Ajoutez un minuteur avec `hook_timer`. +Ajoutez un minuteur avec `+hook_timer+`. Exemple : @@ -1035,7 +1035,7 @@ weechat.hook_timer(60 * 1000, 60, 0, "timer_cb", "") [[hook_process]] ==== Lancer un processus en tâche de fond -Vous pouvez lancer un processus en tâche de fond avec `hook_process`. Votre +Vous pouvez lancer un processus en tâche de fond avec `+hook_process+`. Votre fonction de rappel sera appelée quand des données seront prêtes. Elle peut être appelée plusieurs fois. @@ -1065,7 +1065,7 @@ weechat.hook_process("/bin/ls -l /etc", 10 * 1000, "my_process_cb", "") _Nouveau dans la version 0.3.7._ Pour télécharger une URL (ou poster vers une URL), vous devez utiliser la -fonction `hook_process`, ou `hook_process_hashtable` si vous avez besoin +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" @@ -1108,7 +1108,7 @@ weechat.hook_process_hashtable("url:https://weechat.org/files/src/weechat-devel. ---- Pour plus d'information sur le transfert d'URL et les options disponibles, voir -les fonctions `hook_process` et `hook_process_hashtable` dans la +les fonctions `+hook_process+` et `+hook_process_hashtable+` dans la link:weechat_plugin_api.fr.html#_hook_process[Référence API extension WeeChat]. [[config_options]] @@ -1117,8 +1117,8 @@ link:weechat_plugin_api.fr.html#_hook_process[Référence API extension WeeChat] [[config_options_set_script]] ==== Définir des options pour le script -La fonction `config_is_set_plugin` est utilisée pour vérifier si une option est -définie ou pas, et `config_set_plugin` pour définir une option. +La fonction `+config_is_set_plugin+` est utilisée pour vérifier si une option est +définie ou pas, et `+config_set_plugin+` pour définir une option. Exemple : @@ -1137,7 +1137,7 @@ for option, default_value in script_options.items(): [[config_options_detect_changes]] ==== Détecter des changements -Vous devez utiliser `hook_config` pour être notifié si l'utilisateur modifie +Vous devez utiliser `+hook_config+` pour être notifié si l'utilisateur modifie certaines options du script. Exemple : @@ -1163,9 +1163,9 @@ weechat.hook_config("plugins.var.python." + SCRIPT_NAME + ".*", "config_cb", "") [[config_options_weechat]] ==== Lire les options WeeChat -La fonction `config_get` retourne un pointeur vers une option. Ensuite, en -fonction du type de l'option, il faut appeler `config_string`, `config_boolean`, -`config_integer` ou `config_color`. +La fonction `+config_get+` retourne un pointeur vers une option. Ensuite, en +fonction du type de l'option, il faut appeler `+config_string+`, `+config_boolean+`, +`+config_integer+` ou `+config_color+`. [source,python] ---- @@ -1266,7 +1266,7 @@ Vous pouvez analyser un message IRC avec l'info_hashtable appelée 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!`) : +`+@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!+`) : [width="100%",cols="1,^2,10,8",options="header"] |=== @@ -1274,56 +1274,56 @@ Le résultat est une table de hachage avec les clés suivantes | tags | ≥ 0.4.0 | Les étiquettes dans le message (peut être vide). | - `time=2015-06-27T16:40:35.000Z` + `+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!user@host PRIVMSG #weechat :hello!+` | nick | ≥ 0.3.4 | Le pseudo d'origine. | - `nick` + `+nick+` | user | ≥ 2.7 | L'utilisateur d'origine. | - `user` + `+user+` | host | ≥ 0.3.4 | L'hôte d'origine (incluant le pseudo). | - `nick!user@host` + `+nick!user@host+` | command | ≥ 0.3.4 | La commande (_PRIVMSG_, _NOTICE_, ...). | - `PRIVMSG` + `+PRIVMSG+` | channel | ≥ 0.3.4 | Le canal cible. | - `#weechat` + `+#weechat+` | arguments | ≥ 0.3.4 | Les paramètres de la commande (incluant le canal). | - `#weechat :hello!` + `+#weechat :hello!+` | text | ≥ 1.3 | Le texte (par exemple un message utilisateur). | - `hello!` + `+hello!+` | pos_command | ≥ 1.3 | La position de _command_ dans le message ("-1" si _command_ n'a pas été trouvé). | - `47` + `+47+` | pos_arguments | ≥ 1.3 | La position de _arguments_ dans le message ("-1" si _arguments_ n'a pas été trouvé). | - `55` + `+55+` | pos_channel | ≥ 1.3 | La position de _channel_ dans le message ("-1" si _channel_ n'a pas été trouvé). | - `55` + `+55+` | pos_text | ≥ 1.3 | La position de _text_ dans le message ("-1" si _text_ n'a pas été trouvé). | - `65` + `+65+` |=== [source,python] @@ -1417,5 +1417,5 @@ if infolist: ---- [IMPORTANT] -N'oubliez pas d'appeler `infolist_free` pour libérer la mémoire utilisée par +N'oubliez pas d'appeler `+infolist_free+` pour libérer la mémoire utilisée par l'infolist, car WeeChat ne libère par automatiquement cette mémoire. |