mcabber – маленький консольный Jabber-клиент.

РЕЗЮМЕ
~~~~~~
mcabber [ -f configfile ] [ --help | -h ]

ОПИСАНИЕ
~~~~~~~~
mcabber(1) маленький консольный Jabber-клиент.
Для того, чтобы приступить к работе, необходим файл конфигурации, поэтому скопируйте пример mcabberrc и отредактируйте его согласно вашей конфигурации.

Так же Вам будет необходим аккаунт на сервисе Jabber, т.к. в настоящий момент mcabber не умеет регистрировать (удалять) аккаунты.

Здесь приведены некоторые возможности mcabber:

* поддержка SSL.

* поддержка конференций MUC (Multi-User Chat).

* поддержка PGP.

* поддержка определения статуса в конференции (уведомление о наборе текста)

* Ведение истории переписки: если включено (смотрите раздел в файле конфигурации), mcabber сможет записывать историю переписки в файл.

* Автодополнение комманд: Если это возможно, mcabber пытается завершить вводимую Вами команду, если Вы нажмете клавишу Tab.

* История командной строки: Любое сообщение или команда, введенные в командной строке, сохраняются и могут быть вызваны вновь.

* Дополнительные возможности: Некоторые события (такие как пересылка сообщения) могут быть выполнены как внешняя команда (наподобии shell-скрипта), если конечно Вы включите эту опцию в файле конфигурации. Простейший скрипт события (“eventcmd”) поставляется вместе с исходным кодом mcabber, в каталоге contrib.

OPTIONS
~~~~~~~

–help, -h
Краткая справка

-f configfile
Использовать указанный файл конфигурации “configfile”

ОКНА\ПАНЕЛИ
~~~~~~~~~~~

Рабочее окно mcabber(1) поделено на 4 области. Список контактов, псевдонимы пользователей – находяться слева. Окно чата (конференции) находится справа. Строка ввода команд и сообщений – внизу, под маленьким окном журнала событий.

Две строки с информацией о статусе обрамляют окно журнала событий. Нижняя строка статуса – это “строка основного статуса” и отображает общий статус mcabber`а. Другая строка (сверху окна журнала событий) – это “статус чата (конференции)” и отображает статус текущего пользователя.

Чтобы увидеть окно чата (конференции), Вы должны войти в режим чата (конференции). Вы можете войти в режим чата (конференции) нажав “Enter” и покинуть этот режим нажав клавишу “ESC”. Простая отправка сообщений так же работает в режиме чата (конференции).

Есть несколько преймуществ в использовании двойного режима: первое, это позволяет правильно распределять непрочитанные сообщения, как появляющиеся в следующей области; без этого, только прокрутка к определенному пользователю позволит прочитать новые сообщения всех остальных пользователей. Второе, это позволяет легко скрывать диалог одним нажатием клавиши. В третьих, это позволяет перемещаться между несколькими пользователями, с которыми Вы беседуете, с помощью команды /roster описанной далее, не используя ручную прокрутку назад или вперед.

КОМБИНАЦИИ КЛАВИШ

Набор текста происходит в строке ввода (переводчик не виноват, так написано :)); простейшие операции так же поддерживаются (клавишы влево, вправо, home/end клавиши, insert, delete, backspace…).

Клавиши PageUp and PageDown использованы для перемещения в списке контактов.

Клавиши Вверх\Вниз могут быть использованы для перемещения по истории введенных команд и сообщений в командной строке; они перемещают к предыдущей\следующей строке в истории введенных команд и сообщений.

Чтобы отправить сообщение, переместитесь к нужному пользователю в списке контактов, напиши сообщение и нажмите “Enter”. Если строка начинается со слеша “/”, данная строка будет распознана как команда (смотрите раздел КОМАНДЫ). Нажмите “ESCAPE” для выхода из режима чата.

Здесь приведены быстрые комбинации клавиш, используемые в программе:

Esc             Отключает режим чата
Ctrl-a 		Перемещает к началу набранной строки
Ctrl-e 		Перемещает в конец набранной строки
Ctrl-l 		Принудительная очистка
Up/Down 	Перемещает в истории введенных команд\сообщений
PgUp/PgDown 	Перемещает внутри списка контактов
Tab 		Дополнить вводимое слово в командной строке
Ctrl-g 		Отмена сообщения
Ctrl-c 		Отменить многострочное сообщение\сообщение
Ctrl-d 		Отправить\прервать многострочное сообщение
Ctrl-p/Ctrl-n 	Прокрутить вверх\вниз половину экрана чата (конференции)
Ctrl-Left 	Переместить курсор к началу текущего или следующего слова word
Ctrl-Right 	Переместить курсор к концу текущего или следующего слова word
Ctrl-u 		Удалить текст с начала строки до позиции курсора
Ctrl-k 		Удалить текст с позиции курсора до конца строки
Ctrl-w 		Вернуть удаленное слово
Ctrl-t 		Переставить буквы
Ctrl-o 		Принять строку и поместить следующую строку из истории ввода командной строки в командную строку (accept-line-and-down-history)
Ctrl-q 		Переместиться к следующему непрочитанному сообщению

Дополнительные комбинации клавиш могут быть назначены с помощью команды /bind, описанной в разделе КОМАНДЫ

СПИСОК КОНТАКТОВ MCABBER`А
~~~~~~~~~~~~~~~~~~~~~~~~~~

Первый отображаемый элемент списка контактов это статус [status], который ведет историю всего, что появляется в окне событий, которое ниже основного окна чата (конференции). Окно истории было создано для отображения нескольких последних элементов отражающих статус [status], что делает удобнее просмотр истории событий, нежели прокрутка стандартным методом.

Имена групп отображаются над пользователями, которые в эту группу входят, и отемчаются символами “—” перед названием.

Для каждого реального Jabber-пользователя, списко контактов отображает 4 вида информации: имя или псевдоним пользователя, статус, статус авторизации и количество непрочтенных сообщений адресованных Вам.

Статус пользователя может принимать следующие значения:

o 	в сети
f 	свободен для чата
a 	ушел
n 	не доступен
d 	не беспокоить
i 	невидим (отображается только для вашего пользователя)
_ 	не в сети (или невидим для Вам)
? 	неизвестен, обычно означает, что Вы не авторизированы для просмотра статуса этого пользователя
x 	конференция в которой вы не участвуете
C 	конференция в которой вы участвуете

Статус авторизации показывает значение “авторизированы” ли Вы для получения статуса пользователя и отображается квадратными скобками вокруг статуса. Квадратный скобки, как [o], означают, что этот пользователь авторизирован для получения Вашего статуса. Волнистые скобки, как {o}, означают, что пользователь не авторизирован для получения Вашего статуса.Символ пропадает после того, как Вы просмотрите историю сообщений этого пользователя.

Примеры:

--- Buds 	Группы с название "Buds"
#[o] John 	John в сети, может видеть Ваш статус и послал Вам новое сообщение, которое Вы еще не прочли
{?} Sally 	Ни Вы ни Sally не авторизированы, чтобы видеть статус друг друга
{a} Jane 	Jane ушла, но она не может видеть Ваш статус
#[C] x@y.c 	Вы участник конференции x@y и там есть непрочитанные сообщения

КОМАНДЫ, ОТНОСЯЩИЕСЯ К MCABBER
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

/ALIAS [имя [= команды]]

Эта команда позволяет добавлять собственные альтернативные команды (обозначить ряд команд (одну команду) под определенным именем, для удобства использования).

Вы можете управлять альтернативными командами следующим образом:
/alias
 Выводит список уже определенных альтернативных команд
/alias name
 Выводит значение для альтернативной команды с именем "name"
/alias name=
 Удаляет альтернативную команду с именем "name"
/alias name = command line
 Определяет альтернативную команду с именем "name" и значением "command line"
Пример: "/alias away = status away", где "away" - название альтернативной команды (по которой она будет вызываться), "status away" - исполняемая команда, которая определит Ваш статус как "away" (т.е. при выполнении команды "away" - Ваш статус будет сменен на "away")

/BIND [keycode [= command line]]

Присваивает клавише (определяется по ее keycode) определенную команду. Чтобы проверить, какие клавишы в настоящее время не используются, перейдите в “log window” и нажмите клавишу, которую Вы хотите определить для команды. Пример: “Unknown key=265″ – это значит, что Вы можете присвоить клавише 265 (F1) свое значение и она не занята.
(от переводчика: многие windows manager`ы не очень охотно отдают keycode в терминале, поэтому проще проверять назначена или нет клавиша командой “/bind ‘keycode’”, если Вы получите в ответ “Key 265 is not bound.” – значит клавише не присвоена команда).

/bind
 Выводит список назначенных клавиш и команд.
/bind keycode
 Выводит команду, которая назначена на введенный keycode.
/bind keycode=
 Отменяет привязку использования команды с введенным keycode.
/bind keycode = command line
 Присваивает команду "command line" к клавише с определенным "keycode"
Пример: "/bind 265 = status away" (265 стандартно клавиша "F1").
Пояснение: коды клавиш (keycodes) могут отличаться от Ваших, в зависимости от настройки ncurses.
Полезно: альтернативные (назначенные) команды также могут использоваться вместо стандартных команд.

/BUFFER [clear|purge|top|bottom|date|%|search_backward|search_forward]
/BUFFER [scroll_lock|scroll_unlock|scroll_toggle]

Команда для управления буфером (от переводчика: историей переписки) с пользователеми jabber. То есть, Вы можете искать текст прямо в буфере (истории переписки), очищать окно чата и т.д.

/buffer clear
 Отчищает текущее окно чата
/buffer purge
 Очищает текущее окно чата и очищает все содержимое буфера (истории переписки)
/buffer bottom
 Перемещает к концу буфера (истории переписки) с текущим пользователем
/buffer top
 Перемещает к началу буфера (истории переписки) с текущим пользователем
/buffer up [n]
 Перемещает на [n] строк вверх в буфере (истории переписки) (по умолчанию: половина экрана)
/buffer down [n]
 Перемещает на [n] строк вниз в буфере (истории переписки) (по умолчанию: половина экрана)
/buffer date [date]
 Перемещает в первой строке после определенной даты [date] в буфере (истории переписки) (формат даты: "ГОД-месяц-день" "2006-01-01")
/buffer % n
 Перемещает на позицию %n в текущем буфере (истории переписки)
/buffer search_backward text
 Ищет введенное значение [text] в текущем буфере (истории переписки) (от переводчика: до текущей позиции)
/buffer search_forward text
 Ищет введенное значение [text] в текущем буфере (истории переписки) (от переводчика: после текущей позиции)
/buffer scroll_lock
 Блокирует скроллинг (прокрутку) буфера (истории переписки)
/buffer scroll_unlock
 Разблокирует скроллинг (прокрутку) буфера (истории переписки)
/buffer scroll_toggle
 Показывает настоящее значение скроллинга (прокрутки) (заблокировано/разблокировано)

/CLEAR

Эта команда просто альтернативное название (alias) для “/buffer clear”. Она очищает текущее окно переписки.

/HELP [command|+topic]

Выводит помощь для указанной команды “command” или темы “topic”

Пример: "/help buffer"  выводит помощь по команде "buffer"

/QUIT

Эта команда завершает все активные соединения и выходит из mcabber`а.

/VERSION

Отображает текущую версию mcabber`а.

КОМАНДЫ, ОТНОСЯЩИЕСЯ К СЕРВЕРУ И СОЕДИНЕНИЮ
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

/CONNECT

Устанавливает соединение с Jabber-сервером

/DISCONNECT

Завершает соединение с Jabber-сервером.

Примечание: список контактов доступен только когда соединение с сервером активно, поэтому список контактов пуст при завершении соединения.

/EVENT #N|* accept|ignore|reject
/EVENT list

Говорит mcabber`у что делать с событиями.
Если первый параметр ‘*’, команда будет применена ко всей очереди событий.

/event #N|* accept
 Событие номер #N/All будет разрешено
/event #N|* ignore
 Событие номер #N/All будет проигнорировано
/event #N|* reject
 Событие номер #N/All будет отклонено
/event list
 Показать список всех событий

/RAWXML send string

Отправляет строку “string” (в формате XML) на Jabber-сервер.
Проверка строки не выполняется.
БУДЬТЕ ОСТОРОЖНЫ!
Используйте эту команду только если Вы знаете, что делаете или если Вы можете завершить соединение.

Пример: "/rawxml send <presence><show>away</show></presence>"

КОМАНДЫ, ОТНОСЯЩИЕСЯ К СПИСКУ КОНТАКТОВ И ПОЛЬЗОВАТЕЛЯМ JABBER`А

/ADD [jid [nickname]]

Добавляет “jid” пользователя Jabber в Ваш списко контактов (группа по умолчанию) и отправляет уведомление о подтверждении данному пользователю. Если “jid” не указан (или сторока пуста “”) или “jid” указан как “.” – используется текущий пользователь (участник).

/add [jid [nickname]]
 Добавляет в список контактов "jid" с явным именем (nickname).
Пример: "/add somebody@jabber.server.com Somebody", где "somebody@jabber.server.com" - "jid" пользователя, "Somebody" - имя пользователя (nickname) к списке контактов.

/AUTHORIZATION allow|cancel|request|request_unsubscribe [jid]

Эта команда управляет уведомлениями о присутствии (статусе) пользователей: она позволяет Вам получать статус пользователей в Вашем списке контактов и позволяет Вам контролировать просмотр Вашего статуса другими пользователями.
Если jid пользователя не указан, используется jid текущего пользователя.

/authorization allow
 Позволяет пользователю jabber получать уведомления о Вашем статусе
/authorization cancel
 Отменяет уведомление пользователя jabber о Вашем статусе
/authorization request
 Посылает запрос пользователю jabber на получения уведомлений о его статусе
/authorization request_unsubscribe
 Посылает запрос пользователю jabber на отмену получения уведомлений о его статусе

/DEL

Удаляет текущего пользователя из списка контактов, отключает уведомления о его статусе и отключает уведомления пользователя о нашем статусе.

/GROUP fold|unfold|toggle

Эта команда управляет отображением списка пользователей определенной группы в списке контактов.

/group fold
 Сворачивает (закрывает) текущий развернутый список пользователей определенной группы в списке контактов
/group unfold
 Разворачивает (раскрывает) текущий свернутый список пользователей определенной группы в списке контактов
/group toggle
 Отображает текущее состояние (свернуто\развернуто) списка определенной группы в списке контактов

/INFO

Выводит информацию о выделенной элементе (пользователь, агент, группа…).
Для пользователей, ресурсов отображается статус, приоритет и сообщение статуса (если возможно) для каждого ресурса.

/MOVE [groupname]

Перемещает пользователя в определенную группу. Если группа не указана, пользователь перещается в группу по умолчанию (default group). Если группа “groupname” не создана, она автоматически создается.
Полезно: Если включен режим чата (chatmode), Вы можете использовать “/roster alternate” для перемещения к перемещенному пользователю.

/MSAY begin|verbatim|send|send_to|toggle|abort

Посылает сообщение, состоящие из большого количества строк. Чтобы написать сообщение из нескольких строк должен использоваться режим поддержки многострочного сообщения ‘multi-line mode’.
В режиме поддержки многостроных сообщений ‘multi-line mode’ каждая написанная строка (исключая командные строки) добавляется в тело многострочного сообщения. Когда многострочное сообщение написано, оно может быть отправлено текущему пользователю командой “/msay send”.
Команда ‘/msay begin’ включает режим многострочного сообщения. Обратите внимание, что может быть указана тема сообщения [subject].
Подкоманда ‘verbatim’ включает режим стенограммы. Только команда “/msay” (с параметром send или abort) может быть использована для выхода из режима стенограммы (соответственно, для пересылки или отмены сообщения).
Подкомандой ‘toggle’ можно назначить определенную клавишу для быстрого использования многострочного режима ‘multi-line mode’ (пример: “bind M13 = msay toggle” для переключения режима)

/msay begin [subject]
 Включить многострочный режим 'multi-line mode'
/msay verbatim
 Войти в режим стенограммы многострочного сообщения
/msay send
 Послать текущее многострочное сообщение текущему пользователю
/msay send_to jid
 Послать текущее многострочное сообщение определенному "jid"
/msay toggle
 Узнать режим многострочный сообщения 'multi-line mode'
/msay abort
 Выйти из режима многострочного сообщения не отправляя его

/PGP disable|enable|info [jid]
/PGP setkey [jid [key]]

Эта команда управляет настройками PGP для определенного пользователя “jid” (по умолчанию, для выделенного контакта).
Запомните, что шифрование PGP не может быть использовано, если не обнаружена удаленная поддержка PGP.

/pgp disable [jid]
 Отключает шифрование PGP для пользователя "jid" (или для выделенного контакта)
/pgp enable [jid]
 Включает шифрование PGP для пользователя "jid" (или для выделенного контакта)
/pgp info [jid]
 Показывает текущие настройки PGP для пользователя "jid"
/pgp setkey [jid [key]]
 Устанавливает PGP-ключ, который будет использоваться для шифрования сообщений для данного пользователя.
 Если PGP-ключа не имеется, то текущий ключ удаляется.
 Вы можете использовать сокращенный jid "." для текущего контакта (пользователя)

/RENAME name

Переименовывает текущего пользователя или группу в заданное имя “name”.

/REQUEST last|time|vcard|version [jid]

Отправляет “IQ” запрос текущему или указанному пользователю jabber. Если подобная функция не поддерживается указанным “jid”, mcabber пошлет запрос всем известным интерфейсам для данного пользователя.

/request last
 Запрашивает последнюю информацию (обычно: свободное время)
/request time
 Запрашивает время пользователя
/request vcard
 Запрашивает VCard пользователя
/request version
 Запрашивает пользовательскую версию

/ROOM join|leave|names|nick|remove|topic|unlock|destroy
/ROOM privmsg|invite|kick|ban|role|affil
/ROOM bookmark [add|del] [-autojoin|+autojoin]

Команда ‘room’ работает с конференциями (Multi-User Chat room).

/room join [room [nick [pass]]]
 Производит подключение к конференции, используя "nick" как имя пользователя. Если имя пользователя не задано (или если оставлено пустым), то испольщуется имя пользователя заданное в конфигурации mcabber`а (смотри файл конфигурации). Если текущая запись корректно распознана mcabber как конференция, сокращение "." может быть использовано вместо полного названия конференции. Пароль может быть предусмотрен для закрытых конференций. Если в Вашем имени пользователя (nickname) содержатся пробелы используйте кавычки "nick".
/room leave [message]
 Покинуть конференцию
/room names
 Показать участников текущей конференции
/room nick newnick
 Изменить имя пользователя в текущей конференции
/room privmsg nick msg
 Отправить личное сообщение "msg" пользователю "nick"
/room remove
 Удалить текущую конференцию из списка контактов (Вы должны вначале покинуть конференцию)
/room topic newtopic
 Посмотреть тему текущей конференции
/room unlock
 Разблокировать текущую конференцию (если Вы являетесь ее владельцем)
/room destroy [reason]
 Уничтожить текущую конференцию (пользовать осторожно!)
/room whois nick
 Показать информацию о пользователе "nick"
/room ban jid [reason]
 Наложить запрет (забанить) пользователя "jid" в текущей конференции
/room invite jid [reason]
 Пригоасить пользователя "jid" в текущую конференцию
/room kick nick [reason]
 Исключить пользователя "jid" из текущей конференции
/room role jid role [reason]
 Изменить статус  пользователя "jid" (статус может быть "none", "visitor", "participant", "moderator")
/room affil jid affil [reason]
 Принять пользователя "jid" в члены конференции (члены могут быть "none", "member", "admin", "owner")
/room bookmark [add|del] [-autojoin|+autojoin]
 Добавить, удалить или обновить закладку (по умолчанию: add - добавить)
 Если включена опция autojoin, mcabber автоматически подключается к конференции после соединения с Jabber-сервером.

/ROSTER bottom|top|up|down|group_prev|group_next
/ROSTER alternate|unread_first|unread_next
/ROSTER search bud
/ROSTER hide_offline|show_offline|toggle_offline
/ROSTER item_lock|item_unlock/ROSTER hide|show|toggle
/ROSTER note [-|text]

Команда ‘roster’ управляет Вашим списком контактов.

Могут использоваться следующие параметры:
/roster bottom
 Переместиться к концу списка контактов
/roster top
 Переместиться в начало списка контактов
/roster up
 Листать вверх список контактов
/roster down
 Листать вниз список контактов
/roster group_prev
 Переместиться в предыдущую группу пользователей в списке контактов
/roster group_next
 Переместиться в следующую группу пользователей в списке контактов
/roster alternate
 Переместиться на альтернативного пользователю. "Альтернативный пользователь" - это последний пользователь, с которым Вы вели переписку. Эта команда может быть использована после команд наподобии "/roster unread_next" (Ctrl-q).
/roster unread_first
 Переместиться в первому непрочитанному сообшению
/roster unread_next
 Переместиться в следующему непрочитанному сообшению
/roster search bud
 Найти пользователя чье имя или jid содержить значение "bud" (только в отображаемом списке контактов)
/roster hide_offline
 Скрыть недоступных пользователей
/roster show_offline
 Показать недоступных пользователей
/roster toggle_offline
 Показать значение параметра скрытия недоступных пользователей
/roster item_lock [jid]
 Закрепить пользователя из списка контактов и всегда отображать независимо от его статуса
/roster item_unlock [jid]
 Отменить функцию /roster item_lock
/roster hide
 Скрыть список контактов (окно чата на весь экран)
/roster show
 Показать список контактов
/roster toggle
 Изменить размер списка контактов
/roster note [-|text]
 Установить обновление\удаление комментариев
 Если текст не задан, отображается текущий комментарий -- если Вы находитесь в истории переписка, все заметки отображаются.
 Если текст задан как "-", заметка стирается.

/SAY text

Отправляет сообщение “text” текущему пользователю. Команда может быть полезна, если Вы хотите отправить сообщение начинающееся с флеша (/).

/SAY_TO jid text

Отправляет сообщение “text” определенному пользователю “jid”.
Запомните, что, если Вы хотите отправить несколько сообщение определенному пользователю, данная команда должна вводиться перед каждым сообщением.

/STATUS [online|avail|invisible|free|dnd|notavail|away [-|StatusMessage]]

Отображает или устанавливает текущий статус.
Если статус не задан – отображается текущий статус.
Если статус задан, он будет задан согласно списку переменных в файле конфигурации.
Если указанного статуса не найдено в списке переменных, устанавливается текущий статус.
Если “StatusMessage” задан как “-”, текущий статус очищается.

/STATUS_TO jid online|avail|invisible|free|dnd|notavail|away [StatusMessage]

Отправляет запрос на статус определенному пользователю.
Если “jid” указан как “.” используется текущий пользователь.
Замечание: статус будет изменен следующей командой “/status”. Если Вы пользуетесь функцией auto-away (автоматическая смена статуса), статус будет изменен также.
Замечание: “jid” может быть задан в виде записи user@server/resource

ФАЙЛ КОНФИГУРАЦИИ
~~~~~~~~~~~~~~~~~
Смотрите имеющийся пример файла конфигурации, он хорошо документирован.

ФАЙЛЫ
~~~~~
Следующие файлы используются mcabber`ом(1):

$HOME/.mcabber/mcabberrc Файл конфигурации по умолчанию
$HOME/.mcabberrc Файл конфигурации, используемые если не найдено ничего другого
$HOME/.mcabber/histo/ Каталог, в которой по умолчанию сохраняются файлы истории переписки (если ведение истории включено)

BUGS
~~~~
Обязательно. Сообщите мне, если найдете! :)

АВТОР
~~~~~

Программа написана Mikael BERTHE.
Первоначально основано на Cabber, обращайтесь к файлу AUTHOR для дополнительной информации.

Перевел L. Artyom [aka] dive.

RESOURCES
~~~~~~~~~
Главная страничка проекта

COPYING
~~~~~~~

Copyright (C) 2005, 2006 Mikael Berthe.
Some portions are Copyright (C) 2002-2004 cabber@ajmacias.com.

Free use of this software is granted under the terms of the GNU General Public License (GPL).

Version 0.9.1
Last updated 12-Feb-2007 11:19:42 CEST