From 20b567c3df2e3cf82f90f9b2dfdeb213d5b316b7 Mon Sep 17 00:00:00 2001 From: Sebastien Helleu Date: Mon, 14 May 2007 21:09:08 +0000 Subject: [PATCH] Added charset plugin in doc --- doc/de/weechat.de.xml | 109 +++++++++++++++++++++++++++++++ doc/en/weechat.en.xml | 108 +++++++++++++++++++++++++++++++ doc/fr/weechat.fr.xml | 118 ++++++++++++++++++++++++++++++++++ weechat/doc/de/weechat.de.xml | 109 +++++++++++++++++++++++++++++++ weechat/doc/en/weechat.en.xml | 108 +++++++++++++++++++++++++++++++ weechat/doc/fr/weechat.fr.xml | 118 ++++++++++++++++++++++++++++++++++ 6 files changed, 670 insertions(+) diff --git a/doc/de/weechat.de.xml b/doc/de/weechat.de.xml index 3bb2acdc7..39bb5fbf3 100644 --- a/doc/de/weechat.de.xml +++ b/doc/de/weechat.de.xml @@ -1116,6 +1116,115 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA + +
+ Charset plugin + + + Charset plugin lets you encode or decode data using charsets, with 3 + levels: global, by server, or by channel. + This plugin is optional, but recommended: if it's not loaded, WeeChat + can only read/write UTF-8 data. + + + + Charset plugin should be autoloaded by WeeChat at startup. + To be sure plugin is loaded, try: + "/charset". + If command is not found, then load plugin with command: + /plugin load charset + If plugin is not found, then you should compile again WeeChat with + plugins and Charset support. + + + + When Charset plugin starts, it displays terminal and internal charsets. + Terminal charset depends on your locale, and internal is UTF-8. + For example : + +-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8) + + + +
+ Settings + + + + + To set global decode and encode charsets, use + "/setp" command. + For example: + +/setp charset.global.decode = ISO-8859-15 +/setp charset.global.encode = ISO-8859-15 + + If global decode charset is not set (for example during first + load of Charset plugin), it will be automatically set to terminal + charset (if it's different from UTF-8), or by default to + "ISO-8859-1". + Default encode value is empty, so it sends by default with + internal charset (UTF-8). + + + + + To set server charset, use "/charset" command + on server buffer. + If you give only charset, then it will set "decode" and "encode" + values. + For example: + /charset ISO-8859-15 + It's equivalent to: + +/charset decode ISO-8859-15 +/charset encode ISO-8859-15 + + + + + + To set channel (or private) charset, use same commands as server, + but on channel (or private) buffer. + + + + +
+ +
+ FAQ + + + If you have problems with chars or accents using Charset plugin: + + + + check that weechat-curses is linked to libncursesw (warning: + needed on most distributions but not all) : + ldd /path/to/weechat-curses + + + + + check charset line (on server buffer), you should see + ISO-XXXXXX or UTF-8 for terminal charset. If you see + ANSI_X3.4-1968 or other values, probably your locale is wrong. + + + + + setup global decode value, for example: + /setp charset.global.decode = ISO-8859-15 + + + + + +
+ +
+
Remote-Schnittstelle (FIFO pipe) diff --git a/doc/en/weechat.en.xml b/doc/en/weechat.en.xml index 522e4850f..0100b8004 100644 --- a/doc/en/weechat.en.xml +++ b/doc/en/weechat.en.xml @@ -1111,6 +1111,114 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+
+ Charset plugin + + + Charset plugin lets you encode or decode data using charsets, with 3 + levels: global, by server, or by channel. + This plugin is optional, but recommended: if it's not loaded, WeeChat + can only read/write UTF-8 data. + + + + Charset plugin should be autoloaded by WeeChat at startup. + To be sure plugin is loaded, try: + "/charset". + If command is not found, then load plugin with command: + /plugin load charset + If plugin is not found, then you should compile again WeeChat with + plugins and Charset support. + + + + When Charset plugin starts, it displays terminal and internal charsets. + Terminal charset depends on your locale, and internal is UTF-8. + For example : + +-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8) + + + +
+ Settings + + + + + To set global decode and encode charsets, use + "/setp" command. + For example: + +/setp charset.global.decode = ISO-8859-15 +/setp charset.global.encode = ISO-8859-15 + + If global decode charset is not set (for example during first + load of Charset plugin), it will be automatically set to terminal + charset (if it's different from UTF-8), or by default to + "ISO-8859-1". + Default encode value is empty, so it sends by default with + internal charset (UTF-8). + + + + + To set server charset, use "/charset" command + on server buffer. + If you give only charset, then it will set "decode" and "encode" + values. + For example: + /charset ISO-8859-15 + It's equivalent to: + +/charset decode ISO-8859-15 +/charset encode ISO-8859-15 + + + + + + To set channel (or private) charset, use same commands as server, + but on channel (or private) buffer. + + + + +
+ +
+ FAQ + + + If you have problems with chars or accents using Charset plugin: + + + + check that weechat-curses is linked to libncursesw (warning: + needed on most distributions but not all) : + ldd /path/to/weechat-curses + + + + + check charset line (on server buffer), you should see + ISO-XXXXXX or UTF-8 for terminal charset. If you see + ANSI_X3.4-1968 or other values, probably your locale is wrong. + + + + + setup global decode value, for example: + /setp charset.global.decode = ISO-8859-15 + + + + + +
+ +
+
FIFO pipe diff --git a/doc/fr/weechat.fr.xml b/doc/fr/weechat.fr.xml index 9261258fd..d1d686084 100644 --- a/doc/fr/weechat.fr.xml +++ b/doc/fr/weechat.fr.xml @@ -1124,6 +1124,124 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ +
+ Extension Charset + + + L'extension Charset vous permet d'encoder et décoder les données en + utilisant un jeu de caractères, avec 3 niveaux : global, par serveur, + ou par canal. + Cette extension est facultative, mais recommandée : si elle n'est pas + chargée, WeeChat pourra uniquement lire/écrire des données UTF-8. + + + + L'extension Charset devrait être automatiquement chargée par WeeChat + au démarrage. + Pour s'assurer que l'extension est bien chargée, essayez : + "/charset". + Si la commande n'est pas trouvée, alors chargez l'extension avec la + commande : + /plugin load charset + Si l'extension n'est pas trouvée, alors vous devriez recompiler + WeeChat avec les extensions et le support de Charset. + + + + Lorsque l'extension Charset démarre, elle affiche le jeu de caractères + du terminal et l'interne. + Le jeu de caractères du terminal dépend de votre locale, et l'interne + est UTF-8. + Par exemple : + +-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8) + + + +
+ Configuration + + + + + Pour modifier les jeux de caractères de décodage et d'encodage + globaux, utilisez la commande "/setp". + Par exemple : + +/setp charset.global.decode = ISO-8859-15 +/setp charset.global.encode = ISO-8859-15 + + Si le jeu de caractères de décodage global n'est pas renseigné + (par exemple pendant le premier chargement de Charset), il sera + renseigné automatiquement avec le jeu de caractères du terminal + (s'il est différent de UTF-8) ou par défaut à + "ISO-8859-1". + La valeur d'encodage par défaut est vide, donc WeeChat envoie par + défaut avec le jeu de caractères interne (UTF-8). + + + + + Pour modifier le jeu de caractères d'un serveur, utilisez la + commande "/charset" sur le tampon serveur. + Si vous donnez seulement le jeu de caractères, alors vous + modifiez en même temps les valeurs de décodage et d'encodage. + Par exemple : + /charset ISO-8859-15 + Ce qui est équivalent à : + +/charset decode ISO-8859-15 +/charset encode ISO-8859-15 + + + + + + Pour modifier le jeu de caractères d'un canal (ou d'une + conversation privée), utilisez la même commande que pour le + serveur, mais sur le tampon du canal (ou du privé). + + + + +
+ +
+ FAQ + + + Si vous avez des problèmes avec certains caractères ou les accents en + utilisant l'extension Charset : + + + + vérifiez que weechat-curses est lié avec libncursesw + (attention : nécessaire sur beaucoup de distributions, mais pas + toutes) : + ldd /chemin/vers/weechat-curses + + + + + vérifiez la ligne charset (sur le tampon serveur), vous 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. + + + + + affectez la valeur pour le décodage global, par exemple : + /setp charset.global.decode = ISO-8859-15 + + + + + +
+ +
Tube FIFO diff --git a/weechat/doc/de/weechat.de.xml b/weechat/doc/de/weechat.de.xml index 3bb2acdc7..39bb5fbf3 100644 --- a/weechat/doc/de/weechat.de.xml +++ b/weechat/doc/de/weechat.de.xml @@ -1116,6 +1116,115 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ +
+ Charset plugin + + + Charset plugin lets you encode or decode data using charsets, with 3 + levels: global, by server, or by channel. + This plugin is optional, but recommended: if it's not loaded, WeeChat + can only read/write UTF-8 data. + + + + Charset plugin should be autoloaded by WeeChat at startup. + To be sure plugin is loaded, try: + "/charset". + If command is not found, then load plugin with command: + /plugin load charset + If plugin is not found, then you should compile again WeeChat with + plugins and Charset support. + + + + When Charset plugin starts, it displays terminal and internal charsets. + Terminal charset depends on your locale, and internal is UTF-8. + For example : + +-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8) + + + +
+ Settings + + + + + To set global decode and encode charsets, use + "/setp" command. + For example: + +/setp charset.global.decode = ISO-8859-15 +/setp charset.global.encode = ISO-8859-15 + + If global decode charset is not set (for example during first + load of Charset plugin), it will be automatically set to terminal + charset (if it's different from UTF-8), or by default to + "ISO-8859-1". + Default encode value is empty, so it sends by default with + internal charset (UTF-8). + + + + + To set server charset, use "/charset" command + on server buffer. + If you give only charset, then it will set "decode" and "encode" + values. + For example: + /charset ISO-8859-15 + It's equivalent to: + +/charset decode ISO-8859-15 +/charset encode ISO-8859-15 + + + + + + To set channel (or private) charset, use same commands as server, + but on channel (or private) buffer. + + + + +
+ +
+ FAQ + + + If you have problems with chars or accents using Charset plugin: + + + + check that weechat-curses is linked to libncursesw (warning: + needed on most distributions but not all) : + ldd /path/to/weechat-curses + + + + + check charset line (on server buffer), you should see + ISO-XXXXXX or UTF-8 for terminal charset. If you see + ANSI_X3.4-1968 or other values, probably your locale is wrong. + + + + + setup global decode value, for example: + /setp charset.global.decode = ISO-8859-15 + + + + + +
+ +
+
Remote-Schnittstelle (FIFO pipe) diff --git a/weechat/doc/en/weechat.en.xml b/weechat/doc/en/weechat.en.xml index 522e4850f..0100b8004 100644 --- a/weechat/doc/en/weechat.en.xml +++ b/weechat/doc/en/weechat.en.xml @@ -1111,6 +1111,114 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+
+ Charset plugin + + + Charset plugin lets you encode or decode data using charsets, with 3 + levels: global, by server, or by channel. + This plugin is optional, but recommended: if it's not loaded, WeeChat + can only read/write UTF-8 data. + + + + Charset plugin should be autoloaded by WeeChat at startup. + To be sure plugin is loaded, try: + "/charset". + If command is not found, then load plugin with command: + /plugin load charset + If plugin is not found, then you should compile again WeeChat with + plugins and Charset support. + + + + When Charset plugin starts, it displays terminal and internal charsets. + Terminal charset depends on your locale, and internal is UTF-8. + For example : + +-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8) + + + +
+ Settings + + + + + To set global decode and encode charsets, use + "/setp" command. + For example: + +/setp charset.global.decode = ISO-8859-15 +/setp charset.global.encode = ISO-8859-15 + + If global decode charset is not set (for example during first + load of Charset plugin), it will be automatically set to terminal + charset (if it's different from UTF-8), or by default to + "ISO-8859-1". + Default encode value is empty, so it sends by default with + internal charset (UTF-8). + + + + + To set server charset, use "/charset" command + on server buffer. + If you give only charset, then it will set "decode" and "encode" + values. + For example: + /charset ISO-8859-15 + It's equivalent to: + +/charset decode ISO-8859-15 +/charset encode ISO-8859-15 + + + + + + To set channel (or private) charset, use same commands as server, + but on channel (or private) buffer. + + + + +
+ +
+ FAQ + + + If you have problems with chars or accents using Charset plugin: + + + + check that weechat-curses is linked to libncursesw (warning: + needed on most distributions but not all) : + ldd /path/to/weechat-curses + + + + + check charset line (on server buffer), you should see + ISO-XXXXXX or UTF-8 for terminal charset. If you see + ANSI_X3.4-1968 or other values, probably your locale is wrong. + + + + + setup global decode value, for example: + /setp charset.global.decode = ISO-8859-15 + + + + + +
+ +
+
FIFO pipe diff --git a/weechat/doc/fr/weechat.fr.xml b/weechat/doc/fr/weechat.fr.xml index 9261258fd..d1d686084 100644 --- a/weechat/doc/fr/weechat.fr.xml +++ b/weechat/doc/fr/weechat.fr.xml @@ -1124,6 +1124,124 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ +
+ Extension Charset + + + L'extension Charset vous permet d'encoder et décoder les données en + utilisant un jeu de caractères, avec 3 niveaux : global, par serveur, + ou par canal. + Cette extension est facultative, mais recommandée : si elle n'est pas + chargée, WeeChat pourra uniquement lire/écrire des données UTF-8. + + + + L'extension Charset devrait être automatiquement chargée par WeeChat + au démarrage. + Pour s'assurer que l'extension est bien chargée, essayez : + "/charset". + Si la commande n'est pas trouvée, alors chargez l'extension avec la + commande : + /plugin load charset + Si l'extension n'est pas trouvée, alors vous devriez recompiler + WeeChat avec les extensions et le support de Charset. + + + + Lorsque l'extension Charset démarre, elle affiche le jeu de caractères + du terminal et l'interne. + Le jeu de caractères du terminal dépend de votre locale, et l'interne + est UTF-8. + Par exemple : + +-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8) + + + +
+ Configuration + + + + + Pour modifier les jeux de caractères de décodage et d'encodage + globaux, utilisez la commande "/setp". + Par exemple : + +/setp charset.global.decode = ISO-8859-15 +/setp charset.global.encode = ISO-8859-15 + + Si le jeu de caractères de décodage global n'est pas renseigné + (par exemple pendant le premier chargement de Charset), il sera + renseigné automatiquement avec le jeu de caractères du terminal + (s'il est différent de UTF-8) ou par défaut à + "ISO-8859-1". + La valeur d'encodage par défaut est vide, donc WeeChat envoie par + défaut avec le jeu de caractères interne (UTF-8). + + + + + Pour modifier le jeu de caractères d'un serveur, utilisez la + commande "/charset" sur le tampon serveur. + Si vous donnez seulement le jeu de caractères, alors vous + modifiez en même temps les valeurs de décodage et d'encodage. + Par exemple : + /charset ISO-8859-15 + Ce qui est équivalent à : + +/charset decode ISO-8859-15 +/charset encode ISO-8859-15 + + + + + + Pour modifier le jeu de caractères d'un canal (ou d'une + conversation privée), utilisez la même commande que pour le + serveur, mais sur le tampon du canal (ou du privé). + + + + +
+ +
+ FAQ + + + Si vous avez des problèmes avec certains caractères ou les accents en + utilisant l'extension Charset : + + + + vérifiez que weechat-curses est lié avec libncursesw + (attention : nécessaire sur beaucoup de distributions, mais pas + toutes) : + ldd /chemin/vers/weechat-curses + + + + + vérifiez la ligne charset (sur le tampon serveur), vous 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. + + + + + affectez la valeur pour le décodage global, par exemple : + /setp charset.global.decode = ISO-8859-15 + + + + + +
+ +
Tube FIFO