نام (NAME)

xdg-desktop-icon - ابزار خط فرمان برای نصب یا حذف آیکون‌ها روی میزکار

خلاصه دستور (SYNOPSIS)

xdg-desktop-icon install [--novendor] FILE

xdg-desktop-icon uninstall FILE

xdg-desktop-icon {--help | --manual | --version}

توضیحات (DESCRIPTION)

برنامهٔ xdg-desktop-icon می‌تواند برای نصب یک راه‌انداز برنامه یا هر فایل دیگری بر روی میزکار کاربر جاری استفاده شود.

یک راه‌انداز برنامه با یک فایل *.desktop نمایش داده می‌شود. فایل‌های میزکار توسط مشخصات Desktop Entry متعلق به freedesktop.org تعریف شده‌اند. مهم‌ترین جنبه‌های فایل‌های *.desktop در ادامه خلاصه شده است.

دستورها (COMMANDS)

install

FILE را بر روی میزکار کاربر جاری نصب می‌کند. FILE می‌تواند یک فایل *.desktop یا هر نوع فایل دیگری باشد.

uninstall

FILE را از میزکار کاربر جاری حذف می‌کند.

گزینه‌ها (OPTIONS)

--novendor

به‌طور معمول، xdg-desktop-icon بررسی می‌کند تا مطمئن شود فایل *.desktop که قرار است نصب شود دارای یک پیشوند سازنده (vendor prefix) باشد. از این گزینه می‌توان برای غیرفعال کردن این بررسی استفاده کرد.

یک پیشوند سازنده از نویسه‌های الفبایی ([a-zA-Z]) تشکیل شده و به یک خط تیره («-») ختم می‌شود. به شرکت‌ها و سازمان‌ها توصیه می‌شود از یک کلمه یا عبارت، ترجیحاً نام سازمان که برای آن علامت تجاری دارند، به عنوان پیشوند سازندهٔ خود استفاده کنند. هدف از پیشوند سازنده، جلوگیری از تداخل نام‌ها است.

--help

نمایش خلاصهٔ دستور.

--manual

نمایش این صفحهٔ راهنما.

--version

نمایش اطلاعات نسخهٔ xdg-utils.

فایل‌های میزکار (DESKTOP FILES)

یک راه‌انداز برنامه می‌تواند با نصب یک فایل *.desktop به میزکار افزوده شود. یک فایل *.desktop از یک سربرگ [Desktop Entry] تشکیل شده است که در ادامهٔ آن چندین سطر Key=Value قرار دارد.

یک فایل *.desktop می‌تواند نام و توضیحاتی را برای یک برنامه به چندین زبان مختلف ارائه دهد. این کار با افزودن کد زبان، همان‌طور که توسط LC_MESSAGES استفاده می‌شود، در قلاب‌ها پس از Key انجام می‌پذیرد. از این طریق می‌توان بسته به زبان انتخاب‌شدهٔ جاری، مقادیر متفاوتی را برای یک Key یکسان مشخص کرد.

کلیدهای زیر اغلب استفاده می‌شوند:

Type=Application

این یک فیلد الزامی است که نشان می‌دهد فایل *.desktop یک راه‌انداز برنامه را توصیف می‌کند.

Name=Application Name

نام برنامه. برای نمونه Mozilla

GenericName=Generic Name

توصیفی عمومی از برنامه. برای نمونه Web Browser

Comment=Comment

فیلد اختیاری برای مشخص کردن یک توضیح متنی کوتاه (tooltip) برای برنامه. برای نمونه Visit websites on the Internet

Icon=Icon File

آیکونی که باید برای برنامه استفاده شود. این می‌تواند یک مسیر مطلق به یک فایل تصویری یا یک icon-name باشد. اگر یک icon-name مشخص شود، جستجوی تصویر بر اساس نام در تم آیکون جاری کاربر انجام می‌گیرد. از دستور xdg-icon-resource می‌توان برای نصب فایل‌های تصویری در تم‌های آیکون استفاده کرد. مزیت استفاده از icon-name به جای مسیر مطلق این است که با یک icon-name، آیکون برنامه می‌تواند در چندین اندازهٔ مختلف و همچنین در سبک‌های گوناگون تم ارائه شود.

Exec=Command Line

خط فرمان برای اجرای برنامه. اگر برنامه بتواند فایل‌ها را باز کند، باید نگه‌دارندهٔ مکان %f مشخص شود. هنگامی که فایلی بر روی راه‌انداز برنامه انداخته (drop) می‌شود، %f با مسیر فایل انداخته‌شده جایگزین می‌گردد. اگر چندین فایل را بتوان در خط فرمان مشخص کرد، باید به جای %f از نگه‌دارندهٔ مکان %F استفاده شود. اگر برنامه علاوه بر فایل‌های محلی قادر به باز کردن URLها نیز باشد، می‌توان به جای %f یا %F از %u یا %U استفاده کرد.

برای مشاهدهٔ نمای کلی کامل قالب فایل *.desktop لطفاً از این نشانی بازدید کنید: http://www.freedesktop.org/wiki/Specifications/desktop-entry-spec

متغیرهای محیطی (ENVIRONMENT VARIABLES)

ابزار xdg-desktop-icon از متغیرهای محیطی زیر پیروی می‌کند:

XDG_UTILS_DEBUG_LEVEL

تنظیم این متغیر محیطی به یک مقدار عددی غیرصفر، باعث می‌شود xdg-desktop-icon گزارش‌های دقیق‌تری را در stderr ارائه دهد. تعیین مقداری بالاتر، میزان جزئیات گزارش را افزایش می‌دهد.

وضعیت خروج (EXIT STATUS)

کد خروج 0 نشان‌دهندهٔ موفقیت است، در حالی که کد خروج غیرصفر نشان‌دهندهٔ شکست است. کدهای شکست زیر ممکن است بازگردانده شوند:

1

خطا در نحو خط فرمان.

2

یکی از فایل‌های ارائه‌شده در خط فرمان وجود نداشت.

3

یک ابزار مورد نیاز یافت نشد.

4

عملیات ناموفق بود.

5

مجوزی برای خواندن یکی از فایل‌های ارائه‌شده در خط فرمان وجود ندارد.

همچنین ببینید (SEE ALSO)

xdg-icon-resource(1)

مثال‌ها (EXAMPLES)

شرکت ShinyThings Inc. برنامه‌ای به نام «WebMirror» توسعه داده است و مایل است یک راه‌انداز برای آن روی میزکار اضافه کند. این شرکت از «shinythings» به عنوان شناسهٔ سازندهٔ خود استفاده خواهد کرد. برای افزودن برنامه به میزکار، لازم است یک فایل .desktop برای برنامه وجود داشته باشد:

shinythings-webmirror.desktop:
  [Desktop Entry]
  Encoding=UTF-8
  Type=Application
  Exec=webmirror
  Icon=shinythings-webmirror
  Name=WebMirror
  Name[nl]=WebSpiegel

اکنون می‌توان از ابزار xdg-desktop-icon برای افزودن فایل webmirror.desktop به میزکار استفاده کرد:

xdg-desktop-icon install ./shinythings-webmirror.desktop

برای افزودن یک فایل README نیز به میزکار، می‌توان از دستور زیر استفاده کرد:

xdg-desktop-icon install ./shinythings-README

نویسندگان (AUTHORS)

Kevin Krammer

نویسنده.

Jeremy White

نویسنده.

کپی‌رایت و تکثیر (COPYRIGHT)