'\" t
.\"     Title: pkgctl-version-setup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-21
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "PKGCTL\-VERSION\-SETUP" "1" "2026-06-21" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
pkgctl-version-setup \- تشخیص خودکار و راه‌اندازی پیکربندی اولیه برای nvchecker
.SH "خلاصه دستور (SYNOPSIS)"
.sp
pkgctl version setup [OPTIONS] [PKGBASE.\|.\|.]
.SH "توضیحات (DESCRIPTION)"
.sp
این زیردستور با تحلیل آرایه منبع (source) مشخص‌شده در فایل
.BR PKGBUILD (1)
یک بسته، ساخت یک فایل پیکربندی پایه‌ای
.BR nvchecker (1)
را خودکارسازی می‌کند. این دستور پلتفرم‌ها و APIهای مختلف استفاده‌شده توسط منابع بسته (مانند GitHub، GitLab و PyPI) را به صورت هوشمند تشخیص داده و بر اساس بهترین حدس خود، یک پیکربندی
\f(CR.nvchecker.toml\fP
متناظر تولید می‌کند.
.sp
این ابزار به‌ویژه برای راه‌اندازی تنظیمات
.BR nvchecker (1)
برای یک بسته بدون نیاز به نوشتن دستی فایل
\f(CR.nvchecker.toml\fP
بسیار سودمند است. همچنین فرآیند تنظیم بررسی نسخه‌ها را ساده می‌کند، به‌ویژه هنگام انتقال نظارت بر یک بسته از یک پلتفرم منبع به پلتفرمی دیگر یا آغاز بررسی نسخه برای یک بسته جدید.
.sp
اگر هیچ
\f(CRPKGBASE\fP
مشخص نشود، این دستور به‌طور پیش‌فرض از دایرکتوری کاری جاری استفاده می‌کند.
.sp
برای مشاهده فهرستی از منابع پشتیبانی‌شده و قالب‌های مورد انتظار نشانی اینترنتی (URL) آن‌ها، لطفاً به بخش منابع مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-f, \-\-force\fP
.RS 4
بازنویسی پیکربندی موجود
.BR nvchecker (1)
.RE
.sp
\fB\-\-prefer\-platform\-api\fP
.RS 4
ترجیح دادن API اختصاصی پلتفرم (GitHub/GitLab) به گیت در موارد پیچیده
.RE
.sp
\fB\-\-url\fP \fIURL\fP
.RS 4
استخراج هدف بررسی از نشانی اینترنتی داده‌شده به جای ورودی‌های آرایه منبع
.RE
.sp
\fB\-\-no\-check\fP
.RS 4
عدم اجرای
.BR pkgctl\-version\-check (1)
پس از راه‌اندازی
.RE
.sp
\fB\-\-no\-upstream\fP
.RS 4
ایجاد یک پیکربندی خالی برای بسته‌های فاقد منابع بالادست، مانند فرابسته‌ها (meta packages). این گزینه فقط باید برای موارد بدون بالادست استفاده شود؛ لطفاً برای منابع بالادستی که پیکربندی آن‌ها دشوار است، جهت راهنمایی با تیم توسعه‌دهندگان تماس بگیرید.
.RE
.sp
\fB\-h, \-\-help\fP
.RS 4
نمایش متن راهنما
.RE
.SH "منابع (SOURCES)"
.sp
در اینجا پلتفرم‌ها و منابع پشتیبانی‌شده فعلی، به همراه نمونه‌هایی از قالب‌های نشانی اینترنتی (URL) که امکان تشخیص خودکار آن‌ها را به عنوان انواع منابع خاص فراهم می‌کنند، آورده شده است:
.sp
\fBGit\fP
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://github.com/example/project" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.com/example/group/project" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
git://git.foobar.org/example
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
git+https://git.foobar.org/example
.RE
.RE
.sp
\fBGitHub\fP
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://github.com/example/project" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://github.com/example/project/archive/v1.0/project\-v1.0.tar.gz" "" ""
.RE
.RE
.sp
\fBGitLab\fP
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.com/example/group/project" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.archlinux.org/archlinux/devtools.git" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.archlinux.org/archlinux/devtools/\-/releases/v1.1.0/downloads/devtools\-v1.1.0.tar.gz" "" ""
.RE
.RE
.sp
\fBHackage\fP
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://hackage.haskell.org/package/xmonad" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://hackage.haskell.org/package/xmonad\-0.18.0/xmonad\-0.18.0.tar.gz" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad\-0.18.0.tar.gz" "" ""
.RE
.RE
.sp
\fBNPM\fP
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://registry.npmjs.org/node\-gyp/\-/node\-gyp\-10.0.1.tgz" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://www.npmjs.com/package/node\-gyp" "" ""
.RE
.RE
.sp
\fBPyPI\fP
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://pypi.io/packages/source/p/pyflakes" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://pypi.org/packages/source/b/bleach" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://files.pythonhosted.org/packages/source/p/pyflakes" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://pypi.org/project/SQLAlchemy" "" ""
.RE
.RE
.sp
\fBRubyGems\fP
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://rubygems.org/downloads/diff\-lcs\-1.5.1.gem" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://rubygems.org/gems/diff\-lcs" "" ""
.RE
.RE
.sp
\fBCPAN\fP
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale\-PO\-0.27.tar.gz" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale\-PO\-0.27.tar.gz" "" ""
.RE
.RE
.sp
\fBcrates.io\fP
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://static.crates.io/crates/shotgun/shotgun\-1.0.crate" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://crates.io/api/v1/crates/shotgun/1.0/download" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://crates.io/crates/git\-smash" "" ""
.RE
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
\fBpkgctl version setup\fP
.RS 4
منبع را از
.BR PKGBUILD (1)
دایرکتوری جاری تشخیص داده و یک فایل
\f(CR.nvchecker.toml\fP
پایه را راه‌اندازی می‌کند.
.RE
.sp
\fBpkgctl version setup \-\-url \c
.URL "https://github.com/example/project" "" "\fP"
.RS 4
یک فایل
\f(CR.nvchecker.toml\fP
برای
.BR PKGBUILD (1)
جاری تولید می‌کند اما نشانی اینترنتی منبع را با پروژه مشخص‌شده در گیت‌هاب جایگزین می‌نماید.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
pkgctl\-version(1)
pkgctl\-version\-check(1)
nvchecker(1)
PKGBUILD(5)
.SH "صفحه خانگی (HOMEPAGE)"
.sp
\fI\c
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP"
.sp
لطفاً باگ‌ها و درخواست‌های ویژگی جدید را در بخش ردیاب مشکلات (issue tracker) گزارش دهید. لطفاً تمام تلاش خود را برای ارائه یک نمونه آزمایشی قابل بازتولید جهت بازآفرینی باگ‌ها به کار گیرید.