Краткое введение в WeeChat

В качестве эмулятора терминала для X рекомендуется rxvt-unicode: в нём хорошая поддержка UTF-8 и нет проблем с сочетаниями клавиш.

Запуск из шелла:

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

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

Help is available for options as well:

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

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

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

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

The plugin fset allows you to easily browse options and change them.

For example to display WeeChat options:

IRC options:

The /fset command has completion on part of option names, so for example if you type /fset hot and press Tab this is completed as /fset hotlist. If you press Enter, options about the hotlist are displayed.

For more information about /fset command and keys, see /help fset.

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

Все сетевые протоколы вроде IRC представлены отдельными плагинами.

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

Вы можете добавить IRC сервер с помощью команды /server, например:

In this command, freenode is the internal server name used by WeeChat: you’ll be able to connect with /connect freenode and the server options are irc.server.freenode.xxx.

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

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

Для каждого параметра в группе server WeeChat использует установленное значение, если оно определено (не "null"). В противном случае используется значение по умолчанию ("irc.server_default.xxx").

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

Так можно установить псевдоним и настоящее имя:

Включить автосоединение с сервером при старте программы:

Присоединиться с использованием SSL:

Если сервер предоставляет SASL, то можно использовать его для аутентификации (вы будете идентифицированы до того, как присоединиться к каналам):

Для запуска команды после соединения с сервером, к примеру, аутентификации через nickserv (нужно только если не используется аутентификация SASL):

Если вы хотите защитить ваш пароль в конфигурационном файле, вы можете воспользоваться функцией защиты данных

Для начала, создайте ключевую фразу:

Затем добавьте защищенные данные с помощью вашего freenode пароля:

Вы также можете использоавть ${sec.data.freenode_password} вместо вашего пароля в опциях IRC, например:

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

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

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

With this command, WeeChat connects to the freenode server and auto-joins the channels configured in the "autojoin" server option.

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

Автоматическое совмещение буферов сервера можно отключить, чтобы работать с ними независимо:

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

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

Закрыть соединение с сервером, каналом или частным буфером (/close - псевдоним для /buffer close):

Отключиться от сервера, на серверном буфере:

Открыть буфер и отправить сообщение другому пользователю (с псевдонимом foo):

Закрыть буфер персонального разговора:

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

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

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

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

Отменить разделение экрана:

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

Вы можете переназначить любые сочетания в соответствии со своей клавиатурой и предпочтениями с помощью команды /key. Для получения кодов клавиш полезно использовать сочетание Alt+k.

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

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

Удалить сочетание клавиш:

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

Множество внешних скриптов (написанных контрибьюторами) доступно для WeeChat, вы можете скачать и установить скрипты из репозитория с помощью команды /script, например:

Для получения дополнительной информации введите команду /help script.

Список скриптов, доступных в WeeChat, можно просмотреть, введя команду /script, или на сайте: https://weechat.org/scripts

Теперь вы можете пользоваться WeeChat и консультироваться с FAQ/documentation по возникающим вопросам: https://weechat.org/doc

Приятной работы с WeeChat!