'\" t .\" Title: xdg-desktop-menu .\" Author: Kevin Krammer .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 12/06/2025 .\" Manual: xdg-desktop-menu Manual .\" Source: xdg-utils 1.0 .\" Language: Persian .\" .TH "XDG\-DESKTOP\-MENU" "1" "12/06/2025" "xdg-utils 1.0" "xdg-desktop-menu 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-menu \- ابزار خط فرمان برای نصب یا حذف موارد منوی میزکار .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBxdg\-desktop\-menu\fR\ 'u \fBxdg\-desktop\-menu\fR install [\fB\-\-noupdate\fR] [\fB\-\-novendor\fR] [\fB\-\-mode\ \fR\fB\fImode\fR\fR] \fIdirectory\-file(s)\fR \fIdesktop\-file(s)\fR .HP \w'\fBxdg\-desktop\-menu\fR\ 'u \fBxdg\-desktop\-menu\fR uninstall [\fB\-\-noupdate\fR] [\fB\-\-mode\ \fR\fB\fImode\fR\fR] \fIdirectory\-file(s)\fR \fIdesktop\-file(s)\fR .HP \w'\fBxdg\-desktop\-menu\fR\ 'u \fBxdg\-desktop\-menu\fR forceupdate [\fB\-\-mode\ \fR\fB\fImode\fR\fR] .HP \w'\fBxdg\-desktop\-menu\fR\ 'u \fBxdg\-desktop\-menu\fR {\fB\-\-help\fR | \fB\-\-manual\fR | \fB\-\-version\fR} .SH "توضیحات (DESCRIPTION)" .PP برنامهٔ \fBxdg\-desktop\-menu\fR می‌تواند برای نصب مدخل‌های منوی جدید در منوی برنامه‌های میزکار استفاده شود\&. .PP منوی برنامه‌ها بر اساس «مشخصات منوی میزکار XDG» کار می‌کند که در نشانی زیر در دسترس است: \m[blue]\fB\%http://www.freedesktop.org/wiki/Specifications/menu-spec\fR\m[] .SH "دستورها (COMMANDS)" .PP install .RS 4 نصب یک یا چند برنامه در یک زیرمنو از سامانهٔ منوی میزکار\&. .sp \fIdesktop\-file\fR: یک فایل desktop نشان‌دهندهٔ یک مدخل منفرد در منو است\&. فایل‌های desktop بر اساس «مشخصات مدخل میزکار» freedesktop\&.org تعریف می‌شوند\&. مهم‌ترین جنبه‌های فایل‌های *\&.desktop در ادامه خلاصه شده‌اند\&. .sp مدخل‌های منو می‌توانند به دو روش گوناگون به سامانهٔ منو افزوده شوند\&. آن‌ها می‌توانند بر اساس یک یا چند کلیدواژهٔ دسته‌بندی به یک زیرمنوی از پیش‌تعریف‌شده اضافه شوند، یا اینکه به یک زیرمنوی جدید اضافه گردند\&. .sp برای افزودن مدخل منو به یک زیرمنوی از پیش‌تعریف‌شده، فایل desktop که نمایندهٔ آن مدخل است باید شامل مدخل Categories= باشد که یک یا چند کلیدواژه را فهرست می‌کند\&. مورد منو بر اساس کلیدواژه‌های ذکرشده در زیرمنوی مناسب قرار خواهد گرفت\&. .sp برای افزودن موارد منو به یک زیرمنوی جدید، پیش از desktop\-fileها باید یک directory\-file قرار گیرد که آن زیرمنو را توصیف می‌کند\&. اگر چند desktop\-file مشخص شده باشد، همهٔ مدخل‌ها به همان منو افزوده می‌شوند\&. اگر مدخل‌ها در منویی نصب شوند که پیش‌تر با فراخوانی دیگری از \fBxdg\-desktop\-menu\fR ایجاد شده است، موارد جدید به مدخل‌های موجود اضافه خواهند شد\&. .sp \fIdirectory\-file\fR: فایل *\&.directory که توسط \fIdirectory\-file\fR مشخص می‌شود، بیانگر یک زیرمنو است\&. فایل directory نام و شمایل (آیکون) زیرمنو را فراهم می‌کند\&. نام فایل directory برای شناسایی زیرمنو به کار می‌رود\&. .sp در صورتی که چند فایل directory ارائه شوند، هر فایل نمایندهٔ یک زیرمنو درون منوی پیش از خود خواهد بود و سلسله‌مراتبی تودرتو از منوها (زیر\-زیرمنوها) ایجاد می‌کند\&. خود مدخل‌های منو به آخرین زیرمنو افزوده خواهند شد\&. .sp فایل‌های directory از ساختار نحوی تعریف‌شده در «مشخصات مدخل میزکار» freedesktop\&.org پیروی می‌کنند\&. .RE .PP uninstall .RS 4 حذف برنامه‌ها یا زیرمنوهایی از سامانهٔ منوی میزکار که پیش‌تر با \fBxdg\-desktop\-menu install\fR نصب شده‌اند\&. .sp یک زیرمنو و فایل directory مربوط به آن تنها زمانی حذف می‌شوند که آن زیرمنو دیگر حاوی هیچ مدخل منویی نباشد\&. .RE .PP forceupdate .RS 4 اجبار به به‌روزرسانی سامانهٔ منو\&. .sp این دستور تنها در صورتی کاربرد دارد که آخرین فراخوانی xdg\-desktop\-menu با گزینهٔ \fB\-\-noupdate\fR همراه بوده باشد\&. .RE.SH "گزینه‌ها (OPTIONS)" .PP \fB\-\-noupdate\fR .RS 4 به‌روزرسانی سامانهٔ منو را به تعویق می‌اندازد\&. اگر چندین به‌روزرسانی در سامانهٔ منو به صورت پیاپی انجام می‌شود، این پرچم می‌تواند برای مشخص کردن این‌که تغییرات دیگری نیز در راه است و نیازی به به‌روزرسانی فوری سامانهٔ منو نیست، استفاده شود\&. .RE .PP \fB\-\-novendor\fR .RS 4 به‌طور معمول، xdg\-desktop\-menu بررسی می‌کند تا اطمینان حاصل شود هر فایل *\&.directory و *\&.desktop که قرار است نصب شود دارای پیشوند سازنده (vendor prefix) باشد\&. این گزینه می‌تواند برای غیرفعال کردن این بررسی به کار رود\&. .sp یک پیشوند سازنده شامل نویسه‌های الفبایی ([a\-zA\-Z]) بوده و با یک خط تیره ("\-") خاتمه می‌یابد\&. به شرکت‌ها و سازمان‌ها توصیه می‌شود که از یک کلمه یا عبارت، ترجیحاً نام سازمان که علامت تجاری آن را در اختیار دارند، به عنوان پیشوند سازندهٔ خود استفاده کنند\&. هدف از پیشوند سازنده، جلوگیری از تداخل نام‌ها است\&. .RE .PP \fB\-\-mode\fR \fImode\fR .RS 4 \fImode\fR می‌تواند \fIuser\fR یا \fIsystem\fR باشد\&. در حالت کاربر (user)، فایل فقط برای کاربر فعلی نصب یا حذف می‌شود\&. در حالت سیستم (system)، فایل برای تمام کاربران روی سیستم نصب یا حذف می‌شود\&. معمولاً تنها کاربر ریشه (root) اجازه دارد در حالت سیستم نصب را انجام دهد\&. .sp حالت پیش‌فرض این است که هنگام فراخوانی توسط root از حالت سیستم استفاده شود و هنگام فراخوانی توسط کاربری غیر از root از حالت کاربر استفاده گردد\&. .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 به جای مسیر مطلق این است که با نام شمایل، می‌توان شمایل برنامه را در چندین اندازهٔ مختلف و همچنین در سبک‌های متفاوتی از تم ارائه داد\&. .RE .PP Exec=\fICommand Line\fR .RS 4 خط فرمان برای راه‌اندازی برنامه\&. اگر برنامه می‌تواند فایل‌ها را باز کند، جای‌نگهدار %f باید مشخص شود\&. هنگامی که فایلی روی راه‌انداز برنامه رها (drop) می‌شود، %f با مسیر فایلِ رهاشده جایگزین می‌شود\&. اگر بتوان چندین فایل را در خط فرمان مشخص کرد، باید به جای %f از جای‌نگهدار %F استفاده شود\&. اگر برنامه علاوه بر فایل‌های محلی قادر به باز کردن URLها نیز باشد، می‌توان به جای %f یا %F از %u یا %U استفاده کرد\&. .RE .PP Categories=\fICategories\fR .RS 4 فهرستی از دسته‌ها که با نقطه\-ویرگول از یکدیگر جدا شده‌اند\&. یک دسته، کلیدواژه‌ای است که برنامه را توصیف و طبقه‌بندی می‌کند\&. به‌طور پیش‌فرض، برنامه‌ها در منوی برنامه‌ها بر اساس دسته سازمان‌دهی می‌شوند\&. هنگامی که مدخل‌های منو صریحاً به یک زیرمنوی جدید اختصاص داده شده باشند، نیازی به ذکر هیچ دسته‌ای نیست\&. .sp هنگام استفاده از دسته‌ها، توصیه می‌شود یکی از دسته‌های زیر گنجانده شود: AudioVideo، Development، Education، Game، Graphics، Network، Office، Settings، System، Utility\&. .sp برای اطلاعات بیشتر در مورد دسته‌های اضافی، به پیوست A از مشخصات منوی دسکتاپ XDG مراجعه کنید: \m[blue]\fB\%http://standards.freedesktop.org/menu-spec/menu-spec-1.0.html#category-registry\fR\m[] .RE .PP MimeType=\fIMimetypes\fR .RS 4 فهرستی از نوع‌های MIME که با نقطه\-ویرگول از هم جدا شده‌اند\&. این فیلد برای مشخص کردن نوع فایل‌هایی که برنامه قادر به باز کردن آن‌ها است، به کار می‌رود\&. .RE .PP برای بررسی کامل قالب فایل *\&.desktop لطفاً پیوند زیر را ببینید: \m[blue]\fB\%http://www.freedesktop.org/wiki/Specifications/desktop-entry-spec\fR\m[].SH "فایل‌های دایرکتوری (DIRECTORY FILES)" .PP ظاهر زیرمنو در منوی برنامه‌ها توسط یک فایل *\&.directory تأمین می‌شود\&. به طور خاص، این فایل عنوان زیرمنو و در صورت وجود، آیکون آن را مشخص می‌کند\&. یک فایل *\&.directory شامل سرآیند \fI[Desktop Entry]\fR است که در پی آن چندین خط \fIKey\fR=\fIValue\fR می‌آیند\&. .PP یک فایل *\&.directory می‌تواند عنوان (نام) زیرمنو را به چندین زبان مختلف ارائه دهد\&. این کار با افزودن یک کد زبان مشابه آنچه توسط LC_MESSAGES استفاده می‌شود در کروشه پس از \fIKey\fR انجام می‌پذیرد\&. بدین ترتیب می‌توان مقادیر مختلفی را برای یک \fIKey\fR یکسان بسته به زبان انتخاب‌شده فعلی تعیین کرد\&. .PP کلیدهای زیر برای زیرمنوها کاربرد دارند: .PP Type=Directory .RS 4 این فیلد اجباری است و مشخص می‌کند که فایل *\&.directory یک زیرمنو را توصیف می‌کند\&. .RE .PP Name=\fIMenu Name\fR .RS 4 عنوان زیرمنو\&. برای مثال \fIMozilla\fR .RE .PP Comment=\fIComment\fR .RS 4 فیلدی اختیاری برای تعیین یک پیش‌نمایش متنی (tooltip) برای زیرمنو\&. .RE .PP Icon=\fIIcon File\fR .RS 4 آیکونی که برای زیرمنو استفاده می‌شود\&. این مقدار می‌تواند یک مسیر مطلق به یک فایل تصویر یا یک icon\-name باشد\&. اگر یک icon\-name ارائه شود، جستجوی تصویر بر اساس نام در تم آیکون فعلی کاربر انجام می‌گیرد\&. از دستور \fBxdg\-icon\-resource\fR می‌توان برای نصب فایل‌های تصویری در تم‌های آیکون استفاده کرد\&. مزیت استفاده از icon\-name به جای مسیر مطلق این است که با یک icon\-name، آیکون زیرمنو می‌تواند در چندین اندازه مختلف و همچنین در چندین سبک و تم متفاوت ارائه شود\&. .RE .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .PP دستور xdg\-desktop\-menu از متغیرهای محیطی زیر پیروی می‌کند: .PP XDG_UTILS_DEBUG_LEVEL .RS 4 تنظیم این متغیر محیطی روی یک مقدار عددی غیرصفر باعث می‌شود xdg\-desktop\-menu گزارش‌های پرجزئیات‌تری را در stderr ارائه دهد\&. تنظیم مقادیر بالاتر، میزان جزئیات را افزایش می‌دهد\&. .RE .PP XDG_UTILS_INSTALL_MODE .RS 4 این متغیر محیطی می‌تواند توسط کاربر یا مدیر سیستم برای لغو و تغییر حالت نصب (installation mode) استفاده شود\&. مقادیر معتبر عبارتند از \fIuser\fR و \fIsystem\fR\&. .RE .SH "کدهای خروج (EXIT CODES)" .PP کد خروج 0 نشان‌دهنده موفقیت است، در حالی که کد خروج غیرصفر بیانگر شکست عملیات است\&. کدهای خطای زیر ممکن است بازگردانده شوند: .PP \fB1\fR .RS 4 خطا در نحو (syntax) خط فرمان\&. .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-icon-resource\fR(1), \fBxdg-mime\fR(1), \m[blue]\fBDesktop entry specification\fR\m[]\&\s-2\u[1]\d\s+2, \m[blue]\fBDesktop menu specification\fR\m[]\&\s-2\u[2]\d\s+2 .SH "مثال‌ها (EXAMPLES)" .PP شرکت ShinyThings Inc\&. برنامه‌ای به نام «WebMirror» توسعه داده است و می‌خواهد آن را به منوی برنامه‌ها اضافه کند\&. این شرکت از «shinythings» به عنوان vendor id خود استفاده خواهد کرد\&. برای افزودن برنامه به منو، وجود یک فایل \&.desktop با یک مدخل \fICategories\fR مناسب الزامی است: .sp .if n \{\ .RS 4 .\} .nf shinythings\-webmirror\&.desktop: [Desktop Entry] Encoding=UTF\-8 Type=Application Exec=webmirror Icon=webmirror Name=WebMirror Name[nl]=WebSpiegel Categories=Network;WebDevelopment; .fi .if n \{\ .RE .\} .PP اکنون می‌توان از ابزار xdg\-desktop\-menu برای افزودن فایل shinythings\-webmirror\&.desktop به منوی برنامه‌های میزکار استفاده کرد: .sp .if n \{\ .RS 4 .\} .nf xdg\-desktop\-menu install \&./shinythings\-webmirror\&.desktop .fi .if n \{\ .RE .\} .PP توجه داشته باشید که در این مثال، موارد منو به دو زبان انگلیسی و هلندی ارائه شده‌اند\&. کد زبان هلندی nl است\&. .PP در مثال بعد، شرکت ShinyThings Inc\&. زیرمنوی اختصاصی خود را که شامل یک مورد منوی «WebMirror» و یک مورد منوی «WebMirror Admin Tool» است، به منوی برنامه‌های میزکار اضافه خواهد کرد\&. .PP ابتدا این شرکت باید دو فایل \&.desktop ایجاد کند که این دو مورد منو را توصیف می‌کنند\&. از آنجا که این موارد قرار است به یک زیرمنوی جدید اضافه شوند، نیازی به قرار دادن خط Categories= نیست: .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 shinythings\-webmirror\-admin\&.desktop: [Desktop Entry] Encoding=UTF\-8 Type=Application Exec=webmirror\-admintool Icon=shinythings\-webmirror\-admintool Name=WebMirror Admin Tool Name[nl]=WebSpiegel Administratie Tool .fi .if n \{\ .RE .\} .PP علاوه بر این، برای مشخص کردن عنوان و آیکون خودِ زیرمنو، باید یک فایل \&.directory نیز ایجاد شود: .sp .if n \{\ .RS 4 .\} .nf shinythings\-webmirror\&.directory: [Desktop Entry] Encoding=UTF\-8 Icon=shinythings\-webmirror\-menu Name=WebMirror Name[nl]=WebSpiegel .fi .if n \{\ .RE .\} .PP اکنون می‌توان این فایل‌ها را با دستور زیر نصب کرد: .sp .if n \{\ .RS 4 .\} .nf xdg\-desktop\-menu install \&./shinythings\-webmirror\&.directory \e \&./shinythings\-webmirror\&.desktop \&./shinythings\-webmirror\-admin\&.desktop .fi .if n \{\ .RE .\} .PP همچنین می‌توان مدخل‌های منو را به صورت تک‌تک نصب کرد: .sp .if n \{\ .RS 4 .\} .nf xdg\-desktop\-menu install \-\-noupdate \&./shinythings\-webmirror\&.directory \e \&./shinythings\-webmirror\&.desktop xdg\-desktop\-menu install \-\-noupdate \&./shinythings\-webmirror\&.directory \e \&./shinythings\-webmirror\-admin\&.desktop xdg\-desktop\-menu forceupdate .fi .if n \{\ .RE .\} .PP اگرچه نتیجه یکسان است، ولی نصب هم‌زمان همهٔ فایل‌ها کمی بهینه‌تر است\&. .PP فایل‌های *\&.desktop و *\&.directory به آیکون‌هایی با نام‌های webmirror، webmirror\-admin و webmirror\-menu ارجاع می‌دهند که آن‌ها نیز باید نصب شوند\&. در این مثال، آیکون‌ها در دو اندازهٔ مختلف نصب می‌شوند: یک‌بار با اندازهٔ 22x22 پیکسل و یک‌بار با اندازهٔ 64x64 پیکسل: .sp .if n \{\ .RS 4 .\} .nf xdg\-icon\-resource install \-\-size 22 \&./wmicon\-22\&.png shinythings\-webmirror xdg\-icon\-resource install \-\-size 22 \&./wmicon\-menu\-22\&.png shinythings\-webmirror\-menu xdg\-icon\-resource install \-\-size 22 \&./wmicon\-admin\-22\&.png shinythings\-webmirror\-admin xdg\-icon\-resource install \-\-size 64 \&./wmicon\-64\&.png shinythings\-webmirror xdg\-icon\-resource install \-\-size 64 \&./wmicon\-menu\-64\&.png shinythings\-webmirror\-menu xdg\-icon\-resource install \-\-size 64 \&./wmicon\-admin\-64\&.png shinythings\-webmirror\-admin .fi .if n \{\ .RE .\} .sp.SH "نویسندگان (AUTHORS)" .PP \fBKevin Krammer\fR .RS 4 نویسنده. .RE .PP \fBJeremy White\fR .RS 4 نویسنده. .RE .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .br کپی‌رایت \(co 2006 .br .SH "نکات (NOTES)" .IP " 1." 4 مشخصات Desktop entry .RS 4 \%http://www.freedesktop.org/wiki/Specifications/desktop-entry-spec .RE .IP " 2." 4 مشخصات Desktop menu .RS 4 \%http://www.freedesktop.org/wiki/Specifications/menu-spec .RE