PKGCTL-VERSION-SETUP(1)                                PKGCTL-VERSION-SETUP(1)

نام (NAME)
       pkgctl-version-setup - تشخیص خودکار و راه‌اندازی پیکربندی اولیه برای
       nvchecker

خلاصه دستور (SYNOPSIS)
       pkgctl version setup [OPTIONS] [PKGBASE...]

توضیحات (DESCRIPTION)
       این زیردستور با تحلیل آرایه منبع (source) مشخص‌شده در فایل PKGBUILD(1)
       یک بسته، ساخت یک فایل پیکربندی پایه‌ای nvchecker(1) را خودکارسازی می‌کند.
       این دستور پلتفرم‌ها و APIهای مختلف استفاده‌شده توسط منابع بسته (مانند
       GitHub، GitLab و PyPI) را به صورت هوشمند تشخیص داده و بر اساس بهترین
       حدس خود، یک پیکربندی .nvchecker.toml متناظر تولید می‌کند.

       این ابزار به‌ویژه برای راه‌اندازی تنظیمات nvchecker(1) برای یک بسته بدون
       نیاز به نوشتن دستی فایل .nvchecker.toml بسیار سودمند است. همچنین فرآیند
       تنظیم بررسی نسخه‌ها را ساده می‌کند، به‌ویژه هنگام انتقال نظارت بر یک بسته
       از یک پلتفرم منبع به پلتفرمی دیگر یا آغاز بررسی نسخه برای یک بسته جدید.

       اگر هیچ PKGBASE مشخص نشود، این دستور به‌طور پیش‌فرض از دایرکتوری کاری
       جاری استفاده می‌کند.

       برای مشاهده فهرستی از منابع پشتیبانی‌شده و قالب‌های مورد انتظار نشانی
       اینترنتی (URL) آن‌ها، لطفاً به بخش منابع مراجعه کنید.

گزینه‌ها (OPTIONS)
       -f, --force
           بازنویسی پیکربندی موجود nvchecker(1)

       --prefer-platform-api
           ترجیح دادن API اختصاصی پلتفرم (GitHub/GitLab) به گیت در موارد
           پیچیده

       --url URL
           استخراج هدف بررسی از نشانی اینترنتی داده‌شده به جای ورودی‌های آرایه
           منبع

       --no-check
           عدم اجرای pkgctl-version-check(1) پس از راه‌اندازی

       --no-upstream
           ایجاد یک پیکربندی خالی برای بسته‌های فاقد منابع بالادست، مانند
           فرابسته‌ها (meta packages). این گزینه فقط باید برای موارد بدون
           بالادست استفاده شود؛ لطفاً برای منابع بالادستی که پیکربندی آن‌ها
           دشوار است، جهت راهنمایی با تیم توسعه‌دهندگان تماس بگیرید.

       -h, --help
           نمایش متن راهنما

منابع (SOURCES)
       در اینجا پلتفرم‌ها و منابع پشتیبانی‌شده فعلی، به همراه نمونه‌هایی از
       قالب‌های نشانی اینترنتی (URL) که امکان تشخیص خودکار آن‌ها را به عنوان
       انواع منابع خاص فراهم می‌کنند، آورده شده است:

       Git

           •    <https://github.com/example/project>

           •    <https://gitlab.com/example/group/project>

           •   git://git.foobar.org/example

           •   git+https://git.foobar.org/example

       GitHub

           •    <https://github.com/example/project>

           •
               <https://github.com/example/project/archive/v1.0/project-v1.0.tar.gz>

       GitLab

           •    <https://gitlab.com/example/group/project>

           •    <https://gitlab.archlinux.org/archlinux/devtools.git>

           •
               <https://gitlab.archlinux.org/archlinux/devtools/-/releases/v1.1.0/downloads/devtools-v1.1.0.tar.gz>

       Hackage

           •    <https://hackage.haskell.org/package/xmonad>

           •
               <https://hackage.haskell.org/package/xmonad-0.18.0/xmonad-0.18.0.tar.gz>

           •
               <https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad-0.18.0.tar.gz>

       NPM

           •    <https://registry.npmjs.org/node-gyp/-/node-gyp-10.0.1.tgz>

           •    <https://www.npmjs.com/package/node-gyp>

       PyPI

           •    <https://pypi.io/packages/source/p/pyflakes>

           •    <https://pypi.org/packages/source/b/bleach>

           •    <https://files.pythonhosted.org/packages/source/p/pyflakes>

           •    <https://pypi.org/project/SQLAlchemy>

       RubyGems

           •    <https://rubygems.org/downloads/diff-lcs-1.5.1.gem>

           •    <https://rubygems.org/gems/diff-lcs>

       CPAN

           •
               <https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz>

           •
               <https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz>

       crates.io

           •    <https://static.crates.io/crates/shotgun/shotgun-1.0.crate>

           •    <https://crates.io/api/v1/crates/shotgun/1.0/download>

           •    <https://crates.io/crates/git-smash>

مثال‌ها (EXAMPLES)
       pkgctl version setup
           منبع را از PKGBUILD(1) دایرکتوری جاری تشخیص داده و یک فایل
           .nvchecker.toml پایه را راه‌اندازی می‌کند.

       pkgctl version setup --url  <https://github.com/example/project>
           یک فایل .nvchecker.toml برای PKGBUILD(1) جاری تولید می‌کند اما نشانی
           اینترنتی منبع را با پروژه مشخص‌شده در گیت‌هاب جایگزین می‌نماید.

همچنین ببینید (SEE ALSO)
       pkgctl-version(1) pkgctl-version-check(1) nvchecker(1) PKGBUILD(5)

صفحه خانگی (HOMEPAGE)
        <https://gitlab.archlinux.org/archlinux/devtools>

       لطفاً باگ‌ها و درخواست‌های ویژگی جدید را در بخش ردیاب مشکلات (issue
       tracker) گزارش دهید. لطفاً تمام تلاش خود را برای ارائه یک نمونه آزمایشی
       قابل بازتولید جهت بازآفرینی باگ‌ها به کار گیرید.

                                  2026-06-21           PKGCTL-VERSION-SETUP(1)