.\" -*-Nroff-*- .\" .TH "gendesk" 1 "29 May 2026" "" "" .SH "نام (NAME)" gendesk \- ساخت خودکار فایل‌های .desktop بر اساس آرگومان‌های خط فرمان (یا یک فایل PKGBUILD) .SH "خلاصه دستور (SYNOPSIS)" .B gendesk [گزینه‌ها یا فایل PKGBUILD] .SH "توضیحات (DESCRIPTION)" متغیرهای پشتیبانی‌شده PKGBUILD که در فایل تولیدشده قرار می‌گیرند: .sp .B _name .sp .B _genericname .sp .B _comment .sp .B _mimetype .sp .B _exec .sp .B _categories .sp دستور gendesk تلاش می‌کند آیکون مناسب را از کتابخانه Open Icon Library پیدا کند، در غیر این صورت از آیکون پیش‌فرض استفاده خواهد کرد. .sp اگر دسته‌بندی برنامه مشخص نشده باشد، دسته‌بندی صحیح حدس زده خواهد شد. .sp متغیرهای محیطی پشتیبانی‌شده: .sp .B pkgname .sp .B pkgdesc .sp .SH "مثال‌ها (EXAMPLES)" .B gendesk اگر فایل ../PKGBUILD پیدا نشود و pkgname مشخص نشده باشد و متغیر $pkgname نیز تعریف نشده باشد، با کد خطای ۱ خارج می‌شود. تلاش خواهد کرد از هر دو متغیر $pkgname و $pkgdesc استفاده کند. .sp .B gendesk PKGBUILD به دنبال یک فایل PKGBUILD در دایرکتوری جاری می‌گردد و یک فایل .desktop تولید می‌کند. .sp .B gendesk --pkgname test --pkgdesc test یک فایل .desktop برای نام "test" با توضیحات "test" تولید می‌کند. .sp .B gendesk /home/user/archpackages/mypackage/PKGBUILD از فایل PKGBUILD مشخص‌شده، یک فایل .desktop تولید می‌کند. .sp نام بسته باید مشخص شود؛ خواه با تعیین یک فایل PKGBUILD، خواه با استفاده از \-\-pkgname یا با تعریف متغیر محیطی $pkgname. .sp توجه داشته باشید که پسوندهای "\-bin"، "\-git"، "\-hg" یا "\-svn" در نام بسته، در صورت وجود، نادیده گرفته خواهند شد. .PP .SH "گزینه‌ها (OPTIONS)" .TP .B \-\-version نمایش اطلاعات نسخه جاری .TP .B \-h یا \-\-help نمایش اطلاعات کوتاه نحوه استفاده .TP .B \-n در صورت نبود آیکون، برای دانلود آن تلاش نکن .TP .B \-\-nocolor عدم استفاده از متن رنگی .TP .B \-q حالت ساکت؛ عدم نمایش متن خروجی .TP .B \-f حالت اجباری؛ بازنویسی فایل‌ها در صورت نیاز .TP .B \-wm در عوض، تولید یک فایل دسکتاپ کوچک برای اجرای یک مدیر پنجره (window manager) .TP .B \-\-pkgname استفاده از این نام بسته برای برنامه (مانند emacs) .TP .B \-\-pkgdesc استفاده از این توضیحات بسته برای توصیف برنامه و تلاش برای یافتن یک دسته‌بندی مناسب .TP .B \-\-name استفاده از این نام برای میانبر دسکتاپ (مانند Emacs) .TP .B \-\-genericname استفاده از این نام عمومی برای میانبر دسکتاپ (مانند Text Editor) .TP .B \-\-comment استفاده از این یادداشت برای میانبر دسکتاپ (مانند Use this to edit files) .TP .B \-\-exec تعیین یک فایل اجرایی جایگزین (مانند /usr/bin/emacs) .TP .B \-\-path تعیین مسیر شروع برای اجرای برنامه (مانند /usr/share/kotlin) .TP .B \-\-icon تعیین نام فایل آیکون (پیش‌فرض به pkgname است) .TP .B \-\-categories تعیین دسته‌بندی‌ها (مانند Utility;TextEditor;) .TP .B \-\-terminal مشخص کردن اینکه آیا برنامه باید در یک ترمینال اجرا شود یا خیر (پیش‌فرض false است) .TP .B \-\-mimetypes تعیین انواع mime .TP .B \-\-startupnotify تعیین اینکه آیا هنگام شروع به کار برنامه یک اعلان دسکتاپ ارسال شود یا خیر (پیش‌فرض false است) .TP .B \-\-custom تعیین یک خط اضافی (یا چندین خط) برای الحاق به انتهای فایل .TP .B \-o یا \-\-output تعیین نام فایل .desktop خروجی. برای فایل‌های چندبسته‌ای PKGBUILD، یک فهرست جداشده با کاما شامل یک نام فایل به ازای هر بسته مشخص کنید؛ عدم تطابق تعداد منجر به خطا خواهد شد. پیش‌فرض PKGNAME.desktop است. .PP .SH "هدف (WHY)" .sp هدف این برنامه ساده‌سازی افزودن مدخل‌های منو برای بسته‌بندها (package maintainers) جهت برنامه‌هایی است که بسته‌بندی می‌کنند، بدون اینکه مواردی خارج از آنچه بالادست (upstream) در خود بسته ارائه داده است گنجانده شود. .SH "اشکالات (BUGS)" تاکنون تنها اشکالات ناشناخته وجود دارند. اشکالات را می‌توان در نشانی https://github.com/xyproto/gendesk/issues گزارش داد. .SH "نسخه (VERSION)" 1.0.15 .SH "نویسندگان (AUTHORS)" .B gendesk توسط Alexander F. Rødseth نوشته شده است.