--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ru/index.mdwn	Sun May 14 20:58:00 2017 +0300
@@ -0,0 +1,199 @@
+
+<!-- FIXME: this page contains some multimarkdown definition lists quirks with blocks -->
+[MCabber][home] - это консольный Jabber-клиент, созданный под лицензией GNU GPL.
+
+[[!toc]]
+
+# Особенности
+
+* mcabber - это текстовый Jabber-клиенкт включающий в себя такие функции как:
+  поддержка **SSL**, **история переписки** (конференции), **автодополнение**
+  команд и возможность создания **собственных команд** (триггеров).
+* mcabber работает на следующих платформах: **GNU/Linux**, **FreeBSD**,
+  **NetBSD**, **Mac OS X** и **Cygwin**.
+* Следующие Jabber-спецификации поддерживаются (в последней версии):
+
+  - [[!xep 0012]] - просмотр последних действий Last Activity
+  - [[!xep 0022]] - события на сообщения Message Events
+  - [[!xep 0027]] - поддержка OpenPGP Current Jabber OpenPGP Usage
+  - [[!xep 0030]] - обзор служб (частично) Service Discovery (partial)
+  - [[!xep 0045]] - конференции Multi-User Chat
+  - [[!xep 0048]] - хранение закладок Bookmark Storage
+  - [[!xep 0049]] - приватное хранение XML Private XML Storage
+  - [[!xep 0054]] - работа с VCard (только получение) vcard-temp (retrieval only)
+  - [[!xep 0085]] - уведомление о статусе Chat State Notifications
+  - [[!xep 0086]] - Error Condition Mappings
+  - [[!xep 0090]] - Entity Time
+  - [[!xep 0091]] - отложенная доставка Delayed Delivery
+  - [[!xep 0092]] - версия программного обеспечения Software Version
+  - [[!xep 0115]] - Entity Capabilities
+  - [[!xep 0145]] - аннотации Annotations
+  - [[!xep 0146]] - Remote Controlling Clients (partial)
+  - [[!xep 0184]] - Message Delivery Receipts
+  - [[!xep 0199]] - XMPP Ping (answering only)
+  - [[!xep 0202]] - Entity Time
+  - [[!xep 0203]] - Delayed Delivery
+  - [[!xep 0249]] - Direct MUC Invitations (partial)
+  - [[!xep 0280]] - Message Carbons
+
+# Вводная часть
+
+* Загрузка
+  
+  - Получите последнюю версию mcabber c [официального сайта][home]. Обычно это
+    сжатый bzip архив tar (например, "mcabber-0.9.1.tar.bz2").
+  - Распакуйте его:
+    
+            % tar xvjf mcabber-0.9.1.tar.bz2
+            % cd mcabber-0.9.1
+
+* Установка
+  
+  Примечание: если Вы не хотите устанавливать mcabber в системную папку,
+  используйте ключ `--prefix`.
+  
+        % ./configure
+        % make
+        % make install
+
+* Первый запуск
+  
+  Вы можете запустить mcabber без файла конфигурации, но тогда Вам придется
+  вводить данные настройки вручную. Самый простой способ это скопировать файл
+  конфигурации, распространяемый с исходным кодом программы:
+  
+        % mkdir ~/.mcabber
+        % chmod 0700 ~/.mcabber
+        % cp mcabberrc.example ~/.mcabber/mcabberrc
+  
+  Теперь отредактируйте файл конфигурации. Вы должны задать Ваши имя
+  пользователя и сервер. (Примечание: если Вы хотите использовать
+  SSL-шифрование, взгляните на опции `ssl` и `ssl_verify` в файле конфигурации).
+  
+  Теперь можно запускать mcabber!
+  
+  Рабочее окно mcabber(1) поделено на 4 области. **Список контактов**,
+  **псевдонимы пользователей** (слева). **Окно чата (конференции)** (справа).
+  **Строка ввода команд и сообщений** (внизу, под маленьким **окном журнала
+  событий**).
+  
+  Две строки с информацией о статусе обрамляют **окно журнала событий**. Нижняя
+  строка статуса - это "строка основного статуса" и отображает общий статус
+  mcabber'а. Другая строка (сверху окна журнала событий) это **статус чата
+  (конференции)** и отображает статус текущего пользователя.
+  
+  Чтобы увидеть окно чата (конференции), Вы должны войти в [[режим чата
+  (конференции)|Chat_Mode]]. Вы можете войти в режим _чата (конференции)_ нажав
+  "Enter" и покинуть этот режим нажав клавишу "ESC". Простая отправка сообщений
+  так же работает в _режиме чата (конференции)_.
+  
+  Используйте PageUp/PageDown для перемещения по списку контактов.
+
+* Прочитайте [Manpage][manpage-ru] (на русском) для получения дополнительной
+  информации и пример файла конфигурации, чтобы увидеть все возможные опции.
+  
+  Если mcabber поддерживает Ваш язык, Вы можете установить его, используя опцию
+  `lang` в файле конфигурации.
+
+# Разработка
+
+* Если у Вас есть вопросы или предложения, Вы можете присоединиться к конфереции
+  (MUC Jabber) MCabber по адресу:
+  [mcabber@conf.lilotux.net](xmpp:mcabber@conf.lilotux.net)
+
+  _Помощь всегда приветствуется, не стесняйтесь!_
+
+* Если Вы заинтересованы в развитии mcabber`а или хотите иметь последнюю
+  разрабатываемую или ее хак, взгляните на [репозитарий Mercurial][main_repo].
+
+# FAQ
+
+MCabber не хочет соединяться с сервером. Выдает ошибку: `jab_start: SSL negotiation failed: self signed certificate`.
+:   Используйте опцию `ssl_verify = 0` в файле конфигурации и выставьте
+    правильные опции сертификата.
+
+Как я могу подключиться к моему аккаунту на Google Talk?
+:   Должно работать со следующими опциями:
+    
+    set username = your.email@gmail.com
+    set server = talk.google.com
+    set ssl = 1
+    set ssl_verify = 0
+
+Я хочу назначить определенную клавишу на выполнение команды, как мне узнать ее код?
+:   Если код клавиши доступен, то он будет показан в окне истории, когда Вы
+    нажмете нужную клавишу.
+
+Как мне создать группу пользователей?
+:   Используйте команды `/move`, если указанной группы нет - она будет создана
+    автоматически.
+
+Как мне сделать прозрачный фон?
+:   Установите `color_background = default`.
+
+Могу ли я использовать PGP-шифрование?
+:   Смотрите страницу [[OpenPGP]].
+
+MCabber под NetBSD?
+:   Версия mcabber'а 0.9.1 включена в дерево pkgsrc под NetBSD, если же вы
+    хотите установить mcabber под NetBSD из исходников (c поддержкой
+    OpenPGP-шифрования) предварительно следует установить пакет gpgme-1.0.3nb3
+    и curses версии не старее чем ncursesw-5.6. Далее, в случае привязки к
+    OpenSSL, имеющемуся базовой системе, а не к gnutls, инсталляция происходит
+    следующим образом:
+    
+    $ export CFLAGS='-I/usr/pkg/include'
+    $ export LDFLAGS='-L/usr/pkg/lib'
+    $ ./configure --with-ssl --with-openssl=/usr/lib --with-gpgme-prefix=/usr/pkg --enable-gpgme
+    $ make
+    $ make install
+    
+(Инсталляция произойдёт в каталог `/usr/local`, но в случае надобности
+параметр `prefix`, отвечающий за выбор каталога, может быть изменён).  
+Примечание: справделиво для версии 0.9.1
+
+Как отключить идентифицирующую меня информацию в mcabber (показ названия и версии клиента, версии ОС и имени ресурса)?
+:   Чтобы убрать показ поля `Name` при запросе версии клиента нужно
+    перекомпилировать исходник, предварительно закомментировав в файле
+    `jab_iq.c` строки под нимером 1510 и 1511 (для версии 0.9.6):
+
+    //xmlnode_insert_cdata(xmlnode_insert_tag(myquery, "name"), PACKAGE_NAME, -1);
+    //xmlnode_insert_cdata(xmlnode_insert_tag(myquery, "version"), ver, -1);
+
+Затем, требуется прописать в конфигурационном файле:
+
+    set iq_version_hide_os = 1
+    set resource = myresource
+
+Следует заметить, что значение опции `resource` нельзя оставить пустым: в
+противном случае она будет равна `mcabber`.
+
+Как мне получить исходные коды mcabber используя Mercurial?
+:   Вы невнимательны! Я уже говорил, смотрите
+    [[исходные коды на Mercurial|Bulding_mcabber_from_Mercurial]].
+
+Уменя есть просьба\предложение!
+:   Прекрасно! Приходите и расскажите о нем в конференции mcabber!
+
+Я хочу помочь материально...
+:   Что, серьезно? Воспользуйтесь моей почтой или jid и свяжитесь со мной! ;-)
+
+# Советы
+
+Смотри раздел [[Tips_And_Tricks]], может и поможет что нибудь.
+
+# Links
+
+* [MCabber домашняя страница][home]
+* [MCabber домашняя страница на русском + manpage][home-ru]
+* [Jabber Software Foundation][jabberorg]
+* [[!wikipedia Jabber desc="Jabber в Wikipedia"]]
+
+[home]:       http://mcabber.com/
+[home-ru]:    http://linsovet.com/mcabber_mainpage_ru
+[manpage-ru]: http://zenwalk.info/index.php?itemid=18
+[main_repo]:  http://mcabber.com/hg/
+[otr]:        http://www.cyberpunks.ca/otr/
+[userguide]:  http://mcabber.com/files/mcabber_guide.pdf
+[jabberorg]:  http://www.jabber.org/
+