| 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)
| FREEDESKTOP.ORG |