doc: add non-breaking spaces in French docs before colons and semicolons

v2.8-utf8proc
Sébastien Helleu 2016-12-04 13:13:41 +01:00
parent bd3dfb4827
commit c008fa68b7
13 changed files with 3823 additions and 3823 deletions

View File

@ -15388,7 +15388,7 @@ C example:
struct t_gui_lines *own_lines;
struct t_gui_line *line;
struct t_gui_line_data *line_data;
struct t_gui_line_data *line_data;
struct t_hdata *hdata;
struct t_hashtable *hashtable;
char str_date[64];

View File

@ -7,8 +7,8 @@
*-d*, *--dir* _<répertoire>_::
Définir le répertoire comme étant la base de WeeChat
(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).
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).

View File

@ -36,16 +36,16 @@ consulter la documentation des extensions dans le
https://weechat.org/doc[guide utilisateur de WeeChat].
Avec l'extension irc, vous pouvez vous connecter à un serveur de manière
temporaire avec une URL, comme ceci :
temporaire avec une URL, comme ceci :
irc[6][s]://[[pseudo][:motdepasse]@]serveur[:port][/#canal1[,#canal2...]]
Pour rejoindre le canal IRC de support WeeChat avec le pseudo "monpseudo" :
Pour rejoindre le canal IRC de support WeeChat avec le pseudo "monpseudo" :
irc://monpseudo@chat.freenode.net/#weechat
Les adresses IPv6 peuvent être entourées par des crochets pour ajouter un port
après, par exemple :
après, par exemple :
irc://monpseudo@[2001:db8:0:85a3::ac1f:8001]:6668/#test
@ -111,8 +111,8 @@ choix) toute version ultérieure.
Merci de consulter le fichier COPYING pour plus d'informations.
Site web : https://weechat.org/
Site web : https://weechat.org/
== SUPPORT / SIGNALER DES BUGS
Pour de l'aide ou signaler un bug : https://weechat.org/dev/support
Pour de l'aide ou signaler un bug : https://weechat.org/dev/support

View File

@ -12,7 +12,7 @@
Ce manuel documente le client de messagerie instantanée WeeChat, il fait
partie de WeeChat.
La dernière version de ce document peut être téléchargée sur cette page :
La dernière version de ce document peut être téléchargée sur cette page :
https://weechat.org/doc
@ -22,7 +22,7 @@ https://weechat.org/doc
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.
Ce manuel documente l'intérieur de WeeChat :
Ce manuel documente l'intérieur de WeeChat :
* dépôts
* règles de développement
@ -33,10 +33,10 @@ Ce manuel documente l'intérieur de WeeChat :
[[repositories]]
== Dépôts
Les dépôts de WeeChat sont dans l'organisation "weechat" de GitHub :
Les dépôts de WeeChat sont dans l'organisation "weechat" de GitHub :
https://github.com/weechat
Liste des dépôts :
Liste des dépôts :
weechat::
dépôt principal avec le code source et la documentation
@ -45,7 +45,7 @@ scripts::
les scripts _officiels_ soumis sur weechat.org
weechat.org::
le code source du site de WeeChat : https://weechat.org/
le code source du site de WeeChat : https://weechat.org/
weercd::
serveur de test IRC
@ -58,13 +58,13 @@ Ce manuel documente seulement le dépôt _weechat_.
[[overview]]
=== Vue d'ensemble
Les répertoires principaux de WeeChat sont :
Les répertoires principaux de WeeChat sont :
[width="100%",cols="1m,3",options="header"]
|===
| Répertoire | Description
| src/ | Racine des sources.
|    core/ | Fonctions du cœur : point d'entrée, structures internes.
|    core/ | Fonctions du cœur : point d'entrée, structures internes.
|    gui/ | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces).
|       curses/ | Interface Curses.
|    plugins/ | API extension/script.
@ -100,15 +100,15 @@ Les répertoires principaux de WeeChat sont :
[[sources_core]]
==== Cœur
Le cœur de WeeChat est situé dans les répertoires suivants :
Le cœur de WeeChat est situé dans les répertoires suivants :
* _src/core/_ : fonctions du cœur (pour manipuler des données)
* _src/gui/_ : fonctions pour l'interface (tampons, fenêtres, ...)
* _src/core/_ : fonctions du cœur (pour manipuler des données)
* _src/gui/_ : fonctions pour l'interface (tampons, fenêtres, ...)
[width="100%",cols="1m,3",options="header"]
|===
| Chemin/fichier | Description
| core/ | Fonctions du cœur : point d'entrée, structures internes.
| core/ | Fonctions du cœur : point d'entrée, structures internes.
|    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.
@ -134,7 +134,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.
|    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.
@ -179,7 +179,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|    plugin-api.c | Fonctions supplémentaires pour l'API extension (enveloppes autour des fonctions du cœur de WeeChat).
|    plugin-config.c | Options de configuration des extensions (fichier plugins.conf).
|    plugin-script.c | Fonctions communes utilisés par les extensions pour les scripts.
|    plugin-script-api.c | Fonctions pour l'API script : enveloppes autour de quelques fonctions de l'API extension.
|    plugin-script-api.c | Fonctions pour l'API script : enveloppes autour de quelques fonctions de l'API extension.
|    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.
@ -321,22 +321,22 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|    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.
|          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]]
=== Documentation / traductions
Fichiers de documentation :
Fichiers de documentation :
[width="100%",cols="1m,3",options="header"]
|===
@ -344,7 +344,7 @@ Fichiers de documentation :
| doc/ | Documentation.
|    docinfo.html | Style Asciidoctor.
|    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, ...).
|    XX/ | Documentation pour la langue XX (langues : en, fr, de, it, ...).
|       cmdline_options.XX.adoc | Options de ligne de commande (fichier inclus dans la page de manuel et le guide utilisateur).
|       weechat.1.XX.adoc | Page de manuel (`man weechat`).
|       weechat_dev.XX.adoc | Guide du développeur (ce document).
@ -361,7 +361,7 @@ Fichiers de documentation :
|===
Les traductions pour WeeChat et les extensions sont effectuées avec gettext, les
fichiers sont dans le répertoire _po/_ :
fichiers sont dans le répertoire _po/_ :
[width="100%",cols="1m,3",options="header"]
|===
@ -379,14 +379,14 @@ fichiers sont dans le répertoire _po/_ :
* Dans le code source, vos commentaires, noms de variables, ... doivent être
écrits en anglais *uniquement* (aucune autre langue n'est autorisée).
* Utilisez un en-tête de copyright dans chaque nouveau fichier source avec :
* Utilisez un en-tête de copyright dans chaque nouveau fichier source avec :
** une brève description du fichier (une seule ligne),
** la date,
** le nom,
** l'e-mail,
** la licence.
Exemple en C :
Exemple en C :
[source,C]
----
@ -415,7 +415,7 @@ Exemple en C :
[[coding_c_style]]
=== Style C
Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C :
Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C :
* Utilisez 4 espaces pour l'indentation. N'utilisez pas de tabulations, c'est le
mal.
@ -427,7 +427,7 @@ Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C
(utilisez toujours un commentaire multi-lignes, même si la description est
très courte).
Exemple :
Exemple :
[source,C]
----
@ -457,10 +457,10 @@ foo ()
----
* Utilisez des noms de variable explicites, par exemple "nicks_count" au lieu de
"n" ou "nc". Exception : dans les boucles `for`, où les variables comme "i" ou
"n" ou "nc". Exception : dans les boucles `for`, où les variables comme "i" ou
"n" sont OK.
* Initialisez les variables locales après la déclaration, dans le corps de la
fonction, exemple :
fonction, exemple :
[source,C]
----
@ -480,7 +480,7 @@ foo ()
au lieu de `+x + y * z+`.
* Disposez les accolades `+{ }+` seules sur la ligne, et indentez les avec le
nombre d'espaces utilisés sur la ligne au dessus de l'accolade ouvrante (le
`if` dans l'exemple) :
`if` dans l'exemple) :
[source,C]
----
@ -491,7 +491,7 @@ if (nicks_count == 1)
----
* Utilisez des lignes vides pour séparer différents blocs dans les fonctions, et
si possible ajoutez un commentaire pour chacun, comme ceci :
si possible ajoutez un commentaire pour chacun, comme ceci :
[source,C]
----
@ -535,7 +535,7 @@ irc_server_outqueue_send (struct t_irc_server *server)
* Indentez les conditions `if`, et utilisez des parenthèses autour des
conditions avec un opérateur (pas nécessaire pour un booléen simple), comme
ceci :
ceci :
[source,C]
----
@ -559,7 +559,7 @@ else
}
----
* Indentez les `switch` comme ceci :
* Indentez les `switch` comme ceci :
[source,C]
----
@ -578,7 +578,7 @@ switch (string[0])
----
* Utilisez `typedef` pur les prototypes de fonctions mais pas pour les
structures :
structures :
[source,C]
----
@ -601,7 +601,7 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
----
* Ce code Lisp peut être utilisé dans votre _~/.emacs.el_ pour indenter
correctement si vous utilisez l'éditeur de texte Emacs :
correctement si vous utilisez l'éditeur de texte Emacs :
[source,lisp]
----
@ -628,14 +628,14 @@ Voir http://www.python.org/dev/peps/pep-0008/
[[naming_convention_files]]
==== Fichiers
Les noms de fichiers sont composés de lettres et tirets, avec le format :
Les noms de fichiers sont composés de lettres et tirets, avec le format :
_xxx-yyyyy.[ch]_, où _xxx_ est le répertoire/composant (peut être une
abréviation) et _yyyyy_ un nom pour le fichier.
Le fichier principal d'un répertoire peut avoir le même nom que le répertoire,
par exemple _irc.c_ pour l'extension irc.
Exemples :
Exemples :
[width="100%",cols="1m,3",options="header"]
|===
@ -654,13 +654,13 @@ exemple _wee-command.h_ pour le fichier _wee-command.c_.
[[naming_convention_structures]]
==== Structures
Les structures ont le nom _t_X_Y_ ou _t_X_Y_Z_ :
Les structures ont le nom _t_X_Y_ ou _t_X_Y_Z_ :
* _X_ : répertoire/composant (peut être une abréviation)
* _Y_ : fin du nom de fichier
* _Z_ : nom de la structure (facultatif)
* _X_ : répertoire/composant (peut être une abréviation)
* _Y_ : fin du nom de fichier
* _Z_ : nom de la structure (facultatif)
Exemple : un pseudo IRC (de _src/plugins/irc/irc-nick.h_) :
Exemple : un pseudo IRC (de _src/plugins/irc/irc-nick.h_) :
[source,C]
----
@ -681,16 +681,16 @@ struct t_irc_nick
[[naming_convention_variables]]
==== Variables
Les variables globales (en dehors des fonctions) ont le nom _X_Y_Z_ :
Les variables globales (en dehors des fonctions) ont le nom _X_Y_Z_ :
* _X_ : répertoire/composant (peut être une abréviation)
* _Y_ : fin du nom de fichier
* _Z_ : nom de la variable
* _X_ : répertoire/composant (peut être une abréviation)
* _Y_ : fin du nom de fichier
* _Z_ : nom de la variable
Exception : pour les variables des derniers éléments d'une liste, le nom est
Exception : pour les variables des derniers éléments d'une liste, le nom est
_last_X_ (où _X_ est le nom de la variable, en utilisant le singulier).
Exemple : fenêtres (de _src/gui/gui-window.c_) :
Exemple : fenêtres (de _src/gui/gui-window.c_) :
[source,C]
----
@ -702,7 +702,7 @@ struct t_gui_window *gui_current_window = NULL; /* current window */
Il n'y a pas de convention pour les variables locales (dans les fonctions).
La seule recommandation est que le nom soit explicite (et pas trop court). +
Cependant, les pointeurs vers les structures sont souvent nommés _ptr_xxxx_, par
exemple un pointeur sur _struct t_gui_buffer *_ sera : _*ptr_buffer_.
exemple un pointeur sur _struct t_gui_buffer *_ sera : _*ptr_buffer_.
[[naming_convention_functions]]
==== Fonctions
@ -710,7 +710,7 @@ exemple un pointeur sur _struct t_gui_buffer *_ sera : _*ptr_buffer_.
La convention pour les noms des fonctions est le même que celui des
<<naming_convention_variables,variables>>.
Exemple : création d'une nouvelle fenêtre (de _src/gui/gui-window.c_) :
Exemple : création d'une nouvelle fenêtre (de _src/gui/gui-window.c_) :
[source,C]
----
@ -745,10 +745,10 @@ avec un "callback".
[[doubly_linked_lists]]
=== Listes doublement chaînées
La plupart des listes chaînes WeeChat sont doublement chaînées : chaque nœud a
La plupart des listes chaînes WeeChat sont doublement chaînées : chaque nœud a
un pointeur vers le nœud précédent/suivant.
Exemple : liste des tampons (de _src/gui/gui-buffer.h_) :
Exemple : liste des tampons (de _src/gui/gui-buffer.h_) :
[source,C]
----
@ -763,7 +763,7 @@ struct t_gui_buffer
};
----
Et les deux pointeurs vers la tête et la fin de liste :
Et les deux pointeurs vers la tête et la fin de liste :
[source,C]
----
@ -778,37 +778,37 @@ WeeChat utilise ses propres codes couleur dans les chaînes pour afficher les
attributs (gras, souligné, ...) et les couleurs à l'écran.
Tous les attributs/couleurs sont préfixés par un caractère dans la chaîne, qui
peuvent être :
peuvent être :
* _0x19_ : code couleur (suivi par un/des code(s) couleur)
* _0x1A_ : activer un attribut (suivi par un attribut sur un caractère)
* _0x1B_ : supprimer un attribut (suivi par un attribut sur un caractère)
* _0x1C_ : réinitialiser (rien après)
* _0x19_ : code couleur (suivi par un/des code(s) couleur)
* _0x1A_ : activer un attribut (suivi par un attribut sur un caractère)
* _0x1B_ : supprimer un attribut (suivi par un attribut sur un caractère)
* _0x1C_ : réinitialiser (rien après)
Les attributs autorisés sont (un ou plusieurs caractères) :
Les attributs autorisés sont (un ou plusieurs caractères) :
* `+*+` : gras
* `+!+` : vidéo inverse
* `+/+` : italique
* `+_+` : souligné
* `+|+` : garder les attributs
* `+*+` : gras
* `+!+` : vidéo inverse
* `+/+` : italique
* `+_+` : souligné
* `+|+` : garder les attributs
Les couleurs possibles sont :
Les couleurs possibles sont :
* couleur standard : attributs facultatifs + nombre sur 2 digits
* couleur étendue : `+@+` + attributs facultatifs + nombre sur 5 digits
* couleur standard : attributs facultatifs + nombre sur 2 digits
* couleur étendue : `+@+` + attributs facultatifs + nombre sur 5 digits
Dans le tableau qui suit, les conventions suivantes sont utilisées :
Dans le tableau qui suit, les conventions suivantes sont utilisées :
* `STD` : couleur standard (2 digits)
* `(A)STD` : couleur standard avec des attributs facultatifs
* `STD` : couleur standard (2 digits)
* `(A)STD` : couleur standard avec des attributs facultatifs
(attributs + 2 digits)
* `EXT` : couleur étendue (`+@+` + 5 digits)
* `(A)EXT` : couleur étendue avec des attributs facultatifs
* `EXT` : couleur étendue (`+@+` + 5 digits)
* `(A)EXT` : couleur étendue avec des attributs facultatifs
(`+@+` + attributs + 5 digits)
* `ATTR` : un caractère d'attribut (`+*+`, `+!+`, `+/+`, `+_+` ou `+|+`)
* `ATTR` : un caractère d'attribut (`+*+`, `+!+`, `+/+`, `+_+` ou `+|+`)
Toutes les combinaisons sont résumées dans ce tableau :
Toutes les combinaisons sont résumées dans ce tableau :
[width="100%",cols="4,2,2,8",options="header"]
|===
@ -841,7 +841,7 @@ Toutes les combinaisons sont résumées dans ce tableau :
|===
Les codes couleur utilisant des options (voir _t_gui_color_enum_, dans le
fichier _src/gui/gui-color.h_) :
fichier _src/gui/gui-color.h_) :
[width="70%",cols="^1m,10",options="header"]
|===
@ -893,7 +893,7 @@ fichier _src/gui/gui-color.h_) :
| 44 | weechat.color.chat_value_null _(WeeChat ≥ 1.4)_
|===
Les couleurs WeeChat sont :
Les couleurs WeeChat sont :
[width="70%",cols="^1m,10",options="header"]
|===
@ -917,7 +917,7 @@ Les couleurs WeeChat sont :
| 16 | Blanc
|===
Exemples de codes couleur :
Exemples de codes couleur :
[width="70%",cols="1,2",options="header"]
|===
@ -945,7 +945,7 @@ WeeChat.
Et puis des macros sont utilisées pour appeler ces fonctions.
Par exemple, la fonction _hook_timer_ est définie dans la structure
_t_weechat_plugin_ comme ceci :
_t_weechat_plugin_ comme ceci :
[source,C]
----
@ -958,7 +958,7 @@ struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin,
void *callback_data);
----
Et la macro utilisée pour appeler cette fonction est :
Et la macro utilisée pour appeler cette fonction est :
[source,C]
----
@ -969,7 +969,7 @@ Et la macro utilisée pour appeler cette fonction est :
__callback, __data)
----
Donc dans une extension, l'appel à cette fonction sera par exemple :
Donc dans une extension, l'appel à cette fonction sera par exemple :
[source,C]
----
@ -985,42 +985,42 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
[[git_repository]]
=== Dépôt Git
Le dépôt Git est à cette URL : https://github.com/weechat/weechat
Le dépôt Git est à cette URL : https://github.com/weechat/weechat
Tout patch pour un bug ou une nouvelle fonctionnalité doit être effectué sur la
branche master, le format préféré étant une "pull request" sur GitHub. Un patch
peut aussi être envoyé par e-mail (fait avec `git diff` ou `git format-patch`).
Le format du message de commit est le suivant (pour fermer un bug GitHub) :
Le format du message de commit est le suivant (pour fermer un bug GitHub) :
----
component: fix a problem (closes #123)
----
Pour un bug Savannah :
Pour un bug Savannah :
----
component: fix a problem (bug #12345)
----
Où _component_ est :
Où _component_ est :
* pour le cœur WeeChat : _core_ (les fichiers dans le répertoire racine, _po/_
* pour le cœur WeeChat : _core_ (les fichiers dans le répertoire racine, _po/_
et _src/_, sauf _src/plugins/_)
* fichiers de documentation : _doc_ (fichiers dans le répertoire _doc/_)
* nom d'une extension : _irc_, _python_, _relay_, ... (fichiers dans le
* fichiers de documentation : _doc_ (fichiers dans le répertoire _doc/_)
* nom d'une extension : _irc_, _python_, _relay_, ... (fichiers dans le
répertoire _src/plugins/_)
Quelques règles à suivre :
Quelques règles à suivre :
* Utilisez seulement l'anglais.
* Utilisez des verbes à l'infinitif.
* Si le commit est relatif au tracker, écrivez-le entre parenthèses après le
message, avec ce format :
** GitHub : closes #123
** Savannah : bug #12345, task #12345, patch #12345
message, avec ce format :
** GitHub : closes #123
** Savannah : bug #12345, task #12345, patch #12345
Exemples de messages de commit :
Exemples de messages de commit :
----
irc: add command /unquiet (closes #36)
@ -1041,7 +1041,7 @@ Les fichiers gettext sont dans le répertoire _po/_.
Si vous souhaitez initialiser une nouvelle langue, utilisez la commande
`msginit`. Par exemple pour créer un fichier qui est prêt à traduire en
néerlandais :
néerlandais :
----
$ cd po
@ -1052,7 +1052,7 @@ La langue de base pour WeeChat est l'anglais, donc vous devez évidemment
comprendre parfaitement l'anglais pour traduire vers votre langue.
Une fois terminé, vous *devez* vérifier votre fichier avec le script
_msgcheck.py_ (https://github.com/flashcode/msgcheck) :
_msgcheck.py_ (https://github.com/flashcode/msgcheck) :
----
$ msgcheck.py xx.po
@ -1067,14 +1067,14 @@ par le script _doc/docgen.py_.
Copiez ce script python dans votre répertoire python (par exemple
_~/.weechat/python_).
Vous pouvez alors charger le script dans votre WeeChat, et configurer le chemin
vers votre répertoire _/doc_ :
vers votre répertoire _/doc_ :
----
/python load docgen.py
/set plugins.var.python.docgen.path "~/src/weechat/doc"
----
Créez alors cet alias pour construire les fichiers :
Créez alors cet alias pour construire les fichiers :
----
/alias add doc /perl unload; /python unload; /ruby unload; /lua unload; /tcl unload; /guile unload; /javascript unload; /python load docgen.py; /wait 1ms /docgen
@ -1097,14 +1097,14 @@ Les fichiers Asciidoc donc dans le répertoire _doc/XX/_ où _XX_ est la langue
Faites d'abord une copie du fichier asciidoc en anglais (dans le répertoire
_doc/en/_), puis travaillez dessus.
Les traductions manquantes dans les fichiers sont indiquées par cette chaîne :
Les traductions manquantes dans les fichiers sont indiquées par cette chaîne :
----
// TRANSLATION MISSING
----
Vous devez traduire tout le fichier sauf les liens et les mots-clés spéciaux
pour les notes, avertissements, ... Ces mots doivent être gardés tels quels :
pour les notes, avertissements, ... Ces mots doivent être gardés tels quels :
----
[[link_name]]
@ -1117,7 +1117,7 @@ pour les notes, avertissements, ... Ces mots doivent être gardés tels quels :
[CAUTION]
----
Lorsqu'il y a un nom après `<<link_name>>`, alors vous devez le traduire :
Lorsqu'il y a un nom après `<<link_name>>`, alors vous devez le traduire :
----
<<link_name,ce texte doit être traduit>>

View File

@ -30,7 +30,7 @@ mais elle ne s'applique pas à WeeChat !).
Parce que WeeChat est très léger et apporte des fonctionnalités innovantes.
Plus d'infos sur cette page : https://weechat.org/about/features
Plus d'infos sur cette page : https://weechat.org/about/features
[[compilation_install]]
== Compilation / installation
@ -39,7 +39,7 @@ Plus d'infos sur cette page : https://weechat.org/about/features
=== J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je les compiler/utiliser ?
Des interfaces distantes sont disponibles, voir les liens sur la page des
fonctionnalités : https://weechat.org/about/features
fonctionnalités : https://weechat.org/about/features
[[compile_git]]
=== Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ?
@ -59,13 +59,13 @@ mises à jour.
=== Comment puis-je installer WeeChat sous OS X ?
Il est recommandé d'utiliser http://brew.sh/[Homebrew], vous pouvez avoir de
l'aide avec :
l'aide avec :
----
brew info weechat
----
Vous pouvez installer WeeChat avec cette commande :
Vous pouvez installer WeeChat avec cette commande :
----
brew install weechat --with-aspell --with-curl --with-python --with-perl --with-ruby --with-lua --with-guile
@ -78,7 +78,7 @@ Pour obtenir de l'aide tapez `/help`. Pour de l'aide sur une commande, tapez
`/help commande`. Les touches et commandes sont listées dans la documentation.
Il est recommandé pour les nouveaux utilisateurs de lire le guide de démarrage
rapide : https://weechat.org/doc
rapide : https://weechat.org/doc
[[display]]
== Affichage
@ -87,10 +87,10 @@ rapide : https://weechat.org/doc
=== Je ne vois pas bien certains accents dans WeeChat, que faire ?
C'est un problème courant, merci de lire attentivement et vérifier *TOUS* les
points ci-dessous :
points ci-dessous :
* Vérifiez que weechat est lié avec libncursesw (attention : nécessaire
sur beaucoup de distributions, mais pas toutes) :
* Vérifiez que weechat est lié avec libncursesw (attention : nécessaire
sur beaucoup de distributions, mais pas toutes) :
`ldd /chemin/vers/weechat`.
* Vérifiez que l'extension "charset" est chargée avec la commande `/plugin`
(s'il ne l'est pas, vous devez peut-être installer le paquet
@ -99,9 +99,9 @@ points ci-dessous :
devriez voir _ISO-XXXXXX_ ou _UTF-8_ pour le charset du terminal. Si vous
voyez _ANSI_X3.4-1968_ ou d'autres valeurs, votre locale est probablement
erronée (corrigez votre $LANG).
* Affectez la valeur pour le décodage global, par exemple :
* Affectez la valeur pour le décodage global, par exemple :
`/set charset.default.decode "ISO-8859-15"`.
* Si vous utilisez la locale UTF-8 :
* Si vous utilisez la locale UTF-8 :
** Vérifiez que votre terminal est compatible UTF-8
(un terminal conseillé pour l'UTF-8 est rxvt-unicode).
** Si vous utilisez screen, vérifiez qu'il est lancé en mode UTF-8
@ -121,10 +121,10 @@ 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 :
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 :
Voir ce rapport de bug pour plus d'informations :
https://github.com/weechat/weechat/issues/79
[[bars_background]]
@ -133,16 +133,16 @@ https://github.com/weechat/weechat/issues/79
Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez la
sortie de `echo $TERM` dans votre terminal).
Selon la façon de lancer WeeChat, vous devriez avoir :
Selon la façon de lancer WeeChat, vous devriez avoir :
* Si WeeChat tourne en local ou sur une machine distante sans screen ni tmux :
cela dépend du terminal utilisé : _xterm_, _xterm-256color_, _rxvt-unicode_,
* Si WeeChat tourne en local ou sur une machine distante sans screen ni tmux :
cela dépend du terminal utilisé : _xterm_, _xterm-256color_, _rxvt-unicode_,
_rxvt-256color_, etc...
* Si WeeChat tourne sous screen, vous devriez avoir _screen_ ou _screen-256color_.
* Si WeeChat tourne sous tmux, vous devriez avoir _tmux_, _tmux-256color_,
_screen_ ou _screen-256color_.
Si besoin, corrigez la variable TERM : `export TERM="xxx"`.
Si besoin, corrigez la variable TERM : `export TERM="xxx"`.
[[screen_weird_chars]]
=== Quand j'utilise weechat sous screen/tmux, j'ai des caractères bizarres et aléatoires, comment corriger ça ?
@ -153,7 +153,7 @@ sortie de `echo $TERM` dans votre terminal, *en dehors de screen/tmux*).
Par exemple _xterm-color_ provoque ce genre de problèmes, utilisez
_xterm_ qui est ok (comme plein d'autres valeurs).
Si besoin, corrigez la variable TERM : `export TERM="xxx"`.
Si besoin, corrigez la variable TERM : `export TERM="xxx"`.
[[osx_display_broken]]
=== J'ai compilé WeeChat sous OS X, et je vois des "(null)" partout sur l'écran, pourquoi ?
@ -180,30 +180,30 @@ aucune fenêtre) ou affiché par une ou plusieurs fenêtres.
[[buffers_list]]
=== Comment afficher la liste des tampons sur la gauche ?
Utilisez le script _buffers.pl_ :
Utilisez le script _buffers.pl_ :
----
/script install buffers.pl
----
Pour limiter la taille de la barre :
Pour limiter la taille de la barre :
----
/set weechat.bar.buffers.size_max 15
----
Pour déplacer la barre en bas :
Pour déplacer la barre en bas :
----
/set weechat.bar.buffers.position bottom
----
Pour faire défiler la barre : si la souris est activée (touche : kbd:[Alt+m]),
Pour faire défiler la barre : si la souris est activée (touche : kbd:[Alt+m]),
vous pouvez faire défiler avec la roulette de votre souris.
Ou vous pouvez définir des touches, comme les touches déjà existantes pour faire
défiler la liste de pseudos.
Par exemple pour utiliser kbd:[F1], kbd:[F2], kbd:[Alt+F1] et kbd:[Alt+F2] :
Par exemple pour utiliser kbd:[F1], kbd:[F2], kbd:[Alt+F1] et kbd:[Alt+F2] :
----
/key bind meta-OP /bar scroll buffers * -100%
@ -219,13 +219,13 @@ Pour trouver le code de la touche appuyez sur kbd:[Alt+k] puis la touche.
[[customize_prefix]]
=== Comment puis-je réduire la longueur des pseudos ou supprimer l'alignement des pseudos dans la zone de discussion ?
Pour réduire la longueur maximum des pseudos dans la zone de discussion :
Pour réduire la longueur maximum des pseudos dans la zone de discussion :
----
/set weechat.look.prefix_align_max 15
----
Pour supprimer l'alignement sur les pseudos :
Pour supprimer l'alignement sur les pseudos :
----
/set weechat.look.prefix_align none
@ -235,23 +235,23 @@ Pour supprimer l'alignement sur les pseudos :
=== Que signifie [H: 3(1,8), 2(4)] dans la barre de statut ?
Il s'agit de la "hotlist", une liste de tampons avec le nombre de messages non
lus, par ordre : highlights, messages privés, messages, autres messages
lus, par ordre : highlights, messages privés, messages, autres messages
(comme join/part). +
Le nombre de "messages non lus" est le nombre de nouveaux messages affichés/reçus
depuis que vous avez visité le tampon.
Dans l'exemple `[H: 3(1,8), 2(4)]`, il y a :
Dans l'exemple `[H: 3(1,8), 2(4)]`, il y a :
* un highlight et 8 messages non lus sur le tampon n°3,
* 4 messages non lus sur le tampon n°2.
La couleur du tampon/compter dépend du type de message, les couleurs par défaut
sont :
sont :
* highlight : `lightmagenta` / `magenta`
* message privé : `lightgreen` / `green`
* message : `yellow` / `brown`
* autre message : `default` / `default` (couleur du texte dans le terminal)
* highlight : `lightmagenta` / `magenta`
* message privé : `lightgreen` / `green`
* message : `yellow` / `brown`
* autre message : `default` / `default` (couleur du texte dans le terminal)
Ces couleurs peuvent être changées via les options __weechat.color.status_data_*__
(tampons) et __weechat.color.status_count_*__ (compteurs). +
@ -269,13 +269,13 @@ L'option _size_ dans la barre input peut être définie à une valeur supérieur
dynamique, et alors l'option _size_max_ définira la taille maximum (0 = pas de
limite).
Exemple avec une taille dynamique :
Exemple avec une taille dynamique :
----
/set weechat.bar.input.size 0
----
Taille maximum de 2 :
Taille maximum de 2 :
----
/set weechat.bar.input.size_max 2
@ -287,7 +287,7 @@ Taille maximum de 2 :
Oui, vous devez créer une barre de type "root" (avec un objet pour savoir dans
quelle fenêtre vous êtes), puis supprimer la barre input courante.
Par exemple :
Par exemple :
----
/bar add rootinput root bottom 1 0 [buffer_name]+[input_prompt]+(away),[input_search],[input_paste],input_text
@ -296,7 +296,7 @@ Par exemple :
Si jamais vous n'étiez pas satisfait avec ça, supprimez simplement la nouvelle
barre, WeeChat recréera automatiquement la barre par défaut "input" si l'objet
"input_text" n'est utilisé dans aucune barre :
"input_text" n'est utilisé dans aucune barre :
----
/bar del rootinput
@ -306,14 +306,14 @@ barre, WeeChat recréera automatiquement la barre par défaut "input" si l'objet
=== Comment puis-je copier/coller du texte sans coller la liste des pseudos ?
Avec WeeChat ≥ 1.0, vous pouvez utiliser l'affichage dépouillé (touche par
défaut : kbd:[Alt+l]).
défaut : kbd:[Alt+l]).
Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme
rxvt-unicode, konsole, gnome-terminal, etc...). La touche est habituellement
kbd:[Ctrl] + kbd:[Alt] + sélection à la souris.
Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par
exemple :
exemple :
----
/set weechat.bar.nicklist.position top
@ -323,12 +323,12 @@ exemple :
=== Comment puis-je cliquer sur les longs URLs (plus d'une ligne) ?
Avec WeeChat ≥ 1.0, vous pouvez utiliser l'affichage dépouillé (touche par
défaut : kbd:[Alt+l]).
défaut : kbd:[Alt+l]).
Par défaut, WeeChat affiche l'heure et un préfixe pour chaque ligne avec des
barres optionnelles autour de la zone de discussion. Pour rendre la le clic
d'URL plus facile, vous pouvez déplacer la liste des pseudos en haut et
supprimer l'alignement sur les pseudos :
supprimer l'alignement sur les pseudos :
----
/set weechat.bar.nicklist.position top
@ -338,7 +338,7 @@ supprimer l'alignement sur les pseudos :
Avec WeeChat ≥ 0.3.6, vous pouvez activer l'option "eat_newline_glitch", pour
éviter qu'un caractère de nouvelle ligne soit affiché après chaque ligne (donc
cela ne cassera pas la sélection d'une URL) :
cela ne cassera pas la sélection d'une URL) :
----
/set weechat.look.eat_newline_glitch on
@ -348,7 +348,7 @@ cela ne cassera pas la sélection d'une URL) :
Cette option peut causer des problèmes d'affichage. Si vous rencontrez de tels
problèmes, vous devez désactiver cette option.
Une autre solution est d'utiliser un script :
Une autre solution est d'utiliser un script :
----
/script search url
@ -357,14 +357,14 @@ Une autre solution est d'utiliser un script :
[[change_locale_without_quit]]
=== Je souhaite changer la langue des messages affichés par WeeChat, mais sans quitter WeeChat, est-ce possible ?
Oui, avec WeeChat ≥ 1.0 :
Oui, avec WeeChat ≥ 1.0 :
----
/set env LANG fr_FR.UTF-8
/upgrade
----
Avec un ancien WeeChat :
Avec un ancien WeeChat :
----
/script install shell.py
@ -378,11 +378,11 @@ Avec un ancien WeeChat :
Les 256 couleurs sont supportées avec WeeChat ≥ 0.3.4.
Premièrement vérifiez que votre variable d'environnement _TERM_ est correcte,
les valeurs recommandées sont :
les valeurs recommandées sont :
* sous screen : _screen-256color_
* sous tmux : _screen-256color_ ou _tmux-256color_
* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_,
* sous screen : _screen-256color_
* sous tmux : _screen-256color_ ou _tmux-256color_
* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_,
_putty-256color_, ...
[NOTE]
@ -390,14 +390,14 @@ Vous devrez peut-être installer le paquet "ncurses-term" pour utiliser ces
valeurs dans la variable _TERM_.
Si vous utilisez screen, vous pouvez ajouter cette ligne dans votre
_~/.screenrc_ :
_~/.screenrc_ :
----
term screen-256color
----
Si votre variable _TERM_ a une valeur erronée et que WeeChat est déjà lancé,
vous pouvez la changer avec ces deux commandes (avec WeeChat ≥ 1.0) :
vous pouvez la changer avec ces deux commandes (avec WeeChat ≥ 1.0) :
----
/set env TERM screen-256color
@ -408,7 +408,7 @@ Pour la version 0.3.4, vous devez utiliser la commande `/color` pour ajouter
des nouvelles couleurs.
Pour les versions ≥ 0.3.5, vous pouvez utiliser un numéro de couleur dans les
options (facultatif : vous pouvez ajouter des alias de couleurs avec la commande
options (facultatif : vous pouvez ajouter des alias de couleurs avec la commande
`/color`).
Merci de lire le guide utilisateur pour plus d'information sur la gestion des
@ -417,8 +417,8 @@ couleurs.
[[search_text]]
=== Comment puis-je chercher du texte dans le tampon (comme /lastlog dans irssi) ?
La touche par défaut est kbd:[Ctrl+r] (la commande est : `/input search_text_here`).
Et sauter aux highlights : kbd:[Alt+p] / kbd:[Alt+n].
La touche par défaut est kbd:[Ctrl+r] (la commande est : `/input search_text_here`).
Et sauter aux highlights : kbd:[Alt+p] / kbd:[Alt+n].
Voir le guide utilisateur pour plus d'information sur cette fonctionnalité
(raccourcis clavier par défaut).
@ -429,19 +429,19 @@ Voir le guide utilisateur pour plus d'information sur cette fonctionnalité
Vous devez activer les évènements du focus avec un code spécial envoyé au
terminal.
*Important* :
*Important* :
* Actuellement, *seulement* _xterm_ semble supporter cette fonctionnalité.
* Cela ne fonctionne *pas* sous screen/tmux.
Pour envoyer le code au démarrage de WeeChat :
Pour envoyer le code au démarrage de WeeChat :
----
/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"
----
Puis associez deux touches pour le focus (remplacez les commandes `/print` par
les commandes de votre choix) :
les commandes de votre choix) :
----
/key bind meta2-I /print -core focus
@ -454,7 +454,7 @@ les commandes de votre choix) :
Cela est causé par l'option "bracketed paste" qui est activée par défaut, et
pas correctement gérée par screen dans les autres fenêtres.
Vous pouvez simplement désactiver le mode "bracketed paste" :
Vous pouvez simplement désactiver le mode "bracketed paste" :
----
/set weechat.look.paste_bracketed off
@ -468,13 +468,13 @@ Vous pouvez simplement désactiver le mode "bracketed paste" :
Si vous utilisez certains terminaux comme xterm ou uxterm, quelques touches
meta ne fonctionnent pas par défaut. Vous pouvez ajouter cette ligne dans le
fichier _~/.Xresources_ :
fichier _~/.Xresources_ :
* Pour xterm :
* Pour xterm :
----
XTerm*metaSendsEscape: true
----
* Pour uxterm :
* Pour uxterm :
----
UXTerm*metaSendsEscape: true
----
@ -495,7 +495,7 @@ l'inclure dans la ligne de commande.
La touche est kbd:[Alt+j] puis 2 chiffres, par exemple kbd:[Alt+j], kbd:[1],
kbd:[1] pour sauter au tampon 11.
Vous pouvez définir une touche, par exemple :
Vous pouvez définir une touche, par exemple :
----
/key bind meta-q /buffer *11
@ -509,7 +509,7 @@ La liste des touches par défaut est dans le Guide utilisateur.
Vous pouvez assigner les touches haut et bas sur l'historique global (les
touches par défaut pour l'historique global sont kbd:[Ctrl+↑] et kbd:[Ctrl+↓]).
Exemple :
Exemple :
----
/key bind meta2-A /input history_global_previous
@ -528,7 +528,7 @@ Pour trouver le code de la touche appuyez sur kbd:[Alt+k] puis la touche.
La souris est supportée avec WeeChat ≥ 0.3.6.
Premièrement essayez d'activer la souris :
Premièrement essayez d'activer la souris :
----
/mouse enable
@ -538,7 +538,7 @@ Si la souris ne fonctionne toujours pas, vérifiez la variable TERM dans votre
shell (regardez la sortie de `echo $TERM` dans votre terminal).
Selon le terminfo utilisé, la souris peut ne pas être supportée.
Vous pouvez tester le support de la souris dans le terminal :
Vous pouvez tester le support de la souris dans le terminal :
----
$ printf '\033[?1002h'
@ -547,7 +547,7 @@ $ printf '\033[?1002h'
Et cliquez sur le premier caractère du terminal (en haut à gauche). Vous devriez
voir " !!#!!".
Pour désactiver la souris dans le terminal :
Pour désactiver la souris dans le terminal :
----
$ printf '\033[?1002l'
@ -578,7 +578,7 @@ kbd:[Alt] au lieu de kbd:[Shift]).
Si vous utilisez Mac OS X, vous devez installer `openssl` depuis Homebrew.
Un fichier CA sera installé avec le le trousseau système. Vous pouvez alors
définie le chemin vers les certificats sous WeeChat :
définie le chemin vers les certificats sous WeeChat :
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@ -586,21 +586,21 @@ définie le chemin vers les certificats sous WeeChat :
Si vous voyez des erreurs à propos de la poignée de main gnutls ("handshake"),
vous pouvez utiliser une valeur plus petite pour la clé Diffie-Hellman (par
défaut 2048) :
défaut 2048) :
----
/set irc.server.example.ssl_dhkey_size 1024
----
Si vous voyez des erreurs à propos du certificat, vous pouvez désactiver
"ssl_verify" (attention, la connexion sera moins sûre en faisant cela) :
"ssl_verify" (attention, la connexion sera moins sûre en faisant cela) :
----
/set irc.server.example.ssl_verify off
----
Si le serveur a un certificat invalide et que vous savez ce que devrait être
le certificat, vous pouvez spécifier l'empreinte (SHA-512, SHA-256 ou SHA-1) :
le certificat, vous pouvez spécifier l'empreinte (SHA-512, SHA-256 ou SHA-1) :
----
/set irc.server.example.ssl_fingerprint 0c06e399d3c3597511dc8550848bfd2a502f0ce19883b728b73f6b7e8604243b
@ -610,7 +610,7 @@ le certificat, vous pouvez spécifier l'empreinte (SHA-512, SHA-256 ou SHA-1) :
=== Lors de la connexion SSL à un serveur, je vois juste une erreur "TLS handshake failed", que puis-je faire ?
Vous pouvez essayer une chaîne de priorité différente (WeeChat ≥ 0.3.5
seulement), remplacez "xxx" par le nom de votre serveur :
seulement), remplacez "xxx" par le nom de votre serveur :
----
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
@ -620,7 +620,7 @@ seulement), remplacez "xxx" par le nom de votre serveur :
=== Comment puis-je me connecter à freenode avec SSL ?
Positionnez l'option _weechat.network.gnutls_ca_file_ avec le fichier des
certificats :
certificats :
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@ -630,7 +630,7 @@ certificats :
Vérifiez que vous avez bien ce fichier (fourni généralement par le paquet
"ca-certificates").
Configurez le port du serveur, SSL, puis connectez-vous :
Configurez le port du serveur, SSL, puis connectez-vous :
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
@ -646,7 +646,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 ajouter un tel serveur et vous y connecter avec les commandes
suivantes (remplacez le nom et l'adresse par les valeurs appropriées) :
suivantes (remplacez le nom et l'adresse par les valeurs appropriées) :
----
/server add nom irc.server.org -password=oauth:XXXX
@ -657,7 +657,7 @@ suivantes (remplacez le nom et l'adresse par les valeurs appropriées) :
=== Comment puis-je être identifié avant de rejoindre les canaux ?
Si le serveur supporte SASL, vous devriez l'utiliser au lieu d'envoyer une
commande pour l'authentification avec nickserv, par exemple :
commande pour l'authentification avec nickserv, par exemple :
----
/set irc.server.freenode.sasl_username "mynick"
@ -665,7 +665,7 @@ commande pour l'authentification avec nickserv, par exemple :
----
Si le serveur ne supporte pas SASL, vous pouvez ajouter un délai (entre la
commande et le join des canaux) :
commande et le join des canaux) :
----
/set irc.server.freenode.command_delay 5
@ -693,21 +693,21 @@ active/désactive les filtres).
=== Comment puis-je filtrer les messages join/part/quit sur les canaux IRC ?
Avec le filtre intelligent (pour garder les join/part/quit des utilisateurs qui
ont parlé récemment) :
ont parlé récemment) :
----
/set irc.look.smart_filter on
/filter add irc_smart * irc_smart_filter *
----
Avec un filtre global (pour cacher *tous* les join/part/quit) :
Avec un filtre global (pour cacher *tous* les join/part/quit) :
----
/filter add joinquit * irc_join,irc_part,irc_quit *
----
[NOTE]
Pour l'aide : `/help filter` et `/help irc.look.smart_filter`
Pour l'aide : `/help filter` et `/help irc.look.smart_filter`
[[filter_irc_join_channel_messages]]
=== Comment puis-je filtrer certains messages affichés quand je rejoins un canal IRC ?
@ -731,14 +731,14 @@ voice pour montrer les utilisateurs absents, et vous recevez plein de messages
voice. Par conséquent, vous pouvez changer cela et laisser WeeChat utiliser une
couleur spéciale pour les pseudos absents dans la liste des pseudos.
Pour Bitlbee ≥ 3, faites ceci sur le canal _&bitlbee_ :
Pour Bitlbee ≥ 3, faites ceci sur le canal _&bitlbee_ :
----
channel set show_users online,away
----
Pour une version plus ancienne de Bitlbee, faites ceci sur le canal
_&bitlbee_ :
_&bitlbee_ :
----
set away_devoice false
@ -749,7 +749,7 @@ Pour vérifier les pseudos absents dans WeeChat, voir la question à propos des
Si vous voulez vraiment filtrer les messages voice, vous pouvez utiliser cette
commande, mais elle n'est pas parfaite (elle fonctionne seulement si le
premier mode changé est voice) :
premier mode changé est voice) :
----
/filter add hidevoices * irc_mode (\+|\-)v
@ -765,7 +765,7 @@ Vous pouvez aussi positionner l'option _irc.server_default.away_check_max_nicks_
pour limiter la vérification d'absence sur les petits canaux seulement.
Par exemple, pour vérifier les pseudos absents toutes les 5 minutes, pour les
canaux avec maximum 25 pseudos :
canaux avec maximum 25 pseudos :
----
/set irc.server_default.away_check 5
@ -784,7 +784,7 @@ un highlight ou un message privé. Par conséquent vous pouvez configurer votre
terminal (ou multiplexeur comme screen/tmux) pour lancer une commande ou jouer
un son lorsque le _BEL_ se produit.
Ou vous pouvez ajouter une commande dans le trigger "beep" :
Ou vous pouvez ajouter une commande dans le trigger "beep" :
----
/set trigger.trigger.beep.command "/print -beep;/exec -bg /chemin/vers/commande paramètres"
@ -793,13 +793,13 @@ Ou vous pouvez ajouter une commande dans le trigger "beep" :
Avec un WeeChat plus ancien, vous pouvez utiliser un script comme _beep.pl_ ou
_launcher.pl_.
Pour _launcher.pl_, vous devez configurer la commande :
Pour _launcher.pl_, vous devez configurer la commande :
----
/set plugins.var.perl.launcher.signal.weechat_highlight "/chemin/vers/commande paramètres"
----
Autres scripts sur ce sujet :
Autres scripts sur ce sujet :
----
/script search notify
@ -808,7 +808,7 @@ Autres scripts sur ce sujet :
[[irc_target_buffer]]
=== Comment puis-je changer le serveur cible pour les commandes avec des tampons mélangés (comme le tampon avec les serveurs) ?
La touche par défaut est kbd:[Ctrl+x] (la commande est :
La touche par défaut est kbd:[Ctrl+x] (la commande est :
`/input switch_active_buffer`).
[[plugins_scripts]]
@ -820,7 +820,7 @@ La touche par défaut est kbd:[Ctrl+x] (la commande est :
Sous OpenBSD, le nom des extensions se termine par ".so.0.0" (".so" sous
Linux).
Vous devez configurer ça :
Vous devez configurer ça :
----
/set weechat.plugin.extension ".so.0.0"
@ -843,7 +843,7 @@ Les scripts ne sont pas compatibles avec d'autres clients IRC.
Vous pouvez, mais ce n'est *PAS* recommandé.
La commande `/set` dans WeeChat est recommandée :
La commande `/set` dans WeeChat est recommandée :
* Vous pouvez compléter la valeur avec la touche Tab.
* La valeur est vérifiée, un message est affiché en cas d'erreur.
@ -851,7 +851,7 @@ La commande `/set` dans WeeChat est recommandée :
quoi que ce soit.
Si vous souhaitez quand même éditer les fichiers à la main, vous devez faire
attention :
attention :
* Si vous mettez une valeur invalide pour une option, WeeChat affichera une
erreur au chargement et ne tiendra pas compte de la valeur (la valeur par
@ -862,15 +862,15 @@ attention :
[[memory_usage]]
=== Comment configurer WeeChat pour consommer moins de mémoire ?
Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire :
Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire :
* Utiliser la dernière version stable (elle est supposée avoir moins de fuites
de mémoire que les versions plus anciennes).
* Ne pas charger les extensions si vous ne les utilisez pas, par exemple :
* Ne pas charger les extensions si vous ne les utilisez pas, par exemple :
aspell, fifo, logger, perl, python, ruby, lua, tcl, guile, javascript,
xfer (utilisé pour les DCC).
* Charger uniquement les scripts dont vous avez vraiment besoin.
* Ne pas charger les certificats si SSL n'est *PAS* utilisé : affecter une
* Ne pas charger les certificats si SSL n'est *PAS* utilisé : affecter une
chaîne vide pour l'option _weechat.network.gnutls_ca_file_.
* Réduire la valeur de l'option _weechat.history.max_buffer_lines_number_ ou
affecter une valeur à l'option _weechat.history.max_buffer_lines_minutes_.
@ -880,27 +880,27 @@ Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire :
=== Comment configurer WeeChat pour moins utiliser le processeur ?
Vous pouvez suivre les mêmes astuces que pour la <<memory_usage,mémoire>>, et
celles-ci :
celles-ci :
* Cacher la barre "nicklist" : `/bar hide nicklist`.
* Supprimer l'affichage des secondes dans l'heure de la barre de statut :
* Cacher la barre "nicklist" : `/bar hide nicklist`.
* Supprimer l'affichage des secondes dans l'heure de la barre de statut :
`/set weechat.look.item_time_format "%H:%M"` (ceci est la valeur par défaut).
* Désactiver la vérification en temps réel des mots mal orthographiés dans la
ligne de commande (si vous l'avez activée) : `/set aspell.check.real_time off`.
* Définir la variable _TZ_ (par exemple : `export TZ="Europe/Paris"`), pour
ligne de commande (si vous l'avez activée) : `/set aspell.check.real_time off`.
* Définir la variable _TZ_ (par exemple : `export TZ="Europe/Paris"`), pour
éviter un accès fréquent au fichier _/etc/localtime_.
[[security]]
=== Je suis paranoïaque sur la sécurité, quels paramètres puis-je changer pour être encore plus sûr ?
Désactivez les messages de part et quit IRC :
Désactivez les messages de part et quit IRC :
----
/set irc.server_default.msg_part ""
/set irc.server_default.msg_quit ""
----
Désactivez les réponses à toutes les demandes CTCP :
Désactivez les réponses à toutes les demandes CTCP :
----
/set irc.ctcp.clientinfo ""
@ -913,7 +913,7 @@ Désactivez les réponses à toutes les demandes CTCP :
----
Déchargez et désactivez le chargement automatique de l'extension "xfer"
(utilisée pour le DCC IRC) :
(utilisée pour le DCC IRC) :
----
/plugin unload xfer
@ -921,11 +921,11 @@ Déchargez et désactivez le chargement automatique de l'extension "xfer"
----
Définissez une phrase de chiffrement et utilisez les données sécurisées partout
où vous le pouvez pour les données sensibles comme les mots de passe : voir
où vous le pouvez pour les données sensibles comme les mots de passe : voir
`/help secure` et `/help` sur les options (si vous pouvez utiliser les données
sécurisées, cela est mentionné dans l'aide).
Par exemple :
Par exemple :
----
/secure passphrase xxxxxxxxxx
@ -941,12 +941,12 @@ Par exemple :
[[bug_task_patch]]
=== Comment puis-je reporter un bug, demander une nouvelle fonctionnalité ou envoyer un patch ?
Voir : https://weechat.org/dev/support
Voir : https://weechat.org/dev/support
[[gdb_error_threads]]
=== Quand je lance WeeChat sous gdb, il y a une erreur à propos des threads, que puis-je faire ?
Quand vous lancez WeeChat sous gdb, vous pouvez avoir cette erreur :
Quand vous lancez WeeChat sous gdb, vous pouvez avoir cette erreur :
----
$ gdb /path/to/weechat
@ -956,7 +956,7 @@ Cannot find new threads: generic error
----
Pour corriger ça, vous pouvez lancer gdb avec cette commande (remplacez le
chemin vers libpthread et WeeChat avec les chemins sur votre système) :
chemin vers libpthread et WeeChat avec les chemins sur votre système) :
----
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
@ -966,7 +966,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
[[supported_os]]
=== Quelle est la liste des plates-formes supportées par WeeChat ? Sera-t-il porté sur d'autres systèmes d'exploitation ?
La liste complète est sur cette page : https://weechat.org/download
La liste complète est sur cette page : https://weechat.org/download
Nous faisons le maximum pour supporter le plus de plates-formes possible.
Toute aide est la bienvenue pour les systèmes que nous n'avons pas, pour y
@ -978,7 +978,7 @@ tester WeeChat.
Il y a plusieurs choses à faire (test, code, documentation, etc...)
Merci de prendre contact avec nous par IRC ou mail, consultez la page
support : https://weechat.org/dev/support
support : https://weechat.org/dev/support
[[donate]]
=== Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ?

File diff suppressed because it is too large Load Diff

View File

@ -12,10 +12,10 @@
== Démarrer WeeChat
Un émulateur de terminal recommandé pour X (mais pas obligatoire) est
rxvt-unicode : il a un bon support UTF-8, et aucun problème avec les
rxvt-unicode : il a un bon support UTF-8, et aucun problème avec les
touches par défaut.
Lancer depuis votre shell :
Lancer depuis votre shell :
----
$ weechat
@ -24,19 +24,19 @@ $ weechat
[[help_options]]
== Aide en ligne / options
WeeChat dispose d'aide pour toutes les commandes, tapez simplement :
WeeChat dispose d'aide pour toutes les commandes, tapez simplement :
----
/help
----
Pour avoir de l'aide sur une commande, tapez :
Pour avoir de l'aide sur une commande, tapez :
----
/help commande
----
Pour modifier des options, tapez :
Pour modifier des options, tapez :
----
/set config.section.option valeur
@ -52,28 +52,28 @@ besoin de redémarrer WeeChat après avoir changé la configuration).
Vous pouvez utiliser `/set` avec un nom partiel d'option et le caractère
joker "*" au début ou à la fin pour afficher toutes les options contenant
ces lettres.
Par exemple :
Par exemple :
* Afficher toutes les options (WeeChat et extensions) :
* Afficher toutes les options (WeeChat et extensions) :
----
/set
----
* Afficher les options WeeChat :
* Afficher les options WeeChat :
----
/set weechat.*
----
* Afficher les options de l'extension IRC :
* Afficher les options de l'extension IRC :
----
/set irc.*
----
Vous pouvez afficher de l'aide sur une option avec `/help`, par exemple :
Vous pouvez afficher de l'aide sur une option avec `/help`, par exemple :
----
/help weechat.look.highlight
@ -96,7 +96,7 @@ valeur et applique les changements immédiatement.
Le cœur de WeeChat ("core") ne fait qu'afficher les données à l'écran et
interagir avec l'utilisateur, cela signifie que le cœur sans extension
n'a pas grand intérêt (utilisateurs fidèles : IRC faisait partie du cœur
n'a pas grand intérêt (utilisateurs fidèles : IRC faisait partie du cœur
dans les versions ≤ 0.2.6).
Tous les protocoles réseau comme IRC sont fournis sous forme d'extensions.
@ -107,13 +107,13 @@ devriez voir "irc" et d'autres extensions dans cette liste.
[[add_irc_server]]
== Ajouter un serveur IRC
Vous pouvez ajouter un serveur IRC avec la commande `/server`, par exemple :
Vous pouvez ajouter un serveur IRC avec la commande `/server`, par exemple :
----
/server add freenode chat.freenode.net
----
Comme d'habitude, de l'aide est disponible si vous êtes perdus :
Comme d'habitude, de l'aide est disponible si vous êtes perdus :
----
/help server
@ -131,26 +131,26 @@ définie (non "null"). Sinon WeeChat utilise la valeur par défaut
("irc.server_default.xxx").
Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et
vous pouvez les écraser pour le serveur freenode avec la commande suivante :
vous pouvez les écraser pour le serveur freenode avec la commande suivante :
----
/set irc.server.freenode.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5"
----
Pour modifier le nom d'utilisateur et nom réel :
Pour modifier le nom d'utilisateur et nom réel :
----
/set irc.server.freenode.username "Mon nom d'utilisateur"
/set irc.server.freenode.realname "Mon nom réel"
----
Pour activer la connexion automatique au serveur lors du démarrage :
Pour activer la connexion automatique au serveur lors du démarrage :
----
/set irc.server.freenode.autoconnect on
----
Pour se connecter avec SSL :
Pour se connecter avec SSL :
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
@ -158,7 +158,7 @@ Pour se connecter avec SSL :
----
Si SASL est disponible sur le serveur, vous pouvez l'utiliser pour
l'authentification (vous serez identifié avant de rejoindre les canaux) :
l'authentification (vous serez identifié avant de rejoindre les canaux) :
----
/set irc.server.freenode.sasl_username "pseudo"
@ -167,7 +167,7 @@ l'authentification (vous serez identifié avant de rejoindre les canaux) :
Pour lancer une commande après connexion au serveur, par exemple pour
s'authentifier auprès de nickserv (seulement si vous n'utilisez pas SASL pour
l'authentification) :
l'authentification) :
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
@ -180,26 +180,26 @@ Plusieurs commandes dans l'option _command_ peuvent être séparées par `;`
Si vous souhaitez protéger votre mot de passe dans les fichiers de
configuration, vous pouvez utiliser les données sécurisées.
Définissez d'abord une phrase de chiffrement :
Définissez d'abord une phrase de chiffrement :
----
/secure passphrase this is my secret passphrase
----
Puis ajoutez une donnée sécurisée avec votre mot de passe freenode :
Puis ajoutez une donnée sécurisée avec votre mot de passe freenode :
----
/secure set freenode_password xxxxxxx
----
Vous pouvez alors utiliser `+${sec.data.freenode_password}+` au lieu de votre
mot de passe dans les options IRC mentionnées ci-dessus, par exemple :
mot de passe dans les options IRC mentionnées ci-dessus, par exemple :
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----
Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
----
/set irc.server.freenode.autojoin "#canal1,#canal2"
@ -207,14 +207,14 @@ Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
Pour supprimer la valeur d'une option du serveur et utiliser sa valeur par
défaut à la place, par exemple pour utiliser les pseudos par défaut
(irc.server_default.nicks) :
(irc.server_default.nicks) :
----
/set irc.server.freenode.nicks null
----
Autres options : vous pouvez modifier les autres options avec la commande
suivante ("xxx" est le nom d'une option) :
Autres options : vous pouvez modifier les autres options avec la commande
suivante ("xxx" est le nom d'une option) :
----
/set irc.server.freenode.xxx valeur
@ -237,7 +237,7 @@ WeeChat. Pour basculer entre le tampon _core_ et les tampons des serveurs, il
faut utiliser la touche kbd:[Ctrl+x].
Il est possible de désactiver le mélange des tampons serveurs pour avoir un
tampon distinct par serveur :
tampon distinct par serveur :
----
/set irc.look.server_buffer independent
@ -246,20 +246,20 @@ tampon distinct par serveur :
[[join_part_irc_channels]]
== Rejoindre/quitter les canaux IRC
Rejoindre un canal :
Rejoindre un canal :
----
/join #channel
----
Quitter un canal (en laissant le tampon ouvert) :
Quitter un canal (en laissant le tampon ouvert) :
----
/part [message de fin]
----
Fermer un tampon serveur, canal ou privé (`/close` est un alias sur
`/buffer close`) :
`/buffer close`) :
----
/close
@ -268,7 +268,7 @@ Fermer un tampon serveur, canal ou privé (`/close` est un alias sur
[WARNING]
Fermer le tampon du serveur fermera tous les tampons canaux/privés.
Se déconnecter du serveur, sur le tampon du serveur :
Se déconnecter du serveur, sur le tampon du serveur :
----
/disconnect
@ -277,13 +277,13 @@ Se déconnecter du serveur, sur le tampon du serveur :
[[irc_private_messages]]
== Messages privés IRC
Ouvrir un tampon et envoyer un message à un autre utilisateur (pseudo _foo_) :
Ouvrir un tampon et envoyer un message à un autre utilisateur (pseudo _foo_) :
----
/query foo ceci est un message
----
Fermer le tampon privé :
Fermer le tampon privé :
----
/close
@ -299,7 +299,7 @@ Une fenêtre ("window") est une vue sur un tampon. Par défaut il n'y a
qu'une fenêtre affichant un tampon. Si vous divisez l'écran, vous verrez
alors plusieurs fenêtres avec plusieurs tampons en même temps.
Commandes pour gérer les tampons et les fenêtres :
Commandes pour gérer les tampons et les fenêtres :
----
/buffer
@ -310,13 +310,13 @@ Commandes pour gérer les tampons et les fenêtres :
avec /help)
Par exemple, pour découper verticalement l'écran en une petite fenêtre
(1/3 de la largeur) et une large (2/3), utilisez la commande :
(1/3 de la largeur) et une large (2/3), utilisez la commande :
----
/window splitv 33
----
Pour supprimer le découpage :
Pour supprimer le découpage :
----
/window merge
@ -327,35 +327,35 @@ Pour supprimer le découpage :
WeeChat utilise un certain nombre de touches par défaut. Toutes ces
touches sont dans la documentation, mais vous devriez connaître au moins
les touches vitales :
les touches vitales :
- kbd:[Alt+←] / kbd:[Alt+→] ou kbd:[F5] / kbd:[F6] : aller au tampon
- kbd:[Alt+←] / kbd:[Alt+→] ou kbd:[F5] / kbd:[F6] : aller au tampon
précédent/suivant
- kbd:[F7] / kbd:[F8] : aller à la fenêtre précédente/suivante (quand l'écran
- kbd:[F7] / kbd:[F8] : aller à la fenêtre précédente/suivante (quand l'écran
est divisé)
- kbd:[F9] / kbd:[F10] : faire défiler la barre de titre
- kbd:[F11] / kbd:[F12] : faire défiler la liste des pseudos
- kbd:[Tab] : compléter le texte de la barre d'entrée, comme avec votre shell
- kbd:[PgUp] / kbd:[PgDn] : faire défiler le texte dans le tampon courant
- kbd:[Alt+a] : sauter au tampon avec de l'activité (dans la "hotlist")
- kbd:[F9] / kbd:[F10] : faire défiler la barre de titre
- kbd:[F11] / kbd:[F12] : faire défiler la liste des pseudos
- kbd:[Tab] : compléter le texte de la barre d'entrée, comme avec votre shell
- kbd:[PgUp] / kbd:[PgDn] : faire défiler le texte dans le tampon courant
- kbd:[Alt+a] : sauter au tampon avec de l'activité (dans la "hotlist")
Selon votre clavier et/ou vos besoins, vous pouvez associer n'importe
quelle touche à une commande avec la commande `/key`.
Une touche utile est kbd:[Alt+k] pour trouver le code des touches.
Par exemple, pour associer kbd:[Alt+!] à la commande `/buffer close` :
Par exemple, pour associer kbd:[Alt+!] à la commande `/buffer close` :
----
/key bind (pressez alt-k) (pressez alt-!) /buffer close
----
Vous aurez une ligne de commande qui ressemble à ceci :
Vous aurez une ligne de commande qui ressemble à ceci :
----
/key bind meta-! /buffer close
----
Pour enlever la touche :
Pour enlever la touche :
----
/key unbind meta-!
@ -372,7 +372,7 @@ extensions ou des scripts).
De nombreux scripts externes (de contributeurs) sont disponibles pour WeeChat,
vous pouvez télécharger et installer les scripts avec la commande `/script`,
par exemple :
par exemple :
----
/script install iset.pl
@ -380,13 +380,13 @@ par exemple :
Voir `/help script` pour plus d'infos.
Une liste des scripts est disponible avec `/script` ou à cette URL :
Une liste des scripts est disponible avec `/script` ou à cette URL :
https://weechat.org/scripts
[[more_doc]]
== Plus de documentation
Vous pouvez maintenant utiliser WeeChat et lire la FAQ/documentation pour
toute autre question : https://weechat.org/doc
toute autre question : https://weechat.org/doc
Bon WeeChat !

File diff suppressed because it is too large Load Diff

View File

@ -12,7 +12,7 @@
Ce manuel documente le client de messagerie instantanée WeeChat, il fait
partie de WeeChat.
La dernière version de ce document peut être téléchargée sur cette page :
La dernière version de ce document peut être téléchargée sur cette page :
https://weechat.org/doc
@ -23,7 +23,7 @@ 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.
Ce manuel documente la façon d'écrire des scripts pour WeeChat, en utilisant
l'un des langages de script supportés :
l'un des langages de script supportés :
* python
* perl
@ -61,7 +61,7 @@ l'API est la même pour les autres langages.
* 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 à
cette fonction ressemble à ceci :
cette fonction ressemble à ceci :
[source,ruby]
----
@ -82,7 +82,7 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt
* 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 excède la limite de Guile :
paramètres excède la limite de Guile :
** config_new_section
** config_new_option
** bar_new
@ -97,29 +97,29 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt
Tous les scripts WeeChat doivent s'enregistrer ("register") auprès de WeeChat,
et cela doit être la première fonction WeeChat appelée dans le script.
Prototype :
Prototype :
[source,python]
----
weechat.register(name, author, version, license, description, shutdown_function, charset)
----
Paramètres :
Paramètres :
* _name_ : chaîne, nom interne du script
* _author_ : chaîne, nom de l'auteur
* _version_ : chaîne, version du script
* _license_ : chaîne, licence du script
* _description_ : chaîne, description courte du script
* _shutdown_function_ : chaîne, nom de la fonction appelée lorsque le script
* _name_ : chaîne, nom interne du script
* _author_ : chaîne, nom de l'auteur
* _version_ : chaîne, version du script
* _license_ : chaîne, licence du script
* _description_ : chaîne, description courte du script
* _shutdown_function_ : chaîne, nom de la fonction appelée lorsque le script
est déchargé (peut être une chaîne vide)
* _charset_ : chaîne, jeu de caractères du script (si votre script est UTF-8,
* _charset_ : chaîne, jeu de caractères du script (si votre script est UTF-8,
vous pouvez utiliser une valeur vide ici, car UTF-8 est le jeu de caractères
par défaut)
Exemple, pour chaque langage :
Exemple, pour chaque langage :
* Python :
* Python :
[source,python]
----
@ -129,7 +129,7 @@ weechat.register("test_python", "FlashCode", "1.0", "GPL3", "Script de test", ""
weechat.prnt("", "Bonjour, du script python !")
----
* Perl :
* Perl :
[source,perl]
----
@ -137,7 +137,7 @@ weechat::register("test_perl", "FlashCode", "1.0", "GPL3", "Script de test", "",
weechat::print("", "Bonjour, du script perl !");
----
* Ruby :
* Ruby :
[source,ruby]
----
@ -148,7 +148,7 @@ def weechat_init
end
----
* Lua :
* Lua :
[source,lua]
----
@ -156,7 +156,7 @@ weechat.register("test_lua", "FlashCode", "1.0", "GPL3", "Script de test", "", "
weechat.print("", "Bonjour, du script lua !")
----
* Tcl :
* Tcl :
[source,tcl]
----
@ -164,7 +164,7 @@ weechat::register "test_tcl" "FlashCode" "1.0" "GPL3" "Script de test" "" ""
weechat::print "" "Bonjour, du script tcl !"
----
* Guile (scheme) :
* Guile (scheme) :
[source,lisp]
----
@ -172,7 +172,7 @@ weechat::print "" "Bonjour, du script tcl !"
(weechat:print "" "Bonjour, du script scheme !")
----
* Javascript :
* Javascript :
[source,javascript]
----
@ -184,7 +184,7 @@ weechat.print("", "Bonjour, du script javascript !");
=== Chargement du script
Il est recommandé d'utiliser l'extension "script" pour charger les scripts,
par exemple :
par exemple :
----
/script load script.py
@ -196,7 +196,7 @@ par exemple :
/script load script.js
----
Chaque langage a également sa propre commande :
Chaque langage a également sa propre commande :
----
/python load script.py
@ -211,7 +211,7 @@ Chaque langage a également sa propre commande :
Vous pouvez faire un lien dans le répertoire _langage/autoload_ pour charger
automatiquement le script quand WeeChat démarre.
Par exemple en Python :
Par exemple en Python :
----
$ cd ~/.weechat/python/autoload
@ -227,15 +227,15 @@ dans le répertoire _autoload_ est automatiquement créé.
L'API script est quasiment identique à l'API C.
Vous pouvez consulter la _Référence API Extension WeeChat_ pour le détail de
chaque fonction de l'API : prototype, paramètres, valeurs de retour, exemples.
chaque fonction de l'API : prototype, paramètres, valeurs de retour, exemples.
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
_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`.
Quand votre script _test.py_ appelle une fonction de l'API WeeChat, le chemin
est le suivant :
est le suivant :
....
┌──────────────────────┐ ╔══════════════════╗
@ -246,7 +246,7 @@ test.py ─────► │ API script │ API C │ ─────► ║
....
Quand WeeChat appelle un "callback" dans votre script _test.py_, le chemin
est inversé :
est inversé :
....
╔══════════════════╗ ┌──────────────────────┐
@ -272,7 +272,7 @@ convertira en pointeur réel avant d'appeler la fonction de l'API C.
Une chaîne vide ou "0x0" sont autorisées, cela signifie le pointeur NULL en C.
Par exemple, pour afficher un message sur le tampon core (tampon principal
WeeChat), vous pouvez faire :
WeeChat), vous pouvez faire :
[source,python]
----
@ -283,7 +283,7 @@ weechat.prnt("", "bonjour !")
Dans beaucoup de fonctions, pour des raisons de vitesse, WeeChat ne vérifie pas
si votre pointeur est correct ou pas. Il est de votre responsabilité de
vérifier que vous donnez un pointeur valide, sinon vous pourriez voir un joli
rapport de crash ;)
rapport de crash ;)
[[callbacks]]
=== Callbacks
@ -296,9 +296,9 @@ 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
valeur (ce n'est pas un pointeur).
Exemple de callback, pour chaque langage :
Exemple de callback, pour chaque langage :
* Python :
* Python :
[source,python]
----
@ -309,7 +309,7 @@ def timer_cb(data, remaining_calls):
weechat.hook_timer(1000, 0, 1, "timer_cb", "test")
----
* Perl :
* Perl :
[source,perl]
----
@ -322,7 +322,7 @@ sub timer_cb {
weechat::hook_timer(1000, 0, 1, "timer_cb", "test");
----
* Ruby :
* Ruby :
[source,ruby]
----
@ -334,7 +334,7 @@ end
Weechat.hook_timer(1000, 0, 1, "timer_cb", "test");
----
* Lua :
* Lua :
[source,lua]
----
@ -346,7 +346,7 @@ end
weechat.hook_timer(1000, 0, 1, "timer_cb", "test")
----
* Tcl :
* Tcl :
[source,tcl]
----
@ -358,7 +358,7 @@ proc timer_cb { data remaining_calls } {
weechat::hook_timer 1000 0 1 timer_cb test
----
* Guile (scheme) :
* Guile (scheme) :
[source,lisp]
----
@ -370,7 +370,7 @@ weechat::hook_timer 1000 0 1 timer_cb test
(weechat:hook_timer 1000 0 1 "timer_cb" "test")
----
* Javascript :
* Javascript :
[source,javascript]
----
@ -391,7 +391,7 @@ _Référence API Extension WeeChat_.
[[script_api_functions]]
=== Fonctions
Liste des fonctions de l'API script :
Liste des fonctions de l'API script :
[width="75",cols="1,3",options="header"]
|===
@ -487,10 +487,10 @@ Liste des fonctions de l'API script :
| affichage |
prefix +
color +
print (pour python : prnt) +
print_date_tags (pour python :
print (pour python : prnt) +
print_date_tags (pour python :
prnt_date_tags) +
print_y (pour python : prnt_y) +
print_y (pour python : prnt_y) +
log_print
| hooks |
@ -627,7 +627,7 @@ Liste des fonctions de l'API script :
[[script_api_constants]]
=== Constantes
Liste des constantes de l'API script :
Liste des constantes de l'API script :
[width="75%",cols="1,3",options="header"]
|===
@ -706,7 +706,7 @@ Une chaîne vide est souvent utilisée pour travailler avec le tampon core WeeCh
Pour les autres tampons, vous devez passer un pointeur (sous forme de chaîne,
voir <<pointers,pointeurs>>).
Exemples :
Exemples :
[source,python]
----
@ -728,7 +728,7 @@ weechat.prnt("", "%smauvais paramètres" % weechat.prefix("error"))
weechat.prnt("", "texte %sjaune sur bleu" % weechat.color("yellow,blue"))
# chercher un tampon et afficher un message
# (le nom complet d'un tampon est extension.nom, par exemple : "irc.freenode.#weechat")
# (le nom complet d'un tampon est extension.nom, par exemple : "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
weechat.prnt(buffer, "message sur le canal #weechat")
@ -748,7 +748,7 @@ Perl/Ruby/Lua/Tcl/Guile/Javascript et `prnt` en Python.
Vous pouvez envoyer du texte ou une commande à un tampon. C'est exactement comme
si vous tapiez le texte sur la ligne de commande et que vous pressiez [Enter].
Exemples :
Exemples :
[source,python]
----
@ -766,11 +766,11 @@ 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
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`).
Exemple :
Exemple :
[source,python]
----
@ -800,7 +800,7 @@ weechat.buffer_set(buffer, "localvar_set_no_log", "1")
Vous pouvez lire des propriétés du tampon, sous forme de chaîne, entier ou
pointeur.
Exemples :
Exemples :
[source,python]
----
@ -812,7 +812,7 @@ short_name = weechat.buffer_get_string(buffer, "short_name")
----
Il est possible d'ajouter, lire ou supprimer des variables locales dans le
tampon :
tampon :
[source,python]
----
@ -827,7 +827,7 @@ weechat.buffer_set(buffer, "localvar_del_myvar", "")
----
Pour voir les variables locales d'un tampon, exécutez cette commande dans
WeeChat :
WeeChat :
----
/buffer localvar
@ -842,7 +842,7 @@ WeeChat :
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 :
Exemple :
[source,python]
----
@ -862,7 +862,7 @@ hook = weechat.hook_command("monfiltre", "description de mon filtre",
"my_command_cb", "")
----
Puis sous WeeChat :
Puis sous WeeChat :
----
/help monfiltre
@ -875,7 +875,7 @@ Puis sous WeeChat :
Ajoutez un minuteur avec `hook_timer`.
Exemple :
Exemple :
[source,python]
----
@ -897,7 +897,7 @@ plusieurs fois.
Pour le dernier appel à votre "callback", _rc_ est positionné à 0 ou une valeur
positive, c'est le code retour de la commande.
Exemple :
Exemple :
[source,python]
----
@ -923,8 +923,8 @@ 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
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) :
Exemple de transfert d'URL sans option : la page HTML sera reçue comme "out"
dans le "callback" (sortie standard du processus) :
[source,python]
----
@ -936,7 +936,7 @@ def weechat_process_cb(data, command, rc, out, err):
if out != "":
weechat_version += out
if int(rc) >= 0:
weechat.prnt("", "La version stable courante de WeeChat est : %s" % weechat_version)
weechat.prnt("", "La version stable courante de WeeChat est : %s" % weechat_version)
return weechat.WEECHAT_RC_OK
weechat.hook_process("url:https://weechat.org/dev/info/stable/",
@ -947,8 +947,8 @@ weechat.hook_process("url:https://weechat.org/dev/info/stable/",
Toutes les infos disponibles à propos de WeeChat sont sur la page
https://weechat.org/dev/info
Exemple de transfert d'URL avec une option : télécharger le dernier paquet de
développement WeeChat dans le fichier _/tmp/weechat-devel.tar.gz_ :
Exemple de transfert d'URL avec une option : télécharger le dernier paquet de
développement WeeChat dans le fichier _/tmp/weechat-devel.tar.gz_ :
[source,python]
----
@ -975,7 +975,7 @@ _Référence API Extension WeeChat_.
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 :
Exemple :
[source,python]
----
@ -995,7 +995,7 @@ for option, default_value in script_options.items():
Vous devez utiliser `hook_config` pour être notifié si l'utilisateur modifie
certaines options du script.
Exemple :
Exemple :
[source,python]
----
@ -1025,19 +1025,19 @@ fonction du type de l'option, il faut appeler `config_string`, `config_boolean`,
[source,python]
----
# chaîne
weechat.prnt("", "la valeur de l'option weechat.look.item_time_format est : %s"
weechat.prnt("", "la valeur de l'option weechat.look.item_time_format est : %s"
% (weechat.config_string(weechat.config_get("weechat.look.item_time_format"))))
# booléen
weechat.prnt("", "la valeur de l'option weechat.look.day_change est : %d"
weechat.prnt("", "la valeur de l'option weechat.look.day_change est : %d"
% (weechat.config_boolean(weechat.config_get("weechat.look.day_change"))))
# entier
weechat.prnt("", "la valeur de l'option weechat.look.scroll_page_percent est : %d"
weechat.prnt("", "la valeur de l'option weechat.look.scroll_page_percent est : %d"
% (weechat.config_integer(weechat.config_get("weechat.look.scroll_page_percent"))))
# couleur
weechat.prnt("", "la valeur de l'option weechat.color.chat_delimiters est : %s"
weechat.prnt("", "la valeur de l'option weechat.color.chat_delimiters est : %s"
% (weechat.config_color(weechat.config_get("weechat.color.chat_delimiters"))))
----
@ -1049,7 +1049,7 @@ weechat.prnt("", "la valeur de l'option weechat.color.chat_delimiters est : %s"
L'extension IRC envoie deux signaux pour un message reçu (`xxx` est le nom
interne du serveur IRC, `yyy` est le nom de la commande IRC comme JOIN, QUIT,
PRIVMSG, 301, ..) :
PRIVMSG, 301, ..) :
xxxx,irc_in_yyy::
signal envoyé avant traitement du message
@ -1060,8 +1060,8 @@ xxx,irc_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# signal est par exemple : "freenode,irc_in2_join"
# signal_data est le message IRC, par exemple : ":nick!user@host JOIN :#canal"
# signal est par exemple : "freenode,irc_in2_join"
# signal_data est le message IRC, par exemple : ":nick!user@host JOIN :#canal"
nick = weechat.info_get("irc_nick_from_host", signal_data)
server = signal.split(",")[0]
channel = signal_data.split(":")[-1]
@ -1104,8 +1104,8 @@ 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!`) :
(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"]
|===
@ -1193,7 +1193,7 @@ Le meilleur moyen de vérifier la version est de demander "version_number" et de
faire une comparaison entre nombre entiers avec la version hexadécimale de la
version.
Exemple :
Exemple :
[source,python]
----
@ -1209,7 +1209,7 @@ Les versions ≤ 0.3.1.1 retournent une chaîne vide pour
_info_get("version_number")_, donc vous devez vérifier que la valeur de retour
n'est *pas* vide.
Pour obtenir la version sous forme de chaîne :
Pour obtenir la version sous forme de chaîne :
[source,python]
----
@ -1222,8 +1222,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# répertoire de WeeChat, par exemple : "/home/xxxx/.weechat"
weechat.prnt("", "Répertoire WeeChat : %s" % weechat.info_get("weechat_dir", ""))
# répertoire de WeeChat, par exemple : "/home/xxxx/.weechat"
weechat.prnt("", "Répertoire WeeChat : %s" % weechat.info_get("weechat_dir", ""))
# inactivité clavier
weechat.prnt("", "Inactivité depuis %s secondes" % weechat.info_get("inactivity", ""))
@ -1237,7 +1237,7 @@ weechat.prnt("", "Inactivité depuis %s secondes" % weechat.info_get("inactivity
Vous pouvez lire une infolist construite par WeeChat ou d'autres extensions.
Exemple :
Exemple :
[source,python]
----

View File

@ -20,7 +20,7 @@ sont implémentées, elles doivent être testées, mais pour certaines
fonctionnalités il y a trop de cas à tester et les développeurs ne
peuvent pas tout tester.
Par exemple : l'extension charset introduite dans WeeChat WeeChat 0.2.2 : aucun
Par exemple : l'extension charset introduite dans WeeChat WeeChat 0.2.2 : aucun
de nous (développeurs, contributeurs et testeurs) n'utilisait de canaux avec
des caractères spéciaux dans leurs noms et quand la version 0.2.2 a été rendue
disponible, nous avons reçu de nombreuses remontées d'utilisateurs russes.
@ -35,12 +35,12 @@ fonctionnalités (et à corriger des anciens bugs).
[[prepare_system]]
== Préparez votre système
Cela nous aiderait beaucoup si vous activiez les fichiers _core_ Linux : si
Cela nous aiderait beaucoup si vous activiez les fichiers _core_ Linux : si
WeeChat se plante, Linux écrit un fichier _core_. Ce fichier contient des
informations importantes pour le debug, pour savoir exactement où le problème
se situe dans WeeChat).
Si vous utilisez le shell _bash_, ajoutez cette ligne dans votre _~/.bashrc_ :
Si vous utilisez le shell _bash_, ajoutez cette ligne dans votre _~/.bashrc_ :
----
ulimit -c unlimited
@ -53,7 +53,7 @@ ulimit -c unlimited
Le code tout frais (avec les derniers bugs et fonctionnalités) est stocké dans
GIT.
Vous pouvez décider de le construire manuellement (méthode recommandée) :
Vous pouvez décider de le construire manuellement (méthode recommandée) :
* La version GIT peut être construite et installée en parallèle de la version
stable,
@ -63,14 +63,14 @@ Vous pouvez décider de le construire manuellement (méthode recommandée) :
[[get_sources]]
=== Obtenir et compiler les sources
Créez tout d'abord un répertoire, par exemple _weechat-git_ :
Créez tout d'abord un répertoire, par exemple _weechat-git_ :
----
$ mkdir ~/weechat-git
$ cd ~/weechat-git
----
Si vous avez git installé, vous pouvez cloner la base GIT (recommandé) :
Si vous avez git installé, vous pouvez cloner la base GIT (recommandé) :
----
$ git clone https://github.com/weechat/weechat.git
@ -81,7 +81,7 @@ $ cd weechat
Plus tard, vous pourrez utiliser la commande `git pull` dans ce répertoire
pour obtenir juste les deltas avec la version d'aujourd'hui.
Sinon vous pouvez installer le paquet _devel_ :
Sinon vous pouvez installer le paquet _devel_ :
----
$ wget https://weechat.org/files/src/weechat-devel.tar.bz2
@ -89,7 +89,7 @@ $ tar xvjf weechat-devel.tar.bz2
$ cd weechat-devel
----
Pour compiler les sources, cmake est recommandé :
Pour compiler les sources, cmake est recommandé :
----
$ mkdir build
@ -99,7 +99,7 @@ $ make
$ make install
----
Si vous n'avez pas cmake, il est toujours possible d'utiliser les autotools :
Si vous n'avez pas cmake, il est toujours possible d'utiliser les autotools :
----
$ ./autogen.sh
@ -111,12 +111,12 @@ $ make install
[[install_binary_package]]
=== Obtenir un paquet binaire
Selon votre distribution Linux :
Selon votre distribution Linux :
* Debian : https://weechat.org/download/debian
* Gentoo : https://weechat.org/download
* ArchLinux : PKGBUILD depuis http://aur.archlinux.org/
* autre : nous ne savons pas ! Eheh.
* Debian : https://weechat.org/download/debian
* Gentoo : https://weechat.org/download
* ArchLinux : PKGBUILD depuis http://aur.archlinux.org/
* autre : nous ne savons pas ! Eheh.
[[run]]
@ -125,14 +125,14 @@ Selon votre distribution Linux :
Il est conseillé de lancer WeeChat avec un répertoire différent de la version
stable, avec l'option `--dir`.
La commande est :
La commande est :
----
$ ~/weechat-git/bin/weechat
----
Si vous êtes encore éveillé, vous devriez voir une interface familière et
pouvoir vous vanter d'utiliser la version la plus récente possible de WeeChat ;)
pouvoir vous vanter d'utiliser la version la plus récente possible de WeeChat ;)
Maintenant si vous obtenez un comportement étrange ou un plantage, n'hésitez
pas à nous en avertir sur _#weechat_, serveur _chat.freenode.net_.

File diff suppressed because it is too large Load Diff

View File

@ -15930,7 +15930,7 @@ Esempio in C:
struct t_gui_lines *own_lines;
struct t_gui_line *line;
struct t_gui_line_data *line_data;
struct t_gui_line_data *line_data;
struct t_hdata *hdata;
struct t_hashtable *hashtable;
char str_date[64];

View File

@ -15398,7 +15398,7 @@ C 言語での使用例:
struct t_gui_lines *own_lines;
struct t_gui_line *line;
struct t_gui_line_data *line_data;
struct t_gui_line_data *line_data;
struct t_hdata *hdata;
struct t_hashtable *hashtable;
char str_date[64];