summaryrefslogtreecommitdiff
path: root/doc/ru/weechat_quickstart.ru.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ru/weechat_quickstart.ru.adoc')
-rw-r--r--doc/ru/weechat_quickstart.ru.adoc386
1 files changed, 386 insertions, 0 deletions
diff --git a/doc/ru/weechat_quickstart.ru.adoc b/doc/ru/weechat_quickstart.ru.adoc
new file mode 100644
index 000000000..fa0cfb1f3
--- /dev/null
+++ b/doc/ru/weechat_quickstart.ru.adoc
@@ -0,0 +1,386 @@
+= Краткое введение в WeeChat
+:author: Sébastien Helleu
+:email: flashcode@flashtux.org
+:lang: ru
+:toc: left
+:sectnums:
+:docinfo1:
+
+
+Переводчики:
+
+* 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-плагин и другие.
+
+[[add_irc_server]]
+== Добавить IRC сервер
+
+Вы можете добавить IRC сервер с помощью команды `/server`, например:
+
+----
+/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_ можно записать несколько команд через `;` (точку с
+запятой).
+
+// TRANSLATION MISSING
+If you want to protect your password in configuration files, you can use
+secured data.
+
+// TRANSLATION MISSING
+First setup a passphrase:
+
+----
+/secure passphrase this is my secret passphrase
+----
+
+// TRANSLATION MISSING
+Then add a secured data with your freenode password:
+
+----
+/secure set freenode_password xxxxxxx
+----
+
+// TRANSLATION MISSING
+Then you can use `${sec.data.freenode_password}` instead of your password in
+IRC options mentioned above, for example:
+
+----
+/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
+----
+
+Для автовхода на определённые каналы при подключении к серверу используйте:
+
+----
+/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_-буфером и буферами сервера можно использовать kbd:[Ctrl+x].
+
+Автоматическое совмещение буферов сервера можно отключить, чтобы работать с
+ними независимо:
+
+----
+/set irc.look.server_buffer independent
+----
+
+[[join_part_irc_channels]]
+== Вход и выход с IRC-каналов
+
+Зайти на канал:
+
+----
+/join #channel
+----
+
+Покинуть канал (оставляет буфер открытым):
+
+----
+/part [quit message]
+----
+
+// TRANSLATION MISSING
+Close a server, channel or private buffer (`/close` is an alias for
+`/buffer close`):
+
+----
+/close
+----
+
+// TRANSLATION MISSING
+[WARNING]
+Closing the server buffer will close all channel/private buffers.
+
+// TRANSLATION MISSING
+Disconnect from server, on the server buffer:
+
+----
+/disconnect
+----
+
+[[irc_private_messages]]
+== Персональные IRC-сообщения
+
+Открыть буфер и отправить сообщение другому пользователю (с псевдонимом
+_foo_):
+
+----
+/query foo сообщение
+----
+
+Закрыть буфер персонального разговора:
+
+----
+/close
+----
+
+[[buffer_window]]
+== Управление буферами и окнами
+
+Буфер — это относящийся к плагину компонент с номером, категорией и именем.
+Буфер содержит данные, отображаемые на экране.
+
+Окно — это то, на чём отображается содержимое буфера. По умолчанию создаётся
+одно окно, отображающее один буфер. Если разделить экран, то можно
+одновременно видеть несколько окон с несколькими буферами.
+
+Команды для управления буферами и окнами:
+
+----
+/buffer
+/window
+----
+
+(Я не буду повторять, что вы можете получить помощь, набрав /help с
+соответствующим параметром.)
+
+
+Например, чтобы разделить экран по вертикали на малую (1/3 ширины) и большую
+(2/3) части, используйте команду:
+
+----
+/window splitv 33
+----
+
+[[key_bindings]]
+== Сочетания клавиш
+
+В WeeChat по умолчанию определено немало горячих клавиш. Все они
+задокументированны, но вам обязательно нужно знать несколько жизненно
+необходимых:
+
+- kbd:[Alt+←] / kbd:[Alt+→] или kbd:[F5] / kbd:[F6]: к следующему или предыдущему буферу
+- kbd:[F7] / kbd:[F8]: следующее или предыдущее окно (когда экран разделён)
+- kbd:[F9] / kbd:[F10]: прокрутка title bar
+- kbd:[F11] / kbd:[F12]: прокрутка списка псевдонимов
+- kbd:[Tab]: дополнить текст в строке ввода, как в шелле
+- kbd:[PgUp] / kbd:[PgDn]: прокрутка текста в текущем буфере
+- kbd:[Alt+a]: перейти к буферу с «активностью» (в hotlist’е)
+
+Вы можете переназначить любые сочетания в соответствии со своей клавиатурой и
+предпочтениями с помощью команды `/key`.
+Для получения кодов клавиш полезно использовать сочетание kbd:[Alt+k].
+
+Например, чтобы назначить на kbd:[Alt+!] команду `/buffer close`:
+
+----
+/key bind (press alt-k) (press alt-!) /buffer close
+----
+
+Команда будет выглядеть примерно так:
+
+----
+/key bind meta-! /buffer close
+----
+
+Удалить сочетание клавиш:
+
+----
+/key unbind meta-!
+----
+
+[[plugins_scripts]]
+== Плагины и скрипты
+
+В некоторых дистрибутивах, например в Debian, плагины доступны в виде
+отдельных пакетов (вроде weechat-plugins).
+Плагины загружаются автоматически, если найдены (можете посмотреть
+документацию о загрузке и выгрузке плагинов или скиптов).
+
+Множество внешних скриптов (написанных контрибьюторами) доступно для WeeChat,
+вы можете скачать и установить скрипты из репозитория с помощью команды `/script`,
+например:
+
+----
+/script install iset.pl
+----
+
+Для получения дополнительной информации введите команду `/help script`.
+
+Список скриптов, доступных в WeeChat, можно просмотреть, введя команду `/script`, или на сайте:
+https://weechat.org/scripts
+
+[[more_doc]]
+== Документация для дальнейшего чтения
+
+Теперь вы можете пользоваться WeeChat и консультироваться с FAQ/documentation
+по возникающим вопросам:
+https://weechat.org/doc
+
+Приятной работы с WeeChat!