diff --git a/ChangeLog.asciidoc b/ChangeLog.asciidoc index 24cdbd733..1f8567574 100644 --- a/ChangeLog.asciidoc +++ b/ChangeLog.asciidoc @@ -18,6 +18,7 @@ https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes] === New features * core: add priority in plugins to initialize them in order +* doc: add Russian man page == Version 1.1 (2015-01-11) diff --git a/debian/weechat-curses.links b/debian/weechat-curses.links index 832e14bda..4d0e998c9 100644 --- a/debian/weechat-curses.links +++ b/debian/weechat-curses.links @@ -1,7 +1,8 @@ usr/bin/weechat usr/bin/weechat-curses usr/share/man/man1/weechat.1.gz usr/share/man/man1/weechat-curses.1.gz -usr/share/man/fr/man1/weechat.1.gz usr/share/man/fr/man1/weechat-curses.1.gz -usr/share/man/ja/man1/weechat.1.gz usr/share/man/ja/man1/weechat-curses.1.gz -usr/share/man/it/man1/weechat.1.gz usr/share/man/it/man1/weechat-curses.1.gz usr/share/man/de/man1/weechat.1.gz usr/share/man/de/man1/weechat-curses.1.gz +usr/share/man/fr/man1/weechat.1.gz usr/share/man/fr/man1/weechat-curses.1.gz +usr/share/man/it/man1/weechat.1.gz usr/share/man/it/man1/weechat-curses.1.gz +usr/share/man/ja/man1/weechat.1.gz usr/share/man/ja/man1/weechat-curses.1.gz usr/share/man/pl/man1/weechat.1.gz usr/share/man/pl/man1/weechat-curses.1.gz +usr/share/man/ru/man1/weechat.1.gz usr/share/man/ru/man1/weechat-curses.1.gz 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 . # +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 . + +// TRANSLATION MISSING +Translated by Alexander Turenko . + +== КОПИРАЙТ + +WeeChat написан Sébastien Helleu и другими участниками (полный список находится +в файле AUTHORS.asciidoc). + +Copyright (C) 2003-{sys:date "+%Y"} Sébastien Helleu + +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. + +Веб: + +== ПОДДЕРЖКА / СООБЩЕНИЯ ОБ ОШИБКАХ + +Получить помощь или сообщить об ошибке: 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 , 2006 * Алексей Бортник , 2009 -* Alexander Turenko Totktonada , 2014 +* Alexander Turenko , 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' можно записать несколько команд через ';' (точку с +запятой). Для автовхода на определённые каналы при подключении к серверу используйте: