.TH git-annex-matching-expression 1
.SH "نام (NAME)"
git-annex-matching-expression \- نحو عبارات تطبیق برای انتخاب فایل‌ها
.SH "توضیحات (DESCRIPTION)"
پیکربندی‌های
.B annex.largefiles
و
.B annex.addunlocked
هر دو از عبارت‌هایی استفاده می‌کنند که با برخی از فایل‌ها در درخت کاری (working tree) مطابقت دارند.
.SH "عبارات (EXPRESSIONS)"
قالب این عبارت‌ها مشابه عبارت‌های
.BR git-annex\-preferred\-content (1)
است.
.PP
برای مثال:
.PP
.nf
largerthan=100kb and not (include=*.c or include=*.h)
.fi
.PP
این عبارت فایل‌های حجیم را مطابقت می‌دهد، اما فایل‌های منبع C را مستثنی می‌کند.
.PP
می‌توان از عبارت‌های زیر استفاده کرد:
.IP "\fBinclude=glob\fP / \fBexclude=glob\fP"
فایل‌ها را برای شامل شدن یا مستثنی شدن مشخص می‌کند.
.IP
الگوی glob می‌تواند شامل
.B *
و
.B ?
برای مطابقت با نویسه‌های دلخواه باشد.
.IP
توجه داشته باشید که این تطبیق روی کل نام فایل، نسبت به ریشهٔ دایرکتوری گیت انجام می‌شود. بنابراین،
.B include=foo
یک فایل
.B foo
را در ریشه شامل می‌کند، اما
.B subdir/foo
را شامل نمی‌شود. برای شامل کردن هر دو، از
.B include=foo or include=*/foo
استفاده کنید.
.IP "\fBsmallerthan=size\fP / \fBlargerthan=size\fP"
تنها با فایل‌های کوچک‌تر از، یا بزرگ‌تر از اندازهٔ مشخص‌شده مطابقت دارد.
.IP
اندازه را می‌توان با هر یک از واحدهای رایج مشخص کرد، برای نمونه،
"0.5 gb"
یا
"100 KiloBytes".
.IP "\fBmimetype=glob\fP"
نوع MIME یک فایل را بررسی کرده و تطابق الگوی glob با آن را می‌سنجد.
.IP
برای نمونه،
\fB"mimetype=text/*"\fP
با انواع مختلفی از فایل‌های متنی مطابقت خواهد داشت، از جمله "text/plain" و همچنین "text/x\-shellscript" و "text/x\-makefile" و غیره.
.IP
انواع MIME همان مواردی هستند که با اجرای
.B file \-\-mime\-type
نمایش داده می‌شوند.
.IP
این مورد تنها زمانی مطابقت دارد که محتوای فایل در مخزن محلی موجود باشد. معمولاً این‌گونه است، اما برای نمونه، هنگام وارد کردن از یک مخزن دوردست ویژه با
.BR \-\-no\-content ،
محتوا معمولاً در دسترس نیست.
.IP
این گزینه تنها زمانی قابل استفاده است که git-annex با فلگ ساخت MagicMime کامپایل شده باشد.
.IP "\fBmimeencoding=glob\fP"
کدگذاری MIME یک فایل را بررسی کرده و تطابق الگوی glob با آن را می‌سنجد.
.IP
برای نمونه،
\fB"mimeencoding=binary"\fP
با انواع مختلفی از فایل‌های باینری مطابقت خواهد داشت.
.IP
کدگذاری‌های MIME همان مواردی هستند که با اجرای
.B file \-\-mime\-encoding
نمایش داده می‌شوند.
.IP
این مورد تنها زمانی مطابقت دارد که محتوای فایل در مخزن محلی موجود باشد. معمولاً این‌گونه است، اما برای نمونه، هنگام وارد کردن از یک مخزن دوردست ویژه با
.BR \-\-no\-content ،
محتوا معمولاً در دسترس نیست.
.IP
این گزینه تنها زمانی قابل استفاده است که git-annex با فلگ ساخت MagicMime کامپایل شده باشد.
.IP "\fBanything\fP"
با هر فایلی مطابقت دارد.
.IP "\fBnothing\fP"
با هیچ فایلی مطابقت ندارد. (مشابه "not anything")
.IP "\fBnot expression\fP"
نتیجهٔ تطبیق عبارت را معکوس می‌کند.
.IP "\fBand\fP / \fBor\fP / \fB( expression )\fP"
این موارد می‌توانند برای ساخت عبارت‌های پیچیده‌تر استفاده شوند.
.SH "همچنین ببینید (SEE ALSO)"
.BR git-annex (1)
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>
.PP
<http://git-annex.branchable.com>