WeeChat Quick Start Guide ========================= Sébastien Helleu [[start]] Запуск WeeChat -------------- Рекомендованый эмулятор терминала для X сессии это rxvt-unicode. (в нем хорошая поддержка UTF-8, и отсутствуют проблемы с хоткеями). Наберите "weechat-curses" в терминале. [[help_options]] помощь \ настройки ------------------ В WeeChat есть справка по командам, просто наберите /help Что бы получить справку по определенной команде, наберите `/help команда` Для задания настроек используйте `/set config.section.option value` (где `config` имя конфигурации (`weechat` или имя плагина для настройки), `section` группа в которой настройка и `option` как название настройки) WeeChat немедлено применяет все изменения(вам *никогда* не нужно перезапускать WeeChat после изменений в настройках) С командой `/set` вы можете использовать регулярные выражения заменяя символом "*" опции в начале или в конце строчки. На пример: `/set`:: Показать все опции (WeeChat, и плагинов) `/set weechat.*`:: Показать опции WeeChat `/set irc.*`:: Показать опции IRC плагина Вы можете получить справку по любой опции используя `/help`, на пример `/help weechat.look.highlight`. Все настройки WeeChat сохраняются при выходе (или используя команду `/save` для немедленного сохранения) Вы можете редактировать файлы кофигурации (*.conf) в ручную, и применять параметры с помощью команды `/reload`, в случае, если вас не устраивает `/set`. [[core_vs_plugins]] Ядро vs плагины --------------- Ядро WeeChat используется только для вывода информации на экран пользователя. Это значит что само по себе ядро, без плагинов, бесполезно (преданные пользователи: IRC был частью ядра в версиях до < = 0.2.6). Все протоколы, такие как IRC, работают как раздельные плагины. Используйте команду `/plugin` что бы увидеть все загруженные плагины, среди них будет IRC, и остальные плагины. [[create_irc_server]] Добавление IRC сервера ---------------------- Вы можете добавить сервер используя команду `/server`, на пример: /server add oftc irc.oftc.org/6667 Вы всегда можете обратиться к справке набрав: `/help server` [[irc_server_options]] Дополнительные опции сервера ---------------------------- WeeChat использует стандартные значения для всех серверов ("fall backs") если вы не установили их в ручную. Вы можете посмотреть эти значения набрав "irc.server_default.*". Если определено значение опции(не "null"), WeeChat будет использовать его. Иначе используется стандартное значение ("irc.server_default.xxx"). На пример: есть ники по умолчанию (базируются на логине un*x системы), и вы можете переназначить их для сервера oftc используя команду: /set irc.server.oftc.nicks "mynick1,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 Для выполнения команды после подключения, на пример для идентификации с помошью NickServ: /set irc.server.oftc.command "/msg nickserv identify xxxxxx" На заметку: команды могут быть разделены используя ';' (двоеточия) Для автовхода на каналы при подключении используйте: /set irc.server.oftc.autojoin "#channel1,#channel2" Что бы удалить значение опции, и использовать ее стандартное значение на пример для ников по умолчанию (irc.server_default.nicks): /set irc.server.oftc.nicks null Другие настройки вы можете изменить используя следующую команду (заменяя "xxx" соответствующей опцией) /set irc.server.oftc.xxx value [[connect_to_irc_server]] Подключение к серверу, и автовход на каналы ------------------------------------------- /connect oftc [NOTE] Эту команду можно использовать для подключения к серверу без его создания (должен ли я напомнить что вы можете посмотреть справку набрав `/help connect`?) По умолчанию, буфер сервера совмещен с буфером WeeChat. Для переключения между ними вы можете использовать Ctrl-X, Можно отключить это совмещение, что бы получить раздельные буферы серверов. /set irc.look.server_buffer independent [[join_part_irc_channels]] Подключение\разделение IRC каналов ---------------------------------- `/join #channel`:: зайти на канал `/part [quit message]`:: разделить канал(оставить буфер открытым) `/close [quit message]`:: закрыть буфер сервера, или канала (`/close` это алиас `/buffer close`) [[buffer_window]] Управление буферами\окнами -------------------------- Буфер это компонент привязанный к плагины номером, категорией и именем. Буфер содержит данные которые выводятся на экран. Окно выводит содержимое буфера. По умолчанию, создается одно окно с одним буфером. Если разделить окно, вы можете видеть много буферов одновременно. Команды для управления буферами и окнами: /buffer /window (Я не буду повторять что вы можете получить помощь набрав /help) На пример, что бы разделить окно на маленькое (1/3 ширины) и большое (2/3), используйте команду: /window splitv 33 [[key_bindings]] Комбинации клавиш ----------------- В 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 [[plugins_scripts]] Плагины/Скрипты --------------- В некоторых дистрибутивах, на пример в Debian. Плагины доступны как пакеты (на пример weechat-plugins) Плагины автоматические загружаются если они найдены (пожалуйста, посмотрите документацию о load/unload плагинов или скиптов) Некоторые плагины, позволяют использовать скрипты на других языках (Perl, Python, Lua, Ruby, Tcl). Эти плагины должны быть загружены командой `/plugin`. Они добавляют такие команды как `/perl` для загрузки скриптов. Много пользовательских скриптов/плагинов доступно для WeeChat: http://www.weechat.org/scripts Простейший путь для установки скриптов - исползовать скрипт 'weeget.py': . скачайте и скопируйте 'weeget.py' в ~/.weechat/python/autoload/ . подгрузить скрипт в Weechat: `/python autoload` . скачайте список скриптов: `/weeget list` (for help: `/help weeget`) [[more_doc]] Больше документации ------------------- Для остальных вопросов вы можете прочитать FAQ или документацию: http://www.weechat.org/doc Приятного использования WeeChat!