hub-issue(1) hub manual hub-issue(1)

hub-issue - مدیریت Issueهای GitHub برای مخزن جاری.

hub issue [-a ASSIGNEE] [-c CREATOR] [-@ USER] [-s STATE] [-f FORMAT] [-M MILESTONE] [-l LABELS] [-d DATE] [-o SORT_KEY [-^]] [-L LIMIT]
hub issue show [-f FORMAT] NUMBER
hub issue create [-oc] [-m MESSAGE|-F FILE] [--edit] [-a USERS] [-M MILESTONE] [-l LABELS]
hub issue update NUMBER [-m MESSAGE|-F FILE] [--edit] [-a USERS] [-M MILESTONE] [-l LABELS] [-s STATE]
hub issue labels [--color]
hub issue transfer NUMBER REPO

بدون هیچ آرگومانی، فهرستی از issueهای باز را نمایش می‌دهد.

show

نمایش یک issue موجود مشخص‌شده با NUMBER.

create

ایجاد یک issue در مخزن جاری.

update

به‌روزرسانی فیلدهای یک issue موجود مشخص‌شده با NUMBER. از --edit برای ویرایش تعاملی عنوان و پیام در ویرایشگر متن استفاده کنید.

labels

فهرست کردن برچسب‌های موجود در این مخزن.

transfer

انتقال یک issue به مخزنی دیگر.

-a, --assignee ASSIGNEE

در حالت فهرست، فقط issueهایی را نمایش می‌دهد که به ASSIGNEE واگذار شده‌اند.

-a, --assign USERS

فهرستی جداشده با کاما از شناسه‌های GitHub برای انتساب به issue ایجادشده.

-c, --creator CREATOR

فقط issueهای ایجادشده توسط CREATOR را نمایش می‌دهد.

-@, --mentioned USER

فقط issueهایی را نمایش می‌دهد که در آن‌ها به USER اشاره شده است.

-s, --state STATE

نمایش issueها با وضعیت STATE (پیش‌فرض: "open").

-f, --format FORMAT

چاپ آراسته محتویات issueها با استفاده از قالب FORMAT (پیش‌فرض: "%sC%>(8)%i%Creset %t% l%n"). برای جزئیات تکمیلی در مورد نحوه استفاده از متغیرهای جانگهدار در قالب، بخش "PRETTY FORMATS" در git-log(1) را ببینید. جانگهدارنده‌های موجود برای issueها عبارتند از:

%I: شماره issue

%i: شماره issue با پیشوند "#"

%U: نشانی URL این issue

%S: وضعیت (مانند "open" یا "closed")

%sC: تنظیم رنگ به قرمز یا سبز، بسته به وضعیت issue.

%t: عنوان

%l: برچسب‌های رنگی

%L: برچسب‌های خام جداشده با کاما

%b: متن بدنه

%au: نام کاربری نویسنده

%as: فهرست جداشده با کاما از افراد واگذارشده

%Mn: شماره milestone

%Mt: عنوان milestone

%NC: تعداد دیدگاه‌ها

%Nc: تعداد دیدگاه‌ها درون پرانتز، یا یک رشته خالی در صورت صفر بودن.

%cD: فقط تاریخ ایجاد (بدون ساعت)

%cr: تاریخ ایجاد، نسبی

%ct: تاریخ ایجاد، برچسب زمانی UNIX

%cI: تاریخ ایجاد، در قالب ISO 8601

%uD: فقط تاریخ به‌روزرسانی (بدون ساعت)

%ur: تاریخ به‌روزرسانی، نسبی

%ut: تاریخ به‌روزرسانی، برچسب زمانی UNIX

%uI: تاریخ به‌روزرسانی، در قالب ISO 8601

%n: خط جدید

%%: نویسه واقعی %

--color[=WHEN]

فعال‌سازی خروجی رنگی حتی اگر stdout یک ترمینال نباشد. مقدار WHEN می‌تواند یکی از "always" (پیش‌فرض برای --color)، "never" یا "auto" (پیش‌فرض) باشد.

-m, --message MESSAGE

متن موجود تا نخستین خط خالی در MESSAGE به عنوان عنوان issue در نظر گرفته می‌شود و باقی‌مانده به عنوان شرح issue در قالب Markdown استفاده می‌شود.

هنگامی که چند گزینه --message داده شود، مقادیر آن‌ها با یک خط خالی در میانشان الحاق می‌شوند.

اگر هیچ‌کدام از گزینه‌های --message یا --file به issue create داده نشوند، یک ویرایشگر متن برای نوشتن عنوان و شرح باز خواهد شد.

-F, --file FILE

خواندن عنوان و شرح issue از FILE. برای خواندن از ورودی استاندارد، "-" را ارسال کنید. برای قواعد قالب‌بندی به --message مراجعه کنید.

-e, --edit

باز کردن عنوان و شرح issue در یک ویرایشگر متن پیش از ارسال نهایی. این گزینه می‌تواند در ترکیب با --message یا --file استفاده شود.

-o, --browse

باز کردن issue جدید در یک مرورگر وب.

-c, --copy

قرار دادن نشانی URL مربوط به issue جدید در کلیپ‌بورد به جای چاپ آن در خروجی.

-M, --milestone NAME

فقط نمایش issueهای متعلق به یک milestone در GitHub با نام NAME.

هنگام ایجاد یک issue، این issue به یک milestone در GitHub با نام NAME افزوده می‌شود. ارسال شماره milestone منسوخ شده است.

-l, --labels LABELS

فقط نمایش issueهای دارای برچسب‌های مشخص.

هنگام ایجاد یک issue، فهرستی جداشده با کاما از برچسب‌ها به این issue افزوده می‌شود.

-d, --since DATE

فقط نمایش issueهایی که در تاریخ DATE یا پس از آن در قالب ISO 8601 به‌روزرسانی شده‌اند.

-o, --sort KEY

مرتب‌سازی issueهای نمایش‌داده‌شده بر اساس "created" (پیش‌فرض)، "updated" یا "comments".

-^ --sort-ascending

مرتب‌سازی صعودی تاریخ‌ها به جای نزولی.

-L, --limit LIMIT

فقط نمایش نخستین LIMIT مورد از issueها.

--include-pulls

شامل کردن pull requestها علاوه بر issueها.

--color

فعال‌سازی خروجی رنگی برای فهرست برچسب‌ها.

hub-pr(1), hub(1)

12 Jul 2024 hub version 2.14.2