'\" t
.\"     Title: xdg-desktop-icon
.\"    Author: Kevin Krammer
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 12/06/2025
.\"    Manual: xdg-desktop-icon Manual
.\"    Source: xdg-utils 1.0
.\"  Language: Persian
.\"
.TH "XDG\-DESKTOP\-ICON" "1" "12/06/2025" "xdg-utils 1.0" "xdg-desktop-icon 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-desktop-icon \- ابزار خط فرمان برای نصب یا حذف آیکون‌ها روی میزکار
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBxdg\-desktop\-icon\fR\ 'u
\fBxdg\-desktop\-icon\fR install [\fB\-\-novendor\fR] \fIFILE\fR
.HP \w'\fBxdg\-desktop\-icon\fR\ 'u
\fBxdg\-desktop\-icon\fR uninstall \fIFILE\fR
.HP \w'\fBxdg\-desktop\-icon\fR\ 'u
\fBxdg\-desktop\-icon\fR {\fB\-\-help\fR | \fB\-\-manual\fR | \fB\-\-version\fR}
.SH "توضیحات (DESCRIPTION)"
.PP
برنامهٔ xdg\-desktop\-icon می‌تواند برای نصب یک راه‌انداز برنامه یا هر فایل دیگری بر روی میزکار کاربر جاری استفاده شود\&.
.PP
یک راه‌انداز برنامه با یک فایل *\&.desktop نمایش داده می‌شود\&. فایل‌های میزکار توسط مشخصات Desktop Entry متعلق به freedesktop\&.org تعریف شده‌اند\&. مهم‌ترین جنبه‌های فایل‌های *\&.desktop در ادامه خلاصه شده است\&.
.SH "دستورها (COMMANDS)"
.PP
install
.RS 4
\fIFILE\fR
را بر روی میزکار کاربر جاری نصب می‌کند\&.
\fIFILE\fR
می‌تواند یک فایل *\&.desktop یا هر نوع فایل دیگری باشد\&.
.RE
.PP
uninstall
.RS 4
\fIFILE\fR
را از میزکار کاربر جاری حذف می‌کند\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-novendor\fR
.RS 4
به‌طور معمول، xdg\-desktop\-icon بررسی می‌کند تا مطمئن شود فایل *\&.desktop که قرار است نصب شود دارای یک پیشوند سازنده (vendor prefix) باشد\&. از این گزینه می‌توان برای غیرفعال کردن این بررسی استفاده کرد\&.
.sp
یک پیشوند سازنده از نویسه‌های الفبایی ([a\-zA\-Z]) تشکیل شده و به یک خط تیره («\-») ختم می‌شود\&. به شرکت‌ها و سازمان‌ها توصیه می‌شود از یک کلمه یا عبارت، ترجیحاً نام سازمان که برای آن علامت تجاری دارند، به عنوان پیشوند سازندهٔ خود استفاده کنند\&. هدف از پیشوند سازنده، جلوگیری از تداخل نام‌ها است\&.
.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 "فایل‌های میزکار (DESKTOP FILES)"
.PP
یک راه‌انداز برنامه می‌تواند با نصب یک فایل *\&.desktop به میزکار افزوده شود\&. یک فایل *\&.desktop از یک سربرگ
\fI[Desktop Entry]\fR
تشکیل شده است که در ادامهٔ آن چندین سطر
\fIKey\fR=\fIValue\fR
قرار دارد\&.
.PP
یک فایل *\&.desktop می‌تواند نام و توضیحاتی را برای یک برنامه به چندین زبان مختلف ارائه دهد\&. این کار با افزودن کد زبان، همان‌طور که توسط LC_MESSAGES استفاده می‌شود، در قلاب‌ها پس از
\fIKey\fR
انجام می‌پذیرد\&. از این طریق می‌توان بسته به زبان انتخاب‌شدهٔ جاری، مقادیر متفاوتی را برای یک
\fIKey\fR
یکسان مشخص کرد\&.
.PP
کلیدهای زیر اغلب استفاده می‌شوند:
.PP
Type=Application
.RS 4
این یک فیلد الزامی است که نشان می‌دهد فایل *\&.desktop یک راه‌انداز برنامه را توصیف می‌کند\&.
.RE
.PP
Name=\fIApplication Name\fR
.RS 4
نام برنامه\&. برای نمونه
\fIMozilla\fR
.RE
.PP
GenericName=\fIGeneric Name\fR
.RS 4
توصیفی عمومی از برنامه\&. برای نمونه
\fIWeb Browser\fR
.RE
.PP
Comment=\fIComment\fR
.RS 4
فیلد اختیاری برای مشخص کردن یک توضیح متنی کوتاه (tooltip) برای برنامه\&. برای نمونه
\fIVisit websites on the Internet\fR
.RE
.PP
Icon=\fIIcon File\fR
.RS 4
آیکونی که باید برای برنامه استفاده شود\&. این می‌تواند یک مسیر مطلق به یک فایل تصویری یا یک icon\-name باشد\&. اگر یک icon\-name مشخص شود، جستجوی تصویر بر اساس نام در تم آیکون جاری کاربر انجام می‌گیرد\&. از دستور
\fBxdg\-icon\-resource\fR
می‌توان برای نصب فایل‌های تصویری در تم‌های آیکون استفاده کرد\&. مزیت استفاده از icon\-name به جای مسیر مطلق این است که با یک icon\-name، آیکون برنامه می‌تواند در چندین اندازهٔ مختلف و همچنین در سبک‌های گوناگون تم ارائه شود\&.
.RE
.PP
Exec=\fICommand Line\fR
.RS 4
خط فرمان برای اجرای برنامه\&. اگر برنامه بتواند فایل‌ها را باز کند، باید نگه‌دارندهٔ مکان %f مشخص شود\&. هنگامی که فایلی بر روی راه‌انداز برنامه انداخته (drop) می‌شود، %f با مسیر فایل انداخته‌شده جایگزین می‌گردد\&. اگر چندین فایل را بتوان در خط فرمان مشخص کرد، باید به جای %f از نگه‌دارندهٔ مکان %F استفاده شود\&. اگر برنامه علاوه بر فایل‌های محلی قادر به باز کردن URLها نیز باشد، می‌توان به جای %f یا %F از %u یا %U استفاده کرد\&.
.RE
.PP
برای مشاهدهٔ نمای کلی کامل قالب فایل *\&.desktop لطفاً از این نشانی بازدید کنید:
\m[blue]\fB\%http://www.freedesktop.org/wiki/Specifications/desktop-entry-spec\fR\m[]
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
ابزار xdg\-desktop\-icon از متغیرهای محیطی زیر پیروی می‌کند:
.PP
XDG_UTILS_DEBUG_LEVEL
.RS 4
تنظیم این متغیر محیطی به یک مقدار عددی غیرصفر، باعث می‌شود xdg\-desktop\-icon گزارش‌های دقیق‌تری را در stderr ارائه دهد\&. تعیین مقداری بالاتر، میزان جزئیات گزارش را افزایش می‌دهد\&.
.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-icon-resource\fR(1)
.SH "مثال‌ها (EXAMPLES)"
.PP
شرکت ShinyThings Inc\&. برنامه‌ای به نام «WebMirror» توسعه داده است و مایل است یک راه‌انداز برای آن روی میزکار اضافه کند\&. این شرکت از «shinythings» به عنوان شناسهٔ سازندهٔ خود استفاده خواهد کرد\&. برای افزودن برنامه به میزکار، لازم است یک فایل \&.desktop برای برنامه وجود داشته باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
shinythings\-webmirror\&.desktop:

  [Desktop Entry]
  Encoding=UTF\-8
  Type=Application

  Exec=webmirror
  Icon=shinythings\-webmirror

  Name=WebMirror
  Name[nl]=WebSpiegel
.fi
.if n \{\
.RE
.\}
.PP
اکنون می‌توان از ابزار xdg\-desktop\-icon برای افزودن فایل webmirror\&.desktop به میزکار استفاده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
xdg\-desktop\-icon install \&./shinythings\-webmirror\&.desktop
.fi
.if n \{\
.RE
.\}
.PP
برای افزودن یک فایل README نیز به میزکار، می‌توان از دستور زیر استفاده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
xdg\-desktop\-icon install \&./shinythings\-README
.fi
.if n \{\
.RE
.\}
.sp
.SH "نویسندگان (AUTHORS)"
.PP
\fBKevin Krammer\fR
.RS 4
نویسنده.
.RE
.PP
\fBJeremy White\fR
.RS 4
نویسنده.
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.br
Copyright \(co 2006
.br