1. Запуск WeeChat

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

Run from your shell:

$ weechat-curses

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 + left/right arrows (or F5/F6): к следующему\предыдущему буферу

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

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

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

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

  • page up/down: прокрутка текста к буфере

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

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

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

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

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

/key bind meta-y /buffer close

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

/key unbind meta-y

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

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

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

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

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

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

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