.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "newapkbuild" "1" "2026-06-05"
.PP
.SH "نام (NAME)"
.PP
newapkbuild \- تولید یک فایل APKBUILD جدید
.PP
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBnewapkbuild\fR \fIگزینه‌ها\fR.\&.\&.\& [\fIpkgname\fR[-\fIpkgver\fR] | \fIsource_url\fR]
.PP
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBnewapkbuild\fR یک فایل جدید APKBUILD برای استفاده با abuild(1) تولید می‌کند.\& چنانچه نام بسته قبلاً با \fB-n\fR مشخص نشده باشد، \fIpkgname\fR نام بسته را تعیین می‌کند.\& اگر پس از آن یک خط تیره (-) و یک رشته نسخه معتبر \fIpkgver\fR بیاید، علاوه بر نام، نسخه بسته نیز تعیین می‌شود.\&
.PP
در صورتی که \fIsource_url\fR مشخص شده باشد، \fBnewapkbuild\fR تلاش می‌کند تا با بررسی دایرکتوری سورس، سیستم ساخت را به صورت خودکار تشخیص داده و دستورالعمل‌های ساخت متداول را برای آن سیستم ساخت بنویسد.\& اگر نشانی اینترنتی سورس را مشخص نکنید، یا بخواهید تشخیص خودکار را نادیده بگیرید، می‌توانید سیستم ساخت را با گزینه مناسب مشخص کنید.\& چنانچه هیچ \fIsource_url\fR و گزینه‌ای تعیین نشده باشد، فایل APKBUILD تولیدشده شامل هیچ دستورالعمل ساختی نخواهد بود.\&
.PP
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-a\fR
.RS 4
مشخص می‌کند که بسته از autotools استفاده می‌کند.\&
.PP
.RE
\fB-C\fR
.RS 4
مشخص می‌کند که بسته از CMake استفاده می‌کند.\& ابزار CMake به makedepends اضافه خواهد شد.\&
.PP
.RE
\fB-c\fR
.RS 4
باعث می‌شود که \fBnewapkbuild\fR علاوه بر موارد دیگر، یک اسکریپت init.\&d، یک فایل conf.\&d و اسکریپت‌های نمونه پیش از نصب (pre-install) و پس از نصب (post-install) را در دایرکتوری APKBUILD کپی کند.\& این امر امکان شروع سریع را برای بسته‌های دیمن (daemon) فراهم می‌سازد.\& برای جزئیات بیشتر به بخش «فایل‌ها» مراجعه فرمایید.\&
.PP
.RE
\fB-d\fR \fIDESC\fR
.RS 4
توضیحات (pkgdesc=) را برای بسته جدید مشخص می‌کند.\&
.PP
.RE
\fB-e\fR, \fB-y\fR
.RS 4
مشخص می‌کند که بسته از سیستم ساخت پایتون PEP517 استفاده می‌کند.\& بسته‌های gpep517، setuptools و wheel پایتون به makedepends اضافه خواهند شد.\&
.PP
.RE
\fB-f\fR
.RS 4
در صورتی که فایل APKBUILD از قبل در دایرکتوری بسته وجود داشته باشد، \fBnewapkbuild\fR را وادار به بازنویسی و جایگزینی آن می‌کند.\&
.PP
.RE
\fB-h\fR
.RS 4
اطلاعات نحوه استفاده از دستور را نمایش می‌دهد.\&
.PP
.RE
\fB-l\fR \fILICENSE\fR
.RS 4
مجوزی که بسته جدید تحت آن توزیع می‌شود را مشخص می‌کند.\& این مقدار باید با یک شناسه SPDX مطابقت داشته باشد.\&
.PP
.RE
\fB-m\fR
.RS 4
مشخص می‌کند که بسته از Meson استفاده می‌کند.\& ابزار Meson به makedepends اضافه خواهد شد.\&
.PP
.RE
\fB-n\fR \fINAME\fR
.RS 4
نام بسته جدید را تعیین می‌کند.\& دایرکتوری جدیدی به نام \fINAME\fR حاوی فایل APKBUILD در دایرکتوری جاری ایجاد خواهد شد.\&
.PP
.RE
\fB-p\fR
.RS 4
مشخص می‌کند که بسته از یک فایل Makefile.\&PL پرل استفاده می‌کند.\& قالب CPAN به کار گرفته خواهد شد و Perl به depends اضافه می‌شود.\&
.PP
.RE
\fB-r\fR
.RS 4
مشخص می‌کند که بسته از Cargo استفاده می‌کند.\& ابزار Cargo به makedepends اضافه خواهد شد.\&
.PP
.RE
\fB-s\fR
.RS 4
یک نشانی اینترنتی خودکار SourceForge بر اساس نام و نسخه بسته ایجاد می‌کند.\& این گزینه تنها در صورتی معتبر است که \fIpkgname-pkgver\fR در خط فرمان مشخص شده باشد.\&
.PP
.RE
\fB-u\fR \fIURL\fR
.RS 4
صفحه وب (url=) را برای بسته جدید مشخص می‌کند.\& این نشانی \fIنباید\fR نشانی بسته سورس باشد؛ بلکه باید صفحه وب اصلی پروژه باشد.\&
.PP
.PP
.RE
.SH "فایل‌ها (FILES)"
.PP
تمامی فایل‌های تولیدشده در دایرکتوری \fIpkgname\fR در داخل دایرکتوری کاری جاری قرار خواهند گرفت؛ در صورتی که دایرکتوری \fIpkgname\fR وجود نداشته باشد ایجاد خواهد شد.\&
.PP
APKBUILD
.RS 4
دستور \fBnewapkbuild\fR یک فایل APKBUILD را با استفاده از اطلاعات به‌دست‌آمده از اجرای \fBnewapkbuild\fR و در صورت مشخص بودن \fIsource_url\fR، بررسی سورس بسته دانلودشده ایجاد خواهد کرد.\& برای اطلاعات بیشتر پیرامون APKBUILD و قالب آن، به APKBUILD(5) مراجعه کنید.\&
.PP
.RE
\fIpkgname\fR.\&initd
.RS 4
در صورت تعیین \fB-c\fR، دستور \fBnewapkbuild\fR فایل \fIpkgname\fR.\&initd را همراه با داده‌های نمونه ایجاد می‌کند تا به ساخت اسکریپت init.\&d برای یک دیمن کمک کند.\&
.PP
.RE
\fIpkgname\fR.\&confd
.RS 4
در صورت تعیین \fB-c\fR، دستور \fBnewapkbuild\fR فایل \fIpkgname\fR.\&confd را برای کمک به ایجاد فایل conf.\&d دیمن که توسط اسکریپت‌های init.\&d به کار می‌رود تولید خواهد کرد.\& فایل‌های conf.\&d برای پیکربندی اسکریپت‌های init.\&d استفاده می‌شوند؛ برای اطلاعات بیشتر، openrc(8) و rc_config(3) را ببینید.\&
.PP
.RE
\fIpkgname\fR.\&pre-install
.RS 4
در صورت تعیین \fB-c\fR، دستور \fBnewapkbuild\fR فایل \fIpkgname\fR.\&pre-install را ایجاد می‌کند که محتوای آن پیش از نصب بسته توسط apk(8) اجرا خواهد شد.\&
.PP
.RE
\fIpkgname\fR.\&post-install
.RS 4
در صورت تعیین \fB-c\fR، دستور \fBnewapkbuild\fR فایل \fIpkgname\fR.\&post-install را ایجاد می‌کند که محتوای آن پس از نصب موفق بسته توسط apk(8) اجرا خواهد شد.\& برای اطلاعات بیشتر پیرامون قلاب‌های نصب apk، به راهنمای apk(8) رجوع کنید.\&
.PP
.PP
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
newapkbuild \\
	-n sharutils \\
	-d "Utilities for manipulating shell archives" \\
	-l "GPL-3\&.0+" \\
	-u "https://www\&.gnu\&.org/software/sharutils" \\
	-a \\
	"https://ftp\&.gnu\&.org/gnu/sharutils/sharutils-4\&.15\&.2\&.tar\&.xz"
.fi
.RE
.PP
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
مرجع مجوزهای SPDX (در وب در نشانی <https://spdx.\&org/licenses>)،
abuild(1), apk(8), APKBUILD(5).\&
.PP
.PP
.SH "نویسندگان (AUTHORS)"
.PP
\fBnewapkbuild\fR: Natanael Copa <\fIncopa@alpinelinux.\&org\fR>
.PP
مستندسازی:
.br
A.\& Wilcox <\fIwilfox@adelielinux.\&org\fR>