doc: add non-breaking spaces in French docs before colons and semicolons
parent
bd3dfb4827
commit
c008fa68b7
|
@ -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];
|
||||
|
|
|
@ -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).
|
||||
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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>>
|
||||
|
|
|
@ -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
|
@ -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
|
@ -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]
|
||||
----
|
||||
|
|
|
@ -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
|
@ -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];
|
||||
|
|
|
@ -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];
|
||||
|
|
Loading…
Reference in New Issue