.TH man 1 "2026-06-08" "0.18.2" "Profanity XMPP client"

.SH "نام (NAME)"
/roster \- مدیریت فهرست مخاطبان و تنظیمات نمایش آن

.SH "توضیحات (DESCRIPTION)"
مدیریت فهرست مخاطبان (roster) و تنظیمات نمایش آن. اجرای دستور بدون هیچ آرگومانی، تمامی مخاطبان موجود در فهرست شما را فهرست می‌کند.

.SH "خلاصه دستور (SYNOPSIS)"
/roster

.LP
/roster online

.LP
/roster show [offline|resource|presence|status|empty|priority|contacts|rooms]

.LP
/roster hide [offline|resource|presence|status|empty|priority|contacts|rooms]

.LP
/roster by group|presence|none

.LP
/roster count unread|items|off

.LP
/roster count zero on|off

.LP
/roster color on|off

.LP
/roster order name|presence

.LP
/roster unread before|after|off

.LP
/roster room char <char>|none

.LP
/roster room private char <char>|none

.LP
/roster room position first|last

.LP
/roster room by service|none

.LP
/roster room order name|unread

.LP
/roster room unread before|after|off

.LP
/roster room title bookmark|jid|localpart|name

.LP
/roster private room|group|off

.LP
/roster private char <char>|none

.LP
/roster header char <char>|none

.LP
/roster presence indent <indent>

.LP
/roster contact char <char>|none

.LP
/roster contact indent <indent>

.LP
/roster resource char <char>|none

.LP
/roster resource indent <indent>

.LP
/roster resource join on|off

.LP
/roster size <percent>

.LP
/roster wrap on|off

.LP
/roster add <jid> [<nick>]

.LP
/roster remove <contact>

.LP
/roster remove_all contacts

.LP
/roster nick <jid> <nick>

.LP
/roster clearnick <jid>

.LP
/roster group

.LP
/roster group show <group>

.LP
/roster group add <group> <contat>

.LP
/roster group remove <group> <contact>

.LP.SH "آرگومان‌ها (ARGUMENTS)"
.PP
\fBonline\fR
.RS 4
نمایش تمام مخاطبین برخط در کنسول.
.RE
.PP
\fBshow\fR
.RS 4
نمایش پنل فهرست مخاطبین (roster).
.RE
.PP
\fBshow offline\fR
.RS 4
نمایش مخاطبین برون‌خط در پنل فهرست مخاطبین.
.RE
.PP
\fBshow resource\fR
.RS 4
نمایش منابع متصل مخاطب در پنل فهرست مخاطبین.
.RE
.PP
\fBshow presence\fR
.RS 4
نمایش وضعیت حضور مخاطب در پنل فهرست مخاطبین.
.RE
.PP
\fBshow status\fR
.RS 4
نمایش پیام وضعیت مخاطب در پنل فهرست مخاطبین.
.RE
.PP
\fBshow empty\fR
.RS 4
نمایش گروه‌های خالی در پنل فهرست مخاطبین.
.RE
.PP
\fBshow priority\fR
.RS 4
نمایش اولویت منبع در پنل فهرست مخاطبین.
.RE
.PP
\fBshow contacts\fR
.RS 4
نمایش مخاطبین در پنل فهرست مخاطبین.
.RE
.PP
\fBshow rooms\fR
.RS 4
نمایش اتاق‌های گفتگو در پنل فهرست مخاطبین.
.RE
.PP
\fBhide\fR
.RS 4
پنهان کردن پنل فهرست مخاطبین.
.RE
.PP
\fBhide offline\fR
.RS 4
پنهان کردن مخاطبین برون‌خط در پنل فهرست مخاطبین.
.RE
.PP
\fBhide resource\fR
.RS 4
پنهان کردن منابع متصل مخاطب در پنل فهرست مخاطبین.
.RE
.PP
\fBhide presence\fR
.RS 4
پنهان کردن وضعیت حضور مخاطب در پنل فهرست مخاطبین.
.RE
.PP
\fBhide status\fR
.RS 4
پنهان کردن پیام وضعیت مخاطب در پنل فهرست مخاطبین.
.RE
.PP
\fBhide empty\fR
.RS 4
پنهان کردن گروه‌های خالی در پنل فهرست مخاطبین.
.RE
.PP
\fBhide priority\fR
.RS 4
پنهان کردن اولویت منبع در پنل فهرست مخاطبین.
.RE
.PP
\fBhide contacts\fR
.RS 4
پنهان کردن مخاطبین در پنل فهرست مخاطبین.
.RE
.PP
\fBhide rooms\fR
.RS 4
پنهان کردن اتاق‌های گفتگو در پنل فهرست مخاطبین.
.RE
.PP
\fBby group\fR
.RS 4
گروه‌بندی مخاطبین در پنل فهرست مخاطبین بر اساس گروه فهرست.
.RE
.PP
\fBby presence\fR
.RS 4
گروه‌بندی مخاطبین در پنل فهرست مخاطبین بر اساس وضعیت حضور.
.RE
.PP
\fBby none\fR
.RS 4
بدون گروه‌بندی در پنل فهرست مخاطبین.
.RE
.PP
\fBcount unread\fR
.RS 4
نمایش تعداد پیام‌های خوانده‌نشده به همراه سربرگ‌های فهرست.
.RE
.PP
\fBcount items\fR
.RS 4
نمایش تعداد موارد به همراه سربرگ‌های فهرست.
.RE
.PP
\fBcount off\fR
.RS 4
عدم نمایش هرگونه شمارش به همراه سربرگ‌های فهرست.
.RE
.PP
\fBcount zero on\fR
.RS 4
نمایش شمارش سربرگ فهرست هنگامی که مقدار آن ۰ است.
.RE
.PP
\fBcount zero off\fR
.RS 4
پنهان کردن شمارش سربرگ فهرست هنگامی که مقدار آن ۰ است.
.RE
.PP
\fBcolor on\fR
.RS 4
فعال‌سازی رنگ‌آمیزی خودکار نام‌ها (XEP-0392).
.RE
.PP
\fBcolor off\fR
.RS 4
غیرفعال‌سازی رنگ‌آمیزی خودکار نام‌ها (XEP-0392).
.RE
.PP
\fBorder name\fR
.RS 4
مرتب‌سازی مخاطبین فهرست فقط بر اساس نام.
.RE
.PP
\fBorder presence\fR
.RS 4
مرتب‌سازی مخاطبین فهرست بر اساس وضعیت حضور و سپس بر اساس نام.
.RE
.PP
\fBunread before\fR
.RS 4
نمایش تعداد پیام‌های خوانده‌نشده قبل از مخاطب.
.RE
.PP
\fBunread after\fR
.RS 4
نمایش تعداد پیام‌های خوانده‌نشده بعد از مخاطب.
.RE
.PP
\fBunread off\fR
.RS 4
عدم نمایش تعداد پیام‌های خوانده‌نشده برای مخاطبین.
.RE
.PP
\fBroom char <char>\fR
.RS 4
افزودن نویسهٔ مشخص‌شده به عنوان پیشوند اتاق‌ها.
.RE
.PP
\fBroom char none\fR
.RS 4
حذف پیشوند نویسه‌ای اتاق‌ها.
.RE
.PP
\fBroom private char <char>\fR
.RS 4
افزودن نویسهٔ مشخص‌شده به عنوان پیشوند گفتگوی خصوصی اتاق در صورت نمایش به همراه اتاق.
.RE
.PP
\fBroom private char none\fR
.RS 4
حذف پیشوند نویسه‌ای گفتگوی خصوصی اتاق در صورت نمایش به همراه اتاق.
.RE
.PP
\fBroom position first\fR
.RS 4
نمایش اتاق‌ها در ابتدای فهرست مخاطبین.
.RE
.PP
\fBroom position last\fR
.RS 4
نمایش اتاق‌ها در انتهای فهرست مخاطبین.
.RE.PP
\fBroom by service\fR
.RS 4
گروه‌بندی اتاق‌ها بر اساس سرویس گفت‌وگو.
.RE
.PP
\fBroom by none\fR
.RS 4
عدم گروه‌بندی اتاق‌ها.
.RE
.PP
\fBroom order name\fR
.RS 4
مرتب‌سازی اتاق‌ها بر اساس نام.
.RE
.PP
\fBroom order unread\fR
.RS 4
مرتب‌سازی اتاق‌ها بر اساس پیام‌های خوانده‌نشده، و سپس بر اساس نام.
.RE
.PP
\fBroom unread before\fR
.RS 4
نمایش تعداد پیام‌های خوانده‌نشده پیش از نام اتاق.
.RE
.PP
\fBroom unread after\fR
.RS 4
نمایش تعداد پیام‌های خوانده‌نشده پس از نام اتاق.
.RE
.PP
\fBroom unread off\fR
.RS 4
عدم نمایش تعداد پیام‌های خوانده‌نشده برای اتاق‌ها.
.RE
.PP
\fBroom title bookmark|jid|localpart|name\fR
.RS 4
نمایش نام نشانک (bookmark)، شناسه JID، بخش محلی (localpart) شناسه JID، یا نام اتاق به‌عنوان عنوان فهرست مخاطبان برای MUCها.
.RE
.PP
\fBprivate room\fR
.RS 4
نمایش گفت‌وگوهای خصوصی اتاق همراه با خود اتاق.
.RE
.PP
\fBprivate group\fR
.RS 4
نمایش گفت‌وگوهای خصوصی اتاق در یک گروه جداگانه از فهرست مخاطبان.
.RE
.PP
\fBprivate off\fR
.RS 4
عدم نمایش گفت‌وگوهای خصوصی اتاق.
.RE
.PP
\fBprivate char <char>\fR
.RS 4
قرار دادن نویسه مشخص‌شده به‌عنوان پیشوند گفت‌وگوهای خصوصی اتاق هنگام نمایش در گروهی جداگانه.
.RE
.PP
\fBprivate char none\fR
.RS 4
حذف نویسه پیشوند گفت‌وگوهای خصوصی اتاق.
.RE
.PP
\fBheader char <char>\fR
.RS 4
قرار دادن نویسه مشخص‌شده به‌عنوان پیشوند سرایند‌های فهرست مخاطبان.
.RE
.PP
\fBheader char none\fR
.RS 4
حذف نویسه پیشوند سرایند فهرست مخاطبان.
.RE
.PP
\fBcontact char <char>\fR
.RS 4
قرار دادن نویسه مشخص‌شده به‌عنوان پیشوند مخاطبان در فهرست مخاطبان.
.RE
.PP
\fBcontact char none\fR
.RS 4
حذف نویسه پیشوند مخاطب در فهرست مخاطبان.
.RE
.PP
\fBcontact indent <indent>\fR
.RS 4
ایجاد تورفتگی در سطر مخاطب به میزان <indent> فاصله (۰ تا ۱۰).
.RE
.PP
\fBresource char <char>\fR
.RS 4
قرار دادن نویسه مشخص‌شده به‌عنوان پیشوند منابع (resources) در فهرست مخاطبان.
.RE
.PP
\fBresource char none\fR
.RS 4
حذف نویسه پیشوند منبع در فهرست مخاطبان.
.RE
.PP
\fBresource indent <indent>\fR
.RS 4
ایجاد تورفتگی در سطر منبع به میزان <indent> فاصله (۰ تا ۱۰).
.RE
.PP
\fBresource join on|off\fR
.RS 4
ادغام منبع با سطر قبلی در صورتی که تنها یک منبع در دسترس باشد.
.RE
.PP
\fBpresence indent <indent>\fR
.RS 4
ایجاد تورفتگی در سطر وضعیت حضور به میزان <indent> فاصله (\-1 تا ۱۰)؛ مقدار \-1 وضعیت حضور را در سطر قبلی نمایش می‌دهد.
.RE
.PP
\fBsize <percent>\fR
.RS 4
درصدی از صفحه نمایش که توسط فهرست مخاطبان اشغال می‌شود (۱ تا ۹۹).
.RE
.PP
\fBwrap on|off\fR
.RS 4
فعال یا غیرفعال کردن شکستن سطرها در پانل فهرست مخاطبان.
.RE
.PP
\fBadd <jid> [<nick>]\fR
.RS 4
افزودن یک مورد جدید به فهرست مخاطبان.
.RE
.PP
\fBremove <jid>\fR
.RS 4
حذف یک مورد از فهرست مخاطبان.
.RE
.PP
\fBremove_all contacts\fR
.RS 4
حذف تمامی موارد از فهرست مخاطبان.
.RE
.PP
\fBnick <jid> <nick>\fR
.RS 4
تغییر نام مستعار یک مخاطب.
.RE
.PP
\fBclearnick <jid>\fR
.RS 4
حذف نام مستعار فعلی.
.RE
.PP
\fBgroup show <group>\fR
.RS 4
نمایش فهرست تمامی موارد فهرست مخاطبان موجود در یک گروه.
.RE
.PP
\fBgroup add <group> <contact>\fR
.RS 4
افزودن یک مخاطب به یک گروه.
.RE
.PP
\fBgroup remove <group> <contact>\fR
.RS 4
حذف یک مخاطب از یک گروه.
.RE.SH "مثال‌ها (EXAMPLES)"
/roster

.LP
/roster add odin@valhalla.edda

.LP
/roster add odin@valhalla.edda Allfather

.LP
/roster remove loki@ownserver.org

.LP
/roster nick odin@valhalla.edda "All Father"

.LP
/roster clearnick thor@valhalla.edda

.LP
/roster size 15

.LP
/roster group

.LP
/roster group show friends

.LP
/roster group add friends fenris@ownserver.org

.LP
/roster group add family Brother

.LP
/roster group remove colleagues boss@work.com

.LP