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