Add russian quickstart guide
Sebastien Helleu
parent
bfb9ab6a2a
commit
a5a6066535
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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})
|
||||
|
|
@ -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
|
||||
|
|
@ -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!
|
||||
Loading…
Reference in New Issue