MCABBER(1)

نام (NAME)

mcabber - کلاینت ساده کنسولی جابر (XMPP)

خلاصه دستور (SYNOPSIS)

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

توضیحات (DESCRIPTION)

دستور mcabber(1) یک کلاینت متنی و کوچک جابر (XMPP) برای کنسول است. در حال حاضر برای شروع کار به یک پرونده پیکربندی نیاز دارد، بنابراین لطفاً یک نسخه از نمونه پرونده mcabberrc را کپی کرده و تنظیمات اتصال خود را در آن اعمال کنید.

همچنین برای استفاده از این نرم‌افزار باید یک حساب کاربری از قبل موجود جابر داشته باشید، زیرا این برنامه هنوز قادر به ثبت‌نام یا حذف حساب‌های کاربری نیست.

در ادامه برخی از ویژگی‌های mcabber آورده شده است:

•پشتیبانی از SASL/SSL/TLS.

•پشتیبانی از MUC (گفتگوی چندکاربره).

•پشتیبانی از PGP و OTR

•وضعیت‌های گفتگو (اعلان‌های در حال نوشتن)

•ثبت گزارش تاریخچه: اگر فعال باشد (بخش پرونده پیکربندی را ببینید)، mcabber می‌تواند گفتگوها را در پرونده‌های متنی گزارش تاریخچه ذخیره کند.

•تکمیل خودکار دستورات: در صورت امکان، اگر کلید Tab را فشار دهید، mcabber سعی خواهد کرد خط فرمان شما را تکمیل کند.

•تاریخچه خط ورودی: هر پیام یا دستور واردشده در تاریخچه خط ورودی قرار می‌گیرد و می‌توان به‌سادگی دوباره از آن استفاده کرد.

•اقدامات خارجی: برخی رویدادها (مانند دریافت یک پیام) می‌توانند در صورت فعال‌سازی در پرونده پیکربندی، یک اقدام خارجی مانند یک اسکریپت شل را آغاز کنند. یک نمونه اسکریپت رویدادها ("eventcmd") همراه با کد منبع mcabber در دایرکتوری contrib ارائه شده است.

•ماژول‌ها: mcabber می‌تواند ماژول‌ها (یا همان پلاگین‌ها) را در زمان اجرا بارگذاری کند تا ویژگی‌های آن گسترش یابد.

گزینه‌ها (OPTIONS)

-h

پیام خلاصه راهنمای نحوه استفاده

-V

نمایش نسخه mcabber و تعاریف زمان کامپایل.

-f configfile

استفاده از پرونده پیکربندی configfile

پنجره‌ها/قاب‌ها (WINDOWS/PANES)

صفحه نمایش mcabber(1) به ۴ ناحیه تقسیم شده است. فهرست مخاطبان، با نام دیگر لیست دوستان، در سمت چپ قرار دارد. پنجره گفتگو، یا بافر گفتگو، در سمت راست است. خط ورودی در پایین صفحه، زیر یک پنجره گزارش کوچک قرار دارد.

دو خط وضعیت پنجره گزارش را احاطه کرده‌اند. خط وضعیت پایینی "خط وضعیت اصلی" است و وضعیت کلی mcabber را نشان می‌دهد. خط دیگر "خط وضعیت گفتگو" است و وضعیت مخاطب انتخاب‌شده فعلی را نمایش می‌دهد.

برای نمایش بافرهای گفتگوی مخاطبان، باید وارد حالت گفتگو شوید. می‌توانید با فشردن کلید اینتر وارد حالت گفتگو شوید (مگر اینکه حالت vi فعال باشد)، و با کلید ESC از حالت گفتگو خارج شوید. صرفاً ارسال یک پیام نیز حالت گفتگو را فعال خواهد کرد (مگر اینکه حالت vi فعال باشد).

پیاده‌سازی دومحیطه چندین مزیت دارد: نخست، قابلیت دقیق پیام‌های "خوانده‌نشده" را مطابق آنچه در بخش بعد شرح داده شده فراهم می‌آورد؛ بدون این ویژگی، صرف پیمایش روی یک مخاطب خاص موجب می‌شد پیام‌های جدید تمام مخاطبان این میان "خوانده‌شده" علامت بخورند. دوم، امکان پنهان‌سازی سریع گفتگو را با یک تک‌کلید فراهم می‌کند. سوم، امکان پرش میان مخاطبانی که در حال گفتگو با آن‌ها هستید را با دستور /roster alternate (که در بخش دیگری شرح داده شده) بدون نیاز به پیمایش دستی به جلو و عقب ممکن می‌سازد.

کلیدها (KEYS)

نوشتن متن در خط ورودی انجام می‌شود؛ عملیات پایه‌ای پشتیبانی می‌شوند (کلید جهت‌نمای چپ، جهت‌نمای راست، کلیدهای Home/End، Insert، Delete، Backspace و غیره).

کلیدهای PageUp و PageDown برای جابجایی در فهرست مخاطبان به کار می‌روند.

کلیدهای جهت‌نمای بالا و پایین برای جابجایی در تاریخچه خط ورودی استفاده می‌شوند؛ آن‌ها به خط قبلی/بعدی در تاریخچه که با همان رشته آغاز می‌شود (از ستون اول تا ستون مکان‌نما) پرش می‌کنند.

برای ارسال پیام، روی مخاطب انتخاب‌شده در فهرست دوستان بروید، پیام خود را تایپ کرده و اینتر را فشار دهید. اگر خط با یک اسلش آغاز شود، به عنوان یک دستور تفسیر خواهد شد (بخش دستورات را در ادامه ببینید). کلید 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

انتقال مکان‌نما به ابتدای کلمه فعلی یا قبلی

Ctrl-Right

انتقال مکان‌نما به انتهای کلمه فعلی یا بعدی

Ctrl-u

حذف از ابتدای خط تا مکان‌نما

Ctrl-k

حذف از مکان‌نما تا انتهای خط

Ctrl-w

حذف کلمه به عقب (Backward kill word)

Ctrl-t

جابجایی جای دو نویسه (Transpose chars)

Ctrl-o

پذیرش خط جاری و قرار دادن خط بعدی تاریخچه در خط ورودی (accept-line-and-down-history)

کلیدهای میانبر دیگری را می‌توان با استفاده از دستور /bind که در بخش دستورات شرح داده شده است، تعیین کرد.

حالت VI (VI MODE)

اگر گزینه "vi_mode" برابر با ۱ تنظیم شده باشد، mcabber(1) چند دستور را که تقریباً بر اساس دستورات موجود در حالت عادی vi(1) هستند می‌پذیرد. در این حالت، ورود به حالت گفتگو با فشردن اینتر انجام نمی‌شود، و پیام‌ها را نمی‌توان خارج از حالت گفتگو نوشت. دستورات زیر پذیرفته می‌شوند:

فراخوانی "/roster unread_first".

فراخوانی "/roster unread_next".

فراخوانی "/roster group_prev".

فراخوانی "/roster group_next".

فراخوانی "/roster bottom".

فراخوانی "/roster top".

ورود به حالت گفتگو.

[N]j

فراخوانی "/roster down [N]".

[N]k

فراخوانی "/roster up [N]".

تکرار جستجوی قبلی (در صورت وجود).

فراخوانی "/roster unread_first" و باز کردن پنجره گفتگو.

فراخوانی "/roster unread_next" و باز کردن پنجره گفتگو.

فراخوانی "/quit".

فراخوانی "/group fold" برای همه گروه‌ها.

فراخوانی "/group unfold" برای همه گروه‌ها.

فراخوانی "/roster alternate".

تغییر وضعیت پرچم توجه (attention) برای مخاطب جاری.

تغییر وضعیت پرچم پیام‌های خوانده‌نشده برای مخاطب جاری.

<Space>

فراخوانی "/group toggle" برای گروه جاری.

یک اسلش در ابتدای خط حالت جستجو را فعال می‌کند:

/string

فراخوانی "/roster search string".

قرار دادن دونقطه در ابتدای خط حالت خط فرمان را فعال می‌کند:

دستورات فوق).

دستوراتی که با یک دونقطه در ابتدا وارد می‌شوند و همچنین جستجوها با فشردن اینتر ثبت شده یا با زدن کلید Escape لغو می‌شوند. در هر دو حالت، mcabber(1) به حالت عادی (غیرگفتگو) بازمی‌گردد. ویرایش تاریخچه در حالت خط فرمان و حالت جستجو پشتیبانی می‌شود. در حالت خط فرمان، تکمیل خودکار با Tab نیز پشتیبانی می‌گردد.

فهرست مخاطبان MCABBER (MCABBER’S ROSTER)

نخستین مورد فهرست‌شده در فهرست مخاطبان، مورد [status] است که گزارش تمام رویدادهایی را که در پنجره گزارش کوتاه زیر بخش اصلی گفتگو ظاهر می‌شوند نگهداری می‌کند. در حالی که پنجره گزارش برای نمایش چند مورد اخیر طراحی شده بود، بافر اختصاصی [status] امکان مشاهده راحت‌تر گزارش و همچنین پیمایش آن به شیوه استاندارد را فراهم می‌سازد.

نام‌های گروه‌ها در بالای مواردی که درون آن‌ها هستند نمایش داده می‌شوند و با علامت --- در سمت چپ نام مشخص می‌گردند.

برای هر مخاطب واقعی جابر، فهرست مخاطبان چهار بخش اطلاعاتی را نمایش می‌دهد: نام یا نام مستعار مخاطب، وضعیت برخط بودن او، وضعیت مجوز او، و اینکه آیا پیام‌های خوانده‌نشده‌ای از سوی او در انتظار شماست یا خیر.

وضعیت برخط بودن یکی از موارد زیر است:

برخط (online)

آماده برای گفتگو (free for chat)

غایب (away)

در دسترس نیست (not available، در برخی کلاینت‌ها با برچسب غیبت طولانی (extended away) مشخص می‌شود)

مزاحم نشوید (do not disturb)

آفلاین (یا نامرئی برای شما)

نامشخص، معمولاً به این معنی است که شما مجاز به دیدن وضعیت این مخاطب نیستید

اتاق کنفرانس که در آن شرکت ندارید

اتاق کنفرانس که در آن در حال شرکت هستید

وضعیت مجوز نشان می‌دهد که آیا مخاطب مجاز به دریافت به‌روزرسانی‌های وضعیت برخط شما هست یا خیر، و با براکت‌هایی که وضعیت برخط مخاطب را در بر گرفته‌اند نمایش داده می‌شود. براکت‌های چهارگوش مانند [o] نشان می‌دهند که این مخاطب مجاز به دریافت وضعیت شما است. ابروها (کروشه‌های مجعد) مانند {o} نشان می‌دهند که او مجاز به دریافت وضعیت شما نیست.

هنگامی که پیام‌های خوانده‌نشده‌ای از یک مخاطب وجود دارد که هنوز به آن‌ها نگاه نکرده‌اید، یک علامت هش (#) در سمت چپ‌ترین بخش فهرست مخاطبان برای آن مخاطب ظاهر می‌شود. به محض اینکه بافر پیام‌های آن مخاطب را مشاهده کنید، این علامت هش ناپدید می‌شود. هنگامی که توجه کاربر درخواست شود (یا زمانی که پیامی حاوی نام مستعار خود را در یک اتاق MUC دریافت کنید)، علامت هش با علامت توجه یعنی علامت تعجب (!) جایگزین می‌شود.

مثال‌ها:

' --- Buds'

این یک گروه به نام Buds است

#[o] John

جان (John) برخط است، می‌تواند وضعیت شما را ببیند، و پیامی برای شما فرستاده که هنوز آن را نخوانده‌اید

' {?} Sally'

نه شما و نه Sally به یکدیگر مجوز مشاهده وضعیت برخط را نداده‌اید

' {a} Jane'

مخاطب Jane غایب (away) است، اما نمی‌تواند وضعیت برخط شما را ببیند

#[C] x@y.c

شما در حال شرکت در اتاق کنفرانس x@y.c هستید و پیام‌های خوانده‌نشده‌ای وجود دارد

دستورات (COMMANDS)

لطفاً به راهنمای برخط (دستور /help) مراجعه فرمایید؛ احتمالاً از این صفحه راهنما به‌روزتر است. علاوه بر این، پرونده‌های راهنما به چندین زبان ترجمه شده‌اند. در این راهنما، خلاصه‌ای کلی از دستورات mcabber را خواهید یافت.

دستورات مرتبط با MCABBER (COMMANDS RELATED TO MCABBER)

/add [jid [nickname]]

کاربر جابر با شناسه «jid» را به فهرست مخاطبان ما (گروه پیش‌فرض) اضافه کرده و یک درخواست آگاه‌سازی به این مخاطب ارسال می‌کند. اگر هیچ نام مستعاری مشخص نشده باشد، از همان jid استفاده می‌شود. اگر هیچ jid (یا رشته خالی "") ارائه نشود یا اگر jid برابر با «.» باشد، از مخاطب جاری استفاده می‌شود.

[jid [nickname]]

افزودن «jid» با نام مستعار «nickname» به فهرست مخاطبان ما

مثال: "/add somebody@jabber.server.com Somebody"

/alias [name [= command line]]

این دستور به شما امکان می‌دهد نام‌های مستعار (alias) اضافه کنید که می‌توانند دستورات پیچیده را ساده کنند.

شما می‌توانید نام‌های مستعار خود را با روش‌های زیر مدیریت کنید:

(بدون آرگومان)

چاپ فهرست نام‌های مستعار تعریف‌شده فعلی

name

چاپ مقدار نام مستعار با نام «name»

name=

لغو تعریف نام مستعار با نام «name»

name = command line

تنظیم نام مستعار با نام «name» با مقدار «command line»

مثال: "/alias away = status away"

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

این دستور اشتراک‌های وضعیت حضور (presence) را مدیریت می‌کند: به شما امکان می‌دهد اشتراک وضعیت حضور دیگران را در فهرست مخاطبان خود درخواست کنید و کنترل کنید چه کسانی اعلان‌های حضور شما را دریافت کنند.

اگر هیچ JID مشخص نشود، از مخاطب انتخاب‌شده فعلی استفاده می‌شود.

allow

اجازه به مخاطب برای دریافت به‌روزرسانی‌های وضعیت حضور شما

cancel

لغو اشتراک مخاطب در به‌روزرسانی‌های وضعیت حضور شما

request

درخواست اشتراک در به‌روزرسانی‌های وضعیت حضور مخاطب

request_unsubscribe

درخواست لغو اشتراک از به‌روزرسانی‌های وضعیت حضور مخاطب

/bind [keycode [= command line]]

انتساب دستور به کلیدی که به عنوان «keycode» مشخص شده است. برای بررسی اینکه در حال حاضر کدام کلیدها استفاده نشده‌اند، به پنجره گزارش (log) mcabber نگاه کنید و کلید مورد نظر را فشار دهید. برای مثال: "Unknown key=265" به این معنی است که می‌توانید دستوری را به کلید شماره ۲۶۵ متصل کنید.

(بدون آرگومان)

نمایش فهرست کلیدهای مقیدشده فعلی

keycode

نمایش خط فرمانی که به این کلید متصل شده است

keycode=

لغو انتساب کلید با کد «keycode»

keycode = command line

اتصال «command line» به کلید با کد «keycode»

مثال: "/bind 265 = status away" (کلید 265 همان F1 است). +
نکته: کدهای کلید بسته به پیکربندی ncurses شما می‌توانند متفاوت باشند. +
ترفند: همچنین می‌توان به جای دستورات از نام‌های مستعار (alias) استفاده کرد.

دستور دستکاری بافر مخاطب. به عنوان مثال، می‌توانید در بافر به دنبال «text» بگردید، پنجره گفتگو را پاک کنید و غیره.

clear

پاک کردن پنجره گفتگوی مخاطب جاری

close [jid]

خالی کردن تمام محتویات بافر و بستن پنجره گفتگوی مخاطب جاری

close_all

خالی کردن تمام محتویات بافرهای گفتگو و بستن پنجره‌های گفتگو

purge [jid]

پاک کردن پنجره گفتگوی مخاطب جاری و خالی کردن تمام محتویات بافر گفتگو

list

نمایش فهرست بافرهای موجود همراه با طول آن‌ها (خطوط/بلوک‌ها)

top

پرش به ابتدای بافر گفتگوی مخاطب جاری

bottom

پرش به انتهای بافر گفتگوی مخاطب جاری

up [n]

پیمایش بافر به بالا به میزان [n] خط (پیش‌فرض: نیم‌صفحه)

down [n]

پیمایش بافر به پایین به میزان [n] خط (پیش‌فرض: نیم‌صفحه)

date [date]

پرش به نخستین خط پس از [date] مشخص‌شده در بافر گفتگو (قالب تاریخ: "YYYY-mm-dd")

% n

پرش به موقعیت %n از بافر گفتگوی مخاطب

search_backward text

جستجو برای [text] به سمت عقب در بافر گفتگوی مخاطب جاری

search_forward text

جستجو برای [text] به سمت جلو در بافر گفتگوی مخاطب جاری

scroll_lock

قفل کردن پیمایش بافر

scroll_unlock

باز کردن قفل پیمایش بافر

scroll_toggle

تغییر وضعیت قفل پیمایش بافر (قفل/باز)

save filename

ذخیره محتویات بافر جاری در پرونده «filename»

/chat_disable [--show-roster]

غیرفعال کردن حالت گفتگو.

با گزینه --show-roster، حالت تمام‌صفحه غیرفعال خواهد شد.

/clear

این دستور در واقع یک نام مستعار برای "/buffer clear" است. این دستور پنجره گفتگوی مخاطب جاری را پاک می‌کند.

/color roster (status wildcard (color|-)|clear), /color mucnick nick (color|-), /color muc (jid|.|*) [on|preset|off|-]

دستور color امکان تنظیم ویژگی‌های رنگ پویای صفحه نمایش را فراهم می‌کند.

roster clear

حذف تمام قوانین رنگ برای فهرست مخاطبان. همه موارد فهرست مخاطبان رنگ پیش‌فرض خود را دریافت خواهند کرد.

roster status wildcard color

تنظیم یک قانون رنگ (یا بازنویسی در صورت وجود قبلی). مقدار status رشته‌ای شامل تمام وضعیت‌هایی است که مورد فهرست مخاطبان می‌تواند برای تطابق قانون داشته باشد، یا علامت * اگر هر وضعیتی قابل قبول باشد. آرگومان wildcard الگوی تطبیق فایلی است که روی JID اعمال خواهد شد. آرگومان color رنگ مورد نظر است. اگر color برابر با - باشد، قانون حذف می‌شود. اگر بیش از یک قانون تطابق داشته باشد، رنگ آخرین قانون ایجادشده (بازنویسی‌نشده) استفاده می‌شود.

mucnick nick (color|-)

علامت‌گذاری نام مستعار برای رنگ‌آمیزی با رنگ داده‌شده. اگر یک MUC دارای نام‌های مستعار رنگی باشد، از این رنگ استفاده خواهد شد. اگر color برابر با - باشد، رنگ به عنوان انتخاب خودکار علامت‌گذاری می‌شود، به این معنی که در حالت رنگ‌آمیزی preset استفاده نخواهد شد، اما در حالت رنگ‌آمیزی on یکسان باقی خواهد ماند.

muc (jid|.|*) [on|preset|off|-]

حالت رنگ‌آمیزی نام مستعار MUC را تنظیم می‌کند. اگر یک jid ارائه شود (علامت . به معنای jid انتخاب‌شده فعلی است)، حالت برای این MUC خاص اعمال می‌شود. اگر از * استفاده شود، برای همه MUCها اعمال خواهد شد، به جز مواردی که با jid اختصاصی خود تنظیم شده‌اند. حالت on تمام نام‌های مستعار را رنگ‌آمیزی می‌کند، حالت preset فقط مواردی را که به صورت دستی توسط دستور /color mucnick تنظیم شده‌اند رنگ‌آمیزی می‌کند و حالت off هیچ‌کدام را رنگ‌آمیزی نمی‌کند. اگر مشخص نشود، مقدار پیش‌فرض on است. حالت - حالت را از JID داده‌شده حذف می‌کند، به این معنی که حالت سراسری اعمال خواهد شد. شما نمی‌توانید حالت سراسری را حذف کنید. حالت پیش‌فرض رنگ‌آمیزی سراسری off است.

/connect

برقراری اتصال به کارساز جابر.

/del

حذف مخاطب جاری از فهرست مخاطبان ما، لغو اشتراک از اعلان‌های حضور آن و لغو اشتراک آن از اعلان‌های حضور ما.

/disconnect

قطع اتصال با کارساز جابر.

نکته: فهرست مخاطبان فقط زمانی در دسترس است که اتصال به کارساز فعال باشد، بنابراین هنگام قطع اتصال، فهرست مخاطبان خالی است.

/echo message

نمایش «message» در پنجره گزارش (log).

/event #n|* accept|ignore|reject [event-specific arguments], /event list

تعیین نحوه برخورد mcabber با رویدادهای در انتظار.

اگر پارامتر نخست * باشد، دستور برای تمام رویدادهای موجود در صف اعمال خواهد شد.

آرگومان‌های ویژه رویداد بر اساس هر رویداد تفسیر خواهند شد. تنها مورد توکار که در آن آرگومان استفاده می‌شود، رد دعوت MUC است - در صورت وجود، آرگومان به عنوان دلیل رد تلقی خواهد شد.

#N|* accept [event-specific arguments]

رویداد شماره #N/همه رویدادها پذیرفته خواهند شد

#N|* ignore [event-specific arguments]

رویداد شماره #N/همه رویدادها نادیده گرفته خواهند شد

#N|* reject [event-specific arguments]

رویداد شماره #N/همه رویدادها رد خواهند شد

list

فهرست کردن تمام رویدادهای در انتظار

/group fold|unfold|toggle [groupname]

این دستور نحوه نمایش گروه جاری را تغییر می‌دهد.

fold [groupname]

جمع کردن (بستن) درخت گروه جاری/مشخص‌شده در فهرست مخاطبان

unfold [groupname]

باز کردن (گسترش) درخت گروه جاری/مشخص‌شده در فهرست مخاطبان

toggle [groupname]

تغییر وضعیت (جمع/باز) درخت گروه جاری/مشخص‌شده

/help [command|+topic]

نمایش راهنما برای دستور «command» یا موضوع «topic».

مثال: "/help buffer"

دستورات خط ورودی

fchar

حرکت به نویسه بعدی

bchar

حرکت به نویسه قبلی

char_fdel

حذف نویسه در موقعیت مکان‌نما

char_bdel

حذف نویسه قبل از موقعیت مکان‌نما

char_swap

جابجایی نویسه‌ها

fword

حرکت مکان‌نما به سمت جلو به انتهای کلمه جاری یا بعدی

bword

حرکت مکان‌نما به سمت عقب به ابتدای کلمه جاری یا قبلی

word_bdel

حذف کلمه از موقعیت مکان‌نما تا ابتدای آن

word_fdel

حذف کلمه از موقعیت مکان‌نما تا انتهای آن

word_upcase

تبدیل کلمه از موقعیت مکان‌نما تا انتهای آن به حروف بزرگ

word_downcase

تبدیل کلمه از موقعیت مکان‌نما تا انتهای آن به حروف کوچک

word_capit

بزرگ کردن حرف اول کلمه از موقعیت مکان‌نما تا انتهای آن

hist_beginning_search_bwd

جستجو به سمت عقب در تاریخچه برای خطی که با خط جاری تا موقعیت مکان‌نما آغاز می‌شود (این کار مکان‌نما را در موقعیت اولیه خود باقی می‌گذارد)

hist_beginning_search_fwd

جستجو به سمت جلو در تاریخچه برای خطی که با خط جاری تا موقعیت مکان‌نما آغاز می‌شود (این کار مکان‌نما را در موقعیت اولیه خود باقی می‌گذارد)

hist_prev

خط قبلی در تاریخچه خط ورودی

hist_next

خط بعدی در تاریخچه خط ورودی

iline_start

رفتن به ابتدای خط ورودی

iline_end

رفتن به انتهای خط ورودی

iline_fdel

حذف از موقعیت مکان‌نما تا انتهای خط

iline_bdel

حذف از ابتدای خط تا موقعیت مکان‌نما

iline_accept

پذیرش خط

iline_accept_down_hist

پذیرش خط و قرار دادن خط بعدی تاریخچه در خط ورودی

compl_do

تکمیل کلمه فعلی در خط ورودی

compl_cancel

لغو تکمیل خودکار

send_multiline

ارسال/پایان دادن به یک پیام چندخطی

/info

نمایش اطلاعات درباره مدخل انتخاب‌شده (کاربر، عامل، گروه و...).

برای کاربران، منابع به همراه وضعیت، اولویت و پیام وضعیت هر منبع (در صورت وجود) نمایش داده می‌شوند.

/module load|unload [-f] module, /module info module, /module [list]

بارگذاری، تخلیه یا نمایش اطلاعات مربوط به ماژول.

load [-f] module

ماژول مشخص‌شده را بارگذاری می‌کند. اگر فلگ -f مشخص شده باشد، از بیشتر خطاهای بارگذاری ماژول صرف‌نظر خواهد شد.

unload [-f] module

ماژول مشخص‌شده را تخلیه می‌کند. توجه: فلگ اجبار (force) هیچ‌یک از وابستگی‌های وابسته به این ماژول را حذف نخواهد کرد!

info module

اطلاعات موجود درباره این ماژول را نمایش می‌دهد.

[list]

ماژول‌ها را در قالبی با این ساختار فهرست می‌کند: [نام ماژول] [تعداد ارجاع] ([بارگذاری دستی/خودکار]) [هرگونه اطلاعات اضافی مانند نسخه یا وابستگی‌ها]

/move [groupname]

انتقال مخاطب جاری به گروه درخواستی. اگر گروهی مشخص نشود، مخاطب به گروه پیش‌فرض منتقل می‌شود. اگر گروه "groupname" وجود نداشته باشد، ایجاد خواهد شد.

نکته: در صورت فعال بودن حالت گفتگو (chatmode)، می‌توانید با دستور "/roster alternate" به مخاطب منتقل‌شده پرش کنید.

ارسال یک پیام چندخطی. برای نوشتن یک پیام واحد در چندین خط، باید از حالت چندخطی (multi-line mode) استفاده شود.

در حالت چندخطی، هر خطی که در خط ورودی تایپ شود (به جز خطوط دستور) به پیام چندخطی اضافه خواهد شد. پس از اتمام پیام، می‌توان آن را با دستور "/msay send" برای مخاطب انتخاب‌شده جاری ارسال کرد.

زیردستور begin حالت چندخطی را فعال می‌کند. توجه داشته باشید که این زیردستور امکان تعیین موضوع (subject) پیام را فراهم می‌سازد.

حالت چندخطی verbatim دستورات را غیرفعال می‌کند تا بتوان خطوطی را که با اسلش (/) آغاز می‌شوند نیز وارد کرد. تنها از دستور "/msay" (همراه با پارامترهای send یا abort) می‌توان برای خروج از حالت verbatim استفاده کرد.

زیردستور toggle می‌تواند به یک کلید مقید شود تا استفاده سریع از حالت چندخطی میسر گردد (به عنوان مثال، "bind M13 = msay toggle" برای جابه‌جایی با استفاده از ترکیب کلیدهای Meta-Enter).

begin [subject]

ورود به حالت چندخطی

verbatim

ورود به حالت چندخطی عینی (verbatim)

send [-n|-h]

ارسال پیام چندخطی جاری به مخاطب انتخاب‌شده فعلی

send_to [-n|-h] jid

ارسال پیام چندخطی جاری به "jid"

toggle|toggle_verbatim

جابه‌جایی به/از حالت چندخطی (begin/send)

abort

خروج از حالت چندخطی بدون ارسال پیام

فلگ‌های -n یا -h در مقایسه با پیام پیش‌فرض "chat"، نوع پیام را به ترتیب به "normal" یا "headline" تغییر می‌دهند.

/otr key, /otr start|stop|info [jid], /otr fingerprint [jid [fpr]], /otr smpq|smpr [jid] secret, /otr smpa [jid]

می‌توانید از شناسه میانبر "." برای مخاطب انتخاب‌شده فعلی استفاده کنید.

key

چاپ اثرانگشت کلید خصوصی شما در بافر وضعیت (Status Buffer)

start [jid]

باز کردن یک کانال OTR به jid مشخص‌شده (یا مخاطب انتخاب‌شده فعلی)

stop [jid]

بستن کانال OTR با jid مشخص‌شده (یا مخاطب انتخاب‌شده فعلی)

info [jid]

نمایش وضعیت جاری OTR برای jid مشخص‌شده (یا مخاطب انتخاب‌شده فعلی)

fingerprint [jid [fpr]]

نمایش اثرانگشت فعال یک کانال OTR. اگر اثرانگشت به جای "fpr" ارائه شود، آن اثرانگشت مورد اعتماد (trusted) خواهد شد. اگر "fpr" را با یک رشته ساختگی جایگزین کنید، اثرانگشت وضعیت مورد اعتماد بودن خود را از دست خواهد داد.

smpq [jid] secret

آغاز پروتکل میلیونرهای سوسیالیست (SMP) با عبارت محرمانه و مخاطب

smpr [jid] secret

پاسخ به درخواست آغاز پروتکل از سوی jid با عبارت محرمانه

smpa [jid]

لغو پروتکل در حال اجرای میلیونرهای سوسیالیست

/otrpolicy, /otrpolicy (default|jid) (plain|manual|opportunistic|always)

می‌توانید از شناسه میانبر "." برای مخاطب انتخاب‌شده فعلی استفاده کنید.

(بدون شناسه)

چاپ تمام سیاست‌های OTR در بافر وضعیت

(default|jid) (plain|manual|opportunistic|always)

سیاست پیش‌فرض یا سیاست مربوط به jid داده‌شده را تنظیم می‌کند. از سیاست plain هرگز نباید استفاده شود، زیرا قادر به دریافت یا ارسال هیچ پیام رمزگذاری‌شده با OTR نخواهید بود. اگر سیاست را روی manual تنظیم کنید، شما یا طرف گفتگوی شما باید رمزگذاری OTR را به‌صورت دستی آغاز کنید (مثلاً با دستور /otr start). سیاست "opportunistic" این کار را خودبه‌خود با ارسال یک دنباله فاصله خالی (whitespace) ویژه در انتهای پیام‌های رمزگذاری‌نشده انجام می‌دهد؛ بنابراین کلاینت گفتگوی دیگر با قابلیت OTR متوجه می‌شود که شما مایل به استفاده از OTR هستید. توجه داشته باشید که در صورت استفاده از این سیاست، نخستین پیام همیشه رمزگذاری‌نشده خواهد بود. با سیاست "always"، هیچ پیامی به‌صورت متن ساده (plain text) ارسال نخواهد شد. اگر تلاش کنید نخستین پیام را به‌صورت رمزگذاری‌نشده بفرستید، mcabber برای برقراری یک کانال OTR تلاش خواهد کرد. لطفاً پس از دریافت اطلاع از برقراری کانال، پیام خود را دوباره ارسال کنید. اگر زمانی که سیاست روی "always" تنظیم شده است کسی پیامی با متن ساده برای شما ارسال کند، قادر به خواندن پیام خواهید بود اما در تاریخچه ذخیره نخواهد شد.

/pgp disable|enable|force|info [jid], /pgp setkey [jid [key]]

این دستور تنظیمات PGP را برای jid مشخص‌شده (به‌طور پیش‌فرض مخاطب انتخاب‌شده فعلی) دستکاری می‌کند.

لطفاً توجه داشته باشید که اگر پشتیبانی از PGP در طرف مقابل شناسایی نشود، حتی در صورت فعال بودن PGP با این دستور، از رمزگذاری PGP استفاده نخواهد شد. با زیردستور "force" می‌توانید رمزگذاری PGP را اجباری کنید.

disable [jid]

غیرفعال کردن رمزگذاری PGP برای jid (یا مخاطب انتخاب‌شده فعلی)

enable [jid]

فعال کردن رمزگذاری PGP برای jid (یا مخاطب انتخاب‌شده فعلی)

force [jid]

اجباری کردن رمزگذاری PGP، حتی برای پیام‌های برون‌خط، و فرض همیشگی بر اینکه گیرنده از PGP پشتیبانی می‌کند. اگر پیامی نتواند رمزگذاری شود (به دلیل نبود کلید یا شناسه کلید)، پیام‌ها اصلاً ارسال نخواهند شد. زمانی که PGP غیرفعال باشد، این گزینه نادیده گرفته می‌شود.

info [jid]

نمایش تنظیمات جاری PGP برای مخاطب

setkey [jid [key]]

تنظیم کلید PGP مورد استفاده برای رمزگذاری پیام‌ها جهت این مخاطب. اگر کلیدی ارائه نشود، کلید فعلی پاک می‌شود. می‌توانید از شناسه میانبر "." برای مخاطب انتخاب‌شده فعلی استفاده کنید.

/quit

این دستور تمام اتصالات را می‌بندد و از mcabber خارج می‌شود.

/rawxml send string

ارسال "string" (قالب خام XML) به سرور جابر (Jabber).

هیچ‌گونه بررسی روی رشته ارائه‌شده انجام نمی‌شود.

هشدار! تنها در صورتی از این دستور استفاده کنید که می‌دانید چه کاری انجام می‌دهید، در غیر این صورت ممکن است موجب قطع اتصال شوید.

مثال: "/rawxml send <presence><show>away</show></presence>"

/rename name

تغییر نام مخاطب یا گروه جاری به "name" مشخص‌شده. اگر "name" برابر با - باشد، نام از فهرست مخاطبان حذف می‌شود (و mcabber شناسه JID یا نام کاربری را نمایش خواهد داد).

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

ارسال یک پرس‌وجوی "IQ" به مخاطب جاری یا به کاربر جابر مشخص‌شده. اگر منبع به همراه jid ارائه نشود، mcabber پرس‌وجو را به تمام منابع شناخته‌شده برای این کاربر ارسال خواهد کرد.

last

درخواست اطلاعات "last" (معمولاً زمان بیکاری)

ping

ارسال یک درخواست پینگ XMPP. توجه داشته باشید که باید از JID کامل استفاده کنید، زیرا پینگ ارسالی به یک JID ساده (bare JID) توسط سرور مدیریت و پاسخ داده می‌شود.

time

درخواست زمان از مخاطب

vcard

درخواست VCard از مخاطب

version

درخواست نسخه از مخاطب

دستور room اقدامات مربوط به اتاق گفتگوی چندکاربره (MUC) را مدیریت می‌کند.

join [room [nick [pass]]]

پیوستن به "room" با استفاده از "nick" به عنوان نام مستعار. اگر نام مستعاری مشخص نشود (یا یک رشته خالی باشد)، از مقدار گزینه "nickname" استفاده می‌شود (به پرونده پیکربندی نمونه مراجعه کنید). اگر مدخل انتخاب‌شده فعلی توسط mcabber به‌درستی به‌عنوان یک اتاق شناسایی شود، می‌توان از شناسه میانبر "." به‌جای شناسه کامل اتاق استفاده کرد. برای ورود به اتاق‌های محافظت‌شده می‌توان گذرواژه ارائه داد. اگر نام مستعار شما شامل کاراکترهای فاصله است، از علامت نقل‌قول استفاده کنید.

leave [message]

ترک کردن اتاق جاری

names [--detail|--short|--quiet|--compact]

نمایش اعضای اتاق جاری

nick newnick

تغییر نام مستعار خود در اتاق جاری

privmsg nick msg

ارسال پیام خصوصی "msg" به "nick"

remove

حذف اتاق جاری از فهرست مخاطبان (باید قبلاً از این اتاق خارج شده باشید)

topic -|newtopic

تنظیم موضوع برای اتاق جاری

unlock

باز کردن قفل اتاق جاری (اگر مالک آن باشید)

destroy [reason]

نابود کردن اتاق جاری (با احتیاط استفاده کنید!)

whois nick

نمایش اطلاعات MUC درباره "nick"

ban jid [reason]

مسدود کردن jid از اتاق جاری

unban jid

رفع مسدودیت jid از اتاق جاری

invite jid [reason]

دعوت از jid به اتاق جاری

kick nick [reason]

اخراج "nick" از اتاق جاری

role nick role [reason]

تغییر نقش nick (نقش می‌تواند "none"، "visitor"، "participant" یا "moderator" باشد)

affil jid affil [reason]

تغییر وابستگی (affiliation) مربوط به jid (وابستگی می‌تواند "none"، "member"، "admin" یا "owner" باشد)

setopt print_status|auto_whois [value]

تغییر تنظیمات برای اتاق جاری. برای print_status، مقادیر ممکن عبارتند از "default"، "none"، "in_and_out" و "all". برای auto_whois، مقادیر ممکن عبارتند از "default"، "off" و "on". زمانی که مقدار "default" باشد، از گزینه‌های muc_print_status / muc_auto_whois استفاده می‌شود.

bookmark [add|del] [-autojoin|+autojoin] [-|nick]

افزودن، حذف یا به‌روزرسانی یک نشانک (پیش‌فرض add است). در صورت تنظیم بودن autojoin، برنامه mcabber هنگام اتصال به سرور به‌طور خودکار به اتاق MUC می‌پیوندد. برای مشاهده فهرست نشانک‌ها، از دستور /room bookmark در بافر وضعیت استفاده کنید.

دستور roster فهرست مخاطبان (roster/buddylist) را مدیریت و دستکاری می‌کند.

پارامترهای موجود به شرح زیر هستند:

bottom

پرش به انتهای فهرست مخاطبان

top

پرش به ابتدای فهرست مخاطبان

up [n]

حرکت به بالا [به تعداد n سطر] در فهرست مخاطبان

down [n]

حرکت به پایین [به تعداد n سطر] در فهرست مخاطبان

group_prev

پرش به گروه قبلی در فهرست مخاطبان

group_next

پرش به گروه بعدی در فهرست مخاطبان

alternate

پرش به مخاطب جایگزین. مخاطب «جایگزین» آخرین مخاطبی است که هنگام حضور در حالت گفتگو ترک شده است. بنابراین این دستور به‌ویژه پس از دستورهایی مانند «/roster unread_next» (کلید Ctrl-q) مفید است.

unread_first

پرش به نخستین پیام خوانده‌نشده

unread_next

پرش به پیام خوانده‌نشده بعدی

search bud

جستجو برای مخاطبی با نام یا شناسه jid حاوی «bud» (تنها در فهرست مخاطبانِ نمایش‌یافته)

display [mask]

مشاهده یا به‌روزرسانی فیلتر فهرست مخاطبان. ماسک باید حاوی حروف اختصاری وضعیت‌هایی باشد که می‌خواهید ببینید ([o]nline،‏ [f]ree_for_chat،‏ [d]o_not_disturb،‏ [n]ot_available،‏ [a]way،‏ [_]offline). برای نمونه «ofdna» برای نمایش تنها مخاطبان متصل.

hide_offline

پنهان کردن مخاطبان برون‌خط (مشابه /roster display ofdna)

show_offline

نمایش مخاطبان برون‌خط (مشابه /roster display ofdna_)

toggle_offline

تغییر وضعیت نمایش مخاطبان برون‌خط

item_lock [jid]

قفل کردن آیتم فهرست مخاطبان تا بدون در نظر گرفتن وضعیتش، همواره نمایان باقی بماند

item_unlock [jid]

لغو اثر دستور item_lock

item_toggle_lock [jid]

معکوس کردن پرچم قفل فعلی

hide

پنهان کردن فهرست مخاطبان (پنجره گفتگوی تمام‌عرض)

show

نمایش فهرست مخاطبان

toggle

تغییر وضعیت نمایانی فهرست مخاطبان

note [-|text]

تنظیم/به‌روزرسانی/حذف یک یادداشت. اگر متنی مشخص نشود، یادداشت آیتم جاری نمایش داده می‌شود — اگر در بافر وضعیت باشید، همه یادداشت‌ها نمایش داده می‌شوند. اگر متن «-» باشد، یادداشت پاک می‌شود.

/say [-n|-h|--] text

ارسال پیام «text» به مخاطب انتخاب‌شده فعلی. برای نمونه اگر بخواهید پیامی را ارسال کنید که با یک اسلش آغاز می‌شود، می‌تواند مفید باشد.

فلگ «-n» نوع پیام را به «normal» و «-h» به «headline» تبدیل می‌کند. از «--» می‌توان برای ارسال پیام گفتگویی که با -n یا -h آغاز می‌شود استفاده کرد.

/say_to [-n|-h] [-q] [-f file] jid text

ارسال پیام «text» به شناسه jid مشخص‌شده.

لطفاً توجه داشته باشید که این دستور منبع پیش‌فرض (resource) را برای یک مخاطب تنظیم نمی‌کند، بنابراین اگر می‌خواهید چندین پیام را به یک منبع خاص ارسال کنید، باید برای هر پیام از «/say_to» استفاده نمایید.

می‌توانید با استفاده از دستور /say_to ./resourcename message پیامی را به یک منبع خاص از مخاطب انتخاب‌شده فعلی ارسال کنید.

فلگ «-n» نوع پیام را به «normal» و «-h» به «headline» تبدیل می‌کند. از «--» می‌توان برای ارسال پیام‌های گفتگویی که با -n یا -h آغاز می‌شوند استفاده کرد.

هنگامی که «-q» استفاده شود، پیام در پس‌زمینه ارسال خواهد شد و پنجره فعال فعلی را تغییر نمی‌دهد.

یک پرونده متنی را می‌توان با سوییچ «-f» مشخص کرد (که در این صورت البته نیازی به فرستادن آرگومان text پس از jid نیست).

/screen_refresh

تازه کردن صفحه نمایش mcabber.

/set [option [= value]]

نمایش یا تنظیم مقدار یک گزینه.

بدون آرگومان، فهرستی از همه گزینه‌های تنظیم‌شده را به همراه مقادیر آن‌ها چاپ می‌کند

/source pattern

خواندن پرونده‌های پیکربندی که با الگوی glob مطابقت دارند (مرتب‌شده بر اساس ترتیب الفبایی).

نمایش یا تنظیم وضعیت فعلی.

اگر هیچ وضعیتی مشخص نشود، وضعیت فعلی را نمایش می‌دهد.

اگر پیام وضعیتی مشخص شود، متغیرهای *message را بازنویسی خواهد کرد (این متغیرها را می‌توان در پرونده پیکربندی تنظیم کرد).

اگر متغیر *message مرتبطی تنظیم نشده باشد و هیچ پیام وضعیتی ارائه نشود، پیام وضعیت فعلی حفظ می‌شود.

اگر StatusMessage برابر «-» باشد، پیام وضعیت فعلی پاک می‌شود.

با دستور «/status message»، برنامه mcabber پیام را بدون تغییر وضعیت به‌روزرسانی می‌کند.

ارسال وضعیت درخواستی به کاربر جابر (Jabber) مشخص‌شده.

اگر شناسه jid مشخص‌شده برابر «.» باشد، از مخاطب جاری استفاده می‌شود.

نکته: این وضعیت توسط دستورهای بعدی «/status» لغو و بازنویسی خواهد شد. اگر از ویژگی غیبت خودکار (auto-away) استفاده می‌کنید، این وضعیت نیز بازنویسی خواهد شد.

نکته: شناسه jid می‌تواند شامل یک منبع باشد (یعنی user@server/resource).

/version

نمایش نسخه فعلی mcabber.

پیکربندی (CONFIGURATION FILE)

به پرونده پیکربندی نمونه ارائه‌شده مراجعه کنید که خودتوضیح‌دهنده است.

فایل‌ها (FILES)

پرونده‌های زیر می‌توانند توسط mcabber(1) مورد استفاده قرار گیرند:

$HOME/.mcabber/mcabberrc    پرونده پیکربندی پیش‌فرض
$HOME/.config/mcabber/mcabberrc مکان جایگزین (می‌تواند از XDG_CONFIG_HOME استفاده کند)
$HOME/.mcabberrc            پرونده پیکربندی مورد استفاده در صورت پیدا نشدن مورد دیگر
$HOME/.mcabber/histo/       دایرکتوری پیش‌فرض برای ذخیره پرونده‌های تاریخچه گفتگو، در صورت فعال بودن
/usr/share/mcabber/help/    دایرکتوری پیش‌فرض برای پرونده‌های راهنمای برخط
/usr/lib/mcabber/           دایرکتوری پیش‌فرض برای ماژول‌ها

اشکالات (BUGS)

مسلماً وجود دارند. اگر موردی پیدا کردید لطفاً به من اطلاع دهید! :-) لطفاً برای کسب اطلاعات درباره اتاق MUC و سامانه ردیابی اشکالات از وب‌سایت ما دیدن کنید.