.\" -*- coding: UTF-8 -*-
'\" t
.\"     Title: pkgctl-version-setup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-01-27
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH PKGCTL\-VERSION\-SETUP 1 "27 يناير 2026" \ \& \ \&
.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 الاسم
pkgctl\-version\-setup \- كشف آلي وإعداد تشكيلة nvchecker أساسية
.SH موجز
.sp
pkgctl version setup [خيارات] [PKGBASE.\|.\|.]
.SH الوصف
.sp
هذا الأمر الفرعي يؤتمت إنشاء ملف تشكيلة nvchecker(1) أساسي بتحليل مصفوفة
المصادر المحددة في ملف PKGBUILD(1) لحزمة. يكتشف هذا الأمر بذكاء منصات
وواجهات برمجة تطبيقات متنوعة (مثل GitHub وGitLab وPyPI) المستخدمة من قبل
مصادر الحزمة ويولد تشكيلة \f(CR.nvchecker.toml\fR مقابلة بناءً على أفضل
تخمين له.
.sp
هذا مفيد بشكل خاص لتهيئة إعدادات nvchecker(1) لحزمة دون صياغة ملف
\&\f(CR.nvchecker.toml\fR يدويًا. يبسط عملية إعداد فحوصات الإصدار، خاصة عند
نقل مراقبة حزمة من منصة مصدر إلى أخرى أو بدء فحوصات الإصدار لحزمة جديدة.
.sp
إذا لم يُحدد \f(CRPKGBASE\fR، فسيستخدم الأمر دليل العمل الحالي مبدئياً.
.sp
للحصول على قائمة بالمصادر المدعومة وتنسيقات عناوين URL المتوقعة لها، يُرجى
مراجعة قسم المصادر.
.SH الخيارات
.sp
\fB\-f, \-\-force\fP
.RS 4
استبدال تشكيلة nvchecker(1) الموجودة
.RE
.sp
\fB\-\-prefer\-platform\-api\fP
.RS 4
تفضيل واجهة برمجة تطبيقات GitHub/GitLab الخاصة بالمنصة على git للحالات
المعقدة
.RE
.sp
\fB\-\-url\fP \fIURL\fP
.RS 4
اشتقاق هدف الفحص من عنوان URL المعطى بدلاً من إدخالات مصفوفة المصادر
.RE
.sp
\fB\-\-no\-check\fP
.RS 4
عدم تشغيل pkgctl\-version\-check(1) بعد الإعداد
.RE
.sp
\fB\-\-no\-upstream\fP
.RS 4
إعداد تشكيلة فارغة للحزم بدون مصادر منبعية، مثل الحزم الوصفية. يجب استخدام
هذا فقط للحالات بدون منبع، يُرجى التواصل مع فريق المطورين للحصول على إرشادات
بشأن المصادر المنبعية التي يصعب تكوينها.
.RE
.sp
\fB\-h، \-\-help\fP
.RS 4
أظهر نص المساعدة
.RE
.SH المصادر
.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 أمثلة
.sp
\fBpkgctl version setup\fP
.RS 4
يكتشف المصدر من الدليل الحالي \(cqs PKGBUILD(1) ويُعدّ ملف
\&\f(CR.nvchecker.toml\fR أساسي.
.RE
.sp
\fBpkgctl version setup \-\-url
.URL "https://github.com/example/project" "" "\fP"
\fP
.RS 4
\fBيُولّد ملف \fP\f(CR.nvchecker.toml\fB لـ PKGBUILD(1) الحالي لكنه يتجاوز عنوان URL المصدر بمشروع GitHub المحدد.\fP
.RE
.SH "انظر أيضًا"
.sp
pkgctl\-version(1)  pkgctl\-version\-check(1)  nvchecker(1)  PKGBUILD(5)
.SH "الصفحة الرئيسة"
.sp
\fI
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP"
\fP
.sp
\fIيرجى الإبلاغ عن العلل وطلبات الميزات في متتبع المشكلات. يرجى بذل قصارى جهدك لتوفير حالة اختبار قابلة للتكرار للعلل.\fP
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .