WeeChat Quick Start Guide ========================= Sébastien Helleu [[start]] Запуск WeeChat -------------- Рекомендованый эмулятор терминала для X сессии это rxvt-unicode. (в нем хорошая поддержка UTF-8, и отсутствуют проблемы с хоткеями). // TRANSLATION MISSING Run from your shell: ---------------------------------------- $ weechat ---------------------------------------- [[help_options]] помощь \ настройки ------------------ В 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`. [[core_vs_plugins]] Ядро vs плагины --------------- Ядро WeeChat используется только для вывода информации на экран пользователя. Это значит что само по себе ядро, без плагинов, бесполезно (преданные пользователи: IRC был частью ядра в версиях до ≤ 0.2.6). Все протоколы, такие как IRC, работают как раздельные плагины. Используйте команду `/plugin` что бы увидеть все загруженные плагины, среди них будет IRC, и остальные плагины. [[create_irc_server]] Добавление IRC сервера ---------------------- Вы можете добавить сервер используя команду `/server`, на пример: ---------------------------------------- /server add oftc irc.oftc.net/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 "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 ---------------------------------------- // TRANSLATION MISSING 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" ---------------------------------------- // TRANSLATION MISSING 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" ---------------------------------------- [NOTE] команды могут быть разделены используя ';' (двоеточия). Для автовхода на каналы при подключении используйте: ---------------------------------------- /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` это алиас `/buffer close`): ---------------------------------------- /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 плагинов или скиптов) Много пользовательских плагинов доступно для WeeChat: http://weechat.org/scripts // TRANSLATION MISSING You can manage scripts in WeeChat with command `/script` (see `/help script` for more info). [[more_doc]] Больше документации ------------------- Для остальных вопросов вы можете прочитать FAQ или документацию: http://weechat.org/doc Приятного использования WeeChat!