# WeeChat Quick Start Guide

Sébastien Helleu
`<flashcode@flashtux.org>`
version 0.4.3, 2014-02-10

## 1. Запуск WeeChat

Рекомендованый эмулятор терминала для X сессии это rxvt-unicode. (в нем хорошая поддержка UTF-8, и отсутствуют проблемы с хоткеями).

Run from your shell:

    $ weechat

## 2. помощь \ настройки

В WeeChat есть справка по командам, просто наберите:

    /help

Что бы получить справку по определенной команде, наберите:

    /help команда

Для задания настроек используйте:

    /set config.section.option value

(где `config` имя конфигурации (`weechat` или имя плагина для настройки), `section` группа в которой настройка и `option` как название настройки)

WeeChat немедлено применяет все изменения(вам никогда не нужно перезапускать WeeChat после изменений в настройках)

С командой `/set` вы можете использовать регулярные выражения заменяя символом "*" опции в начале или в конце строчки. На пример:

- Показать все опции (WeeChat, и плагинов):

    /set

- Показать опции WeeChat:

    /set weechat.*

- Показать опции IRC плагина:

    /set irc.*

Вы можете получить справку по любой опции используя `/help`, на пример:

    /help weechat.look.highlight

Все настройки WeeChat сохраняются при выходе (или используя команду `/save` для немедленного сохранения)

Вы можете редактировать файлы кофигурации (*.conf) в ручную, и применять параметры с помощью команды `/reload`, в случае, если вас не устраивает `/set`.

## 3. Ядро vs плагины

Ядро WeeChat используется только для вывода информации на экран пользователя. Это значит что само по себе ядро, без плагинов, бесполезно (преданные пользователи: IRC был частью ядра в версиях до ≤ 0.2.6).

Все протоколы, такие как IRC, работают как раздельные плагины.

Используйте команду `/plugin` что бы увидеть все загруженные плагины, среди них будет IRC, и остальные плагины.

## 4. Добавление IRC сервера

Вы можете добавить сервер используя команду `/server`, на пример:

    /server add oftc irc.oftc.net/6667

Вы всегда можете обратиться к справке набрав:

    /help server

## 5. Дополнительные опции сервера

WeeChat использует стандартные значения для всех серверов ("fall backs") если вы не установили их в ручную. Вы можете посмотреть эти значения набрав "irc.server_default.*".

Если определено значение опции(не "null"), WeeChat будет использовать его. Иначе используется стандартное значение ("irc.server_default.xxx").

На пример: есть ники по умолчанию (базируются на логине un*x системы), и вы можете переназначить их для сервера oftc используя команду:

    /set irc.server.oftc.nicks "mynick,mynick2,mynick3,mynick4,mynick5"

Что бы установить имя, и реальное Имя:

    /set irc.server.oftc.username "My user name"
    /set irc.server.oftc.realname "My real name"

Для соединения с сервером при старте программы:

    /set irc.server.oftc.autoconnect on

If SASL is available on server, you can use it for authentication (you will be identified before you join channels):

    /set irc.server_default.sasl_mechanism dh-blowfish
    /set irc.server.oftc.sasl_username "mynick"
    /set irc.server.oftc.sasl_password "xxxxxxx"

To run a command after connection to server, for example to authenticate with nickserv (only if you don’t use SASL for authentication):

    /set irc.server.oftc.command "/msg nickserv identify xxxxxxx"

Замечание | команды могут быть разделены используя ; (двоеточия).

Для автовхода на каналы при подключении используйте:

    /set irc.server.oftc.autojoin "#channel1,#channel2"

Что бы удалить значение опции, и использовать ее стандартное значение на пример для ников по умолчанию (irc.server_default.nicks):

    /set irc.server.oftc.nicks null

Другие настройки вы можете изменить используя следующую команду (заменяя "xxx" соответствующей опцией)

    /set irc.server.oftc.xxx value

## 6. Подключение к серверу, и автовход на каналы

    /connect oftc

Замечание | Эту команду можно использовать для подключения к серверу без его создания (должен ли я напомнить что вы можете посмотреть справку набрав `/help connect`?)

По умолчанию, буфер сервера совмещен с буфером WeeChat. Для переключения между ними вы можете использовать ctrl+x.

Можно отключить это совмещение, что бы получить раздельные буферы серверов.

    /set irc.look.server_buffer independent

## 7. Подключение\разделение IRC каналов

зайти на канал:

    /join #channel

разделить канал(оставить буфер открытым):

    /part [quit message]

закрыть буфер сервера, или канала (`/close` это алиас `/buffer close`):

    /close

## 8. Управление буферами\окнами

Буфер это компонент привязанный к плагины номером, категорией и именем. Буфер содержит данные которые выводятся на экран.

Окно выводит содержимое буфера. По умолчанию, создается одно окно с одним буфером. Если разделить окно, вы можете видеть много буферов одновременно.

Команды для управления буферами и окнами:

    /buffer
    /window

(Я не буду повторять что вы можете получить помощь набрав /help)

На пример, что бы разделить окно на маленькое (1/3 ширины) и большое (2/3), используйте команду:

    /window splitv 33

## 9. Комбинации клавиш

В WeeChat по умолчанию много горячих клавиш. Все из них задокументированы, но необходимо знать жизненно важные:

- alt+←/→ или F5/F6: к следующему\предыдущему буферу

- F7/F8: следующее\предыдущее окно (когда окна разбиты)

- F9/F10: прокрутка темы

- F11/F12: прокрутка списка ников

- Tab: завершить текст в строке ввода (как в командной оболочке)

- PgUp/PgDn: прокрутка текста к буфере

- alt+a: перейти к буферу с "активностью"

Исходя из ваших нужд, и клавиатуры, вы можете переназначить любые клавиши исползуя команду `/key`. Полезная комбинация для поиска клавшиных кодов alt+k

На пример, что бы назначить на alt+y команду `/buffer close`:

    /key bind (press alt-k) (press alt-y) /buffer close

Команда должна выглядеть так:

    /key bind meta-y /buffer close

Что бы удалить:

    /key unbind meta-y

## 10. Плагины/Скрипты

В некоторых дистрибутивах, на пример в Debian. Плагины доступны как пакеты (на пример weechat-plugins) Плагины автоматические загружаются если они найдены (пожалуйста, посмотрите документацию о load/unload плагинов или скиптов)

Много пользовательских плагинов доступно для WeeChat: http://weechat.org/scripts

You can manage scripts in WeeChat with command `/script` (see `/help script` for more info).

## 11. Больше документации

Для остальных вопросов вы можете прочитать FAQ или документацию: http://weechat.org/doc

Приятного использования WeeChat!