نام (NAME)

xdg-icon-resource - ابزار خط فرمان برای نصب و حذف منابع آیکون

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

xdg-icon-resource install [--noupdate] [--novendor] [--theme theme] [--context context] [--mode mode] --size size icon-file [icon-name]

xdg-icon-resource uninstall [--noupdate] [--theme theme] [--context context] [--mode mode] --size size icon-name

xdg-icon-resource forceupdate [--theme theme] [--mode mode]

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

توضیحات (DESCRIPTION)

برنامهٔ xdg-icon-resource می‌تواند برای نصب منابع آیکون در سامانهٔ آیکون میزکار به منظور مصورسازی ورودی‌های منو، نمایش آیکون‌های میزکار یا نمایش گرافیکی انواع فایل استفاده شود.

سامانهٔ آیکون میزکار، آیکون‌ها را با نام شناسایی می‌کند. این سامانه بسته به اندازهٔ مورد نیاز، پوستهٔ انتخابی آیکون و زمینه‌ای (context) که آیکون در آن استفاده می‌شود، یک منبع آیکون مناسب را برای نمایش آیکون پیدا می‌کند. منابع آیکون می‌توانند فایل‌های XPM یا فایل‌های PNG باشند.

سامانهٔ آیکون میزکار بر اساس «مشخصات پوستهٔ آیکون XDG» در نشانی زیر کار می‌کند: http://www.freedesktop.org/wiki/Specifications/icon-theme-spec

دستورها (COMMANDS)

install

فایل آیکون مشخص‌شده توسط icon-file را با نام icon-name در سامانهٔ آیکون میزکار نصب می‌کند. نام آیکون‌ها پسوند ندارد. اگر icon-name ارائه نشود، این نام از icon-file مشتق می‌شود. فایل آیکون باید دارای پسوند .png یا .xpm باشد. اگر فایل .icon متناظری در همان مکان icon-file وجود داشته باشد، آن نیز نصب خواهد شد.

uninstall

آیکون مشخص‌شده با icon-name را از سامانهٔ آیکون میزکار حذف می‌کند. توجه داشته باشید که نام آیکون‌ها پسوند ندارد.

forceupdate

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

گزینه‌ها (OPTIONS)

--noupdate

به‌روزرسانی سامانهٔ آیکون میزکار را به تعویق می‌اندازد. در صورتی که چندین آیکون به صورت متوالی اضافه شوند، می‌توان از این پرچم برای مشخص کردن این که تغییرات دیگری نیز در راه است و نیازی به به‌روزرسانی فوری سامانهٔ آیکون میزکار نیست استفاده کرد.

--novendor

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

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

--theme theme

فایل آیکون را به عنوان بخشی از پوستهٔ theme نصب یا حذف می‌کند. اگر هیچ پوسته‌ای مشخص نشده باشد، آیکون‌ها به عنوان بخشی از پوستهٔ پیش‌فرض hicolor نصب خواهند شد. برنامه‌ها می‌توانند آیکون‌ها را ذیل چندین پوسته نصب کنند، اما حداقل باید آیکون‌ها را برای پوستهٔ پیش‌فرض hicolor نصب نمایند.

--context context

زمینهٔ (context) آیکون را مشخص می‌کند. آیکون‌هایی که قرار است در منوی برنامه‌ها و به عنوان آیکون میزکار استفاده شوند باید از apps به عنوان زمینه استفاده کنند که زمینهٔ پیش‌فرض است. آیکون‌هایی که برای آیکون فایل‌ها استفاده می‌شوند باید از mimetypes به عنوان زمینه استفاده کنند. سایر زمینه‌های رایج عبارتند از: actions، devices، emblems، filesystems و stock.

--size size

اندازهٔ آیکون را مشخص می‌کند. همهٔ آیکون‌ها باید مربع باشند. اندازه‌های رایج برای آیکون‌ها در زمینهٔ apps عبارتند از: 16، 22، 32، 48، 64 و 128. اندازه‌های رایج برای آیکون‌ها در زمینهٔ mimetypes عبارتند از: 16، 22، 32، 48، 64 و 128.

--mode mode

مقدار mode می‌تواند user یا system باشد. در حالت user، فایل تنها برای کاربر فعلی نصب یا حذف می‌شود. در حالت system، فایل برای تمام کاربران سیستم نصب یا حذف می‌گردد. معمولاً فقط root مجاز به نصب در حالت system است.

پیش‌فرض این است که هنگام فراخوانی توسط root از حالت system و هنگام فراخوانی توسط کاربری غیر از root از حالت user استفاده شود.

--help

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

--manual

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

--version

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

محیط (ENVIRONMENT)

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

XDG_UTILS_DEBUG_LEVEL

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

XDG_UTILS_INSTALL_MODE

این متغیر محیطی می‌تواند توسط کاربر یا مدیر سیستم برای نادیده گرفتن حالت نصب استفاده شود. مقادیر معتبر عبارتند از user و system.

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

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

1

خطا در ساختار دستوری خط فرمان.

2

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

3

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

4

عملیات شکست خورد.

5

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

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

xdg-desktop-icon(1), xdg-desktop-menu(1), xdg-mime(1), Icon theme specification[1]

مثال‌ها (EXAMPLES)

برای نصب یک منبع آیکون جهت نمایش راه‌انداز برنامهٔ myfoobar، شرکت ShinyThings Inc. می‌تواند از دستور زیر استفاده کند:

xdg-icon-resource install --size 64 shinythings-myfoobar.png

برای نصب یک آیکون برای نوع فایل جدید application/x-foobar می‌توان از دستور زیر استفاده کرد:

xdg-icon-resource install --context mimetypes --size 48 ./mime-foobar-48.png application-x-foobar
xdg-icon-resource install --context mimetypes --size 64 ./mime-foobar-64.png application-x-foobar

این دستور دو آیکون با نام application-x-foobar اما با اندازه‌های متفاوت نصب خواهد کرد.

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

Kevin Krammer

نویسنده.

Jeremy White

نویسنده.

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

نکات (NOTES)

1.: Icon theme specification

http://www.freedesktop.org/wiki/Specifications/icon-theme-spec