WeeChat Quick Start Guide
=========================
Sébastien Helleu <flashcode@flashtux.org>


[[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!
