= WeeChat Quick Start Guide
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: ru
:toc:


[[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. Для
переключения между ними вы можете использовать key[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 по умолчанию много горячих клавиш. Все из них задокументированы,
но необходимо знать жизненно важные:

- key[alt-]key[←]/key[→] или key[F5]/key[F6]: к следующему\предыдущему буферу
- key[F7]/key[F8]: следующее\предыдущее окно (когда окна разбиты)
- key[F9]/key[F10]: прокрутка темы
- key[F11]/key[F12]: прокрутка списка ников
- key[Tab]: завершить текст в строке ввода (как в командной оболочке)
- key[PgUp]/key[PgDn]: прокрутка текста к буфере
- key[alt-a]: перейти к буферу с "активностью"

Исходя из ваших нужд, и клавиатуры, вы можете переназначить любые клавиши
исползуя команду `/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)
Плагины автоматические загружаются если они найдены (пожалуйста,
посмотрите документацию о 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!
