diff options
| -rw-r--r-- | configure.in | 1 | ||||
| -rw-r--r-- | doc/CMakeLists.txt | 1 | ||||
| -rw-r--r-- | doc/Makefile.am | 2 | ||||
| -rw-r--r-- | doc/ru/CMakeLists.txt | 26 | ||||
| -rw-r--r-- | doc/ru/Makefile.am | 37 | ||||
| -rw-r--r-- | doc/ru/weechat_quickstart.ru.txt | 245 |
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! |