.\" Manpage for keyart
.\" Aaron Toponce <aaron.toponce@gmail.com>
.TH keyart 1 "17 Jun 2014"
.SH "نام (NAME)"
.B keyart
\- تولید هنر اسکی (ASCII art) از یک کلید OpenPGP
.SH "خلاصه دستور (SYNOPSIS)"
.B keyart
[\-c|\-\-color]
[\-l|\-\-longid]
[\-f|\-\-fingerprint \fIHEX\fR [\-f|\-\-fingerprint \fIHEX\fR ...]]
[\-k|\-\-keyring \fIKEYRING\fR [\-k|\-\-keyring \fIKEYRING\fR ...]]
[\fIKEYID\fR ...]
.SH "توضیحات (DESCRIPTION)"
.B keyart
یک نمایش هنر اسکی (ASCII art) از کلیدهای عمومی OpenPGP تولید می‌کند. این هنر یک پیاده‌سازی از الگوریتم «اسقف مست» (Drunken Bishop) نوشتهٔ Dirk Loss است. مستندات مربوط به این الگوریتم را می‌توان در مسیر /usr/share/doc/signing-party/keyart/ یا مسیر مناسب توزیع شما یافت.

دستور
.B keyart
از چاپ هنر اسکی در هر دو حالت متن ساده (پیش‌فرض) و رنگ‌های ANSI پشتیبانی می‌کند. در حالت رنگی ANSI از یک «نقشه حرارتی» (heat map) استفاده می‌شود که در آن رنگ‌های سرد (آبی) نشان‌دهنده خانه‌هایی از اتاق هستند که اسقف مست به‌ندرت از آن‌ها عبور کرده است و رنگ‌های گرم (قرمز) نشان‌دهنده خانه‌هایی هستند که اسقف مست مرتباً از آن‌ها بازدید کرده است. نسبت رنگ به نویسهٔ چاپ‌شده ۱:۱ است.

شناسه‌های \fIKEYID\fR همان شناسه کلیدها هستند (اثر انگشت، keyid، شناسه کاربری و غیره؛ برای جزئیات به \fBgpg\fR(1) مراجعه کنید). اگر هیچ \fIKEYID\fR مشخص نشود، \fBkeyart\fR برای تمامی کلیدهای یافت‌شده یک نمایش هنر اسکی تولید می‌کند.

.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-c | \-\-color
چاپ هنر اسکی با استفاده از رنگ‌های ANSI در ترمینال.
.TP 8
.B \-l | \-\-longid
چاپ شناسه بلند ۱۶ نویسه‌ای یک کلید OpenPGP در نشان پاورقی. حالت پیش‌فرض چاپ شناسه کوتاه ۸ نویسه‌ای است. اگر گزینهٔ «\fB\-f | \-\-fingerprint \fIHEX\fR» داده شده باشد، این گزینه بدون اخطار نادیده گرفته می‌شود.
.TP 8
.B \-f | \-\-fingerprint \fIHEX\fR
هر رشتهٔ هگزادسیمال دلخواه با هر طولی. می‌تواند یک چکسام هگزادسیمال MD5، SHA1، SHA2 یا SHA3 باشد. برای مقایسه و تحلیل تداخل‌ها و تصادم‌های احتمالی با کلیدهای موجود مفید است. این گزینه می‌تواند چندین بار تکرار شود.
.TP 8
.B \-k | \-\-keyring \fIKEYRING\fR
یک فایل کلید عمومی یا دسته‌کلید (keyring) متعلق به OpenPGP که مقادیر \fIKEYID\fR باید از آن استخراج شوند. اگر این گزینه ارائه نشود، مقادیر \fIKEYID\fR از دسته‌کلید پیش‌فرض GnuPG (معمولاً ~/.gnupg/pubring.gpg) یافت می‌شوند؛ اگر چندین بار تکرار شود، مقادیر \fIKEYRING\fR ارائه‌شده به عنوان منابع متوالی استفاده خواهند شد.
.TP 8
.B \-h | \-\-help
چاپ پیام راهنما و خروج.

.SH "محیط (ENVIRONMENT)"
.TP 8
.I HOME
تنظیم دایرکتوری خانگی پیش‌فرض.
.TP 8
.I GNUPGBIN
تعیین باینری gpg. پیش‌فرض: "gpg".
.TP 8
.I GNUPGHOME
تنظیم دایرکتوری کاری پیش‌فرض برای gpg. پیش‌فرض: "~/.gnupg".

.SH "وضعیت خروج (EXIT STATUS)"
.TP 8
.B 0
دستور \fBkeyart\fR با موفقیت اجرا شد.
.TP 8
.B 1
برنامه \fBgpg\fR(1) یا \fBgpg2\fR(1) نصب نشده است.
.TP 8
.B 2
رشته هگزادسیمال ارائه‌شده مضربی از ۸ بایت نیست.
.SH "همچنین ببینید (SEE ALSO)"
.BR gpg (1)
.SH "نویسندگان (AUTHORS)"
.B keyart
و مستندات آن توسط Aaron Toponce <aaron.toponce@gmail.com> نوشته شده است.