<!-- 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/