نام (NAME)

gendesk - ساخت خودکار فایل‌های .desktop بر اساس آرگومان‌های خط فرمان (یا یک فایل PKGBUILD)

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

gendesk [گزینه‌ها یا فایل PKGBUILD]

توضیحات (DESCRIPTION)

متغیرهای پشتیبانی‌شده PKGBUILD که در فایل تولیدشده قرار می‌گیرند:

_name

_genericname

_comment

_mimetype

_exec

_categories

دستور gendesk تلاش می‌کند آیکون مناسب را از کتابخانه Open Icon Library پیدا کند، در غیر این صورت از آیکون پیش‌فرض استفاده خواهد کرد.

اگر دسته‌بندی برنامه مشخص نشده باشد، دسته‌بندی صحیح حدس زده خواهد شد.

متغیرهای محیطی پشتیبانی‌شده:

pkgname

pkgdesc

مثال‌ها (EXAMPLES)

gendesk اگر فایل ../PKGBUILD پیدا نشود و pkgname مشخص نشده باشد و متغیر $pkgname نیز تعریف نشده باشد، با کد خطای ۱ خارج می‌شود. تلاش خواهد کرد از هر دو متغیر $pkgname و $pkgdesc استفاده کند.

gendesk PKGBUILD به دنبال یک فایل PKGBUILD در دایرکتوری جاری می‌گردد و یک فایل .desktop تولید می‌کند.

gendesk --pkgname test --pkgdesc test یک فایل .desktop برای نام "test" با توضیحات "test" تولید می‌کند.

gendesk /home/user/archpackages/mypackage/PKGBUILD از فایل PKGBUILD مشخص‌شده، یک فایل .desktop تولید می‌کند.

نام بسته باید مشخص شود؛ خواه با تعیین یک فایل PKGBUILD، خواه با استفاده از --pkgname یا با تعریف متغیر محیطی $pkgname.

توجه داشته باشید که پسوندهای "-bin"، "-git"، "-hg" یا "-svn" در نام بسته، در صورت وجود، نادیده گرفته خواهند شد.

گزینه‌ها (OPTIONS)

--version: نمایش اطلاعات نسخه جاری
-h یا --help: نمایش اطلاعات کوتاه نحوه استفاده
-n: در صورت نبود آیکون، برای دانلود آن تلاش نکن
--nocolor: عدم استفاده از متن رنگی
-q: حالت ساکت؛ عدم نمایش متن خروجی
-f: حالت اجباری؛ بازنویسی فایل‌ها در صورت نیاز
-wm: در عوض، تولید یک فایل دسکتاپ کوچک برای اجرای یک مدیر پنجره (window manager)
--pkgname: استفاده از این نام بسته برای برنامه (مانند emacs)
--pkgdesc: استفاده از این توضیحات بسته برای توصیف برنامه و تلاش برای یافتن یک دسته‌بندی مناسب
--name: استفاده از این نام برای میانبر دسکتاپ (مانند Emacs)
--genericname: استفاده از این نام عمومی برای میانبر دسکتاپ (مانند Text Editor)
--comment: استفاده از این یادداشت برای میانبر دسکتاپ (مانند Use this to edit files)
--exec: تعیین یک فایل اجرایی جایگزین (مانند /usr/bin/emacs)
--path: تعیین مسیر شروع برای اجرای برنامه (مانند /usr/share/kotlin)
--icon: تعیین نام فایل آیکون (پیش‌فرض به pkgname است)
--categories: تعیین دسته‌بندی‌ها (مانند Utility;TextEditor;)
--terminal: مشخص کردن اینکه آیا برنامه باید در یک ترمینال اجرا شود یا خیر (پیش‌فرض false است)
--mimetypes: تعیین انواع mime
--startupnotify: تعیین اینکه آیا هنگام شروع به کار برنامه یک اعلان دسکتاپ ارسال شود یا خیر (پیش‌فرض false است)
--custom: تعیین یک خط اضافی (یا چندین خط) برای الحاق به انتهای فایل
-o یا --output: تعیین نام فایل .desktop خروجی. برای فایل‌های چندبسته‌ای PKGBUILD، یک فهرست جداشده با کاما شامل یک نام فایل به ازای هر بسته مشخص کنید؛ عدم تطابق تعداد منجر به خطا خواهد شد. پیش‌فرض PKGNAME.desktop است.

هدف (WHY)

هدف این برنامه ساده‌سازی افزودن مدخل‌های منو برای بسته‌بندها (package maintainers) جهت برنامه‌هایی است که بسته‌بندی می‌کنند، بدون اینکه مواردی خارج از آنچه بالادست (upstream) در خود بسته ارائه داده است گنجانده شود.

اشکالات (BUGS)

تاکنون تنها اشکالات ناشناخته وجود دارند. اشکالات را می‌توان در نشانی https://github.com/xyproto/gendesk/issues گزارش داد.

نسخه (VERSION)

1.0.15

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

gendesk توسط Alexander F. Rødseth <xyproto@archlinux.org> نوشته شده است.