.TH man 1 "2026-06-08" "0.18.2" "Profanity XMPP client"
.SH "نام (NAME)"
Profanity \- یک کلاینت سادهٔ چت XMPP مبتنی بر کنسول
.SH "توضیحات (DESCRIPTION)"
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.PP
این صفحهٔ راهنما با هدف کمک به شما در راه‌اندازی XEP-0374: OpenPGP for XMPP
Instant Messaging تهیه شده است.
که همچنین به نام OX شناخته می‌شود.
.PP
برای جزئیات بیشتر دربارهٔ نحوهٔ استفاده، به راهنمای profanity-ox یا \f[V]/help ox\f[R] مراجعه کنید.
.PP
نرم‌افزار Profanity مایل است حداکثر آزادی عمل را در پیکربندی سامانه به کاربر بدهد.
بنابراین ما مستقیماً به تنظیمات GPG شما دست نخواهیم زد.
این بدان معناست که نیاز است برخی مراحل را به‌صورت دستی انجام دهید.
این مراحل در اینجا شرح داده شده‌اند.
.SH "تولید کلیدهای OpenPGP (GENERATE OPENPGP KEY MATERIALS)"
.PP
نخستین گام، ایجاد یک جفت‌کلید OpenPGP است.
تولید جفت‌کلید با استفاده از دستور \f[V]gpg\f[R] در GnuPG انجام خواهد شد.
.IP
.nf
\f[C]
gpg --quick-generate-key xmpp:alice\[at]domain.tld future-default default 3y
\f[R]
.fi
.PP
این دستور یک کلید OpenPGP با UID به صورت
\f[V]xmpp:alice\[at]domain.tld\f[R] تولید می‌کند.
گزینهٔ \f[V]future-default\f[R] برای تولید یک کلید ed25519/cv25519 استفاده شده است.
این کلید به‌گونه‌ای تنظیم شده که پس از سه سال منقضی شود.
.PP
شناسهٔ Jabber ID را با JID خود جایگزین کنید و پیشوند URI یعنی \f[V]xmpp:\f[R] را فراموش \f[B]نکنید\f[R].
.PP
خروجی نمونه:
.IP
.nf
\f[C]
pub   ed25519 2021-09-21 [SC] [verf\[:a]llt: 2024-09-20]
      583BAE703A801095B6B71A56BD801174B1A0B84A
uid                      xmpp:alice\[at]domain.tld
sub   cv25519 2021-09-21 [E]
\f[R]
.fi
.SH "برون‌ریزی کلید عمومی (EXPORT YOUR PUBLIC KEY)"
.PP
شما باید کلید عمومی خود را برون‌ریزی کنید تا بتوانید بعداً آن را در یک گره PEP بارگذاری نمایید.
این روشی است که طرف‌های گفتگوی شما می‌توانند کلید عمومی را از شما دریافت کنند.
برای برون‌ریزی کلید عمومی از دستور زیر استفاده کنید:
.PP
دستور نمونه:
.IP
.nf
\f[C]
gpg --export \[rs]
  --export-options export-minimal \[rs]
  --export-filter \[aq]keep-uid=uid =\[ti] xmpp:alice\[at]domain.tld\[aq] \[rs]
  --export-filter \[aq]drop-subkey=usage =\[ti] a\[aq] \[rs]
  583BAE703A801095B6B71A56BD801174B1A0B84A \[rs]
  > /tmp/pep-key.gpg
\f[R]
.fi
.PP
کلید در مسیر \f[V]/tmp/pep-key.gpg\f[R] برون‌ریزی خواهد شد.
می‌توانید کلید را با دستور زیر بررسی کنید:
.PP
\f[V]gpg --show-key --with-sig-list /tmp/pep-key.gpg\f[R]
.PP
به یاد داشته باشید: کلیدهای عمومی ممکن است حاوی اطلاعاتی (امضاها، نام، نشانی ایمیل) باشند.
مراقب باشید که چه داده‌هایی برون‌ریزی می‌شوند.
گزینه‌های \f[V]export-options\f[R] و \f[V]export-filter\f[R] در GnuPG به شما در پالایش و فیلتر کردن داده‌ها کمک خواهند کرد.
.SH "انتشار کلید (PUBLISH YOUR KEY)"
.PP
می‌توانید از profanity برای انتشار کلید برون‌ریزی‌شده در حساب کاربری خود (PEP) استفاده کنید.
دستور \f[V]/ox announce\f[R] کلید شما را منتشر خواهد کرد.
.IP
.nf
\f[C]
/ox announce /tmp/pep-key.gpg
\f[R]
.fi
.PP
این دستور دو رکورد گره PEP برای ذخیرهٔ کلید ایجاد خواهد کرد.
.SH "کشف کلیدها (DISCOVER KEYS)"
.PP
برای کشف کلیدهای عمومی مخاطبان خود از دستور \f[V]/ox discover\f[R] استفاده کنید.
.PP
خروجی نمونه:
.IP
.nf
\f[C]
/ox discover buddy\[at]domain.tld
Discovering Public Key for buddy\[at]domain.tld 
1234567890ABCDEF1234567890ABCDEF12345678
\f[R]
.fi
.PP
برای درخواست و وارد کردن یک کلید، می‌توانید از دستور \f[V]/ox request\f[R] استفاده نمایید.
.IP
.nf
\f[C]
/ox request buddy\[at]domain.tld 1234567890ABCDEF1234567890ABCDEF12345678
Requesting Public Key 1234567890ABCDEF1234567890ABCDEF12345678 for buddy\[at]domain.tld
Public Key imported 
\f[R]
.fi
.PP
کلید به جاکلیدی (keyring) برنامهٔ gnupg شما وارد خواهد شد.
.SH "امضای کلید واردشده (SIGN THE IMPORTED KEY)"
.PP
کلید را می‌توان از طریق gpg مشاهده کرد:
\f[V]gpg -k xmpp:buddy\[at]domain.tld\f[R].
مطمئن شوید کلید متعلق به مخاطب شما است و آن را با کلید خود امضا کنید.
.IP
.nf
\f[C]
gpg --ask-cert-level --default-key 583BAE703A801095B6B71A56BD801174B1A0B84A --sign-key 1234567890ABCDEF1234567890ABCDEF12345678
\f[R]
.fi
.PP
دستور \f[V]/ox contacts\f[R] کلیدهای دارای XMPP-UID را نمایش خواهد داد.
دستور \f[V]/ox keys\f[R] همهٔ کلیدهای OpenPGP شناخته‌شده را نشان خواهد داد.
.PP
تنها پس از اینکه کلید را امضا کردید، می‌توانید عملاً از OX با مخاطب خود استفاده کنید.
.SH "استفاده از OX (USE OX)"
.PP
درون پنجرهٔ چت می‌توانید OX را با دستور \f[V]/ox start\f[R] آغاز و با \f[V]/ox end\f[R] متوقف کنید.
.PP
پیام‌ها به‌صورت امضاشده و رمزگذاری‌شده ارسال خواهند شد.