.\"
.\" 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 تعریف شده است:
\fIhttp://freedesktop.org/wiki/Specifications/menu-spec\fP
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
.I \-\-dir=DIR
نصب فایل‌های دسکتاپ در دایرکتوری
.IR DIR .
.TP
.I \-m, \-\-mode=MODE
تنظیم دسترسی‌های فایل‌های مقصد روی
.IR MODE .
.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 پس از نصب فایل‌های دسکتاپ. برای اطلاعات بیشتر درباره این پایگاه‌داده
.BR update\-desktop\-database (1)
را ببینید.
.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
این متغیر می‌تواند به عنوان جایگزینی برای گزینه
.I \-\-vendor
استفاده شود. اگر گزینه
.I \-\-vendor
استفاده شود، این متغیر محیطی نادیده گرفته خواهد شد.
.PP
.B DESKTOP_FILE_INSTALL_DIR
.IP
این متغیر می‌تواند به عنوان جایگزینی برای گزینه
.I \-\-dir
استفاده شود. اگر گزینه
.I \-\-dir
استفاده شود، این متغیر محیطی نادیده گرفته خواهد شد.
.PP
.B RPM_BUILD_ROOT
.IP
این متغیر هنگام ساخت بسته‌های RPM تنظیم می‌شود. اگر گزینه
.I \-\-dir
و متغیر محیطی
.B DESKTOP_FILE_INSTALL_DIR
استفاده نشوند، این متغیر به طور خودکار به ابتدای مسیر دایرکتوری پیش‌فرض نصب اضافه می‌شود تا فایل‌های دسکتاپ هنگام ساخت بسته‌ها به درستی نصب شوند.
.SH "اشکالات (BUGS)"
اگر اشکالی در برنامه
\fIdesktop-file-install\fP
پیدا کردید، لطفاً آن را در
https://bugs.freedesktop.org
گزارش دهید.
.SH "همچنین ببینید (SEE ALSO)"
.BR desktop-file-validate (1),
.BR update-desktop-database (1)