weechat/doc/ru/weechat_quickstart.ru.asciidoc

352 lines
12 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

= Краткое введение в WeeChat
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: ru
:toc2:
:max-width: 100%
Переводчики:
* Stalwart <stlwrt@gmail.com>, 2006
* Алексей Бортник <thebosha@gmail.com>, 2009
* Alexander Turenko <totktonada.ru@gmail.com>, 2014-2015
[[start]]
== Запуск WeeChat
В качестве эмулятора терминала для X рекомендуется rxvt-unicode (в нём хорошая
поддержка UTF-8 и нет проблем с сочетаниями клавиш).
Запуск из шелла:
----
$ 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]]
== Ядро и плагины
«Ядро» WeeChat используется только для вывода информации на экран и
взаимодействия с пользователем, так что ядро без плагинов бесполезно.
(преданные пользователи: IRC был частью ядра в версиях ⩽ 0.2.6).
Все сетевые протоколы вроде IRC представлены отдельными плагинами.
Используйте команду `/plugin`, чтобы увидеть все загруженные плагины. В этом
списке должен быть IRC-плагин и другие.
// TRANSLATION MISSING
[[add_irc_server]]
== Add an IRC server
// TRANSLATION MISSING
You can add an IRC server with `/server` command, for example:
----
/server add freenode chat.freenode.net
----
Вы всегда можете обратиться к справке, набрав:
----
/help server
----
[[irc_server_options]]
== Установка дополнительных параметров для сервера
Для всех значений, которые не были установлены вручную, WeeChat использует
общие для всех серверов значения по умолчанию ("fall backs"). Посмотреть эти
значения можно, набрав "irc.server_default.*".
Для каждого параметра в группе 'server' WeeChat использует установленное
значение, если оно определено (не "null"). В противном случае используется
значение по умолчанию ("irc.server_default.xxx").
Например, есть список псевдонимов по умолчанию (основан на un*x-логине
пользователя), и перекрыть его для сервера freenode можно следующей командой:
----
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
----
Так можно установить псевдоним и настоящее имя:
----
/set irc.server.freenode.username "My user name"
/set irc.server.freenode.realname "My real name"
----
Включить автосоединение с сервером при старте программы:
----
/set irc.server.freenode.autoconnect on
----
Присоединиться с использованием SSL:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
----
Если сервер предоставляет SASL, то можно использовать его для аутентификации
(вы будете идентифицированы до того, как присоединиться к каналам):
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----
Для запуска команды после соединения с сервером, к примеру, аутентификации
через nickserv (нужно только если не используется аутентификация SASL):
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
В параметре 'command' можно записать несколько команд через ';' (точку с
запятой).
Для автовхода на определённые каналы при подключении к серверу используйте:
----
/set irc.server.freenode.autojoin "#channel1,#channel2"
----
Для очистки параметра из группы 'server' и установки значения по умолчанию
используется следующая конструкция, например, для возврата к псевдонимам по
умолчанию (irc.server_default.nicks):
----
/set irc.server.freenode.nicks null
----
Другие параметры можно установить, используя следующую команду ("xxx"
соответствует названию параметра):
----
/set irc.server.freenode.xxx value
----
[[connect_to_irc_server]]
== Подключение к IRC-серверу и автовход на каналы
----
/connect freenode
----
[NOTE]
Эту команду можно использовать для добавления нового сервера и подключения к
нему без команды `/server` (должен ли я напомнить, что вы можете посмотреть
справку, набрав `/help connect` ?).
По умолчанию буфер сервера совмещён с 'core'-буфером WeeChat. Для переключения
между 'core'-буфером и буферами сервера можно использовать key[ctrl-x].
Автоматическое совмещение буферов сервера можно отключить, чтобы работать с
ними независимо:
----
/set irc.look.server_buffer independent
----
[[join_part_irc_channels]]
== Вход и выход с IRC-каналов
Зайти на канал:
----
/join #channel
----
Покинуть канал (оставляет буфер открытым):
----
/part [quit message]
----
Закрыть буфер сервера или канала (`/close` — алиас для `/buffer close`):
----
/close
----
[[irc_private_messages]]
== Персональные IRC-сообщения
Открыть буфер и отправить сообщение другому пользователю (с псевдонимом
'foo'):
----
/query foo сообщение
----
Закрыть буфер персонального разговора:
----
/close
----
[[buffer_window]]
== Управление буферами и окнами
Буфер — это относящийся к плагину компонент с номером, категорией и именем.
Буфер содержит данные, отображаемые на экране.
Окно — это то, на чём отображается содержимое буфера. По умолчанию создаётся
одно окно, отображающее один буфер. Если разделить экран, то можно
одновременно видеть несколько окон с несколькими буферами.
Команды для управления буферами и окнами:
----
/buffer
/window
----
(Я не буду повторять, что вы можете получить помощь, набрав /help с
соответствующим параметром.)
Например, чтобы разделить экран по вертикали на малую (1/3 ширины) и большую
(2/3) части, используйте команду:
----
/window splitv 33
----
[[key_bindings]]
== Сочетания клавиш
В WeeChat по умолчанию определено немало горячих клавиш. Все они
задокументированны, но вам обязательно нужно знать несколько жизненно
необходимых:
- key[alt-]key[←]/key[→] или key[F5]/key[F6]: к следующему или предыдущему буферу
- key[F7]/key[F8]: следующее или предыдущее окно (когда экран разделён)
- key[F9]/key[F10]: прокрутка title bar
- key[F11]/key[F12]: прокрутка списка псевдонимов
- key[Tab]: дополнить текст в строке ввода, как в шелле
- key[PgUp]/key[PgDn]: прокрутка текста в текущем буфере
- key[alt-a]: перейти к буферу с «активностью» (в hotlistе)
Вы можете переназначить любые сочетания в соответствии со своей клавиатурой и
предпочтениями с помощью команды `/key`.
Для получения кодов клавиш полезно использовать сочетание key[alt-k].
Например, чтобы назначить на key[alt-y] команду `/buffer close`:
----
/key bind (press alt-k) (press alt-y) /buffer close
----
Команда будет выглядеть как-то так:
----
/key bind meta-y /buffer close
----
Удалить сочетание клавиш:
----
/key unbind meta-y
----
[[plugins_scripts]]
== Плагины и скрипты
В некоторых дистрибутивах, например, в Debian плагины доступны в виде
отдельных пакетов (вроде weechat-plugins).
Плагины загружаются автоматически, если найдены (можете посмотреть
документацию о загрузке и выгрузке плагинов или скиптов).
// TRANSLATION MISSING
Many external scripts (from contributors) are available for WeeChat, you can
download and install scripts from the repository with the `/script` command,
for example:
----
/script install iset.pl
----
// TRANSLATION MISSING
See `/help script` for more info.
// TRANSLATION MISSING
A list of scripts is available in WeeChat with `/script` or at this URL:
https://weechat.org/scripts
[[more_doc]]
== Документация для дальнейшего чтения
Теперь вы можете пользоваться WeeChat и консультироваться с FAQ/documentation
по возникающим вопросам:
https://weechat.org/doc
Приятной работы с WeeChat!