.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH git-cliff 1  "git-cliff 2.14.1"
.SH "نام (NAME)"
git\-cliff \- ابزاری با قابلیت شخصی‌سازی بالا برای تولید گزارش تغییرات (changelog)
.SH "خلاصه دستور (SYNOPSIS)"
\fBgit\-cliff\fR [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-i\fR|\fB\-\-init\fR] [\fB\-\-templates\-dir\fR] [\fB\-\-list\-templates\fR] [\fB\-c\fR|\fB\-\-config\fR] [\fB\-\-config\-url\fR] [\fB\-w\fR|\fB\-\-workdir\fR] [\fB\-r\fR|\fB\-\-repository\fR] [\fB\-\-include\-path\fR] [\fB\-\-exclude\-path\fR] [\fB\-\-tag\-pattern\fR] [\fB\-\-with\-commit\fR] [\fB\-\-with\-tag\-message\fR] [\fB\-\-skip\-tags\fR] [\fB\-\-ignore\-tags\fR] [\fB\-\-count\-tags\fR] [\fB\-\-limit\-tags\fR] [\fB\-\-skip\-commit\fR] [\fB\-p\fR|\fB\-\-prepend\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-t\fR|\fB\-\-tag\fR] [\fB\-\-bump\fR] [\fB\-\-bumped\-version\fR] [\fB\-b\fR|\fB\-\-body\fR] [\fB\-\-body\-file\fR] [\fB\-l\fR|\fB\-\-latest\fR] [\fB\-\-current\fR] [\fB\-u\fR|\fB\-\-unreleased\fR] [\fB\-\-topo\-order\fR] [\fB\-\-use\-branch\-tags\fR] [\fB\-\-no\-exec\fR] [\fB\-x\fR|\fB\-\-context\fR] [\fB\-\-from\-context\fR] [\fB\-s\fR|\fB\-\-strip\fR] [\fB\-\-sort\fR] [\fB\-\-github\-token\fR] [\fB\-\-github\-repo\fR] [\fB\-\-gitlab\-token\fR] [\fB\-\-gitlab\-repo\fR] [\fB\-\-gitea\-token\fR] [\fB\-\-gitea\-repo\fR] [\fB\-\-bitbucket\-token\fR] [\fB\-\-bitbucket\-repo\fR] [\fB\-\-http\-timeout\fR] [\fB\-\-use\-native\-tls\fR] [\fB\-\-offline\fR] [\fIRANGE\fR]
.SH "توضیحات (DESCRIPTION)"
ابزاری با قابلیت شخصی‌سازی بالا برای تولید گزارش تغییرات (changelog) از تاریخچه گیت.
.SH "فلگ‌ها (FLAGS)"
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ اطلاعات راهنما
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ اطلاعات نسخه
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح جزئیات گزارش‌ها
.TP
\fB\-\-list\-templates\fR
چاپ نام قالب‌های در دسترس (تعبیه‌شده و تعریف‌شده توسط کاربر)
.TP
\fB\-\-bumped\-version\fR
چاپ نسخه ارتقایافته برای تغییرات منتشرنشده
.TP
\fB\-l\fR, \fB\-\-latest\fR
پردازش کامیت‌ها با شروع از آخرین برچسب (tag)
.TP
\fB\-\-current\fR
پردازش کامیت‌های متعلق به برچسب جاری
.TP
\fB\-u\fR, \fB\-\-unreleased\fR
پردازش کامیت‌هایی که به هیچ برچسبی تعلق ندارند
.TP
\fB\-\-topo\-order\fR
مرتب‌سازی توپولوژیک برچسب‌ها
.TP
\fB\-\-use\-branch\-tags\fR
تنها شامل شدن برچسب‌های متعلق به شاخه جاری
.TP
\fB\-\-no\-exec\fR
غیرفعال کردن اجرای دستورهای خارجی
.TP
\fB\-x\fR, \fB\-\-context\fR
چاپ بافتار (context) گزارش تغییرات در قالب JSON
.TP
\fB\-\-use\-native\-tls\fR
بارگذاری گواهی‌های TLS از مخزن گواهی‌های بومی سیستم
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-i\fR, \fB\-\-init\fR [\fI<CONFIG>\fR]
نوشتن فایل پیکربندی پیش‌فرض در cliff.toml
.TP
\fB\-\-templates\-dir\fR \fI<PATH>\fR
تنظیم دایرکتوری جستجوی قالب‌های سفارشی برای `\-\-init`.
.PP
یک قالب تعریف‌شده توسط کاربر بر قالبی تعبیه‌شده با همان نام اولویت داشته و جایگزین آن می‌شود.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_TEMPLATES_DIR\fR مشخص شود.
.RE
.TP
\fB\-c\fR, \fB\-\-config\fR \fI<PATH>\fR
تنظیم فایل پیکربندی.
.PP
در صورت مشخص نشدن، پیکربندی به‌طور خودکار شناسایی می‌شود (ابتدا در پروژه `cliff.toml` / `.cliff.toml` / `.config/cliff.toml` و سپس دایرکتوری پیکربندی کاربر)، و در غیر این صورت به پیش‌فرض تعبیه‌شده برمی‌گردد.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_CONFIG\fR مشخص شود.
.RE
.TP
\fB\-\-config\-url\fR \fI<URL>\fR
تنظیم URL برای فایل پیکربندی
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_CONFIG_URL\fR مشخص شود.
.RE
.TP
\fB\-w\fR, \fB\-\-workdir\fR \fI<PATH>\fR
تنظیم دایرکتوری کاری
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_WORKDIR\fR مشخص شود.
.RE
.TP
\fB\-r\fR, \fB\-\-repository\fR \fI<PATH>...\fR
تنظیم مخزن گیت
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_REPOSITORY\fR مشخص شود.
.RE
.TP
\fB\-\-include\-path\fR \fI<PATTERN>\fR
تنظیم الگو برای مسیرهایی که کامیت‌های مربوط به آن‌ها گنجانده می‌شوند
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_INCLUDE_PATH\fR مشخص شود.
.RE
.TP
\fB\-\-exclude\-path\fR \fI<PATTERN>\fR
تنظیم الگو برای مسیرهایی که کامیت‌های مربوط به آن‌ها مستثنی می‌شوند
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_EXCLUDE_PATH\fR مشخص شود.
.RE
.TP
\fB\-\-tag\-pattern\fR \fI<PATTERN>\fR
تنظیم عبارت باقاعده (regex) برای تطبیق با برچسب‌های گیت
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_TAG_PATTERN\fR مشخص شود.
.RE
.TP
\fB\-\-with\-commit\fR \fI<MSG>\fR
تنظیم پیام‌های کامیت سفارشی برای گنجاندن در گزارش تغییرات
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_WITH_COMMIT\fR مشخص شود.
.RE
.TP
\fB\-\-with\-tag\-message\fR [\fI<MSG>\fR]
تنظیم پیام سفارشی برای آخرین انتشار (release)
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_WITH_TAG_MESSAGE\fR مشخص شود.
.RE
.TP
\fB\-\-skip\-tags\fR \fI<PATTERN>\fR
تنظیم برچسب‌هایی که باید در گزارش تغییرات نادیده گرفته و رد شوند
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_SKIP_TAGS\fR مشخص شود.
.RE
.TP
\fB\-\-ignore\-tags\fR \fI<PATTERN>\fR
تنظیم برچسب‌هایی که در گزارش تغییرات نادیده گرفته می‌شوند
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_IGNORE_TAGS\fR مشخص شود.
.RE
.TP
\fB\-\-count\-tags\fR \fI<PATTERN>\fR
تنظیم برچسب‌هایی که باید در گزارش تغییرات شمرده شوند
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_COUNT_TAGS\fR مشخص شود.
.RE
.TP
\fB\-\-limit\-tags\fR \fI<N>\fR
محدود کردن تعداد برچسب‌ها برای پردازش
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_LIMIT_TAGS\fR مشخص شود.
.RE
.TP
\fB\-\-skip\-commit\fR \fI<SHA1>\fR
تنظیم کامیت‌هایی که در گزارش تغییرات رد می‌شوند
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_SKIP_COMMIT\fR مشخص شود.
.RE
.TP
\fB\-p\fR, \fB\-\-prepend\fR [\fI<PATH>\fR]
الحاق موارد جدید به ابتدای فایل گزارش تغییرات داده‌شده
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_PREPEND\fR مشخص شود.
.RE
.TP
\fB\-o\fR, \fB\-\-output\fR [\fI<PATH>\fR]
نوشتن خروجی در فایل مشخص‌شده
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_OUTPUT\fR مشخص شود.
.RE
.TP
\fB\-t\fR, \fB\-\-tag\fR \fI<TAG>\fR
تنظیم برچسب برای آخرین نسخه
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_TAG\fR مشخص شود.
.RE
.TP
\fB\-\-bump\fR [\fI<BUMP>\fR]
ارتقای نسخه برای تغییرات منتشرنشده؛ به‌صورت اختیاری با نسخه مشخص‌شده
.TP
\fB\-b\fR, \fB\-\-body\fR \fI<TEMPLATE>\fR
تنظیم قالب برای بدنه گزارش تغییرات
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_TEMPLATE\fR مشخص شود.
.RE
.TP
\fB\-\-body\-file\fR \fI<PATH>\fR
خواندن قالب بدنه گزارش تغییرات از یک فایل
.TP
\fB\-\-from\-context\fR \fI<PATH>\fR
تولید گزارش تغییرات از یک بافتار JSON
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_CONTEXT\fR مشخص شود.
.RE
.TP
\fB\-s\fR, \fB\-\-strip\fR \fI<PART>\fR
حذف بخش‌های مشخص‌شده از گزارش تغییرات
.sp
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
header
.IP \(bu 2
footer
.IP \(bu 2
all
.RE
.TP
\fB\-\-sort\fR \fI<SORT>\fR [پیش‌فرض: oldest]
تنظیم نحوه مرتب‌سازی کامیت‌ها در داخل بخش‌ها
.sp
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
oldest
.IP \(bu 2
newest
.RE
.SH "گزینه‌های دوردست (REMOTE OPTIONS)"
.TP
\fB\-\-github\-token\fR \fI<TOKEN>\fR
تنظیم توکن API گیت‌هاب (GitHub)
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGITHUB_TOKEN\fR مشخص شود.
.RE
.TP
\fB\-\-github\-repo\fR \fI<OWNER/REPO>\fR
تنظیم مخزن گیت‌هاب
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGITHUB_REPO\fR مشخص شود.
.RE
.TP
\fB\-\-gitlab\-token\fR \fI<TOKEN>\fR
تنظیم توکن API گیت‌لب (GitLab)
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGITLAB_TOKEN\fR مشخص شود.
.RE
.TP
\fB\-\-gitlab\-repo\fR \fI<OWNER/REPO>\fR
تنظیم مخزن گیت‌لب
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGITLAB_REPO\fR مشخص شود.
.RE
.TP
\fB\-\-gitea\-token\fR \fI<TOKEN>\fR
تنظیم توکن API گیتی (Gitea)
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGITEA_TOKEN\fR مشخص شود.
.RE
.TP
\fB\-\-gitea\-repo\fR \fI<OWNER/REPO>\fR
تنظیم مخزن گیتی
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGITEA_REPO\fR مشخص شود.
.RE
.TP
\fB\-\-bitbucket\-token\fR \fI<TOKEN>\fR
تنظیم توکن API بیت‌باکت (Bitbucket)
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBBITBUCKET_TOKEN\fR مشخص شود.
.RE
.TP
\fB\-\-bitbucket\-repo\fR \fI<OWNER/REPO>\fR
تنظیم مخزن بیت‌باکت
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBBITBUCKET_REPO\fR مشخص شود.
.RE
.TP
\fB\-\-http\-timeout\fR \fI<SECS>\fR
تنظیم مهلت زمانی HTTP برای درخواست‌های فراداده از راه دور بر حسب ثانیه
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_HTTP_TIMEOUT\fR مشخص شود.
.RE
.TP
\fB\-\-offline\fR
غیرفعال کردن دسترسی شبکه برای مخازن دوردست
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBGIT_CLIFF_OFFLINE\fR مشخص شود.
.RE
.SH "آرگومان‌ها (ARGS)"
.TP
[\fIRANGE\fR]
تنظیم بازه کامیت‌ها برای پردازش
.SH "نسخه (VERSION)"
v2.14.1
.SH "نویسندگان (AUTHORS)"
مشارکت‌کنندگان git\-cliff <git\-cliff@protonmail.com>
.SH "همچنین ببینید (SEE ALSO)"
.BR git (1)
.PP
<https://git-cliff.org>