| 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 specification) تعریف شده است: 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 |