Add russian quickstart guide

6 files changed, 311 insertions, 1 deletions

diff --git a/configure.in b/configure.in
index 27c576bf9..747dd8ac8 100644
--- a/configure.in
+++ b/configure.in
@@ -944,6 +944,7 @@ AC_OUTPUT([Makefile
            doc/fr/Makefile
            doc/pl/Makefile
            doc/de/Makefile
+           doc/ru/Makefile
            src/Makefile
            src/core/Makefile
            src/plugins/Makefile
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
index cb16d211d..04d8ed14d 100644
--- a/doc/CMakeLists.txt
+++ b/doc/CMakeLists.txt
@@ -23,6 +23,7 @@ IF(NOT DISABLE_DOC)
     ADD_SUBDIRECTORY( fr )
     ADD_SUBDIRECTORY( pl )
     ADD_SUBDIRECTORY( de )
+    ADD_SUBDIRECTORY( ru )
   ENDIF(ASCIIDOC_FOUND AND SOURCEHIGHLIGHT_FOUND)
 
 ENDIF(NOT DISABLE_DOC)
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 9a5a51208..a06a9939b 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -14,7 +14,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 #
 
-SUBDIRS = . en fr pl de
+SUBDIRS = . en fr pl de ru
 
 man_MANS = weechat-curses.1
 
diff --git a/doc/ru/CMakeLists.txt b/doc/ru/CMakeLists.txt
new file mode 100644
index 000000000..6013b0a46
--- /dev/null
+++ b/doc/ru/CMakeLists.txt
@@ -0,0 +1,26 @@
+# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+# quickstart
+ADD_CUSTOM_COMMAND(
+  OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ru.html
+  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='таблица содержания' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ru.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.ru.txt
+  DEPENDS
+  ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.ru.txt
+  COMMENT "Building weechat_quickstart.ru.html"
+)
+ADD_CUSTOM_TARGET(doc-quickstart-ru ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ru.html)
+INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ru.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME})
diff --git a/doc/ru/Makefile.am b/doc/ru/Makefile.am
new file mode 100644
index 000000000..c547af075
--- /dev/null
+++ b/doc/ru/Makefile.am
@@ -0,0 +1,37 @@
+# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+docdir = $(datadir)/doc/$(PACKAGE)
+
+EXTRA_DIST = CMakeLists.txt \
+		weechat_quickstart.ru.txt
+
+all-local: weechat_quickstart.ru.html
+
+# quickstart
+weechat_quickstart.ru.html: weechat_quickstart.ru.txt
+	$(ASCIIDOC) -a toc -a toc_title='таблица содержания' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.ru.html weechat_quickstart.ru.txt
+
+# install docs
+
+install-data-hook:
+	$(mkinstalldirs) $(DESTDIR)$(docdir)/
+	$(INSTALL_DATA) *.html $(DESTDIR)$(docdir)/
+
+# clean
+
+clean-local:
+	-rm -f *.html
diff --git a/doc/ru/weechat_quickstart.ru.txt b/doc/ru/weechat_quickstart.ru.txt
new file mode 100644
index 000000000..72be12a42
--- /dev/null
+++ b/doc/ru/weechat_quickstart.ru.txt
@@ -0,0 +1,245 @@
+WeeChat Quick Start Guide
+=========================
+FlashCode <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.org/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 "mynick1,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
+
+Для выполнения команды после подключения, на пример для идентификации
+с помошью NickServ:
+
+  /set irc.server.oftc.command "/msg nickserv identify xxxxxx"
+
+На заметку: команды могут быть разделены используя ';' (двоеточия)
+
+Для автовхода на каналы при подключении используйте:
+
+  /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 [quit message]`::
+    закрыть буфер сервера, или канала (`/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 плагинов или скиптов)
+
+Некоторые плагины, позволяют использовать скрипты на других языках
+(Perl, Python, Lua, Ruby, Tcl). Эти плагины должны быть загружены командой
+`/plugin`. Они добавляют такие команды как `/perl` для загрузки скриптов.
+
+Много пользовательских скриптов/плагинов доступно для 
+WeeChat: http://www.weechat.org/plugins
+
+Простейший путь для установки скриптов - исползовать скрипт 'weeget.py':
+
+. скачайте и скопируйте 'weeget.py' в ~/.weechat/python/autoload/
+. подгрузить скрипт в Weechat: `/python autoload`
+. скачайте список скриптов: `/weeget list` (for help: `/help weeget`)
+
+
+[[more_doc]]
+Больше документации
+-------------------
+
+Для остальных вопросов вы можете прочитать FAQ или документацию:
+http://www.weechat.org/doc
+
+Приятного использования WeeChat!