doc: add Russian man page, update Russian quickstart

5 files changed, 191 insertions, 12 deletions

diff --git a/doc/ru/CMakeLists.txt b/doc/ru/CMakeLists.txt
index 61290b18b..08004977b 100644
--- a/doc/ru/CMakeLists.txt
+++ b/doc/ru/CMakeLists.txt
@@ -17,6 +17,23 @@
 # along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
 #
 
+if(ENABLE_MAN)
+  # man page
+  add_custom_command(
+    OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat.1
+    COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/weechat.1.ru.asciidoc .
+    COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/cmdline_options.ru.asciidoc .
+    COMMAND ${A2X_EXECUTABLE} ARGS -a revision='WeeChat ${VERSION}' -d manpage -f manpage -L weechat.1.ru.asciidoc
+    DEPENDS
+    ${CMAKE_CURRENT_SOURCE_DIR}/weechat.1.ru.asciidoc
+    ${CMAKE_CURRENT_SOURCE_DIR}/cmdline_options.ru.asciidoc
+    WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+    COMMENT "Building weechat.1 (ru)"
+  )
+  add_custom_target(doc-man-ru ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
+  install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/ru/man1)
+endif()
+
 if(ENABLE_DOC AND SOURCEHIGHLIGHT_FOUND)
 
   # quickstart
diff --git a/doc/ru/Makefile.am b/doc/ru/Makefile.am
index 737730a5f..a644cad3f 100644
--- a/doc/ru/Makefile.am
+++ b/doc/ru/Makefile.am
@@ -20,12 +20,14 @@
 docdir = $(datadir)/doc/$(PACKAGE)
 
 EXTRA_DIST = CMakeLists.txt \
+             weechat.1.ru.asciidoc \
+             cmdline_options.ru.asciidoc \
              weechat_quickstart.ru.asciidoc
 
 if MAN
-  man_targets =
-  man_install =
-  man_uninstall =
+  man_targets = weechat.1
+  man_install = install-man
+  man_uninstall = uninstall-man
 endif
 if DOC
   doc_targets = weechat_quickstart.ru.html
@@ -34,6 +36,15 @@ if DOC
 endif
 all-local: $(man_targets) $(doc_targets)
 
+# man page
+weechat.1: weechat.1.ru.asciidoc cmdline_options.ru.asciidoc
+	-mkdir tmp_man
+	cp -f $(abs_top_srcdir)/doc/ru/weechat.1.ru.asciidoc ./tmp_man/
+	cp -f $(abs_top_srcdir)/doc/ru/cmdline_options.ru.asciidoc ./tmp_man/
+	(cd tmp_man && $(A2X) -a revision="WeeChat $(VERSION)" -d manpage -f manpage -L weechat.1.ru.asciidoc)
+	mv -f tmp_man/weechat.1 .
+	rm -rf tmp_man
+
 # quickstart
 weechat_quickstart.ru.html: weechat_quickstart.ru.asciidoc $(abs_top_srcdir)/doc/asciidoc_toc2.css
 	$(ASCIIDOC) -b html5 -a revision="$(VERSION)" -a stylesheet=$(abs_top_srcdir)/doc/asciidoc_toc2.css -f $(abs_top_srcdir)/doc/asciidoc.conf -n -o weechat_quickstart.ru.html $(abs_top_srcdir)/doc/ru/weechat_quickstart.ru.asciidoc
@@ -65,4 +76,5 @@ uninstall-doc:
 # clean
 
 clean-local:
+	-rm -f weechat.1 weechat.1.ru.asciidoc cmdline_options.ru.asciidoc
 	-rm -f *.html
diff --git a/doc/ru/cmdline_options.ru.asciidoc b/doc/ru/cmdline_options.ru.asciidoc
new file mode 100644
index 000000000..e9aafbd75
--- /dev/null
+++ b/doc/ru/cmdline_options.ru.asciidoc
@@ -0,0 +1,37 @@
+*-a*, *--no-connect*::
+    Отключить автоподключение к серверу при старте WeeChat.
+
+*-c*, *--colors*::
+    Вывести в терминал умолчальные цвета.
+
+*-d*, *--dir* '<путь>'::
+    Установить <путь> как домашнюю директорию для WeeChat (используется для
+    конфигурационных файлов, логов, пользовательских плагинов и скриптов).
+    Значение по-умолчанию: '~/.weechat' (замечание: директория будет создана,
+    если WeeChat не найдет ее).
+
+*-h*, *--help*::
+    Вывести справку.
+
+*-l*, *--license*::
+    Вывести лицензию WeeChat.
+
+*-p*, *--no-plugin*::
+    Отключить автозагрузку плагинов.
+
+*-r*, *--run-command* '<команда>'::
+    Запустить команду (или команды) после загрузки WeeChat (несколько команд
+    можно записать через точку с запятой).
+
+*-s*, *--no-script*::
+    Отключить автозагрузку скриптов.
+
+*--upgrade*::
+    Обновить WeeChat с использованием сеансовых файлов, сгенерированных
+    командой `/upgrade -quit`.
+
+*-v*, *--version*::
+    Вывести версию WeeChat.
+
+*<плагин>:<параметр>*::
+    Задать параметр плагина.
diff --git a/doc/ru/weechat.1.ru.asciidoc b/doc/ru/weechat.1.ru.asciidoc
new file mode 100644
index 000000000..1aefbf27d
--- /dev/null
+++ b/doc/ru/weechat.1.ru.asciidoc
@@ -0,0 +1,115 @@
+= WEECHAT(1)
+:doctype: manpage
+:lang: ru
+
+== НАЗВАНИЕ
+
+weechat - расширяемый чат-клиент
+
+== ОБЗОР
+
+[verse]
+'weechat' [-a|--no-connect] [-d|--dir <путь>] [-p|--no-plugin] [-r|--run-command <команда>] [-s|--no-script] [--upgrade] [<плагин>:<параметр>...]
+'weechat' [-c|--colors]
+'weechat' [-h|--help]
+'weechat' [-l|--license]
+'weechat' [-v|--version]
+
+== ОПИСАНИЕ
+
+WeeChat — это быстрый, легкий и расширяемый чат-клиент.
+
+Он модульный (легковесное ядро с плагинами), мультипротокольный (IRC и Jabber),
+расширяемый с помощью C и скриптов на нескольких языках.
+
+== ПАРАМЕТРЫ
+
+include::cmdline_options.ru.asciidoc[]
+
+== ПАРАМЕТРЫ ПЛАГИНОВ
+
+Полное описание параметров плагинов доступно в документации по плагинам в 
+https://weechat.org/doc[Руководстве пользователя WeeChat].
+
+С помощью плагина irc можно присоединиться ко временному серверу, используя URL вроде:
+
+    irc[6][s]://[[nickname][:password]@]server[:port][/#channel1[,#channel2...]]
+
+Присоединиться к IRC-каналу поддержки пользователей WeeChat с псевдонимом "mynick":
+
+    irc://mynick@chat.freenode.net/#weechat
+
+IPv6-адрес можно заключить в квадратные скобки, чтобы указать порт. Например:
+
+    irc://mynick@[2001:db8:0:85a3::ac1f:8001]:6668/#test
+
+== ФАЙЛЫ
+
+$HOME/.weechat/weechat.conf::
+    главный файл конфигурации WeeChat
+
+$HOME/.weechat/plugins.conf::
+    файл конфигурации плагинов
+
+$HOME/.weechat/sec.conf::
+    файл конфигурации с защищаемыми данными
+
+$HOME/.weechat/alias.conf::
+    файл конфигурации для плагина 'alias'
+
+$HOME/.weechat/aspell.conf::
+    файл конфигурации для плагина 'aspell'
+
+$HOME/.weechat/charset.conf::
+    файл конфигурации для плагина 'charset'
+
+$HOME/.weechat/exec.conf::
+    файл конфигурации для плагина 'exec'
+
+$HOME/.weechat/irc.conf::
+    файл конфигурации для плагина 'irc'
+
+$HOME/.weechat/logger.conf::
+    файл конфигурации для плагина 'logger'
+
+$HOME/.weechat/relay.conf::
+    файл конфигурации для плагина 'relay'
+
+$HOME/.weechat/script.conf::
+    файл конфигурации для плагина 'script'
+
+$HOME/.weechat/trigger.conf::
+    файл конфигурации для плагина 'trigger'
+
+$HOME/.weechat/xfer.conf::
+    файл конфигурации для плагина 'xref'
+
+$HOME/.weechat/weechat.log::
+    лог-файл WeeChat
+
+== АВТОРЫ
+
+Эта man-страница написана Sébastien Helleu <flashcode@flashtux.org>.
+
+// TRANSLATION MISSING
+Translated by Alexander Turenko <totktonada.ru@gmail.com>.
+
+== КОПИРАЙТ
+
+WeeChat написан Sébastien Helleu и другими участниками (полный список находится
+в файле AUTHORS.asciidoc).
+
+Copyright (C) 2003-{sys:date "+%Y"} Sébastien Helleu <flashcode@flashtux.org>
+
+WeeChat 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.
+
+Подробную информацию можно найти в файле COPYING.
+
+Веб: <https://weechat.org/>
+
+== ПОДДЕРЖКА / СООБЩЕНИЯ ОБ ОШИБКАХ
+
+Получить помощь или сообщить об ошибке: <https://weechat.org/dev/support>
diff --git a/doc/ru/weechat_quickstart.ru.asciidoc b/doc/ru/weechat_quickstart.ru.asciidoc
index e25271cb4..fa51d2056 100644
--- a/doc/ru/weechat_quickstart.ru.asciidoc
+++ b/doc/ru/weechat_quickstart.ru.asciidoc
@@ -6,12 +6,11 @@
 :max-width: 100%
 
 
-// TRANSLATION MISSING
-Translators:
+Переводчики:
 
 * Stalwart <stlwrt@gmail.com>, 2006
 * Алексей Бортник <thebosha@gmail.com>, 2009
-* Alexander Turenko Totktonada <totktonada.ru@gmail.com>, 2014
+* Alexander Turenko <totktonada.ru@gmail.com>, 2014
 
 
 [[start]]
@@ -27,7 +26,7 @@ $ weechat
 ----
 
 [[help_options]]
-== помощь и параметры
+== Помощь и параметры
 
 В WeeChat есть справка по всем командам, просто наберите:
 
@@ -141,14 +140,13 @@ WeeChat немедленно применяет все изменения (ва�
 /set irc.server.freenode.realname "My real name"
 ----
 
-Чтобы включить автосоединение с сервером при старте программы:
+Включить автосоединение с сервером при старте программы:
 
 ----
 /set irc.server.freenode.autoconnect on
 ----
 
-// TRANSLATION MISSING
-To connect with SSL:
+Присоединиться с использованием SSL:
 
 ----
 /set irc.server.freenode.addresses "chat.freenode.net/7000"
@@ -170,9 +168,9 @@ To connect with SSL:
 /set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
 ----
 
-// TRANSLATION MISSING
 [NOTE]
-Many commands in option 'command' can be separated by ';' (semi-colon).
+В параметре 'command' можно записать несколько команд через ';' (точку с
+запятой).
 
 Для автовхода на определённые каналы при подключении к серверу используйте: