.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH jj-bookmark-list 1 "list "
.SH "نام (NAME)"
jj\-bookmark\-list \- فهرست کردن نشانک‌ها و اهداف آن‌ها
.SH "خلاصه دستور (SYNOPSIS)"
\fBjj bookmark list\fR [\fB\-a\fR|\fB\-\-all\-remotes\fR] [\fB\-R\fR|\fB\-\-repository\fR] [\fB\-\-ignore\-working\-copy\fR] [\fB\-\-remote\fR] [\fB\-\-no\-integrate\-operation\fR] [\fB\-t\fR|\fB\-\-tracked\fR] [\fB\-c\fR|\fB\-\-conflicted\fR] [\fB\-\-ignore\-immutable\fR] [\fB\-\-at\-operation\fR] [\fB\-r\fR|\fB\-\-revision\fR] [\fB\-\-debug\fR] [\fB\-T\fR|\fB\-\-template\fR] [\fB\-\-color\fR] [\fB\-\-sort\fR] [\fB\-\-quiet\fR] [\fB\-\-no\-pager\fR] [\fB\-\-config\fR] [\fB\-\-config\-file\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fINAMES\fR]
.SH "توضیحات (DESCRIPTION)"
فهرست کردن نشانک‌ها (bookmarks) و اهداف آن‌ها.
.PP
به‌طور پیش‌فرض، یک نشانک دوردست (remote) ردیابی‌شده تنها در صورتی گنجانده می‌شود که هدف آن با هدف محلی متفاوت باشد. یک نشانک دوردست ردیابی‌نشده فهرست نخواهد شد. برای نشانک‌های دارای تداخل (هم محلی و هم دوردست)، بازنگری‌های هدف قدیمی با یک علامت
.RB "\*(Aq\-" "\*(Aq"
و بازنگری‌های هدف جدید با یک علامت
.RB "\*(Aq+" "\*(Aq"
مشخص می‌شوند.
.PP
برای اطلاعات بیشتر به
[`jj help \-k bookmarks`]
مراجعه کنید.
.PP
[`jj help \-k bookmarks`]: https://docs.jj\-vcs.dev/latest/bookmarks
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR, \fB\-\-all\-remotes\fR
نمایش همه نشانک‌های دوردست ردیابی‌شده و ردیابی‌نشده، از جمله مواردی که اهداف آن‌ها با نشانک‌های محلی همگام‌سازی شده‌اند.
.TP
\fB\-\-remote\fR \fI<REMOTE>\fR
نمایش همه نشانک‌های دوردست ردیابی‌شده و ردیابی‌نشده متعلق به این مخزن دوردست.
.sp
می‌تواند برای پالایش نشانک‌های نمایش‌داده‌شده با
.B \-\-tracked
یا
.B \-\-conflicted
ترکیب شود (می‌تواند تکرار شود).
.sp
به‌طور پیش‌فرض، الگوی مشخص‌شده نام‌های مخازن دوردست را با نحو glob تطبیق می‌دهد. همچنین می‌توانید از سایر نحوهای الگوی رشته‌ای [string pattern syntax] استفاده کنید.
.sp
[string pattern syntax]: https://docs.jj\-vcs.dev/latest/revsets/#string\-patterns
.TP
\fB\-t\fR, \fB\-\-tracked\fR
تنها نمایش نشانک‌های دوردست ردیابی‌شده.
.sp
این گزینه به‌طور پیش‌فرض نشانک‌های محلی ردیابی‌کننده Git را حذف می‌کند.
.TP
\fB\-c\fR, \fB\-\-conflicted\fR
تنها نمایش نشانک‌های دارای تداخل.
.TP
\fB\-r\fR, \fB\-\-revision\fR \fI<REVSETS>\fR
نمایش نشانک‌هایی که اهداف محلی آن‌ها در بازنگری‌های داده‌شده قرار دارند.
.sp
توجه داشته باشید که
.B \-r deleted_bookmark
کار نخواهد کرد زیرا
.B deleted_bookmark
هدف محلی نخواهد داشت.
.TP
\fB\-T\fR, \fB\-\-template\fR \fI<TEMPLATE>\fR
رندر کردن هر نشانک با استفاده از الگوی داده‌شده.
.sp
تمام متدهای بدون آرگومان از نوع
[`CommitRef` type]
به‌عنوان کلمات کلیدی در عبارت الگو در دسترس هستند. برای اطلاعات بیشتر به
[`jj help \-k templates`]
مراجعه کنید.
.sp
الگوی پیش‌فرض را می‌توان با تنظیم
.B templates.bookmark_list
تعیین کرد.
.sp
[`CommitRef` type]: https://docs.jj\-vcs.dev/latest/templates/#commitref\-type
.sp
[`jj help \-k templates`]: https://docs.jj\-vcs.dev/latest/templates
.TP
\fB\-\-sort\fR \fI<SORT_KEY>\fR
مرتب‌سازی نشانک‌ها بر اساس کلید داده‌شده (یا چندین کلید).
.sp
پسوند دادن کلید با
.B \-
باعث مرتب‌سازی به ترتیب نزولی مقدار می‌شود (برای نمونه
.BR \-\-sort\~name\- ).
توجه داشته باشید که هنگام استفاده از چندین کلید، نخستین کلید بیشترین اهمیت را دارد.
.sp
این گزینه به‌طور پیش‌فرض از تنظیم
.B ui.bookmark\-list\-sort\-keys
استفاده می‌کند.
.br
.sp
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
name
.IP \(bu 2
name\-
.IP \(bu 2
author\-name
.IP \(bu 2
author\-name\-
.IP \(bu 2
author\-email
.IP \(bu 2
author\-email\-
.IP \(bu 2
author\-date
.IP \(bu 2
author\-date\-
.IP \(bu 2
committer\-name
.IP \(bu 2
committer\-name\-
.IP \(bu 2
committer\-email
.IP \(bu 2
committer\-email\-
.IP \(bu 2
committer\-date
.IP \(bu 2
committer\-date\-
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq).
.TP
[\fINAMES\fR]
نمایش نشانک‌هایی که نام محلی آن‌ها مطابقت دارد.
.sp
به‌طور پیش‌فرض، الگوی مشخص‌شده نام‌های نشانک را با نحو glob تطبیق می‌دهد. همچنین می‌توانید از سایر نحوهای الگوی رشته‌ای [string pattern syntax] استفاده کنید.
.sp
[string pattern syntax]: https://docs.jj\-vcs.dev/latest/revsets/#string\-patterns
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
\fB\-R\fR, \fB\-\-repository\fR \fI<REPOSITORY>\fR
مسیر مخزنی که عملیات باید روی آن انجام شود.
.sp
به‌طور پیش‌فرض، Jujutsu برای یافتن نزدیک‌ترین دایرکتوری
.B .jj/
در اجداد دایرکتوری کاری فعلی جستجو می‌کند.
.TP
\fB\-\-ignore\-working\-copy\fR
از نسخه کاری (working copy) اسنپ‌شات نمی‌گیرد و آن را به‌روزرسانی نمی‌کند.
.sp
به‌طور پیش‌فرض، Jujutsu در ابتدای هر دستور از نسخه کاری یک اسنپ‌شات تهیه می‌کند. همچنین در پایان دستور، در صورتی که کامیت نسخه کاری
.RB ( @ )
تغییر کرده باشد، نسخه کاری به‌روزرسانی می‌شود. اگر می‌خواهید از تهیه اسنپ‌شات نسخه کاری صرف‌نظر کنید و در عوض یک کامیت نسخه کاری احتمالاً قدیمی را ببینید، می‌توانید از
.B \-\-ignore\-working\-copy
استفاده نمایید. این کار برای نمونه در خط فرمان (prompt)، به‌ویژه هنگامی که فرآیند دیگری نسخه کاری را کامیت می‌کند، مفید است.
.sp
بارگذاری مخزن در یک عملیات خاص با استفاده از
.B \-\-at\-operation
به‌طور ضمنی شامل
.B \-\-ignore\-working\-copy
می‌شود.
.TP
\fB\-\-no\-integrate\-operation\fR
دستور را طبق معمول اجرا می‌کند اما هیچ عملیاتی را یکپارچه‌سازی (integrate) نمی‌کند.
.sp
هنگامی که این گزینه مشخص شود، عملیات همچنان طبق معمول ایجاد می‌شوند اما در گزارش عملیات (operation log) ثبت و یکپارچه نمی‌گردند. نسخه کاری نیز به‌روزرسانی نخواهد شد.
.sp
دستور شناسه عملیات (operation ID) ایجادشده را چاپ می‌کند. می‌توانید آن شناسه را مثلاً به
.B jj \-\-at\-op
ارسال کنید تا وضعیت به‌دست‌آمده مخزن را بررسی نمایید، یا آن را به
.B jj op restore
بدهید تا مخزن را به آن وضعیت بازگرداند. همچنین می‌توانید این شناسه را به
.B jj op integrate
بدهید تا عملیات را یکپارچه‌سازی کند.
.sp
توجه داشته باشید که این گزینه مانع اثرات جانبی بیرون از مخزن *نمی‌شود*. برای نمونه،
.B jj git push \-\-no\-integrate\-operation
همچنان عملیات push را ارسال و اجرا خواهد کرد.
.TP
\fB\-\-ignore\-immutable\fR
اجازه بازنویسی کامیت‌های تغییرناپذیر (immutable).
.sp
به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌های موجود در مجموعه کامیت‌های تغییرناپذیر پیکربندی‌شده جلوگیری می‌کند. این گزینه بررسی مذکور را غیرفعال کرده و به شما امکان می‌دهد هر کامیتی به‌جز کامیت ریشه (root commit) را بازنویسی کنید.
.sp
این گزینه فقط روی این بررسی تأثیر می‌گذارد و روی مجموعه بازبینی
.B immutable_heads()
یا کلمه کلیدی الگوی
.B immutable
تأثیری ندارد.
.TP
\fB\-\-at\-operation\fR \fI<AT_OPERATION>\fR
عملیاتی که مخزن بر اساس آن بارگذاری می‌شود.
.sp
به‌طور پیش‌فرض، Jujutsu مخزن را در تازه‌ترین عملیات، یا در نقطه ادغام عملیات‌های واگرا (divergent) در صورت وجود، بارگذاری می‌کند.
.sp
می‌توانید از
.BI \-\-at\-op= <operation\~ID>
استفاده کنید تا ببینید مخزن در یک عملیات پیشین چگونه بوده است. برای نمونه،
.BI "jj \-\-at\-op=" <operation\~ID> " st"
آنچه را که
.B jj st
بلافاصله پس از اتمام آن عملیات نمایش می‌داد، به شما نشان می‌دهد. گزینه
.B \-\-at\-op=@
تقریباً مشابه حالت پیش‌فرض است، با این تفاوت که عملیات‌های واگرا هرگز ادغام نخواهند شد.
.sp
برای یافتن شناسه عملیات مورد نظر خود از
.B jj op log
استفاده کنید. هر پیشوند غیرمبهم از شناسه عملیات کافی خواهد بود.
.sp
هنگام بارگذاری مخزن در یک عملیات پیشین، نسخه کاری نادیده گرفته می‌شود، درست مانند اینکه
.B \-\-ignore\-working\-copy
مشخص شده باشد.
.sp
اجرای دستورات ایجادکننده تغییر (mutating) هنگام بارگذاری مخزن در یک عملیات پیشین امکان‌پذیر است. انجام این کار معادل اجرای دستورات همزمان با شروع از عملیات قبلی است. به‌ندرت دلیلی برای انجام این کار وجود دارد، اما امکان‌پذیر است.
.TP
\fB\-\-debug\fR
فعال‌سازی ثبت وقایع اشکال‌زدایی (debug logging).
.TP
\fB\-\-color\fR \fI<WHEN>\fR
تعیین زمان رنگی‌سازی خروجی.
.br
.sp
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
never
.IP \(bu 2
debug
.IP \(bu 2
auto
.RE
.TP
\fB\-\-quiet\fR
بی‌صدا کردن خروجی‌های غیرضروری و ثانویه دستور.
.sp
برای نمونه،
.B jj file list
همچنان فایل‌ها را فهرست می‌کند، اما دیگر گزارشی مبنی بر اینکه آیا از نسخه کاری اسنپ‌شات گرفته شده یا فرزندان بازپایه‌ریزی (rebase) شده‌اند ارائه نمی‌دهد.
.sp
پیام‌های هشدار و خطا همچنان نمایش داده می‌شوند.
.TP
\fB\-\-no\-pager\fR
غیرفعال‌سازی صفحه‌بندی‌کننده (pager).
.TP
\fB\-\-config\fR \fI<NAME=VALUE>\fR
گزینه‌های پیکربندی اضافی (می‌تواند تکرار شود).
.sp
نام باید به‌صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار نیز باید در قالب عبارت TOML تعیین گردد. اگر مقدار رشته‌ای درون ساختارهای TOML (مانند آرایه‌ها) قرار نگرفته باشد، می‌توان علامت‌های نقل‌قول را حذف کرد.
.TP
\fB\-\-config\-file\fR \fI<PATH>\fR
فایل‌های پیکربندی اضافی (می‌تواند تکرار شود).
.SH "همچنین ببینید (SEE ALSO)"
.BR jj (1),
.BR jj\-bookmark (1)