.\" Man page generated from reStructuredText.
.
.TH HGIGNORE 5 "" "" "راهنمای مرکوریال (Mercurial)"
.SH "نام (NAME)"
hgignore \- نحو فایل‌های نادیده‌گیری مرکوریال (Mercurial)
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH "خلاصه دستور (SYNOPSIS)"
.sp
سیستم مرکوریال از فایلی به نام \fB.hgignore\fP در شاخهٔ ریشهٔ یک مخزن استفاده می‌کند تا رفتار خود را هنگام جستجو برای فایل‌هایی که در حال حاضر ردیابی نمی‌شوند، کنترل کند.
.SH "توضیحات (DESCRIPTION)"
.sp
شاخهٔ کاری (working directory) یک مخزن مرکوریال معمولاً شامل فایل‌هایی است که نباید توسط مرکوریال ردیابی شوند. این موارد شامل فایل‌های پشتیبان ایجادشده توسط ویرایشگرها و خروجی‌های ساخت ایجادشده توسط کامپایلرها می‌شوند. این فایل‌ها را می‌توان با فهرست کردن آن‌ها در یک فایل \fB.hgignore\fP در ریشهٔ شاخهٔ کاری نادیده گرفت. فایل \fB.hgignore\fP باید به صورت دستی ایجاد شود. این فایل معمولاً تحت کنترل نسخه قرار می‌گیرد تا تنظیمات آن با push و pull به سایر مخازن نیز منتقل شود.
.sp
یک فایل ردیابی‌نشده در صورتی نادیده گرفته می‌شود که مسیر آن نسبت به شاخهٔ ریشهٔ مخزن، یا هر پیشوندِ مسیری از آن، با الگویی در \fB.hgignore\fP مطابقت داشته باشد.
.sp
برای مثال، فرض کنید یک فایل ردیابی‌نشده به نام \fBfile.c\fP در مسیر \fBa/b/file.c\fP درون مخزن داریم. مرکوریال در صورتی \fBfile.c\fP را نادیده می‌گیرد که هر یک از الگوهای موجود در \fB.hgignore\fP با \fBa/b/file.c\fP، \fBa/b\fP یا \fBa\fP مطابقت پیدا کند.
.sp
علاوه بر این، یک فایل پیکربندی مرکوریال می‌تواند به مجموعه‌ای از فایل‌های نادیده‌گیری اختصاصی برای هر کاربر یا سراسری ارجاع دهد. برای جزئیات نحوهٔ پیکربندی این فایل‌ها، کلید پیکربندی \fBignore\fP در بخش \fB[ui]\fP از \%\fBhg help config\fP\: را ببینید.
.sp
برای کنترل نحوهٔ رفتار مرکوریال با فایل‌هایی که مدیریت می‌کند، بسیاری از دستورها از گزینه‌های \fB\-I\fP و \fB\-X\fP پشتیبانی می‌کنند؛ برای جزئیات به \%\fBhg help <command>\fP\: و \%\fBhg help patterns\fP\: مراجعه کنید.
.sp
فایل‌هایی که از قبل ردیابی شده‌اند تحت تأثیر .hgignore قرار نمی‌گیرند، حتی اگر نام آن‌ها در .hgignore درج شده باشد. یک فایل ردیابی‌نشده مانند X را می‌توان با دستور \%\fBhg add X\fP\: به طور صریح اضافه کرد، حتی اگر X توسط الگویی در .hgignore مستثنی شده باشد.
.SH "نحو (SYNTAX)"
.sp
یک فایل نادیده‌گیری، یک فایل متنی ساده شامل فهرستی از الگوها است که در هر خط یک الگو قرار می‌گیرد. خطوط خالی نادیده گرفته می‌شوند. نویسهٔ \fB#\fP به عنوان نویسهٔ توضیح و نویسهٔ \fB\e\fP به عنوان نویسهٔ گریز (escape) در نظر گرفته می‌شود.
.sp
مرکوریال از چندین نحو الگو پشتیبانی می‌کند. نحو پیش‌فرضی که استفاده می‌شود، عبارات باقاعده (regular expressions) به سبک Python/Perl است.
.sp
برای تغییر نحو مورد استفاده، از خطی با قالب زیر استفاده کنید:
.sp
.nf
.ft C
syntax: NAME
.ft P
.fi
.sp
که در آن \fBNAME\fP یکی از موارد زیر است:
.INDENT 0.0
.TP
.B \fBregexp\fP
.sp
عبارت باقاعده، نحو Python/Perl.
.TP
.B \fBglob\fP
.sp
تطبیق الگو به سبک پوسته (Shell-style glob).
.TP
.B \fBrootglob\fP
.sp
گونه‌ای از \fBglob\fP که ریشه‌دار است (در ادامه را ببینید).
.UNINDENT
.sp
نحو انتخاب‌شده هنگام پردازش تمام الگوهای بعدی معتبر باقی می‌ماند تا زمانی که نحو دیگری انتخاب شود.
.sp
نه الگوهای \fBglob\fP و نه الگوهای regexp ریشه‌دار نیستند. یک الگوی نحو glob به شکل \fB*.c\fP با فایلی که به \fB.c\fP ختم می‌شود در هر شاخه‌ای مطابقت خواهد داشت، و یک الگوی regexp به شکل \fB\e.c$\fP نیز همین کار را انجام می‌دهد. برای ریشه‌دار کردن یک الگوی regexp، آن را با \fB^\fP شروع کنید. برای دستیابی به همان نتیجه با نحو glob، باید از \fBrootglob\fP استفاده کنید.
.sp
زیرشاخه‌ها می‌توانند با افزودن \fBsubinclude:path/to/subdir/.hgignore\fP به فایل \fB.hgignore\fP ریشه، تنظیمات .hgignore مختص به خود را داشته باشند. برای جزئیات در مورد \fBsubinclude:\fP و \fBinclude:\fP به \%\fBhg help patterns\fP\: مراجعه کنید.
.IP "نکته (Note)"
.
الگوهایی که در جایی غیر از \fB.hgignore\fP مشخص می‌شوند همیشه ریشه‌دار هستند. لطفاً برای جزئیات به \%\fBhg help patterns\fP\: مراجعه کنید.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
در اینجا نمونه‌ای از یک فایل نادیده‌گیری آورده شده است:
.sp
.nf
.ft C
# use glob syntax.
syntax: glob

*.elc
*.pyc
*~

# switch to regexp syntax.
syntax: regexp
^\e.pc/
.ft P
.fi
.SH "اشکال‌زدایی (DEBUGGING)"
.sp
از دستور \fBdebugignore\fP برای بررسی اینکه آیا یک فایل نادیده گرفته شده است و دلیل آن چیست، یا برای مشاهدهٔ الگوی ترکیبی نادیده‌گیری استفاده کنید. برای جزئیات به \%\fBhg help debugignore\fP\: مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
.sp
Vadim Gelfer <\%vadim.gelfer@gmail.com\:>
.sp
مرکوریال توسط Olivia Mackall <\%olivia@selenic.com\:> نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\%\fBhg\fP(1)\:, \%\fBhgrc\fP(5)\:
.SH "حق نشر (COPYING)"
.sp
حق نشر این صفحهٔ راهنما متعلق به Vadim Gelfer در سال 2006 است.
حق نشر مرکوریال متعلق به Olivia Mackall در سال‌های 2005\-2026 است.
استفاده رایگان از این نرم‌افزار تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) نسخه ۲ یا هر نسخهٔ بالاتر اعطا شده است.
.\" Common link and substitution definitions.
.
.SH "نویسندگان (AUTHORS)"
Vadim Gelfer <vadim.gelfer@gmail.com>

سازمان: Mercurial
.\" Generated by docutils manpage writer.
.\" 
.