'\" t
.\"     Title: mcabber
.\"    Author: Mikael BERTHE <mcabber@lilotux.net>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net>
.\"      Date: September 2020
.\"    Manual: \ \&
.\"    Source: \ \& 1.1.2
.\"  Language: Persian
.\"
.TH "MCABBER" "1" "سپتامبر 2020" "\ \& 1\&.1\&.2" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
mcabber \- کلاینت ساده کنسولی جابر (XMPP)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fImcabber\fR [ \-h | \-V | \-f configfile ]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور mcabber(1) یک کلاینت متنی و کوچک جابر (XMPP) برای کنسول است\&. در حال حاضر برای شروع کار به یک پرونده پیکربندی نیاز دارد، بنابراین لطفاً یک نسخه از نمونه پرونده mcabberrc را کپی کرده و تنظیمات اتصال خود را در آن اعمال کنید\&.
.sp
همچنین برای استفاده از این نرم‌افزار باید یک حساب کاربری از قبل موجود جابر داشته باشید، زیرا این برنامه هنوز قادر به ثبت‌نام یا حذف حساب‌های کاربری نیست\&.
.sp
در ادامه برخی از ویژگی‌های mcabber آورده شده است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIپشتیبانی از SASL/SSL/TLS\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIپشتیبانی از MUC\fR
(گفتگوی چندکاربره)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIپشتیبانی از PGP و OTR\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIوضعیت‌های گفتگو\fR
(اعلان‌های در حال نوشتن)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIثبت گزارش تاریخچه:\fR
اگر فعال باشد (بخش پرونده پیکربندی را ببینید)،
mcabber
می‌تواند گفتگوها را در پرونده‌های متنی گزارش تاریخچه ذخیره کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIتکمیل خودکار دستورات:\fR
در صورت امکان، اگر کلید Tab را فشار دهید،
mcabber
سعی خواهد کرد خط فرمان شما را تکمیل کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIتاریخچه خط ورودی:\fR
هر پیام یا دستور واردشده در تاریخچه خط ورودی قرار می‌گیرد و می‌توان به‌سادگی دوباره از آن استفاده کرد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIاقدامات خارجی:\fR
برخی رویدادها (مانند دریافت یک پیام) می‌توانند در صورت فعال‌سازی در پرونده پیکربندی، یک اقدام خارجی مانند یک اسکریپت شل را آغاز کنند\&. یک نمونه اسکریپت رویدادها ("eventcmd") همراه با کد منبع
mcabber
در دایرکتوری contrib ارائه شده است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIماژول‌ها:\fR
mcabber
می‌تواند ماژول‌ها (یا همان پلاگین‌ها) را در زمان اجرا بارگذاری کند تا ویژگی‌های آن گسترش یابد\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\-h
.RS 4
پیام خلاصه راهنمای نحوه استفاده
.RE
.PP
\-V
.RS 4
نمایش نسخه
mcabber
و تعاریف زمان کامپایل\&.
.RE
.PP
\-f configfile
.RS 4
استفاده از پرونده پیکربندی
\fIconfigfile\fR
.RE
.SH "پنجره‌ها/قاب‌ها (WINDOWS/PANES)"
.sp
صفحه نمایش mcabber(1) به ۴ ناحیه تقسیم شده است\&. \fIفهرست مخاطبان\fR، با نام دیگر \fIلیست دوستان\fR، در سمت چپ قرار دارد\&. \fIپنجره گفتگو\fR، یا بافر گفتگو، در سمت راست است\&. \fIخط ورودی\fR در پایین صفحه، زیر یک \fIپنجره گزارش\fR کوچک قرار دارد\&.
.sp
دو خط وضعیت پنجره گزارش را احاطه کرده‌اند\&. خط وضعیت پایینی "خط وضعیت اصلی" است و وضعیت کلی mcabber را نشان می‌دهد\&. خط دیگر "خط وضعیت گفتگو" است و وضعیت مخاطب انتخاب‌شده فعلی را نمایش می‌دهد\&.
.sp
برای نمایش بافرهای گفتگوی مخاطبان، باید وارد \fIحالت گفتگو\fR شوید\&. می‌توانید با فشردن کلید اینتر وارد حالت گفتگو شوید (مگر اینکه \fIحالت vi\fR فعال باشد)، و با کلید ESC از حالت گفتگو خارج شوید\&. صرفاً ارسال یک پیام نیز حالت گفتگو را فعال خواهد کرد (مگر اینکه \fIحالت vi\fR فعال باشد)\&.
.sp
پیاده‌سازی دومحیطه چندین مزیت دارد: نخست، قابلیت دقیق پیام‌های "خوانده‌نشده" را مطابق آنچه در بخش بعد شرح داده شده فراهم می‌آورد؛ بدون این ویژگی، صرف پیمایش روی یک مخاطب خاص موجب می‌شد پیام‌های جدید تمام مخاطبان این میان "خوانده‌شده" علامت بخورند\&. دوم، امکان پنهان‌سازی سریع گفتگو را با یک تک‌کلید فراهم می‌کند\&. سوم، امکان پرش میان مخاطبانی که در حال گفتگو با آن‌ها هستید را با دستور \fI/roster alternate\fR (که در بخش دیگری شرح داده شده) بدون نیاز به پیمایش دستی به جلو و عقب ممکن می‌سازد\&.
.SH "کلیدها (KEYS)"
.sp
نوشتن متن در \fIخط ورودی\fR انجام می‌شود؛ عملیات پایه‌ای پشتیبانی می‌شوند (کلید جهت‌نمای چپ، جهت‌نمای راست، کلیدهای Home/End، Insert، Delete، Backspace و غیره)\&.
.sp
کلیدهای PageUp و PageDown برای جابجایی در فهرست مخاطبان به کار می‌روند\&.
.sp
کلیدهای جهت‌نمای بالا و پایین برای جابجایی در تاریخچه خط ورودی استفاده می‌شوند؛ آن‌ها به خط قبلی/بعدی در تاریخچه که با همان رشته آغاز می‌شود (از ستون اول تا ستون مکان‌نما) پرش می‌کنند\&.
.sp
برای ارسال پیام، روی مخاطب انتخاب‌شده در فهرست دوستان بروید، پیام خود را تایپ کرده و اینتر را فشار دهید\&. اگر خط با یک اسلش آغاز شود، به عنوان یک دستور تفسیر خواهد شد (بخش دستورات را در ادامه ببینید)\&. کلید Escape را بزنید تا از حالت گفتگو خارج شوید\&.
.sp
در اینجا شرح کوتاهی از کلیدهای میانبر پیش‌فرض آمده است:
.PP
Esc
.RS 4
غیرفعال کردن حالت گفتگو
.RE
.PP
Ctrl\-a
.RS 4
رفتن به ابتدای خط ورودی
.RE
.PP
Ctrl\-e
.RS 4
رفتن به انتهای خط ورودی
.RE
.PP
Ctrl\-l
.RS 4
تازه‌سازی اجباری صفحه
.RE
.PP
Up/Down
.RS 4
جابجایی در تاریخچه خط ورودی
.RE
.PP
PgUp/PgDown
.RS 4
جابجایی درون فهرست مخاطبان (لیست دوستان)
.RE
.PP
Tab
.RS 4
تکمیل کلمه فعلی در خط ورودی
.RE
.PP
Ctrl\-g
.RS 4
لغو تکمیل خودکار
.RE
.PP
Ctrl\-c
.RS 4
انصراف از پیام‌های چندخطی و تکمیل‌ها
.RE
.PP
Ctrl\-d
.RS 4
ارسال/پایان دادن به یک پیام چندخطی
.RE
.PP
Ctrl\-p/Ctrl\-n
.RS 4
پیمایش نیم‌صفحه به بالا/پایین در پنجره بافر (حالت گفتگو)
.RE
.PP
Ctrl\-Left
.RS 4
انتقال مکان‌نما به ابتدای کلمه فعلی یا قبلی
.RE
.PP
Ctrl\-Right
.RS 4
انتقال مکان‌نما به انتهای کلمه فعلی یا بعدی
.RE
.PP
Ctrl\-u
.RS 4
حذف از ابتدای خط تا مکان‌نما
.RE
.PP
Ctrl\-k
.RS 4
حذف از مکان‌نما تا انتهای خط
.RE
.PP
Ctrl\-w
.RS 4
حذف کلمه به عقب (Backward kill word)
.RE
.PP
Ctrl\-t
.RS 4
جابجایی جای دو نویسه (Transpose chars)
.RE
.PP
Ctrl\-o
.RS 4
پذیرش خط جاری و قرار دادن خط بعدی تاریخچه در خط ورودی (accept\-line\-and\-down\-history)
.RE
.sp
کلیدهای میانبر دیگری را می‌توان با استفاده از دستور \fI/bind\fR که در بخش دستورات شرح داده شده است، تعیین کرد\&.
.SH "حالت VI (VI MODE)"
.sp
اگر گزینه "vi_mode" برابر با ۱ تنظیم شده باشد، mcabber(1) چند دستور را که تقریباً بر اساس دستورات موجود در حالت عادی vi(1) هستند می‌پذیرد\&. در این حالت، ورود به حالت گفتگو با فشردن اینتر انجام نمی‌شود، و پیام‌ها را نمی‌توان خارج از حالت گفتگو نوشت\&. دستورات زیر پذیرفته می‌شوند:
.PP
A
.RS 4
فراخوانی "/roster unread_first"\&.
.RE
.PP
a
.RS 4
فراخوانی "/roster unread_next"\&.
.RE
.PP
F
.RS 4
فراخوانی "/roster group_prev"\&.
.RE
.PP
f
.RS 4
فراخوانی "/roster group_next"\&.
.RE
.PP
G
.RS 4
فراخوانی "/roster bottom"\&.
.RE
.PP
gg
.RS 4
فراخوانی "/roster top"\&.
.RE
.PP
i
.RS 4
ورود به حالت گفتگو\&.
.RE
.PP
[N]j
.RS 4
فراخوانی "/roster down [N]"\&.
.RE
.PP
[N]k
.RS 4
فراخوانی "/roster up [N]"\&.
.RE
.PP
n
.RS 4
تکرار جستجوی قبلی (در صورت وجود)\&.
.RE
.PP
O
.RS 4
فراخوانی "/roster unread_first" و باز کردن پنجره گفتگو\&.
.RE
.PP
o
.RS 4
فراخوانی "/roster unread_next" و باز کردن پنجره گفتگو\&.
.RE
.PP
ZZ
.RS 4
فراخوانی "/quit"\&.
.RE
.PP
zM
.RS 4
فراخوانی "/group fold" برای همه گروه‌ها\&.
.RE
.PP
zR
.RS 4
فراخوانی "/group unfold" برای همه گروه‌ها\&.
.RE
.PP
\*(Aq\*(Aq
.RS 4
فراخوانی "/roster alternate"\&.
.RE
.PP
!
.RS 4
تغییر وضعیت پرچم توجه (attention) برای مخاطب جاری\&.
.RE
.PP
#
.RS 4
تغییر وضعیت پرچم پیام‌های خوانده‌نشده برای مخاطب جاری\&.
.RE
.PP
<Space>
.RS 4
فراخوانی "/group toggle" برای گروه جاری\&.
.RE
.sp
یک اسلش در ابتدای خط حالت جستجو را فعال می‌کند:
.PP
/string
.RS 4
فراخوانی "/roster search string"\&.
.RE
.sp
قرار دادن دونقطه در ابتدای خط حالت خط فرمان را فعال می‌کند:
.sp
.if n \{\
.RS 4
.\}
.nf
دستورات فوق)\&.
.fi
.if n \{\
.RE
.\}
.sp
دستوراتی که با یک دونقطه در ابتدا وارد می‌شوند و همچنین جستجوها با فشردن اینتر ثبت شده یا با زدن کلید Escape لغو می‌شوند\&. در هر دو حالت، mcabber(1) به حالت عادی (غیرگفتگو) بازمی‌گردد\&. ویرایش تاریخچه در حالت خط فرمان و حالت جستجو پشتیبانی می‌شود\&. در حالت خط فرمان، تکمیل خودکار با Tab نیز پشتیبانی می‌گردد\&.
.SH "فهرست مخاطبان MCABBER (MCABBER\(cqS ROSTER)"
.sp
نخستین مورد فهرست‌شده در فهرست مخاطبان، مورد \fI[status]\fR است که گزارش تمام رویدادهایی را که در پنجره گزارش کوتاه زیر بخش اصلی گفتگو ظاهر می‌شوند نگهداری می‌کند\&. در حالی که پنجره گزارش برای نمایش چند مورد اخیر طراحی شده بود، بافر اختصاصی \fI[status]\fR امکان مشاهده راحت‌تر گزارش و همچنین پیمایش آن به شیوه استاندارد را فراهم می‌سازد\&.
.sp
نام‌های گروه‌ها در بالای مواردی که درون آن‌ها هستند نمایش داده می‌شوند و با علامت \fI\-\-\-\fR در سمت چپ نام مشخص می‌گردند\&.
.sp
برای هر مخاطب واقعی جابر، فهرست مخاطبان چهار بخش اطلاعاتی را نمایش می‌دهد: نام یا نام مستعار مخاطب، وضعیت برخط بودن او، وضعیت مجوز او، و اینکه آیا پیام‌های خوانده‌نشده‌ای از سوی او در انتظار شماست یا خیر\&.
.sp
وضعیت برخط بودن یکی از موارد زیر است:
.PP
\fIo\fR
.RS 4
برخط (online)
.RE
.PP
\fIf\fR
.RS 4
آماده برای گفتگو (free for chat)
.RE
.PP
\fIa\fR
.RS 4
غایب (away)
.RE
.PP
\fIn\fR
.RS 4
در دسترس نیست (not available، در برخی کلاینت‌ها با برچسب
\fIغیبت طولانی (extended away)\fR
مشخص می‌شود)
.RE
.PP
\fId\fR
.RS 4
مزاحم نشوید (do not disturb)
.RE
.PP
\fI_\fR
.RS 4
آفلاین (یا نامرئی برای شما)
.RE
.PP
\fI?\fR
.RS 4
نامشخص، معمولاً به این معنی است که شما مجاز به دیدن وضعیت این مخاطب نیستید
.RE
.PP
\fIx\fR
.RS 4
اتاق کنفرانس که در آن شرکت ندارید
.RE
.PP
\fIC\fR
.RS 4
اتاق کنفرانس که در آن در حال شرکت هستید
.RE
.sp
وضعیت مجوز نشان می‌دهد که آیا مخاطب مجاز به دریافت به‌روزرسانی‌های وضعیت برخط شما هست یا خیر، و با براکت‌هایی که وضعیت برخط مخاطب را در بر گرفته‌اند نمایش داده می‌شود\&. براکت‌های چهارگوش مانند \fI[o]\fR نشان می‌دهند که این مخاطب مجاز به دریافت وضعیت شما است\&. ابروها (کروشه‌های مجعد) مانند \fI{o}\fR نشان می‌دهند که او مجاز به دریافت وضعیت شما نیست\&.
.sp
هنگامی که پیام‌های خوانده‌نشده‌ای از یک مخاطب وجود دارد که هنوز به آن‌ها نگاه نکرده‌اید، یک علامت هش (\fI#\fR) در سمت چپ‌ترین بخش فهرست مخاطبان برای آن مخاطب ظاهر می‌شود\&. به محض اینکه بافر پیام‌های آن مخاطب را مشاهده کنید، این علامت هش ناپدید می‌شود\&. هنگامی که توجه کاربر درخواست شود (یا زمانی که پیامی حاوی نام مستعار خود را در یک اتاق MUC دریافت کنید)، علامت هش با \fIعلامت توجه\fR یعنی علامت تعجب (\fI!\fR) جایگزین می‌شود\&.
.sp
مثال‌ها:
.PP
\*(Aq \-\-\- Buds\*(Aq
.RS 4
این یک گروه به نام
\fIBuds\fR
است
.RE
.PP
\fI#[o] John\fR
.RS 4
جان (John) برخط است، می‌تواند وضعیت شما را ببیند، و پیامی برای شما فرستاده که هنوز آن را نخوانده‌اید
.RE
.PP
\*(Aq {?} Sally\*(Aq
.RS 4
نه شما و نه Sally به یکدیگر مجوز مشاهده وضعیت برخط را نداده‌اید
.RE
.PP
\*(Aq {a} Jane\*(Aq
.RS 4
مخاطب Jane غایب (away) است، اما نمی‌تواند وضعیت برخط شما را ببیند
.RE
.PP
\fI#[C] x@y\&.c\fR
.RS 4
شما در حال شرکت در اتاق کنفرانس x@y\&.c هستید و پیام‌های خوانده‌نشده‌ای وجود دارد
.RE
.SH "دستورات (COMMANDS)"
.sp
لطفاً به راهنمای برخط (دستور /help) مراجعه فرمایید؛ احتمالاً از این صفحه راهنما به‌روزتر است\&. علاوه بر این، پرونده‌های راهنما به چندین زبان ترجمه شده‌اند\&. در این راهنما، خلاصه‌ای کلی از دستورات mcabber را خواهید یافت\&.
.SH "دستورات مرتبط با MCABBER (COMMANDS RELATED TO MCABBER)"
.PP
/add [jid [nickname]]
.RS 4
کاربر جابر با شناسه «jid» را به فهرست مخاطبان ما (گروه پیش‌فرض) اضافه کرده و یک درخواست آگاه‌سازی به این مخاطب ارسال می‌کند\&. اگر هیچ نام مستعاری مشخص نشده باشد، از همان jid استفاده می‌شود\&. اگر هیچ jid (یا رشته خالی "") ارائه نشود یا اگر jid برابر با «\&.» باشد، از مخاطب جاری استفاده می‌شود\&.
.PP
[\fIjid\fR [nickname]]
.RS 4
افزودن «jid» با نام مستعار «nickname» به فهرست مخاطبان ما
.sp
.if n \{\
.RS 4
.\}
.nf
مثال: "/add somebody@jabber\&.server\&.com Somebody"
.fi
.if n \{\
.RE
.\}
.RE
.RE
.PP
/alias [name [= command line]]
.RS 4
این دستور به شما امکان می‌دهد نام‌های مستعار (alias) اضافه کنید که می‌توانند دستورات پیچیده را ساده کنند\&.

شما می‌توانید نام‌های مستعار خود را با روش‌های زیر مدیریت کنید:
.PP
(بدون آرگومان)
.RS 4
چاپ فهرست نام‌های مستعار تعریف‌شده فعلی
.RE
.PP
\fIname\fR
.RS 4
چاپ مقدار نام مستعار با نام «name»
.RE
.PP
\fIname\fR=
.RS 4
لغو تعریف نام مستعار با نام «name»
.RE
.PP
\fIname\fR = command line
.RS 4
تنظیم نام مستعار با نام «name» با مقدار «command line»
.sp
.if n \{\
.RS 4
.\}
.nf
مثال: "/alias away = status away"
.fi
.if n \{\
.RE
.\}
.RE
.RE
.PP
/authorization allow|cancel|request|request_unsubscribe [jid]
.RS 4
این دستور اشتراک‌های وضعیت حضور (presence) را مدیریت می‌کند: به شما امکان می‌دهد اشتراک وضعیت حضور دیگران را در فهرست مخاطبان خود درخواست کنید و کنترل کنید چه کسانی اعلان‌های حضور شما را دریافت کنند\&.

اگر هیچ JID مشخص نشود، از مخاطب انتخاب‌شده فعلی استفاده می‌شود\&.
.PP
\fIallow\fR
.RS 4
اجازه به مخاطب برای دریافت به‌روزرسانی‌های وضعیت حضور شما
.RE
.PP
\fIcancel\fR
.RS 4
لغو اشتراک مخاطب در به‌روزرسانی‌های وضعیت حضور شما
.RE
.PP
\fIrequest\fR
.RS 4
درخواست اشتراک در به‌روزرسانی‌های وضعیت حضور مخاطب
.RE
.PP
\fIrequest_unsubscribe\fR
.RS 4
درخواست لغو اشتراک از به‌روزرسانی‌های وضعیت حضور مخاطب
.RE
.RE
.PP
/bind [keycode [= command line]]
.RS 4
انتساب دستور به کلیدی که به عنوان «keycode» مشخص شده است\&. برای بررسی اینکه در حال حاضر کدام کلیدها استفاده نشده‌اند، به پنجره گزارش (log)
mcabber
نگاه کنید و کلید مورد نظر را فشار دهید\&. برای مثال: "Unknown key=265" به این معنی است که می‌توانید دستوری را به کلید شماره ۲۶۵ متصل کنید\&.
.PP
(بدون آرگومان)
.RS 4
نمایش فهرست کلیدهای مقیدشده فعلی
.RE
.PP
\fIkeycode\fR
.RS 4
نمایش خط فرمانی که به این کلید متصل شده است
.RE
.PP
\fIkeycode\fR=
.RS 4
لغو انتساب کلید با کد «keycode»
.RE
.PP
\fIkeycode\fR = command line
.RS 4
اتصال «command line» به کلید با کد «keycode»
.sp
.if n \{\
.RS 4
.\}
.nf
مثال: "/bind 265 = status away" (کلید 265 همان F1 است)\&. +
نکته: کدهای کلید بسته به پیکربندی ncurses شما می‌توانند متفاوت باشند\&. +
ترفند: همچنین می‌توان به جای دستورات از نام‌های مستعار (alias) استفاده کرد\&.
.fi
.if n \{\
.RE
.\}
.RE
.RE
.PP
/buffer clear|close|close_all|purge|list, /buffer top|bottom|date|%|search_backward|search_forward, /buffer scroll_lock|scroll_unlock|scroll_toggle, /buffer save filename
.RS 4
دستور دستکاری بافر مخاطب\&. به عنوان مثال، می‌توانید در بافر به دنبال «text» بگردید، پنجره گفتگو را پاک کنید و غیره\&.
.PP
\fIclear\fR
.RS 4
پاک کردن پنجره گفتگوی مخاطب جاری
.RE
.PP
\fIclose\fR [jid]
.RS 4
خالی کردن تمام محتویات بافر و بستن پنجره گفتگوی مخاطب جاری
.RE
.PP
\fIclose_all\fR
.RS 4
خالی کردن تمام محتویات بافرهای گفتگو و بستن پنجره‌های گفتگو
.RE
.PP
\fIpurge\fR [jid]
.RS 4
پاک کردن پنجره گفتگوی مخاطب جاری و خالی کردن تمام محتویات بافر گفتگو
.RE
.PP
\fIlist\fR
.RS 4
نمایش فهرست بافرهای موجود همراه با طول آن‌ها (خطوط/بلوک‌ها)
.RE
.PP
\fItop\fR
.RS 4
پرش به ابتدای بافر گفتگوی مخاطب جاری
.RE
.PP
\fIbottom\fR
.RS 4
پرش به انتهای بافر گفتگوی مخاطب جاری
.RE
.PP
\fIup\fR [n]
.RS 4
پیمایش بافر به بالا به میزان [n] خط (پیش‌فرض: نیم‌صفحه)
.RE
.PP
\fIdown\fR [n]
.RS 4
پیمایش بافر به پایین به میزان [n] خط (پیش‌فرض: نیم‌صفحه)
.RE
.PP
\fIdate\fR [date]
.RS 4
پرش به نخستین خط پس از [date] مشخص‌شده در بافر گفتگو (قالب تاریخ: "YYYY\-mm\-dd")
.RE
.PP
% n
.RS 4
پرش به موقعیت %n از بافر گفتگوی مخاطب
.RE
.PP
\fIsearch_backward\fR text
.RS 4
جستجو برای [text] به سمت عقب در بافر گفتگوی مخاطب جاری
.RE
.PP
\fIsearch_forward\fR text
.RS 4
جستجو برای [text] به سمت جلو در بافر گفتگوی مخاطب جاری
.RE
.PP
\fIscroll_lock\fR
.RS 4
قفل کردن پیمایش بافر
.RE
.PP
\fIscroll_unlock\fR
.RS 4
باز کردن قفل پیمایش بافر
.RE
.PP
\fIscroll_toggle\fR
.RS 4
تغییر وضعیت قفل پیمایش بافر (قفل/باز)
.RE
.PP
\fIsave\fR filename
.RS 4
ذخیره محتویات بافر جاری در پرونده «filename»
.RE
.RE
.PP
/chat_disable [\-\-show\-roster]
.RS 4
غیرفعال کردن حالت گفتگو\&.

با گزینه \-\-show\-roster، حالت تمام‌صفحه غیرفعال خواهد شد\&.
.RE
.PP
/clear
.RS 4
این دستور در واقع یک نام مستعار برای "/buffer clear" است\&. این دستور پنجره گفتگوی مخاطب جاری را پاک می‌کند\&.
.RE
.PP
/color roster (status wildcard (color|\-)|clear), /color mucnick nick (color|\-), /color muc (jid|\&.|*) [on|preset|off|\-]
.RS 4
دستور
\fIcolor\fR
امکان تنظیم ویژگی‌های رنگ پویای صفحه نمایش را فراهم می‌کند\&.
.PP
\fIroster\fR clear
.RS 4
حذف تمام قوانین رنگ برای فهرست مخاطبان\&. همه موارد فهرست مخاطبان رنگ پیش‌فرض خود را دریافت خواهند کرد\&.
.RE
.PP
\fIroster\fR status wildcard color
.RS 4
تنظیم یک قانون رنگ (یا بازنویسی در صورت وجود قبلی)\&. مقدار status رشته‌ای شامل تمام وضعیت‌هایی است که مورد فهرست مخاطبان می‌تواند برای تطابق قانون داشته باشد، یا علامت * اگر هر وضعیتی قابل قبول باشد\&. آرگومان wildcard الگوی تطبیق فایلی است که روی JID اعمال خواهد شد\&. آرگومان color رنگ مورد نظر است\&. اگر color برابر با \- باشد، قانون حذف می‌شود\&. اگر بیش از یک قانون تطابق داشته باشد، رنگ آخرین قانون ایجادشده (بازنویسی‌نشده) استفاده می‌شود\&.
.RE
.PP
\fImucnick\fR nick (color|\-)
.RS 4
علامت‌گذاری نام مستعار برای رنگ‌آمیزی با رنگ داده‌شده\&. اگر یک MUC دارای نام‌های مستعار رنگی باشد، از این رنگ استفاده خواهد شد\&. اگر color برابر با \- باشد، رنگ به عنوان انتخاب خودکار علامت‌گذاری می‌شود، به این معنی که در حالت رنگ‌آمیزی
\fIpreset\fR
استفاده نخواهد شد، اما در حالت رنگ‌آمیزی
\fIon\fR
یکسان باقی خواهد ماند\&.
.RE
.PP
\fImuc\fR (jid|\&.|*) [on|preset|off|\-]
.RS 4
حالت رنگ‌آمیزی نام مستعار MUC را تنظیم می‌کند\&. اگر یک jid ارائه شود (علامت \&. به معنای jid انتخاب‌شده فعلی است)، حالت برای این MUC خاص اعمال می‌شود\&. اگر از * استفاده شود، برای همه MUCها اعمال خواهد شد، به جز مواردی که با jid اختصاصی خود تنظیم شده‌اند\&. حالت
\fIon\fR
تمام نام‌های مستعار را رنگ‌آمیزی می‌کند، حالت
\fIpreset\fR
فقط مواردی را که به صورت دستی توسط دستور /color mucnick تنظیم شده‌اند رنگ‌آمیزی می‌کند و حالت
\fIoff\fR
هیچ‌کدام را رنگ‌آمیزی نمی‌کند\&. اگر مشخص نشود، مقدار پیش‌فرض
\fIon\fR
است\&. حالت
\fI\-\fR
حالت را از JID داده‌شده حذف می‌کند، به این معنی که حالت سراسری اعمال خواهد شد\&. شما نمی‌توانید حالت سراسری را حذف کنید\&. حالت پیش‌فرض رنگ‌آمیزی سراسری
\fIoff\fR
است\&.
.RE
.RE
.PP
/connect
.RS 4
برقراری اتصال به کارساز جابر\&.
.RE
.PP
/del
.RS 4
حذف مخاطب جاری از فهرست مخاطبان ما، لغو اشتراک از اعلان‌های حضور آن و لغو اشتراک آن از اعلان‌های حضور ما\&.
.RE
.PP
/disconnect
.RS 4
قطع اتصال با کارساز جابر\&.

نکته: فهرست مخاطبان فقط زمانی در دسترس است که اتصال به کارساز فعال باشد، بنابراین هنگام قطع اتصال، فهرست مخاطبان خالی است\&.
.RE
.PP
/echo message
.RS 4
نمایش «message» در پنجره گزارش (log)\&.
.RE
.PP
/event #n|* accept|ignore|reject [event\-specific arguments], /event list
.RS 4
تعیین نحوه برخورد mcabber با رویدادهای در انتظار\&.

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

آرگومان‌های ویژه رویداد بر اساس هر رویداد تفسیر خواهند شد\&. تنها مورد توکار که در آن آرگومان استفاده می‌شود، رد دعوت MUC است \- در صورت وجود، آرگومان به عنوان دلیل رد تلقی خواهد شد\&.
.PP
#N|* accept [event\-specific arguments]
.RS 4
رویداد شماره #N/همه رویدادها پذیرفته خواهند شد
.RE
.PP
#N|* ignore [event\-specific arguments]
.RS 4
رویداد شماره #N/همه رویدادها نادیده گرفته خواهند شد
.RE
.PP
#N|* reject [event\-specific arguments]
.RS 4
رویداد شماره #N/همه رویدادها رد خواهند شد
.RE
.PP
\fIlist\fR
.RS 4
فهرست کردن تمام رویدادهای در انتظار
.RE
.RE
.PP
/group fold|unfold|toggle [groupname]
.RS 4
این دستور نحوه نمایش گروه جاری را تغییر می‌دهد\&.
.PP
\fIfold\fR [groupname]
.RS 4
جمع کردن (بستن) درخت گروه جاری/مشخص‌شده در فهرست مخاطبان
.RE
.PP
\fIunfold\fR [groupname]
.RS 4
باز کردن (گسترش) درخت گروه جاری/مشخص‌شده در فهرست مخاطبان
.RE
.PP
\fItoggle\fR [groupname]
.RS 4
تغییر وضعیت (جمع/باز) درخت گروه جاری/مشخص‌شده
.RE
.RE
.PP
/help [command|+topic]
.RS 4
نمایش راهنما برای دستور «command» یا موضوع «topic»\&.

مثال: "/help buffer"
.RE
.PP
/iline fchar|bchar|char_fdel|char_bdel|char_swap, /iline fword|bword|word_bdel|word_fdel, /iline word_upcase|word_downcase|word_capit, /iline hist_beginning_search_bwd|hist_beginning_search_fwd, /iline hist_prev|hist_next, /iline iline_start|iline_end|iline_fdel|iline_bdel, /iline iline_accept|iline_accept_down_hist, /iline compl_do|compl_cancel, /iline send_multiline
.RS 4
دستورات خط ورودی
.PP
\fIfchar\fR
.RS 4
حرکت به نویسه بعدی
.RE
.PP
\fIbchar\fR
.RS 4
حرکت به نویسه قبلی
.RE
.PP
\fIchar_fdel\fR
.RS 4
حذف نویسه در موقعیت مکان‌نما
.RE
.PP
\fIchar_bdel\fR
.RS 4
حذف نویسه قبل از موقعیت مکان‌نما
.RE
.PP
\fIchar_swap\fR
.RS 4
جابجایی نویسه‌ها
.RE
.PP
\fIfword\fR
.RS 4
حرکت مکان‌نما به سمت جلو به انتهای کلمه جاری یا بعدی
.RE
.PP
\fIbword\fR
.RS 4
حرکت مکان‌نما به سمت عقب به ابتدای کلمه جاری یا قبلی
.RE
.PP
\fIword_bdel\fR
.RS 4
حذف کلمه از موقعیت مکان‌نما تا ابتدای آن
.RE
.PP
\fIword_fdel\fR
.RS 4
حذف کلمه از موقعیت مکان‌نما تا انتهای آن
.RE
.PP
\fIword_upcase\fR
.RS 4
تبدیل کلمه از موقعیت مکان‌نما تا انتهای آن به حروف بزرگ
.RE
.PP
\fIword_downcase\fR
.RS 4
تبدیل کلمه از موقعیت مکان‌نما تا انتهای آن به حروف کوچک
.RE
.PP
\fIword_capit\fR
.RS 4
بزرگ کردن حرف اول کلمه از موقعیت مکان‌نما تا انتهای آن
.RE
.PP
\fIhist_beginning_search_bwd\fR
.RS 4
جستجو به سمت عقب در تاریخچه برای خطی که با خط جاری تا موقعیت مکان‌نما آغاز می‌شود (این کار مکان‌نما را در موقعیت اولیه خود باقی می‌گذارد)
.RE
.PP
\fIhist_beginning_search_fwd\fR
.RS 4
جستجو به سمت جلو در تاریخچه برای خطی که با خط جاری تا موقعیت مکان‌نما آغاز می‌شود (این کار مکان‌نما را در موقعیت اولیه خود باقی می‌گذارد)
.RE
.PP
\fIhist_prev\fR
.RS 4
خط قبلی در تاریخچه خط ورودی
.RE
.PP
\fIhist_next\fR
.RS 4
خط بعدی در تاریخچه خط ورودی
.RE
.PP
\fIiline_start\fR
.RS 4
رفتن به ابتدای خط ورودی
.RE
.PP
\fIiline_end\fR
.RS 4
رفتن به انتهای خط ورودی
.RE
.PP
\fIiline_fdel\fR
.RS 4
حذف از موقعیت مکان‌نما تا انتهای خط
.RE
.PP
\fIiline_bdel\fR
.RS 4
حذف از ابتدای خط تا موقعیت مکان‌نما
.RE
.PP
\fIiline_accept\fR
.RS 4
پذیرش خط
.RE
.PP
\fIiline_accept_down_hist\fR
.RS 4
پذیرش خط و قرار دادن خط بعدی تاریخچه در خط ورودی
.RE
.PP
\fIcompl_do\fR
.RS 4
تکمیل کلمه فعلی در خط ورودی
.RE
.PP
\fIcompl_cancel\fR
.RS 4
لغو تکمیل خودکار
.RE
.PP
\fIsend_multiline\fR
.RS 4
ارسال/پایان دادن به یک پیام چندخطی
.RE
.RE
.PP
/info
.RS 4
نمایش اطلاعات درباره مدخل انتخاب‌شده (کاربر، عامل، گروه و...)\&.

برای کاربران، منابع به همراه وضعیت، اولویت و پیام وضعیت هر منبع (در صورت وجود) نمایش داده می‌شوند\&.
.RE
.PP
/module load|unload [\-f] module, /module info module, /module [list]
.RS 4
بارگذاری، تخلیه یا نمایش اطلاعات مربوط به ماژول\&.
.PP
\fIload\fR [\-f] module
.RS 4
ماژول مشخص‌شده را بارگذاری می‌کند\&. اگر فلگ \-f مشخص شده باشد، از بیشتر خطاهای بارگذاری ماژول صرف‌نظر خواهد شد\&.
.RE
.PP
\fIunload\fR [\-f] module
.RS 4
ماژول مشخص‌شده را تخلیه می‌کند\&. توجه: فلگ اجبار (force) هیچ‌یک از وابستگی‌های وابسته به این ماژول را حذف نخواهد کرد!
.RE
.PP
\fIinfo\fR module
.RS 4
اطلاعات موجود درباره این ماژول را نمایش می‌دهد\&.
.RE
.PP
[\fIlist\fR]
.RS 4
ماژول‌ها را در قالبی با این ساختار فهرست می‌کند: [نام ماژول] [تعداد ارجاع] ([بارگذاری دستی/خودکار]) [هرگونه اطلاعات اضافی مانند نسخه یا وابستگی‌ها]
.RE
.RE
.PP
/move [groupname]
.RS 4
انتقال مخاطب جاری به گروه درخواستی\&. اگر گروهی مشخص نشود، مخاطب به گروه پیش‌فرض منتقل می‌شود\&. اگر گروه "groupname" وجود نداشته باشد، ایجاد خواهد شد\&.

نکته: در صورت فعال بودن حالت گفتگو (chatmode)، می‌توانید با دستور "/roster alternate" به مخاطب منتقل‌شده پرش کنید\&.
.RE
.PP
/msay begin|verbatim|send|send_to|toggle|toggle_verbatim|abort
.RS 4
ارسال یک پیام چندخطی\&. برای نوشتن یک پیام واحد در چندین خط، باید از
\fIحالت چندخطی (multi\-line mode)\fR
استفاده شود\&.

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

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

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

زیردستور
\fItoggle\fR
می‌تواند به یک کلید مقید شود تا استفاده سریع از حالت چندخطی میسر گردد (به عنوان مثال، "bind M13 = msay toggle" برای جابه‌جایی با استفاده از ترکیب کلیدهای Meta\-Enter)\&.
.PP
\fIbegin\fR [subject]
.RS 4
ورود به حالت چندخطی
.RE
.PP
\fIverbatim\fR
.RS 4
ورود به حالت چندخطی عینی (verbatim)
.RE
.PP
\fIsend\fR [\-n|\-h]
.RS 4
ارسال پیام چندخطی جاری به مخاطب انتخاب‌شده فعلی
.RE
.PP
\fIsend_to\fR [\-n|\-h] jid
.RS 4
ارسال پیام چندخطی جاری به "jid"
.RE
.PP
\fItoggle\fR|\fItoggle_verbatim\fR
.RS 4
جابه‌جایی به/از حالت چندخطی (begin/send)
.RE
.PP
\fIabort\fR
.RS 4
خروج از حالت چندخطی بدون ارسال پیام
.sp
.if n \{\
.RS 4
.\}
.nf
فلگ‌های \-n یا \-h در مقایسه با پیام پیش‌فرض "chat"، نوع پیام را به ترتیب به "normal" یا "headline" تغییر می‌دهند\&.
.fi
.if n \{\
.RE
.\}
.RE
.RE
.PP
/otr key, /otr start|stop|info [jid], /otr fingerprint [jid [fpr]], /otr smpq|smpr [jid] secret, /otr smpa [jid]
.RS 4
می‌توانید از شناسه میانبر "\&." برای مخاطب انتخاب‌شده فعلی استفاده کنید\&.
.PP
\fIkey\fR
.RS 4
چاپ اثرانگشت کلید خصوصی شما در بافر وضعیت (Status Buffer)
.RE
.PP
\fIstart\fR [jid]
.RS 4
باز کردن یک کانال OTR به jid مشخص‌شده (یا مخاطب انتخاب‌شده فعلی)
.RE
.PP
\fIstop\fR [jid]
.RS 4
بستن کانال OTR با jid مشخص‌شده (یا مخاطب انتخاب‌شده فعلی)
.RE
.PP
\fIinfo\fR [jid]
.RS 4
نمایش وضعیت جاری OTR برای jid مشخص‌شده (یا مخاطب انتخاب‌شده فعلی)
.RE
.PP
\fIfingerprint\fR [jid [fpr]]
.RS 4
نمایش اثرانگشت فعال یک کانال OTR\&. اگر اثرانگشت به جای "fpr" ارائه شود، آن اثرانگشت مورد اعتماد (trusted) خواهد شد\&. اگر "fpr" را با یک رشته ساختگی جایگزین کنید، اثرانگشت وضعیت مورد اعتماد بودن خود را از دست خواهد داد\&.
.RE
.PP
\fIsmpq\fR [jid] secret
.RS 4
آغاز پروتکل میلیونرهای سوسیالیست (SMP) با عبارت محرمانه و مخاطب
.RE
.PP
\fIsmpr\fR [jid] secret
.RS 4
پاسخ به درخواست آغاز پروتکل از سوی jid با عبارت محرمانه
.RE
.PP
\fIsmpa\fR [jid]
.RS 4
لغو پروتکل در حال اجرای میلیونرهای سوسیالیست
.RE
.RE
.PP
/otrpolicy, /otrpolicy (default|jid) (plain|manual|opportunistic|always)
.RS 4
می‌توانید از شناسه میانبر "\&." برای مخاطب انتخاب‌شده فعلی استفاده کنید\&.
.PP
(بدون شناسه)
.RS 4
چاپ تمام سیاست‌های OTR در بافر وضعیت
.RE
.PP
(\fIdefault\fR|\fIjid\fR) (plain|manual|opportunistic|always)
.RS 4
سیاست پیش‌فرض یا سیاست مربوط به jid داده‌شده را تنظیم می‌کند\&. از سیاست plain هرگز نباید استفاده شود، زیرا قادر به دریافت یا ارسال هیچ پیام رمزگذاری‌شده با OTR نخواهید بود\&. اگر سیاست را روی manual تنظیم کنید، شما یا طرف گفتگوی شما باید رمزگذاری OTR را به‌صورت دستی آغاز کنید (مثلاً با دستور /otr start)\&. سیاست "opportunistic" این کار را خودبه‌خود با ارسال یک دنباله فاصله خالی (whitespace) ویژه در انتهای پیام‌های رمزگذاری‌نشده انجام می‌دهد؛ بنابراین کلاینت گفتگوی دیگر با قابلیت OTR متوجه می‌شود که شما مایل به استفاده از OTR هستید\&. توجه داشته باشید که در صورت استفاده از این سیاست، نخستین پیام همیشه رمزگذاری‌نشده خواهد بود\&. با سیاست "always"، هیچ پیامی به‌صورت متن ساده (plain text) ارسال نخواهد شد\&. اگر تلاش کنید نخستین پیام را به‌صورت رمزگذاری‌نشده بفرستید، mcabber برای برقراری یک کانال OTR تلاش خواهد کرد\&. لطفاً پس از دریافت اطلاع از برقراری کانال، پیام خود را دوباره ارسال کنید\&. اگر زمانی که سیاست روی "always" تنظیم شده است کسی پیامی با متن ساده برای شما ارسال کند، قادر به خواندن پیام خواهید بود اما در تاریخچه ذخیره نخواهد شد\&.
.RE
.RE
.PP
/pgp disable|enable|force|info [jid], /pgp setkey [jid [key]]
.RS 4
این دستور تنظیمات PGP را برای jid مشخص‌شده (به‌طور پیش‌فرض مخاطب انتخاب‌شده فعلی) دستکاری می‌کند\&.

لطفاً توجه داشته باشید که اگر پشتیبانی از PGP در طرف مقابل شناسایی نشود، حتی در صورت فعال بودن PGP با این دستور، از رمزگذاری PGP استفاده نخواهد شد\&. با زیردستور "force" می‌توانید رمزگذاری PGP را اجباری کنید\&.
.PP
\fIdisable\fR [jid]
.RS 4
غیرفعال کردن رمزگذاری PGP برای jid (یا مخاطب انتخاب‌شده فعلی)
.RE
.PP
\fIenable\fR [jid]
.RS 4
فعال کردن رمزگذاری PGP برای jid (یا مخاطب انتخاب‌شده فعلی)
.RE
.PP
\fIforce\fR [jid]
.RS 4
اجباری کردن رمزگذاری PGP، حتی برای پیام‌های برون‌خط، و فرض همیشگی بر اینکه گیرنده از PGP پشتیبانی می‌کند\&. اگر پیامی نتواند رمزگذاری شود (به دلیل نبود کلید یا شناسه کلید)، پیام‌ها اصلاً ارسال نخواهند شد\&. زمانی که PGP غیرفعال باشد، این گزینه نادیده گرفته می‌شود\&.
.RE
.PP
\fIinfo\fR [jid]
.RS 4
نمایش تنظیمات جاری PGP برای مخاطب
.RE
.PP
\fIsetkey\fR [jid [key]]
.RS 4
تنظیم کلید PGP مورد استفاده برای رمزگذاری پیام‌ها جهت این مخاطب\&. اگر کلیدی ارائه نشود، کلید فعلی پاک می‌شود\&. می‌توانید از شناسه میانبر "\&." برای مخاطب انتخاب‌شده فعلی استفاده کنید\&.
.RE
.RE
.PP
/quit
.RS 4
این دستور تمام اتصالات را می‌بندد و از mcabber خارج می‌شود\&.
.RE
.PP
/rawxml send string
.RS 4
ارسال "string" (قالب خام XML) به سرور جابر (Jabber)\&.

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

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

مثال: "/rawxml send <presence><show>away</show></presence>"
.RE
.PP
/rename name
.RS 4
تغییر نام مخاطب یا گروه جاری به "name" مشخص‌شده\&. اگر "name" برابر با \- باشد، نام از فهرست مخاطبان حذف می‌شود (و mcabber شناسه JID یا نام کاربری را نمایش خواهد داد)\&.
.RE
.PP
/request last|ping|time|vcard|version [jid]
.RS 4
ارسال یک پرس‌وجوی "IQ" به مخاطب جاری یا به کاربر جابر مشخص‌شده\&. اگر منبع به همراه jid ارائه نشود، mcabber پرس‌وجو را به تمام منابع شناخته‌شده برای این کاربر ارسال خواهد کرد\&.
.PP
\fIlast\fR
.RS 4
درخواست اطلاعات "last" (معمولاً زمان بیکاری)
.RE
.PP
\fIping\fR
.RS 4
ارسال یک درخواست پینگ XMPP\&. توجه داشته باشید که باید از JID کامل استفاده کنید، زیرا پینگ ارسالی به یک JID ساده (bare JID) توسط سرور مدیریت و پاسخ داده می‌شود\&.
.RE
.PP
\fItime\fR
.RS 4
درخواست زمان از مخاطب
.RE
.PP
\fIvcard\fR
.RS 4
درخواست VCard از مخاطب
.RE
.PP
\fIversion\fR
.RS 4
درخواست نسخه از مخاطب
.RE
.RE
.PP
/room join|leave|names|nick|remove|topic|unlock|destroy, /room privmsg|invite|whois|kick|ban|unban|role|affil, /room setopt print_status|auto_whois [value], /room bookmark [add|del] [\-autojoin|+autojoin] [\-|nick]
.RS 4
دستور
\fIroom\fR
اقدامات مربوط به اتاق گفتگوی چندکاربره (MUC) را مدیریت می‌کند\&.
.PP
\fIjoin\fR [room [nick [pass]]]
.RS 4
پیوستن به "room" با استفاده از "nick" به عنوان نام مستعار\&. اگر نام مستعاری مشخص نشود (یا یک رشته خالی باشد)، از مقدار گزینه "nickname" استفاده می‌شود (به پرونده پیکربندی نمونه مراجعه کنید)\&. اگر مدخل انتخاب‌شده فعلی توسط mcabber به‌درستی به‌عنوان یک اتاق شناسایی شود، می‌توان از شناسه میانبر "\&." به‌جای شناسه کامل اتاق استفاده کرد\&. برای ورود به اتاق‌های محافظت‌شده می‌توان گذرواژه ارائه داد\&. اگر نام مستعار شما شامل کاراکترهای فاصله است، از علامت نقل‌قول استفاده کنید\&.
.RE
.PP
\fIleave\fR [message]
.RS 4
ترک کردن اتاق جاری
.RE
.PP
\fInames\fR [\-\-detail|\-\-short|\-\-quiet|\-\-compact]
.RS 4
نمایش اعضای اتاق جاری
.RE
.PP
\fInick\fR newnick
.RS 4
تغییر نام مستعار خود در اتاق جاری
.RE
.PP
\fIprivmsg\fR nick msg
.RS 4
ارسال پیام خصوصی "msg" به "nick"
.RE
.PP
\fIremove\fR
.RS 4
حذف اتاق جاری از فهرست مخاطبان (باید قبلاً از این اتاق خارج شده باشید)
.RE
.PP
\fItopic\fR \-|newtopic
.RS 4
تنظیم موضوع برای اتاق جاری
.RE
.PP
\fIunlock\fR
.RS 4
باز کردن قفل اتاق جاری (اگر مالک آن باشید)
.RE
.PP
\fIdestroy\fR [reason]
.RS 4
نابود کردن اتاق جاری (با احتیاط استفاده کنید!)
.RE
.PP
\fIwhois\fR nick
.RS 4
نمایش اطلاعات MUC درباره "nick"
.RE
.PP
\fIban\fR jid [reason]
.RS 4
مسدود کردن jid از اتاق جاری
.RE
.PP
\fIunban\fR jid
.RS 4
رفع مسدودیت jid از اتاق جاری
.RE
.PP
\fIinvite\fR jid [reason]
.RS 4
دعوت از jid به اتاق جاری
.RE
.PP
\fIkick\fR nick [reason]
.RS 4
اخراج "nick" از اتاق جاری
.RE
.PP
\fIrole\fR nick role [reason]
.RS 4
تغییر نقش nick (نقش می‌تواند "none"، "visitor"، "participant" یا "moderator" باشد)
.RE
.PP
\fIaffil\fR jid affil [reason]
.RS 4
تغییر وابستگی (affiliation) مربوط به jid (وابستگی می‌تواند "none"، "member"، "admin" یا "owner" باشد)
.RE
.PP
\fIsetopt\fR print_status|auto_whois [value]
.RS 4
تغییر تنظیمات برای اتاق جاری\&. برای print_status، مقادیر ممکن عبارتند از "default"، "none"، "in_and_out" و "all"\&. برای auto_whois، مقادیر ممکن عبارتند از "default"، "off" و "on"\&. زمانی که مقدار "default" باشد، از گزینه‌های muc_print_status / muc_auto_whois استفاده می‌شود\&.
.RE
.PP
\fIbookmark\fR [add|del] [\-autojoin|+autojoin] [\-|nick]
.RS 4
افزودن، حذف یا به‌روزرسانی یک نشانک (پیش‌فرض add است)\&. در صورت تنظیم بودن autojoin، برنامه mcabber هنگام اتصال به سرور به‌طور خودکار به اتاق MUC می‌پیوندد\&. برای مشاهده فهرست نشانک‌ها، از دستور /room bookmark در بافر وضعیت استفاده کنید\&.
.RE
.RE.PP
/roster bottom|top|up|down|group_prev|group_next, /roster alternate|unread_first|unread_next, /roster search bud, /roster display|hide_offline|show_offline|toggle_offline, /roster item_lock|item_unlock|item_toggle_lock, /roster hide|show|toggle, /roster note [\-|text]
.RS 4
دستور
\fIroster\fR
فهرست مخاطبان (roster/buddylist) را مدیریت و دستکاری می‌کند\&.

پارامترهای موجود به شرح زیر هستند:
.PP
\fIbottom\fR
.RS 4
پرش به انتهای فهرست مخاطبان
.RE
.PP
\fItop\fR
.RS 4
پرش به ابتدای فهرست مخاطبان
.RE
.PP
\fIup\fR [n]
.RS 4
حرکت به بالا [به تعداد n سطر] در فهرست مخاطبان
.RE
.PP
\fIdown\fR [n]
.RS 4
حرکت به پایین [به تعداد n سطر] در فهرست مخاطبان
.RE
.PP
\fIgroup_prev\fR
.RS 4
پرش به گروه قبلی در فهرست مخاطبان
.RE
.PP
\fIgroup_next\fR
.RS 4
پرش به گروه بعدی در فهرست مخاطبان
.RE
.PP
\fIalternate\fR
.RS 4
پرش به مخاطب جایگزین\&. مخاطب «جایگزین» آخرین مخاطبی است که هنگام حضور در حالت گفتگو ترک شده است\&. بنابراین این دستور به‌ویژه پس از دستورهایی مانند «/roster unread_next» (کلید Ctrl\-q) مفید است\&.
.RE
.PP
\fIunread_first\fR
.RS 4
پرش به نخستین پیام خوانده‌نشده
.RE
.PP
\fIunread_next\fR
.RS 4
پرش به پیام خوانده‌نشده بعدی
.RE
.PP
\fIsearch\fR bud
.RS 4
جستجو برای مخاطبی با نام یا شناسه jid حاوی «bud» (تنها در فهرست مخاطبانِ نمایش‌یافته)
.RE
.PP
\fIdisplay\fR [mask]
.RS 4
مشاهده یا به‌روزرسانی فیلتر فهرست مخاطبان\&. ماسک باید حاوی حروف اختصاری وضعیت‌هایی باشد که می‌خواهید ببینید ([o]nline،‏ [f]ree_for_chat،‏ [d]o_not_disturb،‏ [n]ot_available،‏ [a]way،‏ [_]offline)\&. برای نمونه «ofdna» برای نمایش تنها مخاطبان متصل\&.
.RE
.PP
\fIhide_offline\fR
.RS 4
پنهان کردن مخاطبان برون‌خط (مشابه /roster display ofdna)
.RE
.PP
\fIshow_offline\fR
.RS 4
نمایش مخاطبان برون‌خط (مشابه /roster display ofdna_)
.RE
.PP
\fItoggle_offline\fR
.RS 4
تغییر وضعیت نمایش مخاطبان برون‌خط
.RE
.PP
\fIitem_lock\fR [jid]
.RS 4
قفل کردن آیتم فهرست مخاطبان تا بدون در نظر گرفتن وضعیتش، همواره نمایان باقی بماند
.RE
.PP
\fIitem_unlock\fR [jid]
.RS 4
لغو اثر دستور item_lock
.RE
.PP
\fIitem_toggle_lock\fR [jid]
.RS 4
معکوس کردن پرچم قفل فعلی
.RE
.PP
\fIhide\fR
.RS 4
پنهان کردن فهرست مخاطبان (پنجره گفتگوی تمام‌عرض)
.RE
.PP
\fIshow\fR
.RS 4
نمایش فهرست مخاطبان
.RE
.PP
\fItoggle\fR
.RS 4
تغییر وضعیت نمایانی فهرست مخاطبان
.RE
.PP
\fInote\fR [\-|text]
.RS 4
تنظیم/به‌روزرسانی/حذف یک یادداشت\&. اگر متنی مشخص نشود، یادداشت آیتم جاری نمایش داده می‌شود \(em اگر در بافر وضعیت باشید، همه یادداشت‌ها نمایش داده می‌شوند\&. اگر متن «\-» باشد، یادداشت پاک می‌شود\&.
.RE
.RE
.PP
/say [\-n|\-h|\-\-] text
.RS 4
ارسال پیام «text» به مخاطب انتخاب‌شده فعلی\&. برای نمونه اگر بخواهید پیامی را ارسال کنید که با یک اسلش آغاز می‌شود، می‌تواند مفید باشد\&.

فلگ «\-n» نوع پیام را به «normal» و «\-h» به «headline» تبدیل می‌کند\&. از «\-\-» می‌توان برای ارسال پیام گفتگویی که با \-n یا \-h آغاز می‌شود استفاده کرد\&.
.RE
.PP
/say_to [\-n|\-h] [\-q] [\-f file] jid text
.RS 4
ارسال پیام «text» به شناسه jid مشخص‌شده\&.

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

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

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

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

یک پرونده متنی را می‌توان با سوییچ «\-f» مشخص کرد (که در این صورت البته نیازی به فرستادن آرگومان text پس از jid نیست)\&.
.RE
.PP
/screen_refresh
.RS 4
تازه کردن صفحه نمایش mcabber\&.
.RE
.PP
/set [option [= value]]
.RS 4
نمایش یا تنظیم مقدار یک گزینه\&.

بدون آرگومان، فهرستی از همه گزینه‌های تنظیم‌شده را به همراه مقادیر آن‌ها چاپ می‌کند
.RE
.PP
/source pattern
.RS 4
خواندن پرونده‌های پیکربندی که با الگوی glob مطابقت دارند (مرتب‌شده بر اساس ترتیب الفبایی)\&.
.RE
.PP
/status [online|avail|free|dnd|notavail|away [\-|statusmessage]], /status message \-|statusmessage
.RS 4
نمایش یا تنظیم وضعیت فعلی\&.

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

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

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

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

با دستور «/status message»، برنامه mcabber پیام را بدون تغییر وضعیت به‌روزرسانی می‌کند\&.
.RE
.PP
/status_to jid online|avail|free|dnd|notavail|away [statusmessage], /status_to jid message statusmessage
.RS 4
ارسال وضعیت درخواستی به کاربر جابر (Jabber) مشخص‌شده\&.

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

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

نکته: شناسه jid می‌تواند شامل یک منبع باشد (یعنی user@server/resource)\&.
.RE
.PP
/version
.RS 4
نمایش نسخه فعلی mcabber\&.
.RE
.SH "پیکربندی (CONFIGURATION FILE)"
.sp
به پرونده پیکربندی نمونه ارائه‌شده مراجعه کنید که خودتوضیح‌دهنده است\&.
.SH "فایل‌ها (FILES)"
.sp
پرونده‌های زیر می‌توانند توسط mcabber(1) مورد استفاده قرار گیرند:
.sp
.if n \{\
.RS 4
.\}
.nf
$HOME/\&.mcabber/mcabberrc    پرونده پیکربندی پیش‌فرض
$HOME/\&.config/mcabber/mcabberrc مکان جایگزین (می‌تواند از XDG_CONFIG_HOME استفاده کند)
$HOME/\&.mcabberrc            پرونده پیکربندی مورد استفاده در صورت پیدا نشدن مورد دیگر
$HOME/\&.mcabber/histo/       دایرکتوری پیش‌فرض برای ذخیره پرونده‌های تاریخچه گفتگو، در صورت فعال بودن
/usr/share/mcabber/help/    دایرکتوری پیش‌فرض برای پرونده‌های راهنمای برخط
/usr/lib/mcabber/           دایرکتوری پیش‌فرض برای ماژول‌ها
.fi
.if n \{\
.RE
.\}
.SH "اشکالات (BUGS)"
.sp
مسلماً وجود دارند\&. اگر موردی پیدا کردید لطفاً به من اطلاع دهید! :\-) لطفاً برای کسب اطلاعات درباره اتاق MUC و سامانه ردیابی اشکالات از وب‌سایت ما دیدن کنید\&.
.SH "نویسنده (AUTHOR)"
.sp
نوشته‌شده توسط \m[blue]\fBMikael BERTHE\fR\m[]\&\s-2\u[1]\d\s+2 و دیگران (پرونده AUTHORS را ببینید)\&.
.SH "منابع (RESOURCES)"
.sp
\m[blue]\fBوب‌سایت اصلی\fR\m[]\&\s-2\u[2]\d\s+2
.sp
\m[blue]\fBویکی رسمی\fR\m[]\&\s-2\u[3]\d\s+2
.sp
\m[blue]\fBاتاق MUC برنامه MCabber\fR\m[]\&\s-2\u[4]\d\s+2
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق نشر (C) 2005\-2020 متعلق به Mikael Berthe و دیگران است\&.
.sp
استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی همگانی گنو (GPL) مجاز است\&.
.SH "نویسنده (AUTHOR)"
.PP
\fBMikael BERTHE\fR <\&mcabber@lilotux\&.net\&>
.RS 4
نویسنده.
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
Mikael BERTHE
.RS 4
\%mailto:mikael@lilotux.net
.RE
.IP " 2." 4
وب‌سایت اصلی
.RS 4
\%http://mcabber.com
.RE
.IP " 3." 4
ویکی رسمی
.RS 4
\%http://wiki.mcabber.com
.RE
.IP " 4." 4
اتاق MUC برنامه MCabber
.RS 4
\%xmpp:mcabber@conf.lilotux.net
.RE