.TH git-annex-view 1
.SH "نام (NAME)"
git-annex-view \- ورود به یک شاخه نمایشی
.PP
.SH "خلاصه دستور (SYNOPSIS)"
\fBgit annex view\fP \fB[tag ...] [field=value ...] [field=glob ...] [?tag ...] [field?=glob] [!tag ...] [field!=value ...]\fP
.PP
.SH "توضیحات (DESCRIPTION)"
از فراداده‌ها (metadata) برای ساخت یک شاخه نمایشی (view branch) از فایل‌های موجود در شاخه فعلی استفاده کرده و شاخه نمایشی را بررسی و دریافت (checkout) می‌کند. تنها فایل‌هایی از شاخه فعلی در این نما نمایش داده می‌شوند که فراداده‌های آن‌ها با تمامی مقادیر فیلدها و برچسب‌های (tags) مشخص‌شده مطابقت داشته باشد.
.PP
می‌توان چندین مقدار را برای یک فیلد فراداده تعیین کرد، چه با استفاده از یک الگو یا گلوب (\fBfield="*"\fP) و چه با ذکر تک‌تک مقادیر مورد نظر. نمای حاصل، فایل‌ها را بر اساس مقدار فیلدهایشان در زیردایرکتوری‌ها قرار می‌دهد.
.PP
پس از ورود به چنین نمایی، می‌توانید دایرکتوری‌های اضافی ایجاد کرده و فایل‌ها را به درون آن‌ها کپی کرده یا انتقال دهید. هنگامی که کامیت (commit) می‌کنید، فراداده‌ها متناسب با تغییرات شما به‌روزرسانی خواهند شد. حذف فایل‌ها و ثبت کامیت نیز فراداده‌ها را به‌روزرسانی می‌کند.
.PP
علاوه بر فراداده‌های معمول، فیلدهایی متناظر با مسیر فایل نیز در دسترس هستند. بنابراین یک فایل «foo/bar/baz/file» دارای فیلدهای «/=foo»، «foo/=bar» و «foo/bar/=baz» است. از این فیلدهای موقعیت مکانی می‌توان همانند سایر فراداده‌ها برای ساخت نما استفاده کرد.
.PP
برای مثال،
.B /=foo
تنها فایل‌های موجود در دایرکتوری foo را در نما قرار می‌دهد، در حالی که
.B foo/=*
زیردایرکتوری‌های دایرکتوری foo را در نما حفظ خواهد کرد.
.PP
برای ورود به نمایی که تنها شامل فایل‌هایی باشد که فاقد یک مقدار فراداده یا برچسب مشخص هستند، عبارت
.B field!=value
یا
.B !tag
را مشخص کنید. (در اینجا نمی‌توان از الگوهای گلوب استفاده کرد.)
.PP
عبارت
.B field?=*
مشابه
.B field=*
است، اما یک دایرکتوری اضافی به نام
.B _
(به‌طور پیش‌فرض) اضافه می‌کند که شامل فایل‌هایی است که فیلد برای آن‌ها روی هیچ مقداری تنظیم نشده است. به همین ترتیب،
.B ?tag
یک دایرکتوری اضافی به نام
.B _
می‌افزاید که شامل فایل‌هایی است که هیچ برچسبی برای آن‌ها تنظیم نشده است. انتقال فایل‌ها از دایرکتوری
.B _
به یک دایرکتوری دیگر و کامیت کردن، فراداده را تنظیم می‌کند؛ و انتقال فایل‌ها به داخل دایرکتوری
.B _
و ثبت کامیت، تنظیم فراداده را لغو (unset) خواهد کرد.
.PP
نام دایرکتوری
.B _
را می‌توان با استفاده از تنظیمات
.B annex.viewunsetdirectory
در پیکربندی گیت تغییر داد.
.PP
نام فایل‌ها در شاخه نمایشی شامل مسیر آن‌ها در شاخه اصلی است تا از یکتا بودن آن‌ها اطمینان حاصل شود. مسیر بعد از نام اصلی فایل و قبل از هر پسوندی قرار می‌گیرد. برای مثال، «foo/bar.baz» نامی شبیه به «bar_%foo%.baz» خواهد داشت. از
.B annex.maxextensionlength
می‌توان برای پیکربندی مواردی که به عنوان پسوند در نظر گرفته می‌شوند استفاده کرد.
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "می‌توان از گزینه‌های \fBgit-annex\-common\-options\fP(1) استفاده کرد."
.IP
.SH "همچنین ببینید (SEE ALSO)"
.BR git-annex (1)
.PP
.BR git-annex\-metadata (1)
.PP
.BR git-annex\-vpop (1)
.PP
.BR git-annex\-vfilter (1)
.PP
.BR git-annex\-vadd (1)
.PP
.BR git-annex\-vcycle (1)
.PP
.BR git-annex\-adjust (1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>