.\"
.\" desktop-file-install manual page.
.\" (C) 2010 Vincent Untz (vuntz@gnome.org)
.\"
.TH DESKTOP-FILE-INSTALL 1 FREEDESKTOP.ORG
.SH "نام (NAME)"
desktop-file-install, desktop-file-edit \- نصب و ویرایش فایل‌های دسکتاپ
.SH "خلاصه دستور (SYNOPSIS)"
.B desktop-file-install [\-\-dir=DIR] [\-m MODE|\-\-mode=MODE]
.B [\-\-vendor=VENDOR] [\-\-delete-original]
.B [\-\-rebuild-mime-info-cache]
.B [EDITOPTION]... FILE...
.PP
.B desktop-file-edit [EDITOPTION]... FILE
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fIdesktop-file-install\fP ابزاری برای نصب، و در صورت تمایل ویرایش، فایل‌های دسکتاپ است. برنامهٔ \fIdesktop-file-edit\fP ابزاری برای ویرایش یک فایل دسکتاپ است. این برنامه‌ها عمدتاً برای توسعه‌دهندگان و بسته‌بندها کاربرد دارند.
.PP
گزینه‌های گوناگونی برای ویرایش فایل‌های دسکتاپ موجود است. گزینه‌های ویرایش می‌توانند بیش از یک‌بار مشخص شوند و به همان ترتیبی که به برنامه ارسال شده‌اند پردازش خواهند شد.
.PP
برنامه‌های \fIdesktop-file-install\fP و \fIdesktop-file-edit\fP همواره تلاش می‌کنند تا فایل دسکتاپ نهایی را اعتبارسنجی کنند. عدم موفقیت در اعتبارسنجی ممکن است منجر به لغو نصب فایل‌های دسکتاپ شود.
.PP
فهرست دسته‌بندی‌ها و محیط‌های رومیزی ثبت‌شده در مشخصات منو (Menu specification) تعریف شده است:
\fIhttp://freedesktop.org/wiki/Specifications/menu-spec\fP.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
.I --dir=DIR
نصب فایل‌های دسکتاپ در دایرکتوری \fIDIR\fP.
.TP
.I -m, --mode=MODE
تنظیم مجوزهای دسترسی فایل‌های مقصد روی \fIMODE\fP.
.TP
.I --vendor=VENDOR
افزودن یک پیشوند ارائه‌دهنده (vendor) به فایل‌های دسکتاپ. اگر فایلی از پیش این پیشوند را داشته باشد، هیچ اتفاقی رخ نمی‌دهد؛ در غیر این صورت، نام فایل به صورت \fIVENDOR\fP-\fIFILE\fP تغییر خواهد کرد. برای نمونه: اگر \fIVENDOR\fP برابر با \fBfreedesktop.org\fP و \fIFILE\fP برابر با \fBspecification.desktop\fP باشد، فایل حاصل \fBfreedesktop.org-specification.desktop\fP خواهد بود.
.TP
.I --delete-original
حذف فایل‌های دسکتاپ مبدأ، به‌گونه‌ای که تنها فایل‌های مقصد باقی بمانند. در عمل باعث «تغییر نام» فایل‌های دسکتاپ می‌شود.
.TP
.I --rebuild-mime-info-cache
بازسازی پایگاه داده برنامه‌های انواع MIME پس از نصب فایل‌های دسکتاپ. برای اطلاعات بیشتر درباره این پایگاه داده به \fIupdate-desktop-database(1)\fP مراجعه کنید.
.PP
.SH "گزینه‌های ویرایش (EDIT OPTIONS)"
گزینه‌های ویرایش زیر پشتیبانی می‌شوند:
.TP
.I --set-key=KEY
تنظیم کلید KEY با مقداری که به گزینه \fI--set-value\fP بعدی داده می‌شود. همراهی این گزینه با یک \fI--set-value\fP متناظر الزامی است.
.TP
.I --set-value=VALUE
تنظیم کلیدی که با گزینه \fI--set-key\fP قبلی مشخص شده است با مقدار VALUE. همراهی این گزینه با یک \fI--set-key\fP متناظر الزامی است.
.TP
.I --set-name=NAME
تنظیم نام (کلید \fBName\fP) با مقدار NAME. اگر نامی از قبل تنظیم شده باشد، رونویسی خواهد شد. محلی‌سازی‌های نام قبلی حذف خواهند شد.
.TP
.I --copy-name-to-generic-name
رونوشت از مقدار کلید \fBName\fP در کلید \fBGenericName\fP. توجه داشته باشید که وجود کلید \fBName\fP برای معتبر بودن فایل دسکتاپ الزامی است، بنابراین این گزینه همواره مؤثر خواهد بود.
.TP
.I --set-generic-name=GENERIC-NAME
تنظیم نام عمومی (کلید \fBGenericName\fP) با مقدار GENERIC-NAME. اگر نام عمومی از قبل تنظیم شده باشد، رونویسی خواهد شد. محلی‌سازی‌های نام عمومی قبلی حذف خواهند شد.
.TP
.I --copy-generic-name-to-name
رونوشت از مقدار کلید \fBGenericName\fP در کلید \fBName\fP، در صورتی که کلید \fBGenericName\fP موجود باشد.
.TP
.I --set-comment=COMMENT
تنظیم توضیحات (کلید \fBComment\fP) با مقدار COMMENT. اگر توضیحی از قبل تنظیم شده باشد، رونویسی خواهد شد. محلی‌سازی‌های توضیحات قبلی حذف خواهند شد.
.TP
.I --set-icon=ICON
تنظیم آیکون (کلید \fBIcon\fP) با مقدار ICON. اگر آیکونی از قبل تنظیم شده باشد، رونویسی خواهد شد. محلی‌سازی‌های آیکون قبلی حذف خواهند شد.
.TP
.I --add-category=CATEGORY
افزودن \fICATEGORY\fP به فهرست دسته‌بندی‌ها (کلید \fBCategories\fP). اگر \fICATEGORY\fP از پیش در فهرست موجود باشد، هیچ عملیاتی انجام نمی‌شود. یک دسته‌بندی ثبت‌نشده باید دارای پیشوند \fBX-\fP باشد.
.TP
.I --remove-category=CATEGORY
حذف \fICATEGORY\fP از فهرست دسته‌بندی‌ها (کلید \fBCategories\fP). اگر \fICATEGORY\fP در فهرست موجود نباشد، هیچ عملیاتی انجام نمی‌شود.
.TP
.I --add-mime-type=MIME-TYPE
افزودن \fIMIME-TYPE\fP به فهرست انواع MIME (کلید \fBMimeType\fP). اگر \fIMIME-TYPE\fP از پیش در فهرست موجود باشد، هیچ عملیاتی انجام نمی‌شود.
.TP
.I --remove-mime-type=MIME-TYPE
حذف \fIMIME-TYPE\fP از فهرست انواع MIME (کلید \fBMimeType\fP). اگر \fIMIME-TYPE\fP در فهرست موجود نباشد، هیچ عملیاتی انجام نمی‌شود.
.TP
.I --add-only-show-in=ENVIRONMENT
افزودن \fIENVIRONMENT\fP به فهرست محیط‌های رومیزی که فایل‌های دسکتاپ باید در آن‌ها نمایش داده شوند (کلید \fBOnlyShowIn\fP). اگر \fIENVIRONMENT\fP از پیش در فهرست موجود باشد، هیچ عملیاتی انجام نمی‌شود. یک محیط رومیزی ثبت‌نشده باید دارای پیشوند \fBX-\fP باشد. توجه داشته باشید که خالی بودن کلید \fBOnlyShowIn\fP در یک فایل دسکتاپ به این معنی است که فایل دسکتاپ در تمام محیط‌ها نمایش داده خواهد شد.
.TP
.I --remove-only-show-in=ENVIRONMENT
حذف \fIENVIRONMENT\fP از فهرست محیط‌های رومیزی که فایل‌های دسکتاپ باید در آن‌ها نمایش داده شوند (کلید \fBOnlyShowIn\fP). اگر \fIENVIRONMENT\fP در فهرست موجود نباشد، هیچ عملیاتی انجام نمی‌شود.
.TP
.I --add-not-show-in=ENVIRONMENT
افزودن \fIENVIRONMENT\fP به فهرست محیط‌های رومیزی که فایل‌های دسکتاپ نباید در آن‌ها نمایش داده شوند (کلید \fBNotShowIn\fP). اگر \fIENVIRONMENT\fP از پیش در فهرست موجود باشد، هیچ عملیاتی انجام نمی‌شود. یک محیط رومیزی ثبت‌نشده باید دارای پیشوند \fBX-\fP باشد. توجه داشته باشید که خالی بودن کلید \fBNotShowIn\fP در یک فایل دسکتاپ به این معنی است که فایل دسکتاپ در تمام محیط‌ها نمایش داده خواهد شد.
.TP
.I --remove-not-show-in=ENVIRONMENT
حذف \fIENVIRONMENT\fP از فهرست محیط‌های رومیزی که فایل‌های دسکتاپ نباید در آن‌ها نمایش داده شوند (کلید \fBNotShowIn\fP). اگر \fIENVIRONMENT\fP در فهرست موجود نباشد، هیچ عملیاتی انجام نمی‌شود.
.TP
.I --remove-key=KEY
حذف کلید \fIKEY\fP از فایل‌های دسکتاپ، در صورت وجود داشتن.
.SH "محیط (ENVIRONMENT)"
برخی متغیرهای محیطی رفتار \fIdesktop-file-install\fP را تغییر می‌دهند:
.PP
.B DESKTOP_FILE_VENDOR
.IP
این متغیر می‌تواند به‌عنوان جایگزینی برای گزینهٔ \fI--vendor\fP استفاده شود. در صورت استفاده از گزینهٔ \fI--vendor\fP، این متغیر محیطی نادیده گرفته خواهد شد.
.PP
.B DESKTOP_FILE_INSTALL_DIR
.IP
این متغیر می‌تواند به‌عنوان جایگزینی برای گزینهٔ \fI--dir\fP استفاده شود. در صورت استفاده از گزینهٔ \fI--dir\fP، این متغیر محیطی نادیده گرفته خواهد شد.
.PP
.B RPM_BUILD_ROOT
.IP
این متغیر هنگام ساخت بسته‌های RPM مقداردهی می‌شود. در صورتی که از گزینهٔ \fI--dir\fP و متغیر محیطی \fBDESKTOP_FILE_INSTALL_DIR\fP استفاده نشود، این مقدار به‌صورت خودکار در ابتدای مسیر دایرکتوری نصب پیش‌فرض قرار می‌گیرد تا فایل‌های دسکتاپ هنگام ساخت بسته‌ها به‌طور مناسب نصب شوند.
.SH "گزارش باگ‌ها (BUGS)"
در صورت مشاهده هرگونه اشکال در برنامهٔ \fIdesktop-file-install\fP، لطفاً آن را در https://bugs.freedesktop.org گزارش دهید.
.SH "همچنین ببینید (SEE ALSO)"
.BR desktop-file-validate(1)
.BR update-desktop-database(1)