Готовый перевод Mcabber Manual Page / Mcabber - страница руководства: Mcabber Manual Page

MCABBER - Руководство использования

НАЗВАНИЕ

mcabber - простой консольный Jabber клиент

СИНТАКСИС

mcabber [ -h | -V | -f configfile ]

ОПИСАНИЕ

mcabber - это небольшой консольный Jabber клиент.

Для начала Вам нужен файл конфигурации для запуска. Для этого скопируйте образец файла mcabberrc и сконфигурируйте настройки подключения.

У вас также должен быть существующий Jabber-аккаунт для использования данного приложения, так как mcabber пока не может регистрировать/удалять аккаунты.

Некоторые особенности mcabber'а:

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

— Поддержка MUC (многопользовательские конференции).

— поддержка PGP

— Состояния (уведомления о наборе)

— История сообщений: Если включено (см. Файл Конфигурации), то mcabber может сохранять разговоры в файл.

— Завершение команд: Если возможно, mcabber попытается закончить Вашу команду при нажатии клавиши "Tab".

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

— Внешние действия: Некоторые события (например, получение сообщений) могут вызвать внешние действия, такие как сценарий оболочки, если включить их в файле конфигурации. Образец сценария ("eventcmd") показан в исходном коде, в директории contrib.

ПАРАМЕТРЫ

--help, -h

Быстрая справка посредством сообщения

-f configfile

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

ОКНА

Окно mcabber'а разделено на 4 части. Ростер, он же контакт-лист, находится слева. Окно чатанаходится справа. Строка ввода находится внизу экрана, под небольшим окном истории.

Окно логов окружают две строки статусов. Нижняя строка - "главная", отображает основной статус mcabber. Другая - строка статуса в чате, показывает статус выбранного друга.

Чтобы отобразить буфер общения с собеседником, Вам необходимо войти в режим разговора. Вы можете войти в этот режим, нажав клавишу Enter, и выйти из него, нажав клавишу Esc. Просто отправка сообщения собеседнику также включит режим разговора.

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

КЛАВИШИ

Ввод текста осуществляется в строке ввода; поддерживаются основные операции (клавиша "Стрелка влево", клавиша "Стрелка вправо", клавиши Home/End, Insert, Del. Backspace...).

Клавиши PageUp и PageDown предназначаются для передвижения по ростеру.

Клавиши Up и Down могут быть использованы для перемещения в истории строки ввода, они позволяют перейти к предыдущей/следующей строке из истории, начиная с той же строки.

Для отправки сообщения переместите курсор на нужный контакт, наберите сообщение и нажмите Enter. Если строка начинается с "/", это будет воспринято как команда (см. раздел КОМАНДЫ). Нажмите Escape, чтобы покинуть режим чата.

Далее приводится краткий список горячих клавиш:

Esc - Отключить режим чата

Ctrl-a - Перейти к началу строки ввода

Ctrl-e - Перейти к концу строки ввода

Ctrl-l - принудительное обновление

Up/Down - Передвигаться по истории ввода

PgUp/PgDown - Передвигаться внутри ростера (контакт-листа)

Tab - Завершить слово в строке ввода

Ctrl-g - Отменить завершение

Ctrl-c - прекратить ввод многострокого сообщения

Ctrl-d - Отправить/завершить многострочное сообщение

Прокрутить вверх/вниз половину экрана в окне чата

Ctrl-Left - Переход к началу текущего или предыдущего слова

Ctrl-Right - Переход вперед к концу текущего или следующего слова

Ctrl-u - Удалить от начала строки до курсора

Ctrl-k - удалить от курсора и до конца строки

Ctrl-w - удалить предыдущее слово

Ctrl-t - Перестановка символов

Ctrl-o - отправить текущую строку и вставить следующую строку из истории в строку ввода.

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

РОСТЕР (контакт-лист)

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

Имена групп отображаются над контактами, которые включены в эту группу, и помечены --- слева от имени группы.

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

Текущий статус может быть одним из следующих:

o - в сети

f - готов общаться

a - отошел

n - недоступен (в некоторых клиентах отображается как "отошел надолго")

d - не беспокоить

i - невидимый (отображается только для вашего собственного ресурса)

_ - не в сети (или невидимый для Вас)

? - неизвестно, обычно означает, что Вы не авторизованны у этого контакта

x - конференция, в которой Вы не являетесь участником

C - конференция, в которой Вы являетесь участником

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

Когда есть непрочитанные сообщения от ресурса, которые вы ещё не смотрели, слева от данного ресурса в ростере появляется знак решётки (#). Этот знак пропадает сразу же после прочтения сообщений.

Примеры:

--- Buds - Группа с именем "Buds"

#[o] Вася - Вася в сети, может видеть Ваш статус и у Вас есть непрочитанное сообщение от него

{?} Салли - Ни Вы, ни Салли не авторизовали друг друга и не можете видеть ваши статусы

{a} Вася - Вася "отошел", но не может видеть Ваш статус

#[C] x@y.c - Вы являетесь участником в конференции x@y.c , и у Вас есть там непрочитанные сообщения

КОМАНДЫ

Пожалуйста, обратитесь к встроенной справке (команда /help), она, вероятно, новее, чем этот мануал. Кроме того, файлы помощи были переведены на несколько языков.

Вы найдете обзор команды mcabber'а в данном руководстве.

КОМАНДЫ, СВЯЗАННЫЕ С MCABBER'ом

/alias [name [= command line]]

Добавляет "name", как сокращение (aslias) для "command line". Сокращения раскрываются только один раз, поэтому они не могут быть сцепленными. "/alias name" отображает значение, привязанное к сокращению "name"; "/alias name=" удаляет сокращение для "name". "/alias" отображает список существующих сокращений.

Например: "/alias away = status away".

/bind [keycode [= command line]]

Назначает команду command line клавише с кодом keycode. Коды неиспользуемых клавиш отображаются при нажатии таких клавиш в окне истории, например, "Unknown key=265". "/bind keycode xxx" выводит команду, назначенную клавише с кодом xxx; "/bind keycode =xxx" удаляет привязку команды к клавише с кодом xxx. "/bind" выводит список кодов клавиш, которым назначены команды. Например: "/bind 265 = status online" (на моем компьютере 265 - это клавиша F1, но это зависит от установленной в вашей системе версии ncurses).

/buffer clear|close|close_all|purge

/buffer top|bottom|date|%|search_backward|search_forward

/buffer scroll_lock|scroll_unlock|scroll_toggle

buffer-команды управляют окном чата текущего контакта.

clear - очищает текущее окно чата

close - очищает всю историю текущего чата и закрывает это окно

close_all - очищает историю всех чатов и закрывает все окна

purge - очищает текущее окно чата и очищает всё содержимое истории чата

top - перейти в начало текущей истории чата

bottom - перейти в конец текущей истории чата

up [n] - прокрутить окно сообщений вверх на n строк (по умолчанию на половину экрана)

down [n] - прокрутить текущую историю чата на n строк вниз (по умолчанию: половина экрана)

date дата - перейти к первой строке указанной даты в текущей истории чата (формат даты: "ГГГГ-мм-дд[ЧЧ:ММ:СС]", "-" и ":" не обязательны)

% n - перейти на позицию %n в текущей истории чата

search_backward текст - поиск "текст" в текущем окне чата

search_forward текст - поиск "текст" в текущем окне чата

scroll_lock - заблокировать прокрутку окна чата

scroll_unlock - разблокировать прокрутку окна чата

scroll_toggle - переключение между режимами прокрутки (заблокирована/разблокирована)

/clear

Команда очистки, фактически является алиасом для "/buffer clear".

/help [команда]

Отобразить общую справку, или справку о конкретной команде mcabber'а.

/quit

Отключиться и выйти из mcabber'а.

/set опция[=значение]

Отображение или установка значения опции

/source [файл]

Конфигурационный файл

/version

Отображение версии mcabber

КОМАНДЫ, СВЯЗАННЫЕ С СЕРВЕРОМ И СОЕДИНЕНИЕМ

/connect

Установка соединения с сервером Jabber

/disconnect

Завершите соединение с Jabber серверо. Обратите внимание: список доступен только когда соединение с сервером активно, контакт-лист пуст, когда Вы отключены.

/event #n|* accept|ignore|reject

/event list

Указать mcabber, что делать с событиями.

Если первый параметр задан как «*», то команда будет применена ко всем событиям.

accept - разрешить событие #n

ignore - игнорировать событие #n

reject - отклонить событие #n

list - список всех событий

/rawxml send string

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

КОМАНДЫ, СВЯЗАННЫЕ С РОСТЕРОМ И JABBER РЕСУРСАМИ

/add [jid [nickname]]

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

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

Управление подписками.

Если не указан джид, используется для выделенного контакта.

allow - позволяет пользовател получать уведомления о Вашем статусе

cancel - отозвать подписку у контакта

request - запрос подписки у контакта

request_unsubscribe - запрос на отмену подписки контакта

/del

Удалить текущий контакт из Вашего ростера, отписаться от него и отписать его от себя.

/group fold|unfold|toggle

Команда, управляющая отображением текущей группы в ростере.

fold - скрыть контакты в текущей группе

unfold - отобразить контакты в текущей группе

toggle - переключение между режимами (свернута/развернута) текущей группы

/info

Показать информацию о выбранном пункте (контакт, группа...)

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

/move [имя_группы]

Переместить текущий контакт в указанную группу. Если группа не указана, то контакт попадает в группу по умолчанию. Если нет группы с указанным именем, то она будет создана.

Заметка: Если включен режим чата (chatmode), то вы можете использовать "/roster alternate" для перехода к перемещенному контакту.

/msay begin|verbatim|send|send_to|toggle|toggle_verbatim|abort

Отправить многострочное сообщение. Для создания сообщения, состоящего из нескольких строк должен использоваться режим многострочного (multi-line mode) сообщения.
В режиме многострочных сообщений (multi-line mode) каждая написанная строка (исключая командные строки) добавляется в тело многострочного сообщения. Когда многострочное сообщение написано, оно может быть отправлено текущему пользователю командой "/msay send" (или Ctrl+d).
Команда "/msay begin" включает режим многострочного сообщения. Обратите внимание, что может быть указана тема сообщения [subject].
Подкоманда 'verbatim' включает дословный режим. В этом режиме не воспринимаются никакие команды, что позволяет начинать строки со слеша "/". Только команда "/msay" (с параметром send или abort) может быть использована для выхода из дословного режима (соответственно, для пересылки или отмены сообщения).
Подкомандам toggle и toggle_verbatim можно назначить клавиши, чтобы быстро переходить в многострочный режим (для примера, "bind M109 = msay toggle" привязка для использования комбинации Meta+m)

begin [subject] - войти в мульти-строковый режим

verbatim - войти в дословный режим

send - отправить мультистроковое сообщение выделенному контакту

send_to jid - отправить текущее многострочное сообщение указанному jid'у

toggle - переключение между режимами "начать/отправить" многострочное сообщение (begin/send)

toggle_verbatim - тоже самое, только с дословным режимом

abort - выйти из мультистрокового режима без отправки сообщения

/pgp disable|enable|force|info [jid]

/pgp setkey [jid [key]]

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

disable [jid] - отключить PGP шифрование для jid (или выделенного контакта)

enable [jid] - включить PGP шифрование для jid (или выделенного контакта)

force [jid] - постоянно использовать PGP шифрование, даже для offline сообщений и всегда предполагать, что получатель ипользует PGP

info [jid] - показать текущие настройки PGP для контакта

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

/rename имя

Переименовывает текущий контакт или группу в указанное имя. Обратите внимание на то, что переименование группы происходит только после обработки сервера, поэтому может возникнуть небольшая задержка.

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

Отправка IQ-запроса текущему контакту или указанному пользователю Jabber. Если ресурс не указан в jid, то запрос отправляется на все ресурсы данного пользователя.

/room join|leave|names|nick|privmsg|remove|topic|unlock|destroy

/room invite|kick|ban|role|affil

/room bookmark [add|del] [-autojoin|+autojoin]

Команда room используется для управления конференциями (Multi-User Chat).

join [room [nick [pass]]] - войти в конференцию "room" с ником "nick". Если не предусмотрено никакого ника (или, если строка пустая), то ник берется из файла настроек (см. пример файла настройки). Если выбранный элемент ростера правильно распознается mcabber как конференция, то можно использовать сокращение "." вместо полного названия конференции. Пароль может использоваться для входа в закрытые конференции. Если ваш ник из нескольких слов, то используйте кавычки.

leave [сообщение] - выйти из текущей комнаты

names [--detail|--short|--quiet] - показать список пользователей текущей комнаты

nick ваш_новый_ник - изменить ваш ник в текущей комнате

privmsg имя_контакта текст_сообщения - переслать приватное сообщение "текст_сообщения" "имени контакта".

remove - удалить текущую комнату из ростера (перед этим вы должны выйти из комнаты)

topic - установить тему для текущей комнаты

unlock - разблокировать текущую комнату (если вы её владелец)

destroy [причина] - удалить текущую комнату (используйте с осторожностью!)

whois ник - показать информацию о пользователе

ban jid [причина] - заблокировать пользователя с указанным JID'ом в текущей комнате

invite jid [причина] - пригласить JID в текущую комнату

kick nick [причина] - выгнать пользователя из текущей комнаты

role jid статус [причина] - назначить статус jid (статусы могут быть следующие: "none", "visitor" - посетитель, "participant" - участник, "moderator" - модератор)

affil jid affil [причина] - принять jid в члены конференции (члены могут быть: "none", "member" - член, "admin" - администратор, "owner" - владелец)

bookmark [add|update|remove|set/unset autojoin] - добавить/обновить/удалить конференцию в закладках, включить/выключить автоматический вход в конференцию.

/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 управляет конатакт-листом. Для неё доступны следующие параметры:

bottom - перейти в конец контакт-листа

top - перейти в начало контакт-листа

up - переместиться вверх по контакт-листу

down - переместиться вниз по контакт-листу

group_prev - перейти к предыдущей группе в контакт-листе

group_next - перейти к следующей группе в контакт-листе

alternate - перейти к альтернативному контакту. "Альтернативный" контакт это последний контакт, с которым вы переписывались (эта команда особенно полезна после такой команды как "/roster unread_first")

unread_first - перейти к первому непрочитанному сообщению

unread_next - перейти к следующему непрочитанному сообщению

Искать "Вася" - искать кантакт, в нике или jid'e которого содержится "Вася" (только для отображаемого контакт-листа)

hide_offline - скрыть оффлайн контакты

show_offline - показать оффлайн контакты

toggle_offline - отключить показ оффлайн контактов

item_lock jid - прикрепить контакт jid. Он всегда будет видимым не зависимо от его статуса.

item_unlock jid - отменить эффект item_lock

hide - скрыть контакт-лист (полноразмерное окно чата)

show - показать контакт-лист

toggle - переключатель видимости для контакт-листа

note [заметка] - установить текст заметки (если заметка задана в виде "-", то заметка удаляется). В поле "status" буду отображены все заметки.

/say текст сообщения

Переслать "текстовое" сообщение выбранному контакту. Может быть полезно, если вы, например, хотите послать сообщение, которое начинается с косой черты.

/say_to jid сообщение

Отправить сообщение на указанный JID. Пожалуйста, обратите внимание, что эта команда не устанавливает по умолчанию ресурс для контакта, так что если Вы хотите отправить несколько сообщений для конкретного ресурса, Вы должны будете использовать "/ say_to" для каждого сообщения.

/status [online|avail|invisible|free|dnd|notavail|away [-|описание]]

Показать или установить текущий статус. Если статус не указан, то отображается текущий статус. Если указано сообщение статуса, то оно перезапишет message* (варианты message* могут быть заданы в файле конфигурации). Если не указано сообщение message* и не указано новое статусное сообщение, то сохраняется текущее статусное сообщение. Если статусное сообщение "-", то сообщение статуса удаляется.

/status_to jid online|avail|invisible|free|dnd|notavail|away [сообщение]

Отправить статус определённому пользователю. Если JID указан как «.», то статус будет отправлен текущему пользователю.
Обратите внимание, что этот статус будет перезаписан последующими командами «/status». Если вы используете автостатус, то статус будет также перезаписан.

Примечание: jid может включать в себя ресурс (например user@server/resource)

ФАЙЛ КОНФИГУРАЦИИ

Посмотрите предоставленный пример конфигурационного файла, который хорошо прокомментирован

ФАЙЛЫ

Следующие файлы могут быть использованы mcabber'ом:

$HOME/.mcabber/mcabberrc - Стандартный файл конфигурации

$HOME/.mcabberrc - файл конфигурации, используемый, если другие не были найдены

$HOME/.mcabber/histo/ - Стандартная директория для файлов истории, если включена поддержка в файле конфигурации

Переведено на Нотабеноиде
http://notabenoid.org/book/6728/20277

Переводчики: Lost, sattellite, slasyz, konstov

SoulThreads, kaliy, ap_Codkelden