DESKTOP-FILE-INSTALL(1)     General Commands Manual    DESKTOP-FILE-INSTALL(1)

نام (NAME)
       desktop-file-install, desktop-file-edit - نصب و ویرایش فایل‌های دسکتاپ

خلاصه دستور (SYNOPSIS)
       desktop-file-install [--dir=DIR] [-m MODE|--mode=MODE]
       [--vendor=VENDOR] [--delete-original] [--rebuild-mime-info-cache]
       [EDITOPTION]... FILE...

       desktop-file-edit [EDITOPTION]... FILE

توضیحات (DESCRIPTION)
       برنامه desktop-file-install ابزاری برای نصب و در صورت تمایل ویرایش
       فایل‌های دسکتاپ است. برنامه desktop-file-edit ابزاری برای ویرایش یک فایل
       دسکتاپ است. این برنامه‌ها بیشتر برای توسعه‌دهندگان و بسته‌بندها کاربرد
       دارند.

       گزینه‌های مختلفی برای ویرایش فایل‌های دسکتاپ در دسترس است. گزینه‌های
       ویرایش را می‌توان بیش از یک بار مشخص کرد و این گزینه‌ها به همان ترتیبی که
       به برنامه داده شده‌اند پردازش خواهند شد.

       برنامه‌های desktop-file-install و desktop-file-edit همواره تلاش می‌کنند
       فایل دسکتاپ حاصل را اعتبارسنجی کنند. ناموفق بودن اعتبارسنجی ممکن است
       منجر به لغو فرآیند نصب فایل‌های دسکتاپ شود.

       فهرست دسته‌بندی‌های ثبت‌شده و محیط‌های رومیزی در مشخصات Menu تعریف شده است:
       http://freedesktop.org/wiki/Specifications/menu-spec

گزینه‌ها (OPTIONS)
       گزینه‌های زیر پشتیبانی می‌شوند:

       --dir=DIR
              نصب فایل‌های دسکتاپ در دایرکتوری DIR.

       -m, --mode=MODE
              تنظیم دسترسی‌های فایل‌های مقصد روی MODE.

       --vendor=VENDOR
              افزودن یک پیشوند ارائه‌دهنده (vendor) به فایل‌های دسکتاپ. اگر
              فایلی از قبل این پیشوند را داشته باشد، تغییری ایجاد نمی‌شود؛ در
              غیر این صورت، نام فایل به‌صورت VENDOR-FILE خواهد بود. برای مثال:
              اگر VENDOR برابر با freedesktop.org و FILE برابر با
              specification.desktop باشد، فایل حاصل
              freedesktop.org-specification.desktop خواهد بود.

       --delete-original
              حذف فایل‌های دسکتاپ مبدأ و نگه داشتن فایل‌های مقصد. این کار در عمل
              فایل‌های دسکتاپ را "تغییر نام" می‌دهد.

       --rebuild-mime-info-cache
              بازسازی پایگاه‌داده برنامه‌های انواع MIME پس از نصب فایل‌های
              دسکتاپ. برای اطلاعات بیشتر درباره این پایگاه‌داده
              update-desktop-database(1) را ببینید.

گزینه‌های ویرایش (EDIT OPTIONS)
       گزینه‌های ویرایش زیر پشتیبانی می‌شوند:

       --set-key=KEY
              تنظیم کلید KEY روی مقداری که به گزینه بعدی --set-value داده
              می‌شود. استفاده از گزینه متناظر --set-value الزامی است.

       --set-value=VALUE
              تنظیم کلیدی که با گزینه قبلی --set-key مشخص شده روی مقدار VALUE.
              استفاده از گزینه متناظر --set-key الزامی است.

       --set-name=NAME
              تنظیم نام (کلید Name) روی NAME. اگر نامی از قبل تنظیم شده باشد،
              بازنویسی خواهد شد. ترجمه‌های محلی نام قبلی حذف خواهند شد.

       --copy-name-to-generic-name
              کپی کردن مقدار کلید Name در کلید GenericName. توجه داشته باشید
              که یک فایل دسکتاپ برای معتبر بودن به کلید Name نیاز دارد،
              بنابراین این گزینه همیشه تأثیرگذار خواهد بود.

       --set-generic-name=GENERIC-NAME
              تنظیم نام عمومی (کلید GenericName) روی GENERIC-NAME. اگر نام
              عمومی از قبل تنظیم شده باشد، بازنویسی خواهد شد. ترجمه‌های محلی
              نام عمومی قبلی حذف خواهند شد.

       --copy-generic-name-to-name
              کپی کردن مقدار کلید GenericName در کلید Name، در صورتی که کلید
              GenericName وجود داشته باشد.

       --set-comment=COMMENT
              تنظیم توضیح (کلید Comment) روی COMMENT. اگر توضیحی از قبل تنظیم
              شده باشد، بازنویسی خواهد شد. ترجمه‌های محلی توضیح قبلی حذف خواهند
              شد.

       --set-icon=ICON
              تنظیم آیکون (کلید Icon) روی ICON. اگر آیکونی از قبل تنظیم شده
              باشد، بازنویسی خواهد شد. ترجمه‌های محلی آیکون قبلی حذف خواهند شد.

       --add-category=CATEGORY
              افزودن CATEGORY به فهرست دسته‌بندی‌ها (کلید Categories). اگر
              CATEGORY از قبل در فهرست وجود داشته باشد، این عملیات اثری ندارد.
              دسته‌بندی‌های ثبت‌نشده باید با پیشوند X- مشخص شوند.

       --remove-category=CATEGORY
              حذف CATEGORY از فهرست دسته‌بندی‌ها (کلید Categories). اگر CATEGORY
              در فهرست وجود نداشته باشد، این عملیات اثری ندارد.

       --add-mime-type=MIME-TYPE
              افزودن MIME-TYPE به فهرست انواع MIME (کلید MimeType). اگر MIME-
              TYPE از قبل در فهرست وجود داشته باشد، این عملیات اثری ندارد.

       --remove-mime-type=MIME-TYPE
              حذف MIME-TYPE از فهرست انواع MIME (کلید MimeType). اگر MIME-TYPE
              در فهرست وجود نداشته باشد، این عملیات اثری ندارد.

       --add-only-show-in=ENVIRONMENT
              افزودن ENVIRONMENT به فهرست محیط‌های رومیزی که فایل‌های دسکتاپ
              باید در آن‌ها نمایش داده شوند (کلید OnlyShowIn). اگر ENVIRONMENT
              از قبل در فهرست وجود داشته باشد، این عملیات اثری ندارد. محیط‌های
              رومیزی ثبت‌نشده باید با پیشوند X- مشخص شوند. توجه داشته باشید که
              خالی بودن کلید OnlyShowIn در یک فایل دسکتاپ به این معنی است که
              فایل دسکتاپ در تمام محیط‌ها نمایش داده خواهد شد.

       --remove-only-show-in=ENVIRONMENT
              حذف ENVIRONMENT از فهرست محیط‌های رومیزی که فایل‌های دسکتاپ باید
              در آن‌ها نمایش داده شوند (کلید OnlyShowIn). اگر ENVIRONMENT در
              فهرست وجود نداشته باشد، این عملیات اثری ندارد.

       --add-not-show-in=ENVIRONMENT
              افزودن ENVIRONMENT به فهرست محیط‌های رومیزی که فایل‌های دسکتاپ
              نباید در آن‌ها نمایش داده شوند (کلید NotShowIn). اگر ENVIRONMENT
              از قبل در فهرست وجود داشته باشد، این عملیات اثری ندارد. محیط‌های
              رومیزی ثبت‌نشده باید با پیشوند X- مشخص شوند. توجه داشته باشید که
              خالی بودن کلید NotShowIn در یک فایل دسکتاپ به این معنی است که
              فایل دسکتاپ در تمام محیط‌ها نمایش داده خواهد شد.

       --remove-not-show-in=ENVIRONMENT
              حذف ENVIRONMENT از فهرست محیط‌های رومیزی که فایل‌های دسکتاپ نباید
              در آن‌ها نمایش داده شوند (کلید NotShowIn). اگر ENVIRONMENT در
              فهرست وجود نداشته باشد، این عملیات اثری ندارد.

       --remove-key=KEY
              حذف کلید KEY از فایل‌های دسکتاپ، در صورت وجود.

محیط (ENVIRONMENT)
       برخی متغیرهای محیطی رفتار desktop-file-install را تغییر می‌دهند:

       DESKTOP_FILE_VENDOR

              این متغیر می‌تواند به عنوان جایگزینی برای گزینه --vendor استفاده
              شود. اگر گزینه --vendor استفاده شود، این متغیر محیطی نادیده
              گرفته خواهد شد.

       DESKTOP_FILE_INSTALL_DIR

              این متغیر می‌تواند به عنوان جایگزینی برای گزینه --dir استفاده
              شود. اگر گزینه --dir استفاده شود، این متغیر محیطی نادیده گرفته
              خواهد شد.

       RPM_BUILD_ROOT

              این متغیر هنگام ساخت بسته‌های RPM تنظیم می‌شود. اگر گزینه --dir و
              متغیر محیطی DESKTOP_FILE_INSTALL_DIR استفاده نشوند، این متغیر به
              طور خودکار به ابتدای مسیر دایرکتوری پیش‌فرض نصب اضافه می‌شود تا
              فایل‌های دسکتاپ هنگام ساخت بسته‌ها به درستی نصب شوند.

اشکالات (BUGS)
       اگر اشکالی در برنامه desktop-file-install پیدا کردید، لطفاً آن را در
       https://bugs.freedesktop.org گزارش دهید.

همچنین ببینید (SEE ALSO)
       desktop-file-validate(1), update-desktop-database(1)

                                FREEDESKTOP.ORG        DESKTOP-FILE-INSTALL(1)