diff options
Diffstat (limited to 'doc/en')
| -rw-r--r-- | doc/en/weechat.en.xml | 108 |
1 files changed, 108 insertions, 0 deletions
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 </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> |