1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-28 22:06:38 +02:00

Added charset plugin in doc

This commit is contained in:
Sebastien Helleu
2007-05-14 21:09:08 +00:00
parent d395846fb7
commit 20b567c3df
6 changed files with 670 additions and 0 deletions
+109
View File
@@ -1116,6 +1116,115 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
</section>
<!-- TRANSLATION NEEDED -->
<section id="secCharset">
<title>Charset plugin</title>
<para>
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.
</para>
<para>
Charset plugin should be autoloaded by WeeChat at startup.
To be sure plugin is loaded, try:
"<literal>/charset</literal>".
If command is not found, then load plugin with command:
<screen>/plugin load charset</screen>
If plugin is not found, then you should compile again WeeChat with
plugins and Charset support.
</para>
<para>
When Charset plugin starts, it displays terminal and internal charsets.
Terminal charset depends on your locale, and internal is UTF-8.
For example :
<screen>
-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8)
</screen>
</para>
<section id="secCharsetSettings">
<title>Settings</title>
<itemizedlist>
<listitem>
<para>
To set global decode and encode charsets, use
"<literal>/setp</literal>" command.
For example:
<screen>
/setp charset.global.decode = ISO-8859-15
/setp charset.global.encode = ISO-8859-15
</screen>
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
"<literal>ISO-8859-1</literal>".
Default encode value is empty, so it sends by default with
internal charset (UTF-8).
</para>
</listitem>
<listitem>
<para>
To set server charset, use "<literal>/charset</literal>" command
on server buffer.
If you give only charset, then it will set "decode" and "encode"
values.
For example:
<screen>/charset ISO-8859-15</screen>
It's equivalent to:
<screen>
/charset decode ISO-8859-15
/charset encode ISO-8859-15
</screen>
</para>
</listitem>
<listitem>
<para>
To set channel (or private) charset, use same commands as server,
but on channel (or private) buffer.
</para>
</listitem>
</itemizedlist>
</section>
<section id="secCharsetFAQ">
<title>FAQ</title>
<para>
If you have problems with chars or accents using Charset plugin:
<itemizedlist>
<listitem>
<para>
check that weechat-curses is linked to libncursesw (warning:
needed on most distributions but not all) :
<screen>ldd /path/to/weechat-curses</screen>
</para>
</listitem>
<listitem>
<para>
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.
</para>
</listitem>
<listitem>
<para>
setup global decode value, for example:
<screen>/setp charset.global.decode = ISO-8859-15</screen>
</para>
</listitem>
</itemizedlist>
</para>
</section>
</section>
<section id="secFIFOpipe">
<title> Remote-Schnittstelle (FIFO pipe) </title>
+108
View File
@@ -1111,6 +1111,114 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
</section>
<section id="secCharset">
<title>Charset plugin</title>
<para>
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.
</para>
<para>
Charset plugin should be autoloaded by WeeChat at startup.
To be sure plugin is loaded, try:
"<literal>/charset</literal>".
If command is not found, then load plugin with command:
<screen>/plugin load charset</screen>
If plugin is not found, then you should compile again WeeChat with
plugins and Charset support.
</para>
<para>
When Charset plugin starts, it displays terminal and internal charsets.
Terminal charset depends on your locale, and internal is UTF-8.
For example :
<screen>
-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8)
</screen>
</para>
<section id="secCharsetSettings">
<title>Settings</title>
<itemizedlist>
<listitem>
<para>
To set global decode and encode charsets, use
"<literal>/setp</literal>" command.
For example:
<screen>
/setp charset.global.decode = ISO-8859-15
/setp charset.global.encode = ISO-8859-15
</screen>
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
"<literal>ISO-8859-1</literal>".
Default encode value is empty, so it sends by default with
internal charset (UTF-8).
</para>
</listitem>
<listitem>
<para>
To set server charset, use "<literal>/charset</literal>" command
on server buffer.
If you give only charset, then it will set "decode" and "encode"
values.
For example:
<screen>/charset ISO-8859-15</screen>
It's equivalent to:
<screen>
/charset decode ISO-8859-15
/charset encode ISO-8859-15
</screen>
</para>
</listitem>
<listitem>
<para>
To set channel (or private) charset, use same commands as server,
but on channel (or private) buffer.
</para>
</listitem>
</itemizedlist>
</section>
<section id="secCharsetFAQ">
<title>FAQ</title>
<para>
If you have problems with chars or accents using Charset plugin:
<itemizedlist>
<listitem>
<para>
check that weechat-curses is linked to libncursesw (warning:
needed on most distributions but not all) :
<screen>ldd /path/to/weechat-curses</screen>
</para>
</listitem>
<listitem>
<para>
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.
</para>
</listitem>
<listitem>
<para>
setup global decode value, for example:
<screen>/setp charset.global.decode = ISO-8859-15</screen>
</para>
</listitem>
</itemizedlist>
</para>
</section>
</section>
<section id="secFIFOpipe">
<title>FIFO pipe</title>
+118
View File
@@ -1124,6 +1124,124 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
</para>
</section>
<section id="secCharset">
<title>Extension Charset</title>
<para>
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.
</para>
<para>
L'extension Charset devrait être automatiquement chargée par WeeChat
au démarrage.
Pour s'assurer que l'extension est bien chargée, essayez :
"<literal>/charset</literal>".
Si la commande n'est pas trouvée, alors chargez l'extension avec la
commande :
<screen>/plugin load charset</screen>
Si l'extension n'est pas trouvée, alors vous devriez recompiler
WeeChat avec les extensions et le support de Charset.
</para>
<para>
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 :
<screen>
-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8)
</screen>
</para>
<section id="secCharsetSettings">
<title>Configuration</title>
<itemizedlist>
<listitem>
<para>
Pour modifier les jeux de caractères de décodage et d'encodage
globaux, utilisez la commande "<literal>/setp</literal>".
Par exemple :
<screen>
/setp charset.global.decode = ISO-8859-15
/setp charset.global.encode = ISO-8859-15
</screen>
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 à
"<literal>ISO-8859-1</literal>".
La valeur d'encodage par défaut est vide, donc WeeChat envoie par
défaut avec le jeu de caractères interne (UTF-8).
</para>
</listitem>
<listitem>
<para>
Pour modifier le jeu de caractères d'un serveur, utilisez la
commande "<literal>/charset</literal>" 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 :
<screen>/charset ISO-8859-15</screen>
Ce qui est équivalent à :
<screen>
/charset decode ISO-8859-15
/charset encode ISO-8859-15
</screen>
</para>
</listitem>
<listitem>
<para>
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é).
</para>
</listitem>
</itemizedlist>
</section>
<section id="secCharsetFAQ">
<title>FAQ</title>
<para>
Si vous avez des problèmes avec certains caractères ou les accents en
utilisant l'extension Charset :
<itemizedlist>
<listitem>
<para>
vérifiez que weechat-curses est lié avec libncursesw
(attention : nécessaire sur beaucoup de distributions, mais pas
toutes) :
<screen>ldd /chemin/vers/weechat-curses</screen>
</para>
</listitem>
<listitem>
<para>
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.
</para>
</listitem>
<listitem>
<para>
affectez la valeur pour le décodage global, par exemple :
<screen>/setp charset.global.decode = ISO-8859-15</screen>
</para>
</listitem>
</itemizedlist>
</para>
</section>
</section>
<section id="secTubeFIFO">
<title>Tube FIFO</title>
+109
View File
@@ -1116,6 +1116,115 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
</section>
<!-- TRANSLATION NEEDED -->
<section id="secCharset">
<title>Charset plugin</title>
<para>
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.
</para>
<para>
Charset plugin should be autoloaded by WeeChat at startup.
To be sure plugin is loaded, try:
"<literal>/charset</literal>".
If command is not found, then load plugin with command:
<screen>/plugin load charset</screen>
If plugin is not found, then you should compile again WeeChat with
plugins and Charset support.
</para>
<para>
When Charset plugin starts, it displays terminal and internal charsets.
Terminal charset depends on your locale, and internal is UTF-8.
For example :
<screen>
-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8)
</screen>
</para>
<section id="secCharsetSettings">
<title>Settings</title>
<itemizedlist>
<listitem>
<para>
To set global decode and encode charsets, use
"<literal>/setp</literal>" command.
For example:
<screen>
/setp charset.global.decode = ISO-8859-15
/setp charset.global.encode = ISO-8859-15
</screen>
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
"<literal>ISO-8859-1</literal>".
Default encode value is empty, so it sends by default with
internal charset (UTF-8).
</para>
</listitem>
<listitem>
<para>
To set server charset, use "<literal>/charset</literal>" command
on server buffer.
If you give only charset, then it will set "decode" and "encode"
values.
For example:
<screen>/charset ISO-8859-15</screen>
It's equivalent to:
<screen>
/charset decode ISO-8859-15
/charset encode ISO-8859-15
</screen>
</para>
</listitem>
<listitem>
<para>
To set channel (or private) charset, use same commands as server,
but on channel (or private) buffer.
</para>
</listitem>
</itemizedlist>
</section>
<section id="secCharsetFAQ">
<title>FAQ</title>
<para>
If you have problems with chars or accents using Charset plugin:
<itemizedlist>
<listitem>
<para>
check that weechat-curses is linked to libncursesw (warning:
needed on most distributions but not all) :
<screen>ldd /path/to/weechat-curses</screen>
</para>
</listitem>
<listitem>
<para>
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.
</para>
</listitem>
<listitem>
<para>
setup global decode value, for example:
<screen>/setp charset.global.decode = ISO-8859-15</screen>
</para>
</listitem>
</itemizedlist>
</para>
</section>
</section>
<section id="secFIFOpipe">
<title> Remote-Schnittstelle (FIFO pipe) </title>
+108
View File
@@ -1111,6 +1111,114 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
</section>
<section id="secCharset">
<title>Charset plugin</title>
<para>
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.
</para>
<para>
Charset plugin should be autoloaded by WeeChat at startup.
To be sure plugin is loaded, try:
"<literal>/charset</literal>".
If command is not found, then load plugin with command:
<screen>/plugin load charset</screen>
If plugin is not found, then you should compile again WeeChat with
plugins and Charset support.
</para>
<para>
When Charset plugin starts, it displays terminal and internal charsets.
Terminal charset depends on your locale, and internal is UTF-8.
For example :
<screen>
-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8)
</screen>
</para>
<section id="secCharsetSettings">
<title>Settings</title>
<itemizedlist>
<listitem>
<para>
To set global decode and encode charsets, use
"<literal>/setp</literal>" command.
For example:
<screen>
/setp charset.global.decode = ISO-8859-15
/setp charset.global.encode = ISO-8859-15
</screen>
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
"<literal>ISO-8859-1</literal>".
Default encode value is empty, so it sends by default with
internal charset (UTF-8).
</para>
</listitem>
<listitem>
<para>
To set server charset, use "<literal>/charset</literal>" command
on server buffer.
If you give only charset, then it will set "decode" and "encode"
values.
For example:
<screen>/charset ISO-8859-15</screen>
It's equivalent to:
<screen>
/charset decode ISO-8859-15
/charset encode ISO-8859-15
</screen>
</para>
</listitem>
<listitem>
<para>
To set channel (or private) charset, use same commands as server,
but on channel (or private) buffer.
</para>
</listitem>
</itemizedlist>
</section>
<section id="secCharsetFAQ">
<title>FAQ</title>
<para>
If you have problems with chars or accents using Charset plugin:
<itemizedlist>
<listitem>
<para>
check that weechat-curses is linked to libncursesw (warning:
needed on most distributions but not all) :
<screen>ldd /path/to/weechat-curses</screen>
</para>
</listitem>
<listitem>
<para>
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.
</para>
</listitem>
<listitem>
<para>
setup global decode value, for example:
<screen>/setp charset.global.decode = ISO-8859-15</screen>
</para>
</listitem>
</itemizedlist>
</para>
</section>
</section>
<section id="secFIFOpipe">
<title>FIFO pipe</title>
+118
View File
@@ -1124,6 +1124,124 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
</para>
</section>
<section id="secCharset">
<title>Extension Charset</title>
<para>
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.
</para>
<para>
L'extension Charset devrait être automatiquement chargée par WeeChat
au démarrage.
Pour s'assurer que l'extension est bien chargée, essayez :
"<literal>/charset</literal>".
Si la commande n'est pas trouvée, alors chargez l'extension avec la
commande :
<screen>/plugin load charset</screen>
Si l'extension n'est pas trouvée, alors vous devriez recompiler
WeeChat avec les extensions et le support de Charset.
</para>
<para>
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 :
<screen>
-P- Charset plugin starting, terminal charset: ISO-8859-15 (WeeChat internal: UTF-8)
</screen>
</para>
<section id="secCharsetSettings">
<title>Configuration</title>
<itemizedlist>
<listitem>
<para>
Pour modifier les jeux de caractères de décodage et d'encodage
globaux, utilisez la commande "<literal>/setp</literal>".
Par exemple :
<screen>
/setp charset.global.decode = ISO-8859-15
/setp charset.global.encode = ISO-8859-15
</screen>
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 à
"<literal>ISO-8859-1</literal>".
La valeur d'encodage par défaut est vide, donc WeeChat envoie par
défaut avec le jeu de caractères interne (UTF-8).
</para>
</listitem>
<listitem>
<para>
Pour modifier le jeu de caractères d'un serveur, utilisez la
commande "<literal>/charset</literal>" 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 :
<screen>/charset ISO-8859-15</screen>
Ce qui est équivalent à :
<screen>
/charset decode ISO-8859-15
/charset encode ISO-8859-15
</screen>
</para>
</listitem>
<listitem>
<para>
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é).
</para>
</listitem>
</itemizedlist>
</section>
<section id="secCharsetFAQ">
<title>FAQ</title>
<para>
Si vous avez des problèmes avec certains caractères ou les accents en
utilisant l'extension Charset :
<itemizedlist>
<listitem>
<para>
vérifiez que weechat-curses est lié avec libncursesw
(attention : nécessaire sur beaucoup de distributions, mais pas
toutes) :
<screen>ldd /chemin/vers/weechat-curses</screen>
</para>
</listitem>
<listitem>
<para>
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.
</para>
</listitem>
<listitem>
<para>
affectez la valeur pour le décodage global, par exemple :
<screen>/setp charset.global.decode = ISO-8859-15</screen>
</para>
</listitem>
</itemizedlist>
</para>
</section>
</section>
<section id="secTubeFIFO">
<title>Tube FIFO</title>