'\" t
.\"     Title: xdg-icon-resource
.\"    Author: Kevin Krammer
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 12/06/2025
.\"    Manual: xdg-icon-resource Manual
.\"    Source: xdg-utils 1.0
.\"  Language: Persian
.\"
.TH "XDG\-ICON\-RESOURCE" "1" "12/06/2025" "xdg-utils 1.0" "xdg-icon-resource Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
xdg-icon-resource \- ابزار خط فرمان برای نصب و حذف منابع آیکون
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBxdg\-icon\-resource\fR\ 'u
\fBxdg\-icon\-resource\fR install [\fB\-\-noupdate\fR] [\fB\-\-novendor\fR] [\fB\-\-theme\ \fR\fB\fItheme\fR\fR] [\fB\-\-context\ \fR\fB\fIcontext\fR\fR] [\fB\-\-mode\ \fR\fB\fImode\fR\fR] \fB\-\-size\ \fR\fB\fIsize\fR\fR \fIicon\-file\fR [\fIicon\-name\fR]
.HP \w'\fBxdg\-icon\-resource\fR\ 'u
\fBxdg\-icon\-resource\fR uninstall [\fB\-\-noupdate\fR] [\fB\-\-theme\ \fR\fB\fItheme\fR\fR] [\fB\-\-context\ \fR\fB\fIcontext\fR\fR] [\fB\-\-mode\ \fR\fB\fImode\fR\fR] \fB\-\-size\ \fR\fB\fIsize\fR\fR \fIicon\-name\fR
.HP \w'\fBxdg\-icon\-resource\fR\ 'u
\fBxdg\-icon\-resource\fR forceupdate [\fB\-\-theme\ \fR\fB\fItheme\fR\fR] [\fB\-\-mode\ \fR\fB\fImode\fR\fR]
.HP \w'\fBxdg\-icon\-resource\fR\ 'u
\fBxdg\-icon\-resource\fR {\fB\-\-help\fR | \fB\-\-manual\fR | \fB\-\-version\fR}
.SH "توضیحات (DESCRIPTION)"
.PP
برنامهٔ xdg\-icon\-resource می‌تواند برای نصب منابع آیکون در سامانهٔ آیکون میزکار به منظور مصورسازی ورودی‌های منو، نمایش آیکون‌های میزکار یا نمایش گرافیکی انواع فایل استفاده شود\&.
.PP
سامانهٔ آیکون میزکار، آیکون‌ها را با نام شناسایی می‌کند\&. این سامانه بسته به اندازهٔ مورد نیاز، پوستهٔ انتخابی آیکون و زمینه‌ای (context) که آیکون در آن استفاده می‌شود، یک منبع آیکون مناسب را برای نمایش آیکون پیدا می‌کند\&. منابع آیکون می‌توانند فایل‌های XPM یا فایل‌های PNG باشند\&.
.PP
سامانهٔ آیکون میزکار بر اساس «مشخصات پوستهٔ آیکون XDG» در نشانی زیر کار می‌کند:
\m[blue]\fB\%http://www.freedesktop.org/wiki/Specifications/icon-theme-spec\fR\m[]
.SH "دستورها (COMMANDS)"
.PP
install
.RS 4
فایل آیکون مشخص‌شده توسط
\fIicon\-file\fR
را با نام
\fIicon\-name\fR
در سامانهٔ آیکون میزکار نصب می‌کند\&. نام آیکون‌ها پسوند ندارد\&. اگر
\fIicon\-name\fR
ارائه نشود، این نام از
\fIicon\-file\fR
مشتق می‌شود\&. فایل آیکون باید دارای پسوند
\fI\&.png\fR
یا
\fI\&.xpm\fR
باشد\&. اگر فایل
\fI\&.icon\fR
متناظری در همان مکان
\fIicon\-file\fR
وجود داشته باشد، آن نیز نصب خواهد شد\&.
.RE
.PP
uninstall
.RS 4
آیکون مشخص‌شده با
\fIicon\-name\fR
را از سامانهٔ آیکون میزکار حذف می‌کند\&. توجه داشته باشید که نام آیکون‌ها پسوند ندارد\&.
.RE
.PP
forceupdate
.RS 4
به‌روزرسانی اجباری سامانهٔ آیکون میزکار\&. این دستور تنها در صورتی مفید است که آخرین فراخوانی xdg\-icon\-resource شامل گزینهٔ
\fB\-\-noupdate\fR
بوده باشد\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-noupdate\fR
.RS 4
به‌روزرسانی سامانهٔ آیکون میزکار را به تعویق می‌اندازد\&. در صورتی که چندین آیکون به صورت متوالی اضافه شوند، می‌توان از این پرچم برای مشخص کردن این که تغییرات دیگری نیز در راه است و نیازی به به‌روزرسانی فوری سامانهٔ آیکون میزکار نیست استفاده کرد\&.
.RE
.PP
\fB\-\-novendor\fR
.RS 4
به‌طور معمول، xdg\-icon\-resource بررسی می‌کند تا مطمئن شود فایل آیکونی که قرار است در زمینهٔ
\fIapps\fR
نصب شود، دارای یک پیشوند سازندهٔ (vendor prefix) مناسب است\&. از این گزینه می‌توان برای غیرفعال کردن این بررسی استفاده کرد\&.
.sp
یک پیشوند سازنده شامل نویسه‌های الفبایی ([a\-zA\-Z]) است و به یک خط تیره ("\-") ختم می‌شود\&. شرکت‌ها و سازمان‌ها تشویق می‌شوند از یک کلمه یا عبارت، ترجیحاً نام سازمان، که علامت تجاری آن را در اختیار دارند به عنوان پیشوند سازنده استفاده کنند\&. هدف از پیشوند سازنده جلوگیری از تداخل نام‌ها است\&.
.RE
.PP
\fB\-\-theme\fR \fItheme\fR
.RS 4
فایل آیکون را به عنوان بخشی از پوستهٔ
\fItheme\fR
نصب یا حذف می‌کند\&. اگر هیچ پوسته‌ای مشخص نشده باشد، آیکون‌ها به عنوان بخشی از پوستهٔ پیش‌فرض
\fIhicolor\fR
نصب خواهند شد\&. برنامه‌ها می‌توانند آیکون‌ها را ذیل چندین پوسته نصب کنند، اما حداقل باید آیکون‌ها را برای پوستهٔ پیش‌فرض
\fIhicolor\fR
نصب نمایند\&.
.RE
.PP
\fB\-\-context\fR \fIcontext\fR
.RS 4
زمینهٔ (context) آیکون را مشخص می‌کند\&. آیکون‌هایی که قرار است در منوی برنامه‌ها و به عنوان آیکون میزکار استفاده شوند باید از
\fIapps\fR
به عنوان زمینه استفاده کنند که زمینهٔ پیش‌فرض است\&. آیکون‌هایی که برای آیکون فایل‌ها استفاده می‌شوند باید از
\fImimetypes\fR
به عنوان زمینه استفاده کنند\&. سایر زمینه‌های رایج عبارتند از:
\fIactions\fR،
\fIdevices\fR،
\fIemblems\fR،
\fIfilesystems\fR
و
\fIstock\fR\&.
.RE
.PP
\fB\-\-size\fR \fIsize\fR
.RS 4
اندازهٔ آیکون را مشخص می‌کند\&. همهٔ آیکون‌ها باید مربع باشند\&. اندازه‌های رایج برای آیکون‌ها در زمینهٔ apps عبارتند از: 16، 22، 32، 48، 64 و 128\&. اندازه‌های رایج برای آیکون‌ها در زمینهٔ mimetypes عبارتند از: 16، 22، 32، 48، 64 و 128\&.
.RE
.PP
\fB\-\-mode\fR \fImode\fR
.RS 4
مقدار
\fImode\fR
می‌تواند
\fIuser\fR
یا
\fIsystem\fR
باشد\&. در حالت user، فایل تنها برای کاربر فعلی نصب یا حذف می‌شود\&. در حالت system، فایل برای تمام کاربران سیستم نصب یا حذف می‌گردد\&. معمولاً فقط root مجاز به نصب در حالت system است\&.
.sp
پیش‌فرض این است که هنگام فراخوانی توسط root از حالت system و هنگام فراخوانی توسط کاربری غیر از root از حالت user استفاده شود\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
نمایش خلاصهٔ دستور\&.
.RE
.PP
\fB\-\-manual\fR
.RS 4
نمایش این صفحهٔ راهنما\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش اطلاعات نسخهٔ xdg\-utils\&.
.RE
.SH "محیط (ENVIRONMENT)"
.PP
دستور xdg\-icon\-resource از متغیرهای محیطی زیر پیروی می‌کند:
.PP
XDG_UTILS_DEBUG_LEVEL
.RS 4
تنظیم این متغیر محیطی روی یک مقدار عددی غیرصفر باعث می‌شود xdg\-icon\-resource گزارش‌های مفصل‌تری در stderr ارائه دهد\&. تنظیم مقادیر بالاتر، میزان جزئیات را افزایش می‌دهد\&.
.RE
.PP
XDG_UTILS_INSTALL_MODE
.RS 4
این متغیر محیطی می‌تواند توسط کاربر یا مدیر سیستم برای نادیده گرفتن حالت نصب استفاده شود\&. مقادیر معتبر عبارتند از
\fIuser\fR
و
\fIsystem\fR\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
کد خروج 0 نشان‌دهندهٔ موفقیت است، در حالی که کد خروج غیرصفر نشان‌دهندهٔ شکست است\&. کدهای خطای زیر ممکن است برگردانده شوند:
.PP
\fB1\fR
.RS 4
خطا در ساختار دستوری خط فرمان\&.
.RE
.PP
\fB2\fR
.RS 4
یکی از فایل‌های ارائه‌شده در خط فرمان وجود ندارد\&.
.RE
.PP
\fB3\fR
.RS 4
ابزار مورد نیاز یافت نشد\&.
.RE
.PP
\fB4\fR
.RS 4
عملیات شکست خورد\&.
.RE
.PP
\fB5\fR
.RS 4
عدم دسترسی برای خواندن یکی از فایل‌های ارائه‌شده در خط فرمان\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBxdg-desktop-icon\fR(1),
\fBxdg-desktop-menu\fR(1),
\fBxdg-mime\fR(1),
\m[blue]\fBIcon theme specification\fR\m[]\&\s-2\u[1]\d\s+2
.SH "مثال‌ها (EXAMPLES)"
.PP
برای نصب یک منبع آیکون جهت نمایش راه‌انداز برنامهٔ myfoobar، شرکت ShinyThings Inc\&. می‌تواند از دستور زیر استفاده کند:
.sp
.if n \{\
.RS 4
.\}
.nf
xdg\-icon\-resource install \-\-size 64 shinythings\-myfoobar\&.png
.fi
.if n \{\
.RE
.\}
.PP
برای نصب یک آیکون برای نوع فایل جدید application/x\-foobar می‌توان از دستور زیر استفاده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
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
.fi
.if n \{\
.RE
.\}
.sp
این دستور دو آیکون با نام application\-x\-foobar اما با اندازه‌های متفاوت نصب خواهد کرد\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBKevin Krammer\fR
.RS 4
نویسنده.
.RE
.PP
\fBJeremy White\fR
.RS 4
نویسنده.
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.br
Copyright \(co 2006
.br
.SH "نکات (NOTES)"
.IP " 1." 4
Icon theme specification
.RS 4
\%http://www.freedesktop.org/wiki/Specifications/icon-theme-spec
.RE