.\" 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 "hut" "1" "2026-03-28" .PP .SH "نام (NAME)" .PP hut \- ابزار خط فرمانی برای sr.\&ht .PP .SH "خلاصه دستور (SYNOPSIS)" .PP \fBhut\fR [commands.\&.\&.\&] [options.\&.\&.\&] .PP .SH "توضیحات (DESCRIPTION)" .PP برنامه hut یک ابزار خط فرمانی کمکی برای تعامل با sr.\&ht است.\& .PP منابع (مانند وظایف ساخت، تیکت‌های todo، مجموعه‌وصله‌های lists، مخازن git و غیره) را می‌توان در چندین قالب مشخص کرد: نام، مالک و نام، یا نشانی کامل (URL).\& برای نمونه، به مخزن \fIhut\fR متعلق به \fI\(tiemersion\fR روی \fIgit.\&sr.\&ht\fR می‌توان از راه‌های زیر ارجاع داد: .PP .PD 0 .IP \(bu 4 "hut" .IP \(bu 4 "\(tiemersion/hut" .IP \(bu 4 "https://git.\&sr.\&ht/\(tiemersion/hut" .PD .PP علاوه بر این، به فهرست‌های پستی می‌توان از طریق نشانی ایمیل آن‌ها اشاره کرد.\& .PP دستورات \fIhut\fR که ورودی می‌خوانند، مانند \fBhut graphql\fR یا \fBhut builds user-webhook create\fR، بسته به اینکه ورودی استاندارد (stdin) آن‌ها روی یک پایانه است یا خیر، به شکل‌های زیر ورودی را می‌خوانند: .PP .PD 0 .IP \(bu 4 اگر stdin روی یک پایانه نباشد، برای نمونه به این دلیل که stdin از یک فایل یا از یک لوله (pipe) تغییر مسیر یافته است، \fIhut\fR ورودی را از stdin می‌خواند.\& .PD .PP .PD 0 .IP \(bu 4 در غیر این صورت، چنانچه گزینه \fB--stdin\fR برای دستور مشخص شده باشد، \fIhut\fR ورودی را از stdin می‌خواند.\& .PD .PP .PD 0 .IP \(bu 4 در غیر این صورت، \fIhut\fR فرض می‌کند که در یک پایانه اجرا می‌شود و دستوری که توسط متغیر محیطی \fI$EDITOR\fR تعیین شده است را برای دریافت ورودی اجرا می‌کند.\& .PD .PP .SH "گزینه‌ها (OPTIONS)" .PP \fB-h\fR, \fB--help\fR .RS 4 نمایش پیام راهنما و خروج.\& می‌توان پس از یک دستور برای دریافت اطلاعات بیشتر درباره آن استفاده شود.\& .PP .RE \fB--config\fR .RS 4 انتخاب صریح فایل پیکربندی که باید به جای پیکربندی پیش‌فرض استفاده شود.\& .PP .RE \fB--debug\fR .RS 4 درخواست GraphQL زیربنایی دستور را در \fIstderr\fR چاپ می‌کند.\& .PP .RE \fB--instance\fR .RS 4 انتخاب اینکه کدام نمونه sr.\&ht از فایل پیکربندی باید استفاده شود.\& به‌طور پیش‌فرض اولین نمونه انتخاب خواهد شد.\& .PP .RE .SH "دستورها (COMMANDS)" .PP \fBhelp\fR .RS 4 راهنمایی درباره هر یک از دستورها.\& .PP .RE \fBgraphql\fR .RS 4 نوشتن یک پرسمان GraphQL و اجرای آن.\& پاسخ JSON در stdout نوشته می‌شود.\& آرگومان \fIservice\fR سرویس sr.\&ht برای اجرای پرسمان روی آن است (برای نمونه "meta" یا "builds").\& .PP ابزاری مانند \fBjq\fR(1) می‌تواند برای زیباتر کردن خروجی و پردازش داده‌ها استفاده شود.\& مثال: .PP .nf .RS 4 hut graphql meta <= .RS 4 تنظیم یک متغیر فایلی.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرسمان از \fIstdin\fR.\& .PP .RE \fB-v\fR, \fB--var\fR = .RS 4 تنظیم یک متغیر خام.\& مثال: .PP .nf .RS 4 hut graphql meta -v username=emersion <<\&'EOF\&' query($username: String!) { userByName(username: $username) { bio } } EOF .fi .RE .PP .RE .RE \fBinit\fR .RS 4 مقداردهی اولیه فایل پیکربندی hut.\& .PP .RE \fBexport\fR [resource|service.\&.\&.\&] .RS 4 برون‌بری داده‌های حساب کاربری.\& .PP به‌طور پیش‌فرض، تمام داده‌های کاربر جاری برون‌بری خواهد شد.\& همچنین می‌توان فهرستی صریح از سرویس‌های نمونه (مانند "todo.\&sr.\&ht") یا منابع (مانند "todo.\&sr.\&ht/\(tiuser/tracker") را مشخص کرد.\& .PP .RE \fBimport\fR .RS 4 درون‌ریزی داده‌های حساب کاربری.\& .PP .RE \fBversion\fR .RS 4 نمایش نسخه hut.\& .PP .RE.SS builds .PP \fBartifacts\fR .RS 4 فهرست کردن دست‌سازه‌ها.\& .PP .RE \fBcancel\fR .RS 4 لغو کارها.\& .PP .RE \fBlist\fR [owner] [options.\&.\&.\&] .RS 4 فهرست کردن کارها.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد کارهایی که باید واکشی شوند.\& .PP .RE \fB-s\fR, \fB--status\fR .RS 4 فیلتر کردن بر اساس وضعیت کار.\& .PP .RE \fB-t\fR, \fB--tags\fR .RS 4 تنها نمایش کارهایی که رشتهٔ برچسب‌های آن‌ها با مقدار ارائه‌شده آغاز می‌شود.\& .PP .RE .RE \fBresubmit\fR .RS 4 ارسال مجدد یک ساخت.\& .PP گزینه‌ها عبارتند از: .PP \fB-e\fR, \fB--edit\fR .RS 4 ویرایش مانیفست با \fI$EDITOR\fR.\& .PP .RE \fB-f\fR, \fB--follow\fR .RS 4 دنبال کردن گزارش‌های ساخت.\& .PP .RE \fB-n\fR, \fB--note\fR .RS 4 ارائهٔ یک توضیح کوتاه برای کار.\& .PP .RE \fB-s\fR, \fB--no-secrets\fR .RS 4 غیرفعال‌سازی رازها برای این ساخت.\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 میزان نمایانی مورد استفاده (public، unlisted، private).\& پیش‌فرض همان میزان نمایانی استفاده‌شده در کار ساخت اصلی است.\& .PP .RE .RE \fBsecret list\fR [options.\&.\&.\&] .RS 4 فهرست کردن رازها.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد رازهایی که باید واکشی شوند.\& .PP .RE .RE \fBsecret share\fR .RS 4 به‌اشتراک‌گذاری یک راز.\& .PP گزینه‌ها عبارتند از: .PP \fB-u\fR, \fB--user\fR .RS 4 کاربری که راز باید با او به اشتراک گذاشته شود (الزامی).\& .PP .RE .RE \fBshow\fR [ID] [options.\&.\&.\&] .RS 4 نمایش وضعیت کار.\& .PP اگر هیچ شناسه‌ای مشخص نشود، آخرین ساخت چاپ خواهد شد.\& .PP گزینه‌ها عبارتند از: .PP \fB-f\fR, \fB--follow\fR .RS 4 دنبال کردن وضعیت کار.\& .PP .RE \fB--web\fR .RS 4 باز کردن در مرورگر.\& .PP .RE .RE \fBssh\fR .RS 4 اتصال از طریق SSH به یک کار.\& .PP .RE \fBsubmit\fR [manifest.\&.\&.\&] [options.\&.\&.\&] .RS 4 ارسال یک مانیفست ساخت.\& .PP اگر هیچ مانیفست ساختی مشخص نشود، مانیفست‌های ساخت در \fI.\&build.\&yml\fR، \fI.\&build.\&yaml\fR، \fI.\&builds/*.\&yml\fR و \fI.\&builds/*.\&yaml\fR شناسایی می‌شوند.\& .PP گزینه‌ها عبارتند از: .PP \fB-e\fR, \fB--edit\fR .RS 4 ویرایش مانیفست با \fI$EDITOR\fR.\& .PP .RE \fB-f\fR, \fB--follow\fR .RS 4 دنبال کردن گزارش‌های ساخت.\& .PP .RE \fB-n\fR, \fB--note\fR .RS 4 ارائهٔ یک توضیح کوتاه برای کار.\& .PP .RE \fB-s\fR, \fB--no-secrets\fR .RS 4 غیرفعال‌سازی رازها برای این ساخت.\& .PP .RE \fB-t\fR, \fB--tags\fR .RS 4 برچسب‌های جداشده با اسلش (مانند \(lqhut/test\(rq).\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 میزان نمایانی مورد استفاده (public، unlisted، private).\& پیش‌فرض unlisted است.\& .PP .RE .RE \fBupdate\fR [options.\&.\&.\&] .RS 4 به‌روزرسانی یک کار.\& .PP گزینه‌ها عبارتند از: .PP \fB-v\fR, \fB--visibility\fR .RS 4 میزان نمایانی مورد استفاده (public، unlisted، private) .PP .RE \fB-t\fR, \fB--tags\fR .RS 4 برچسب‌هایی که باید به کار پیوست شوند .PP .RE .RE \fBuser-webhook create\fR [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک کاربر.\& .PP گزینه‌ها عبارتند از: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرست رویدادهایی که باید وب‌هوک را فعال کنند (JOB_CREATED).\& الزامی.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& ناسازگار با \fB--stdin\fR (مانعة‌الجمع).\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی URL بار داده (payload) که درخواست \fIPOST\fR را دریافت می‌کند.\& الزامی.\& .PP .RE .RE \fBuser-webhook delete\fR .RS 4 حذف یک وب‌هوک کاربر.\&.PP .RE \fBuser-webhook list\fR [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های کاربر.\& .PP گزینه‌ها: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای دریافت.\& .PP .RE .RE .SS git .PP گزینه‌ها: .PP .RS 4 \fB-r\fR, \fB--repo\fR .RS 4 نام مخزن.\& .PP .RE .RE \fBacl delete\fR .RS 4 حذف یک مدخل ACL.\& .PP .RE \fBacl list\fR [repo] [options.\&.\&.\&] .RS 4 فهرست کردن مدخل‌های ACL یک مخزن.\& پیش‌فرض مخزن فعلی است.\& .PP گزینه‌ها: .PP \fB--count\fR .RS 4 تعداد مدخل‌های ACL برای دریافت.\& .PP .RE .RE \fBacl update\fR [options.\&.\&.\&] .RS 4 به‌روزرسانی یا افزودن یک مدخل ACL برای کاربر.\& .PP گزینه‌ها: .PP \fB-m\fR, \fB--mode\fR .RS 4 حالت دسترسی برای تنظیم (RW، RO).\& .PP .RE .RE \fBartifact delete\fR .RS 4 حذف یک آرتیفکت.\& .PP .RE \fBartifact list\fR [options.\&.\&.\&] .RS 4 فهرست کردن آرتیفکت‌ها.\& .PP .RE \fBartifact upload\fR [options.\&.\&.\&] .RS 4 بارگذاری آرتیفکت‌ها.\& .PP گزینه‌ها: .PP \fB--rev\fR .RS 4 تگ بازبینی.\& پیش‌فرض آخرین تگ Git است.\& .PP .RE .RE \fBclone\fR .RS 4 این دستور مخزن را در \fICWD\fR کلون کرده و در صورت امکان برای \fIgit send-email\fR پیکربندی می‌کند.\& "repo" می‌تواند یک نشانی URL (مشابه scp برای git) یا یک منبع sourcehut ("hut"، "\(tixenrox/hut") باشد.\& .PP .RE \fBcreate\fR [options.\&.\&.\&] .RS 4 ایجاد یک مخزن.\& در صورتی که از \fB--clone\fR استفاده نشود، نشانی URL دوردست در \fIstdout\fR چاپ خواهد شد.\& .PP گزینه‌ها: .PP \fB-c\fR, \fB--clone\fR .RS 4 کلون کردن مخزن در \fICWD\fR.\& .PP .RE \fB-d\fR, \fB--description\fR .RS 4 توضیحات مخزن.\& .PP .RE \fB--import-url\fR .RS 4 وارد کردن مخزن از URL ارائه‌شده.\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 قابلیت مشاهده برای استفاده (public، unlisted، private).\& پیش‌فرض public است.\& .PP .RE .RE \fBdelete\fR [repo] [options.\&.\&.\&] .RS 4 حذف یک مخزن.\& به‌طور پیش‌فرض مخزن فعلی حذف خواهد شد.\& .PP گزینه‌ها: .PP \fB-y\fR, \fB--yes\fR .RS 4 تأیید حذف بدون درخواست تأیید.\& .PP .RE .RE \fBlist\fR [owner] [options.\&.\&.\&] .RS 4 فهرست کردن مخازن.\& .PP گزینه‌ها: .PP \fB--count\fR .RS 4 تعداد مخازن برای دریافت.\& .PP .RE .RE \fBsetup\fR [options.\&.\&.\&] .RS 4 راه‌اندازی مخزن برای \fIgit send-email\fR.\& برنامه hut تنظیمات مورد نیاز را از فایل پیکربندی پروژه می‌خواند.\& اگر مخزن از قبل دارای پیکربندی باشد، از راه‌اندازی صرف‌نظر خواهد شد.\& .PP گزینه‌ها: .PP \fB-f\fR, \fB--force\fR .RS 4 اجبار به راه‌اندازی حتی اگر مخزن از قبل برای \fIgit send-email\fR پیکربندی شده باشد.\& .PP .RE .RE \fBshow\fR [repo] [options.\&.\&.\&] .RS 4 نمایش اطلاعات درباره یک مخزن.\& .PP گزینه‌ها: .PP \fB--web\fR .RS 4 باز کردن در مرورگر.\& .PP .RE .RE \fBupdate\fR [repo] [options.\&.\&.\&] .RS 4 به‌روزرسانی یک مخزن.\& به‌طور پیش‌فرض مخزن فعلی به‌روزرسانی خواهد شد.\& .PP گزینه‌ها: .PP \fB-b\fR, \fB--default-branch\fR .RS 4 تنظیم شاخه پیش‌فرض.\& .PP .RE \fB-d\fR, \fB--description\fR .RS 4 تنظیم توضیحات تک‌خطی مخزن.\& .PP .RE \fB-n\fR, \fB--name\fR .RS 4 نام جدید مخزن.\& .PP .RE \fB--readme\fR .RS 4 به‌روزرسانی تنظیمات سفارشی README.\& می‌توانید HTML را از یک فایل بخوانید یا "-" را به‌عنوان نام فایل برای خواندن از \fIstdin\fR ارسال کنید.\& برای پاک کردن README سفارشی از یک رشته خالی "" استفاده کنید.\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 قابلیت مشاهده برای استفاده (public، unlisted، private).\& .PP .RE .RE \fBuser-webhook create\fR [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک کاربر.\& .PP گزینه‌ها:.PP \fB-e\fR, \fB--events\fR .RS 4 فهرست رویدادهایی که باید وب‌هوک را فعال کنند (REPO_CREATED, REPO_UPDATE, REPO_DELETED).\& الزامی است.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& غیرقابل استفاده هم‌زمان با \fB--stdin\fR.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی اینترنتی بار داده (payload URL) که درخواست \fIPOST\fR را دریافت می‌کند.\& الزامی است.\& .PP .RE .RE \fBuser-webhook delete\fR .RS 4 حذف یک وب‌هوک کاربر.\& .PP .RE \fBuser-webhook list\fR [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های کاربر.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای دریافت.\& .PP .RE .RE \fBwebhook create\fR [list] [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک git.\& .PP گزینه‌ها عبارتند از: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرست رویدادهایی که باید وب‌هوک را فعال کنند (GIT_PRE_RECEIVE, GIT_POST_RECEIVE).\& الزامی است.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& غیرقابل استفاده هم‌زمان با \fB--stdin\fR.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی اینترنتی بار داده (payload URL) که درخواست \fIPOST\fR را دریافت می‌کند.\& الزامی است.\& .PP .RE .RE \fBwebhook delete\fR .RS 4 حذف یک وب‌هوک git.\& .PP .RE \fBwebhook list\fR [repo] [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های git.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای دریافت.\& .PP .RE .RE .SS hg .PP گزینه‌ها عبارتند از: .PP .RS 4 \fB-r\fR, \fB--repo\fR .RS 4 نام مخزن.\& .PP .RE .RE \fBacl delete\fR .RS 4 حذف یک مدخل ACL.\& .PP .RE \fBacl list\fR [repo] [options.\&.\&.\&] .RS 4 فهرست کردن مدخل‌های ACL یک مخزن.\& پیش‌فرض مخزن جاری است.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد مدخل‌های ACL برای دریافت.\& .PP .RE .RE \fBacl update\fR [options.\&.\&.\&] .RS 4 به‌روزرسانی یا افزودن یک مدخل ACL برای کاربر.\& .PP گزینه‌ها عبارتند از: .PP \fB-m\fR, \fB--mode\fR .RS 4 حالت دسترسی برای تنظیم (RW, RO).\& .PP .RE .RE \fBcreate\fR [options.\&.\&.\&] .RS 4 ایجاد یک مخزن.\& در صورتی که از \fB--clone\fR استفاده نشود، نشانی URL دوردست در \fIstdout\fR چاپ خواهد شد.\& .PP گزینه‌ها عبارتند از: .PP \fB-c\fR, \fB--clone\fR .RS 4 کلون کردن مخزن در \fICWD\fR.\& .PP .RE \fB-d\fR, \fB--description\fR .RS 4 توضیحات مخزن.\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 میزان پدیداری مورد استفاده (public, unlisted, private).\& پیش‌فرض public است.\& .PP .RE .RE \fBdelete\fR [repo] [options.\&.\&.\&] .RS 4 حذف یک مخزن.\& به‌طور پیش‌فرض، مخزن جاری حذف خواهد شد.\& .PP گزینه‌ها عبارتند از: .PP \fB-y\fR, \fB--yes\fR .RS 4 تأیید حذف بدون اعلان (prompt).\& .PP .RE .RE \fBlist\fR [owner] [options.\&.\&.\&] .RS 4 فهرست کردن مخازن.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد مخازن برای دریافت.\& .PP .RE .RE \fBupdate\fR [repo] [options.\&.\&.\&] .RS 4 به‌روزرسانی یک مخزن.\& به‌طور پیش‌فرض، مخزن جاری به‌روزرسانی خواهد شد.\& .PP گزینه‌ها عبارتند از: .PP \fB-d\fR, \fB--description\fR .RS 4 تنظیم توضیحات تک‌خطی برای مخزن.\& .PP .RE \fB--non-publishing\fR .RS 4 کنترل می‌کند که آیا این مخزن، یک مخزن غیرقابل انتشار (non-publishing) باشد یا خیر.\& .PP .RE \fB--readme\fR .RS 4 به‌روزرسانی تنظیمات README سفارشی.\& می‌توانید HTML را از یک فایل بخوانید یا نام فایل را "-" قرار دهید تا از \fIstdin\fR خوانده شود.\& برای پاک کردن README سفارشی از یک رشته خالی "" استفاده کنید.\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 میزان پدیداری مورد استفاده (public, unlisted, private).\& .PP .RE .RE \fBuser-webhook create\fR [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک کاربر.\&.PP گزینه‌ها عبارتند از: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرست رویدادهایی که باید وب‌هوک را فعال کنند (REPO_CREATED، REPO_UPDATE، REPO_DELETED).\& اجباری.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& غیرقابل استفاده هم‌زمان با \fB--stdin\fR.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی URL بار داده (payload) که درخواست \fIPOST\fR را دریافت می‌کند.\& اجباری.\& .PP .RE .RE \fBuser-webhook delete\fR .RS 4 حذف یک وب‌هوک کاربر.\& .PP .RE \fBuser-webhook list\fR [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های کاربر.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای واکشی.\& .PP .RE .RE .SS hub .PP \fBlist\fR [owner] [options.\&.\&.\&] .RS 4 فهرست کردن پروژه‌ها.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد پروژه‌ها برای واکشی.\& .PP .RE .RE \fBshow\fR [project] .RS 4 نمایش اطلاعات درباره یک پروژه.\& .PP .RE .SS lists .PP گزینه‌ها عبارتند از: .PP .RS 4 \fB-l\fR, \fB--mailing-list\fR .RS 4 انتخاب یک لیست پستی.\& .PP به‌طور پیش‌فرض، لیست پستی پیکربندی‌شده برای مخزن Git فعلی انتخاب خواهد شد.\& .PP .RE .RE \fBacl delete\fR .RS 4 حذف یک مدخل ACL.\& .PP .RE \fBacl list\fR [list] [options.\&.\&.\&] .RS 4 فهرست کردن مدخل‌های ACL یک لیست پستی.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد مدخل‌های ACL برای واکشی.\& .PP .RE .RE \fBarchive\fR [list] [options.\&.\&.\&] .RS 4 بارگیری بایگانی یک لیست پستی در قالب یک فایل mbox به \fIstdout\fR.\& .PP گزینه‌ها عبارتند از: .PP \fB-d\fR, \fB--days\fR .RS 4 تعداد روزهای پایانی که بایگانی باید برای آن‌ها بارگیری شود.\& به‌طور پیش‌فرض کل بایگانی انتخاب خواهد شد.\& .PP .RE .RE \fBcreate\fR [options.\&.\&.\&] .RS 4 ایجاد یک لیست پستی.\& .PP گزینه‌ها عبارتند از: .PP \fB--stdin\fR .RS 4 خواندن توضیحات از \fIstdin\fR.\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 میزان نمایانی مورد استفاده (public، unlisted، private).\& پیش‌فرض public است.\& .PP .RE .RE \fBdelete\fR [list] [options.\&.\&.\&] .RS 4 حذف یک لیست پستی.\& .PP گزینه‌ها عبارتند از: .PP \fB-y\fR, \fB--yes\fR .RS 4 تأیید حذف بدون پرسش.\& .PP .RE .RE \fBlist\fR [owner] [options.\&.\&.\&] .RS 4 فهرست کردن لیست‌های پستی.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد لیست‌های پستی برای واکشی.\& .PP .RE .RE \fBpatchset apply\fR .RS 4 اعمال یک مجموعه وصله.\& .PP .RE \fBpatchset list\fR [list] [options.\&.\&.\&] .RS 4 فهرست کردن مجموعه‌های وصله در لیست.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد مجموعه‌های وصله برای واکشی.\& .PP .RE \fB-s\fR, \fB--status\fR .RS 4 فیلتر کردن بر اساس وضعیت مجموعه وصله.\& به‌طور پیش‌فرض تنها مجموعه‌های وصله "PROPOSED" نمایش داده خواهند شد.\& از "" برای نمایش تمام مجموعه‌های وصله استفاده کنید.\& .PP .RE \fB-u\fR, \fB--user\fR .RS 4 فهرست کردن مجموعه‌های وصله بر اساس کاربر به جای لیست.\& .PP .RE .RE \fBpatchset show\fR .RS 4 نمایش یک مجموعه وصله.\& .PP .RE \fBpatchset update\fR .RS 4 به‌روزرسانی یک مجموعه وصله.\& .PP گزینه‌ها عبارتند از: .PP \fB-s\fR, \fB--status\fR .RS 4 وضعیت مجموعه وصله برای تنظیم (اجباری).\& .PP .RE .RE \fBpreferences show\fR .RS 4 نمایش ترجیحات کاربر برای لیست‌ها.\& .PP .RE \fBpreferences update\fR [options.\&.\&.\&] .RS 4 به‌روزرسانی ترجیحات کاربر برای لیست‌ها.\& .PP گزینه‌ها عبارتند از:.PP \fB-c\fR, \fB--copy-self\fR .RS 4 اینکه آیا کاربر مایل به دریافت رونوشتی از رایانامه‌های خود در فهرست‌های پستی است یا خیر.\& .PP .RE .RE \fBsubscribe\fR [list] .RS 4 اشتراک در یک فهرست پستی.\& .PP .RE \fBsubscriptions\fR [options.\&.\&.\&] .RS 4 فهرست کردن اشتراک‌های فهرست پستی.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد اشتراک‌ها برای واکشی.\& .PP .RE .RE \fBunsubscribe\fR [list] .RS 4 لغو اشتراک از یک فهرست پستی.\& .PP .RE \fBupdate\fR [list] [options.\&.\&.\&] .RS 4 به‌روزرسانی یک فهرست پستی.\& .PP گزینه‌ها عبارتند از: .PP \fB--description\fR .RS 4 ویرایش توضیحات.\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 میزان نمایانی مورد استفاده (public، unlisted، private).\& .PP .RE .RE \fBuser-webhook create\fR [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک کاربری.\& .PP گزینه‌ها عبارتند از: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرست رویدادهایی که باید وب‌هوک را فعال کنند (LIST_CREATED، LIST_UPDATED، LIST_DELETED، EMAIL_RECEIVED، PATCHSET_RECEIVED).\& الزامی است.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& با \fB--stdin\fR مانعةالجمع است.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی URL بار داده (payload) که درخواست \fIPOST\fR را دریافت می‌کند.\& الزامی است.\& .PP .RE .RE \fBuser-webhook delete\fR .RS 4 حذف یک وب‌هوک کاربری.\& .PP .RE \fBuser-webhook list\fR [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های کاربری.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای واکشی.\& .PP .RE .RE \fBwebhook create\fR [list] [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک فهرست پستی.\& .PP گزینه‌ها عبارتند از: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرست رویدادهایی که باید وب‌هوک را فعال کنند (LIST_UPDATED، LIST_DELETED، EMAIL_RECEIVED، PATCHSET_RECEIVED).\& الزامی است.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& با \fB--stdin\fR مانعةالجمع است.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی URL بار داده (payload) که درخواست \fIPOST\fR را دریافت می‌کند.\& الزامی است.\& .PP .RE .RE \fBwebhook delete\fR .RS 4 حذف یک وب‌هوک ردیاب.\& .PP .RE \fBwebhook list\fR [list] [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های فهرست پستی.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای واکشی.\& .PP .RE .RE.SS meta .PP \fBaudit-log\fR [گزینه‌ها.\&.\&.\&] .RS 4 نمایش گزارش حسابرسی شما.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد مدخل‌های گزارش برای دریافت.\& .PP .RE .RE \fBoauth tokens\fR .RS 4 فهرست کردن توکن‌های دسترسی شخصی.\& .PP .RE \fBpgp-key create\fR [path] .RS 4 بارگذاری یک کلید عمومی PGP و پیوند دادن آن با حساب کاربری شما.\& .PP کلید عمومی باید در قالب armored باشد.\& .PP اگر \fIpath\fR مشخص نشده باشد، از کلید عمومی پیش‌فرض موجود در دسته‌کلید GPG محلی استفاده می‌شود.\& .PP .RE \fBpgp-key delete\fR .RS 4 حذف یک کلید PGP از حساب کاربری شما.\& .PP .RE \fBpgp-key list\fR [username] [گزینه‌ها.\&.\&.\&] .RS 4 فهرست کردن کلیدهای عمومی PGP.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد کلیدها جهت دریافت.\& .PP .RE \fB-r\fR, \fB--raw\fR .RS 4 تنها چاپ کلید عمومی خام .PP .RE .RE \fBshow\fR [username] .RS 4 نمایش نمایه یک کاربر.\& .PP اگر \fIusername\fR مشخص نشده باشد، نمایه شما نمایش داده می‌شود.\& .PP .RE \fBssh-key create\fR [path] .RS 4 بارگذاری یک کلید عمومی SSH و پیوند دادن آن با حساب کاربری شما.\& .PP اگر \fIpath\fR مشخص نشده باشد، از کلید عمومی پیش‌فرض SSH استفاده می‌شود.\& .PP .RE \fBssh-key delete\fR .RS 4 حذف یک کلید عمومی SSH از حساب کاربری شما.\& .PP .RE \fBssh-key list\fR [username] [گزینه‌ها.\&.\&.\&] .RS 4 فهرست کردن کلیدهای عمومی SSH.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد کلیدها جهت دریافت.\& .PP .RE \fB-r\fR, \fB--raw\fR .RS 4 تنها چاپ کلید عمومی خام .PP .RE .RE \fBupdate\fR [گزینه‌ها.\&.\&.\&] .RS 4 به‌روزرسانی حساب کاربری.\& .PP گزینه‌ها عبارتند از: .PP \fB--avatar\fR .RS 4 تنظیم آواتار.\& .PP .RE \fB--bio\fR .RS 4 ویرایش زندگی‌نامه.\& .PP .RE \fB--email\fR .RS 4 تنظیم نشانی ایمیل.\& .PP .RE \fB--location\fR .RS 4 تنظیم مکان.\& .PP .RE \fB--pronouns\fR .RS 4 تنظیم ضمایر.\& .PP .RE \fB--url\fR .RS 4 تنظیم URL.\& .PP .RE .RE \fBuser-webhook create\fR [گزینه‌ها.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک کاربر.\& .PP گزینه‌ها عبارتند از: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرست رویدادهایی که باید وب‌هوک را فعال کنند (PROFILE_UPDATE، PGP_KEY_ADDED، PGP_KEY_REMOVED، SSH_KEY_ADDED، SSH_KEY_REMOVED).\& الزامی است.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& با \fB--stdin\fR هم‌زمان قابل استفاده نیست.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی URL بار داده (payload) که درخواست \fIPOST\fR را دریافت می‌کند.\& الزامی است.\& .PP .RE .RE \fBuser-webhook delete\fR .RS 4 حذف یک وب‌هوک کاربر.\& .PP .RE \fBuser-webhook list\fR [گزینه‌ها.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های کاربر.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها جهت دریافت.\& .PP .RE .RE.SS pages .PP \fBacl delete\fR .RS 4 حذف یک مدخل ACL.\& .PP .RE \fBacl list\fR [options.\&.\&.\&] .RS 4 فهرست کردن مدخل‌های ACL یک سایت.\& .PP گزینه‌ها عبارت‌اند از: .PP \fB--count\fR .RS 4 تعداد مدخل‌های ACL برای واکشی.\& .PP .RE \fB-d\fR, \fB--domain\fR .RS 4 نام دامنه کاملاً مشخص (FQDN).\& الزامی است.\& .PP .RE \fB-p\fR, \fB--protocol\fR .RS 4 پروتکل مورد استفاده (HTTPS یا GEMINI؛ پیش‌فرض HTTPS است).\& .PP .RE .RE \fBacl update\fR [options.\&.\&.\&] .RS 4 به‌روزرسانی یک مدخل ACL برای کاربر.\& .PP گزینه‌ها عبارت‌اند از: .PP \fB--id\fR .RS 4 شناسه سایت.\& .PP .RE \fB--publish\fR .RS 4 مجوز انتشار سایت.\& برای لغو مجوز، از مشخص کردن این پرچم صرف‌نظر کنید.\& .PP .RE .RE \fBlist\fR [options.\&.\&.\&] .RS 4 فهرست کردن سایت‌های ثبت‌شده.\& .PP گزینه‌ها عبارت‌اند از: .PP \fB--count\fR .RS 4 تعداد سایت‌ها برای واکشی.\& .PP .RE .RE \fBpublish\fR [file] [options.\&.\&.\&] .RS 4 انتشار یک وب‌سایت.\& .PP فایل ورودی \fIfile\fR می‌تواند یک بایگانی tar فشرده‌شده با gzip یا یک دایرکتوری باشد.\& اگر \fIfile\fR مشخص نشود، از ورودی استاندارد استفاده می‌شود.\& .PP گزینه‌ها عبارت‌اند از: .PP \fB-d\fR, \fB--domain\fR .RS 4 نام دامنه کاملاً مشخص (FQDN).\& .PP .RE \fB-p\fR, \fB--protocol\fR .RS 4 پروتکل مورد استفاده (HTTPS یا GEMINI؛ پیش‌فرض HTTPS است) .PP .RE \fB--site-config\fR .RS 4 مسیر فایل پیکربندی سایت (به‌عنوان مثال برای cache-control).\& .PP .RE \fB-s\fR, \fB--subdirectory\fR .RS 4 در صورت تعیین، فقط این زیردایرکتوری به‌روزرسانی می‌شود و بقیه سایت دست‌نخورده باقی می‌ماند.\& .PP .RE .RE \fBunpublish\fR [options.\&.\&.\&] .RS 4 لغو انتشار یک وب‌سایت.\& .PP گزینه‌ها عبارت‌اند از: .PP \fB-d\fR, \fB--domain\fR .RS 4 نام دامنه کاملاً مشخص (FQDN).\& .PP .RE \fB-p\fR, \fB--protocol\fR .RS 4 پروتکل مورد استفاده (HTTPS یا GEMINI؛ پیش‌فرض HTTPS است) .PP .RE .RE \fBuser-webhook create\fR [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک کاربر.\& .PP گزینه‌ها عبارت‌اند از: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرست رویدادهایی که باید وب‌هوک را فعال کنند (SITE_PUBLISHED، SITE_UNPUBLISHED).\& الزامی است.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& با \fB--stdin\fR مانعة‌الجمع است.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی URL بار داده (payload) که درخواست \fIPOST\fR را دریافت می‌کند.\& الزامی است.\& .PP .RE .RE \fBuser-webhook delete\fR .RS 4 حذف یک وب‌هوک کاربر.\& .PP .RE \fBuser-webhook list\fR [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های کاربر.\& .PP گزینه‌ها عبارت‌اند از: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای واکشی.\& .PP .RE .RE.SS paste .PP \fBcreate\fR .RS 4 ایجاد یک پیست (paste) جدید.\& .PP گزینه‌ها عبارتند از: .PP \fB-v\fR, \fB--visibility\fR .RS 4 میزان پدیداری برای استفاده (public، unlisted، private).\& پیش‌فرض unlisted است.\& .PP .RE \fB-n\fR, \fB--name\fR .RS 4 نام پیست ایجادشده.\& تنها هنگام خواندن از \fIstdin\fR معتبر است.\& .PP .RE .RE \fBdelete\fR .RS 4 حذف پیست‌ها.\& .PP .RE \fBlist\fR [options.\&.\&.\&] .RS 4 فهرست کردن پیست‌ها.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد پیست‌ها برای دریافت.\& .PP .RE .RE \fBshow\fR .RS 4 نمایش یک پیست.\& .PP .RE \fBupdate\fR [options.\&.\&.\&] .RS 4 به‌روزرسانی پدیداری یک پیست.\& .PP گزینه‌ها عبارتند از: .PP \fB-v\fR, \fB--visibility\fR .RS 4 میزان پدیداری برای استفاده (public، unlisted، private) .PP .RE .RE \fBuser-webhook create\fR [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک کاربری.\& .PP گزینه‌ها عبارتند از: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرست رویدادهایی که باید وب‌هوک را فعال کنند (PASTE_CREATED، PASTE_UPDATED، PASTE_DELETED).\& الزامی است.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& مانعة‌الجمع با \fB--stdin\fR.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی اینترنتی (URL) محموله که درخواست \fIPOST\fR را دریافت می‌کند.\& الزامی است.\& .PP .RE .RE \fBuser-webhook delete\fR .RS 4 حذف یک وب‌هوک کاربری.\& .PP .RE \fBuser-webhook list\fR [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های کاربری.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای دریافت.\& .PP .RE .RE .SS todo .PP گزینه‌ها عبارتند از: .PP .RS 4 \fB-t\fR, \fB--tracker\fR .RS 4 نام ردیاب (tracker).\& .PP .RE .RE \fBacl delete\fR .RS 4 حذف یک مدخل ACL.\& .PP .RE \fBacl list\fR [tracker] [options.\&.\&.\&] .RS 4 فهرست کردن مدخل‌های ACL یک ردیاب.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد مدخل‌های ACL برای دریافت.\& .PP .RE .RE \fBcreate\fR [options.\&.\&.\&] .RS 4 ایجاد یک ردیاب.\& .PP گزینه‌ها عبارتند از: .PP \fB--stdin\fR .RS 4 خواندن توضیحات از \fIstdin\fR.\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 میزان پدیداری برای استفاده (public، unlisted، private).\& پیش‌فرض public است.\& .PP .RE .RE \fBdelete\fR [tracker] [options.\&.\&.\&] .RS 4 حذف یک ردیاب.\& .PP گزینه‌ها عبارتند از: .PP \fB-y\fR, \fB--yes\fR .RS 4 تأیید حذف بدون پرسش مجدد.\& .PP .RE .RE \fBlabel create\fR [options.\&.\&.\&] .RS 4 ایجاد یک برچسب.\& .PP گزینه‌ها عبارتند از: .PP \fB-b\fR, \fB--background\fR .RS 4 رنگ پس‌زمینه در قالب hex (الزامی).\& .PP .RE \fB-f\fR, \fB--foreground\fR .RS 4 رنگ پیش‌زمینه در قالب hex.\& در صورت تعیین نشدن، رنگ سیاه یا سفید برای کنتراست بهینه انتخاب خواهد شد.\& .PP .RE .RE \fBlabel delete\fR .RS 4 حذف یک برچسب.\& .PP .RE \fBlabel list\fR [options.\&.\&.\&] .RS 4 فهرست کردن برچسب‌ها.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد برچسب‌ها برای دریافت.\& .PP .RE .RE \fBlabel update\fR [options.\&.\&.\&] .RS 4 به‌روزرسانی یک برچسب.\& .PP گزینه‌ها عبارتند از: .PP \fB-b\fR, \fB--background\fR .RS 4 رنگ پس‌زمینه در قالب hex.\& .PP .RE \fB-f\fR, \fB--foreground\fR .RS 4 رنگ پیش‌زمینه در قالب hex.\&.PP .RE \fB-n\fR, \fB--name\fR .RS 4 نام برچسب جدید.\& .PP .RE .RE \fBlist\fR [owner] [options.\&.\&.\&] .RS 4 فهرست کردن ردگیرها.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد ردگیرها برای دریافت.\& .PP .RE .RE \fBpreferences show\fR .RS 4 نمایش ترجیحات کاربر برای ردگیرها.\& .PP .RE \fBpreferences update\fR [options.\&.\&.\&] .RS 4 به‌روزرسانی ترجیحات کاربر برای ردگیرها.\& .PP گزینه‌ها عبارتند از: .PP \fB-n\fR, \fB--notify-self\fR .RS 4 این که آیا کاربر می‌خواهد از اقدامات خودش مطلع شود یا خیر.\& .PP .RE .RE \fBsubscribe\fR [tracker] .RS 4 مشترک شدن در یک ردگیر.\& .PP .RE \fBticket assign\fR [options.\&.\&.\&] .RS 4 تخصیص یک کاربر به یک تیکت.\& .PP گزینه‌ها عبارتند از: .PP \fB-u\fR, \fB--user\fR .RS 4 نام کاربری مسئول جدید (الزامی).\& .PP .RE .RE \fBticket comment\fR [options.\&.\&.\&] .RS 4 ثبت نظر روی یک تیکت.\& .PP گزینه‌ها عبارتند از: .PP \fB-r\fR, \fB--resolution\fR .RS 4 راه‌حل برای تیکت‌های حل‌شده.\& در صورت مشخص نشدن وضعیت، بر روی \fIRESOLVED\fR تنظیم خواهد شد.\& .PP .RE \fB-s\fR, \fB--status\fR .RS 4 وضعیت جدید تیکت.\& در صورت تنظیم بر روی \fIRESOLVED\fR، راه‌حل به‌طور پیش‌فرض \fICLOSED\fR خواهد بود.\& .PP .RE \fB--stdin\fR .RS 4 خواندن نظر از \fIstdin\fR.\& .PP .RE .RE \fBticket create\fR [options.\&.\&.\&] .RS 4 ایجاد یک تیکت جدید.\& .PP گزینه‌ها عبارتند از: .PP \fB--stdin\fR .RS 4 خواندن تیکت از \fIstdin\fR.\& .PP .RE .RE \fBticket delete\fR [options.\&.\&.\&] .RS 4 حذف یک تیکت.\& .PP گزینه‌ها عبارتند از: .PP \fB-y\fR, \fB--yes\fR .RS 4 تأیید حذف بدون اعلانات و پرسش.\& .PP .RE .RE \fBticket edit\fR .RS 4 ویرایش یک تیکت.\& .PP .RE \fBticket label\fR [options.\&.\&.\&] .RS 4 افزودن برچسب به یک تیکت.\& .PP گزینه‌ها عبارتند از: .PP \fB-l\fR, \fB--label\fR .RS 4 نام برچسب (الزامی).\& .PP .RE .RE \fBticket list\fR [options.\&.\&.\&] .RS 4 فهرست کردن تیکت‌ها.\& .PP گزینه‌ها عبارتند از: .PP \fB--count\fR .RS 4 تعداد تیکت‌ها برای دریافت.\& .PP .RE \fB-s\fR, \fB--status\fR .RS 4 فیلتر بر اساس وضعیت تیکت.\& به‌طور پیش‌فرض تنها تیکت‌های باز نمایش داده خواهند شد.\& برای نمایش تمام تیکت‌ها از "" استفاده کنید.\& .PP .RE .RE \fBticket show\fR [options.\&.\&.\&] .RS 4 نمایش یک تیکت.\& .PP گزینه‌ها عبارتند از: .PP \fB--web\fR .RS 4 باز کردن در مرورگر.\& .PP .RE .RE \fBticket subscribe\fR .RS 4 مشترک شدن در یک تیکت.\& .PP .RE \fBticket unassign\fR [options.\&.\&.\&] .RS 4 لغو تخصیص یک کاربر از یک تیکت.\& .PP گزینه‌ها عبارتند از: .PP \fB-u\fR, \fB--user\fR .RS 4 نام کاربری کاربر تخصیص‌یافته (الزامی).\& .PP .RE .RE \fBticket unlabel\fR [options.\&.\&.\&] .RS 4 حذف یک برچسب از یک تیکت.\& .PP گزینه‌ها عبارتند از: .PP \fB-l\fR, \fB--label\fR .RS 4 نام برچسب (الزامی).\& .PP .RE .RE \fBticket unsubscribe\fR .RS 4 لغو اشتراک از یک تیکت.\& .PP .RE \fBticket update-status\fR [options.\&.\&.\&] .RS 4 به‌روزرسانی وضعیت یک تیکت.\& .PP گزینه‌ها عبارتند از: .PP \fB-r\fR, \fB--resolution\fR .RS 4 راه‌حل برای تیکت‌های حل‌شده (در صورت استفاده از وضعیت \fIRESOLVED\fR الزامی است).\& اگر وضعیت قید نشود، بر روی \fIRESOLVED\fR تنظیم خواهد شد.\& .PP .RE \fB-s\fR, \fB--status\fR .RS 4 وضعیت جدید تیکت.\& .PP .RE .RE \fBticket webhook create\fR [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک برای تیکت.\&.PP گزینه‌ها: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرستی از رویدادهایی که باید وب‌هوک را فعال کنند (EVENT_CREATED، TICKET_UPDATE، TICKET_DELETED).\& اجباری.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& با \fB--stdin\fR هم‌زمان قابل استفاده نیست.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی URL بار داده (payload) که درخواست \fIPOST\fR را دریافت می‌کند.\& اجباری.\& .PP .RE .RE \fBticket webhook delete\fR .RS 4 حذف یک وب‌هوک تیکت.\& .PP .RE \fBticket webhook list\fR [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های تیکت.\& .PP گزینه‌ها: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای واکشی.\& .PP .RE .RE \fBunsubscribe\fR [tracker] .RS 4 لغو اشتراک از یک ترکر (tracker).\& .PP .RE \fBupdate\fR [tracker] [options.\&.\&.\&] .RS 4 به‌روزرسانی یک ترکر.\& .PP گزینه‌ها: .PP \fB--description\fR .RS 4 ویرایش توضیحات.\& .PP .RE \fB-n\fR, \fB--name\fR .RS 4 نام جدید ترکر.\& .PP .RE \fB-v\fR, \fB--visibility\fR .RS 4 میزان نمایانی مورد استفاده (public، unlisted، private).\& .PP .RE .RE \fBuser-webhook create\fR [options.\&.\&.\&] .RS 4 ایجاد یک وب‌هوک کاربر.\& .PP گزینه‌ها: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرستی از رویدادهایی که باید وب‌هوک را فعال کنند (TRACKER_CREATED، TRACKER_UPDATE، TRACKER_DELETED، TICKET_CREATED).\& اجباری.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& با \fB--stdin\fR هم‌زمان قابل استفاده نیست.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی URL بار داده (payload) که درخواست \fIPOST\fR را دریافت می‌کند.\& اجباری.\& .PP .RE .RE \fBuser-webhook delete\fR .RS 4 حذف یک وب‌هوک کاربر.\& .PP .RE \fBuser-webhook list\fR [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های کاربر.\& .PP گزینه‌ها: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای واکشی.\& .PP .RE .RE \fBwebhook create\fR [tracker] [options.\&.\&.\&] .RS 4 ایجاد وب‌هوک برای ترکر.\& .PP گزینه‌ها: .PP \fB-e\fR, \fB--events\fR .RS 4 فهرستی از رویدادهایی که باید وب‌هوک را فعال کنند (TRACKER_UPDATE، TRACKER_DELETED، LABEL_CREATED، LABEL_UPDATE، LABEL_DELETED، TICKET_CREATED، TICKET_UPDATE، TICKET_DELETED، EVENT_CREATED).\& اجباری.\& .PP .RE \fB--stdin\fR .RS 4 خواندن پرس‌وجو از \fIstdin\fR.\& .PP .RE \fB-q\fR, \fB--query\fR .RS 4 پرس‌وجوی وب‌هوک.\& با \fB--stdin\fR هم‌زمان قابل استفاده نیست.\& .PP .RE \fB-u\fR, \fB--url\fR .RS 4 نشانی URL بار داده (payload) که درخواست \fIPOST\fR را دریافت می‌کند.\& اجباری.\& .PP .RE .RE \fBwebhook delete\fR .RS 4 حذف یک وب‌هوک ترکر.\& .PP .RE \fBwebhook list\fR [tracker] [options.\&.\&.\&] .RS 4 فهرست کردن وب‌هوک‌های ترکر.\& .PP گزینه‌ها: .PP \fB--count\fR .RS 4 تعداد وب‌هوک‌ها برای واکشی.\& .PP .RE .RE.SH "پیکربندی (CONFIGURATION)" .PP یک توکن دسترسی OAuth2 جدید در \fImeta.\&sr.\&ht\fR ایجاد کنید.\& .PP در هنگام راه‌اندازی، hut به دنبال فایلی در مسیر \fB$XDG_CONFIG_HOME/hut/config\fR می‌گردد.\& در صورت عدم تنظیم، مقدار پیش‌فرض \fI$XDG_CONFIG_HOME\fR برابر با \fB\(ti/.\&config/\fR خواهد بود.\& .PP .nf .RS 4 instance "sourcehut" { # Set the origin/common domain for the instance\&. origin "sr\&.ht" access-token "" # As an alternative you can specify a command whose first line of output # will be parsed as the token access-token-cmd pass token meta { # You can set the origin for each service\&. As fallback hut will # construct the origin from the instance name and the service\&. origin "https://meta\&.sr\&.ht" } } .fi .RE .PP .SH "فایل پیکربندی پروژه (PROJECT CONFIGURATION FILE)" .PP فایل پیکربندی پروژه، فایلی در بالاترین سطح یک مخزن به نام \fI.\&hut.\&scfg\fR است که در آن می‌توان ردیاب (tracker) و فهرست ایمیل توسعه مرتبط را مشخص کرد.\& این منابع هر زمان که دستوری فراخوانی شود که به ردیاب یا فهرست ایمیل نیاز دارد و هیچ موردی به‌طور صریح تنظیم نشده باشد، استفاده خواهند شد.\& علاوه بر این، امکان پیکربندی این مورد وجود دارد که وصله‌ها حاوی نام مخزن در پیشوند خود باشند.\& دستور \fIhut git clone\fR مخزن تازه کلون‌شده را به‌گونه‌ای پیکربندی می‌کند که مشارکت آسان‌تر شود.\& .PP .nf .RS 4 tracker https://todo\&.sr\&.ht/~xenrox/hut development-mailing-list ~xenrox/hut-dev@lists\&.sr\&.ht patch-prefix false .fi .RE .PP .SH "نویسندگان (AUTHORS)" .PP در ابتدا توسط Simon Ser نوشته شده است.\& در حال حاضر توسط Thorben Günther نگهداری می‌شود که توسط سایر مشارکت‌کنندگان متن‌باز یاری می‌گردد.\& برای اطلاعات بیشتر درباره توسعه hut، به مراجعه کنید.\&