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


[[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.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`::
    закрыть буфер сервера, или канала (`/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 плагинов или скиптов)

Много пользовательских плагинов доступно для WeeChat:
http://www.weechat.org/scripts

// TRANSLATION MISSING
You can manage scripts in WeeChat with command `/script` (see `/help script`
for more info).


[[more_doc]]
Больше документации
-------------------

Для остальных вопросов вы можете прочитать FAQ или документацию:
http://www.weechat.org/doc

Приятного использования WeeChat!
