.\" Man page generated from reStructuredText.
.
.
.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
..
.TH "SYNCTHING-STIGNORE" "5" "Jul 23, 2026" "v2.1.0" "Syncthing"
.SH "نام (NAME)"
syncthing-stignore \- جلوگیری از همگام‌سازی فایل‌ها با گره‌های دیگر
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\&.stignore
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
اگر نباید برخی فایل‌ها با سایر دستگاه‌ها همگام‌سازی شوند (یا از آن‌ها دریافت گردند)، می‌توان فایلی به نام
\fB\&.stignore\fP حاوی الگوهای نادیده‌گیری فایل‌ها ایجاد کرد. فایل \fB\&.stignore\fP
باید در ریشه پوشه همگام‌سازی قرار گیرد (فایل‌ها در مکان‌های دیگر اعمال نمی‌شوند). خود فایل \fB\&.stignore\fP
هرگز با دستگاه‌های دیگر همگام‌سازی نمی‌شود، هرچند می‌تواند با \fB#include\fP فایل‌هایی را که بین دستگاه‌ها همگام‌سازی \fIمی‌شوند\fP فراخوانی کند. تمام الگوها نسبت به ریشه پوشه همگام‌سازی سنجیده می‌شوند. محتویات فایل \fB\&.stignore\fP باید با کدبندی UTF\-8 باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
توجه داشته باشید که فایل‌های نادیده‌گرفته‌شده می‌توانند مانع از حذف یک دایرکتوری در غیر این صورت خالی شوند. برای اجازه حذف فایل‌های نادیده‌گرفته‌شده، پیشوند (?d) را در ادامه ببینید.
.UNINDENT
.UNINDENT
.SH "الگوها (PATTERNS)"
.sp
فایل \fB\&.stignore\fP حاوی فهرستی از الگوهای فایل یا مسیر است.
\fIاولین\fP الگویی که مطابقت یابد، وضعیت فایل مربوطه را تعیین می‌کند.
.INDENT 0.0
.IP \(bu 2
نام‌های معمولی فایل با خودشان تطابق می‌یابند؛ به عنوان مثال، الگوی \fBfoo\fP با فایل‌های
\fBfoo\fP، \fBsubdir/foo\fP و هر دایرکتوری با نام \fBfoo\fP تطابق دارد. فاصله‌ها به عنوان نویسه‌های معمولی در نظر گرفته می‌شوند، به جز فاصله‌های ابتدا و انتهای خط که به طور خودکار حذف می‌شوند.
.IP \(bu 2
\fBستاره\fP (\fB*\fP) با صفر یا چند نویسه در نام فایل تطابق می‌یابد، اما با جداکننده دایرکتوری تطابق ندارد. الگوی \fBte*ne\fP با \fBtelephone\fP و
\fBsubdir/telephone\fP تطابق دارد اما با \fBtele/phone\fP تطابق ندارد.
.IP \(bu 2
\fBدو ستاره\fP (\fB**\fP) مانند بالا تطابق می‌یابد، اما شامل جداکننده‌های دایرکتوری نیز می‌شود.
الگوی \fBte**ne\fP با \fBtelephone\fP، \fBsubdir/telephone\fP و
\fBtele/sub/dir/phone\fP تطابق دارد.
.IP \(bu 2
\fBعلامت سوال\fP (\fB?\fP) با یک نویسه منفرد که جداکننده دایرکتوری نباشد تطابق می‌یابد.
الگوی \fBte??st\fP با \fBtebest\fP تطابق دارد اما با \fBteb/st\fP یا
\fBtest\fP تطابق ندارد.
.IP \(bu 2
\fBکروکوشه‌ها\fP (\fB[]\fP) بیانگر محدوده‌ای از نویسه‌ها هستند: \fB[a\-z]\fP با هر نویسه کوچک انگلیسی تطابق دارد.
.IP \(bu 2
\fBآکولادها\fP (\fB{}\fP) مجموعه‌ای از گزینه‌های جداشده با کاما را نشان می‌دهند:
\fB{banana,pineapple}\fP با هر یک از مقادیر \fBbanana\fP یا \fBpineapple\fP تطابق دارد.
.IP \(bu 2
\fBاسلش رو به عقب\fP (\fB\e\fP) یک نویسه خاص را بی‌اثر (escape) می‌کند تا معنی خاص خود را از دست بدهد. به عنوان مثال، \fB\e{banana\e}\fP دقیقاً با \fB{banana}\fP تطابق دارد و مجموعه‌ای از گزینه‌ها مانند بالا به حساب نمی‌آید.
.sp
\fBنکته:\fP
.INDENT 2.0
.INDENT 3.5
در ویندوز، \fB\e\fP جداکننده مسیر است، بنابراین از \fB|\fP برای اسکیپ کردن نویسه‌های خاص استفاده کنید. به عنوان مثال، \fB|{banana|}\fP با \fB{banana}\fP مطابقت دارد.
.sp
برای استفاده از \fB\e\fP جهت اسکیپ نویسه‌های خاص (و استفاده از \fB/\fP به عنوان جداکننده مسیر)، عبارت \fB#escape=\e\fP را در بالای فایل درج کنید. مثال کوتاه:
.INDENT 0.0
.INDENT 3.5
.nf
\fB#escape=\e\fP
\fB/foo\fP
\fB/path/bar/\e{banana\e}\fP
\fB/path/baz\e[2\e]/ex\e[3\e].txt\fP
.fi
.sp
.UNINDENT
.UNINDENT
.sp
عبارت \fB#escape=\e\fP باید در بالای فایل و پیش از هر الگویی قرار گیرد، هرچند توضیحات و خطوط خالی در ابتدا مجاز هستند.
.sp
هر فایلی که با دستور \fB#include\fP فراخوانی شود (پایین را ببینید) به عبارت \fB#escape=\e\fP اختصاصی خود نیاز خواهد داشت.
.sp
استفاده از \fB#escape=\e\fP امکان همگام‌سازی و استفاده از یک فایل مشترک را در هر سیستم‌عاملی فراهم می‌کند.
.UNINDENT
.UNINDENT
.IP \(bu 2
الگویی که با \fB/\fP آغاز شود تنها در ریشه پوشه همگام‌سازی مطابقت می‌یابد.
\fB/foo\fP با \fBfoo\fP مطابقت دارد اما با \fBsubdir/foo\fP تطابق ندارد.
.IP \(bu 2
الگویی که با \fB#include\fP شروع شود، منجر به بارگذاری الگوها از فایل نام‌برده می‌شود. در صورت عدم وجود فایل یا درج بیش از یک بار، خطا رخ می‌دهد. توجه داشته باشید که هرچند می‌توان از این برای درج الگوها از یک فایل در زیرپوشه استفاده کرد، الگوها کماکان نسبت به \fIریشه\fP پوشه همگام‌سازی سنجیده می‌شوند. مثال:
\fB#include more\-patterns.txt\fP.
.sp
هر دستور \fB#include\fP درون فایلی که بارگذاری می‌شود، به مسیرهایی نیاز دارد که نسبت به پوشه حاوی همان فایل مشخص شده باشند، نه نسبت به ریشه همگام‌سازی.
.IP \(bu 2
الگویی با پیشوند \fB!\fP الگو را نفی می‌کند: فایل‌های منطبق \fIدرج\fP می‌شوند (یعنی نادیده گرفته \fIنمی‌شوند\fP). این ویژگی می‌تواند برای بازنویسی الگوهای عمومی‌تر بعدی استفاده شود.
.sp
\fBنکته:\fP
.INDENT 2.0
.INDENT 3.5
الگوهای منفی که با اقلام پایین‌تر از ریشه پوشه تطابق دارند، باعث می‌شوند Syncthing پوشه‌هایی را که در غیر این صورت نادیده گرفته می‌شدند پیمایش کند. اگر ناظر (\fIwatcher\fP) فعال باشد، آن پوشه‌ها نیز پایش می‌شوند. با این حال پوشه‌هایی که قبل از نخستین الگوی منفی نادیده گرفته شده‌اند، می‌توانند با خیال راحت نادیده انگاشته شوند زیرا اولین الگوی منطبق اولویت دارد. به عنوان مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
/foo
/bar
!baz
*
.EE
.UNINDENT
.UNINDENT
.sp
پوشه‌های \fBfoo\fP و \fBbar\fP کاملاً نادیده گرفته خواهند شد. اما هر پوشه دیگر باید به طور کامل پویش شود تا موارد با نام \fIbaz\fP پیدا شوند، علی‌رغم اینکه به دلیل الگوی \fB*\fP نادیده گرفته خواهند شد. به عنوان حالتی خاص، الگوهای ریشه‌ای سطح بالا (مانند \fB!/foo\fP) باعث این رفتار نمی‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
!/baz
*
.EE
.UNINDENT
.UNINDENT
.sp
در این حالت، فقط پوشه \fBbaz\fP پویش می‌شود، زیرا همه موارد دیگر با الگوی \fB*\fP نادیده گرفته شده‌اند.
.UNINDENT
.UNINDENT
.IP \(bu 2
الگویی که با پیشوند \fB(?i)\fP شروع شود، تطبیق الگو را به حروف کوچک و بزرگ حساس نمی‌کند.
الگوی \fB(?i)test\fP با \fBtest\fP، \fBTEST\fP و \fBtEsT\fP تطابق دارد.
پیشوند \fB(?i)\fP را می‌توان با الگوهای دیگر ترکیب کرد؛ مثلاً الگوی \fB(?i)!picture*.png\fP نشان می‌دهد که \fBPicture1.PNG\fP باید همگام‌سازی شود. در Mac OS و Windows، الگوها همیشه نسبت به حروف بزرگ و کوچک حساس نیستند.
.IP \(bu 2
الگویی با پیشوند \fB(?d)\fP حذف فایل‌ها را در صورتی که مانع حذف دایرکتوری شوند مجاز می‌کند. این پیشوند باید برای فایل‌های تولیدشده توسط سیستم‌عامل که حذف آن‌ها مشکلی ایجاد نمی‌کند استفاده شود.
.sp
\fBنکته:\fP
.INDENT 2.0
.INDENT 3.5
پیشوندها می‌توانند با هر ترتیبی مشخص شوند (مثلاً \fB(?d)(?i)\fP)، اما نمی‌توان آن‌ها را درون یک جفت پرانتز ترکیب کرد (مانند (?di)).
.UNINDENT
.UNINDENT
.IP \(bu 2
خطی که با \fB//\fP آغاز شود یک توضیح (کامنت) است و اثری ندارد. دو اسلش در هر نقطه دیگر به صورت لغوی تفسیر می‌شوند؛ مثلاً درج \fBfile // comment\fP باعث می‌شود Syncthing به دنبال فایلی با نام \fBfile // comment\fP بگردد.
.UNINDENT
.SH "مثال (EXAMPLE)"
.sp
با فرض ساختار پوشه‌ای زیر در ریشه پوشه همگام‌سازی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\&.DS_Store
\&.stignore
foo
foofoo
bar/
    baz
    quux
    quuz
bar2/
    baz
    frobble
My Pictures/
    Img15.PNG
.EE
.UNINDENT
.UNINDENT
.sp
و فایلی به نام \fB\&.stignore\fP با محتویات زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
(?d).DS_Store
!frobble
!quuz
foo
*2
qu*
(?i)my pictures
.EE
.UNINDENT
.UNINDENT
.sp
تمام فایل‌ها و پوشه‌هایی با نام “foo”، پایان‌یافته با “2” یا شروع‌شده با “qu” نادیده گرفته خواهند شد. نتیجه نهایی به این صورت خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\&.DS_Store     # نادیده گرفته شد، در صورت جلوگیری از حذف پوشه والد حذف خواهد شد
foo           # نادیده گرفته شد، منطبق با \(dqfoo\(dq
foofoo        # همگام‌سازی شد، با \(dqfoo\(dq تطابق ندارد اما با \(dqfoo*\(dq یا \(dq*foo\(dq تطابق داشت
bar/          # همگام‌سازی شد
    baz       # همگام‌سازی شد
    quux      # نادیده گرفته شد، منطبق با \(dqqu*\(dq
    quuz      # همگام‌سازی شد، با \(dqqu*\(dq تطابق دارد اما با الگوی قبلی \(dq!quuz\(dq استثنا شده
bar2/         # همگام‌سازی شد، علیرغم تطابق با \(dq*2\(dq به دلیل وجود فرزند frobble
    baz       # نادیده گرفته شد، به دلیل نادیده گرفته شدن والد
    frobble   # همگام‌سازی شد، به دلیل \(dq!frobble\(dq
My Pictures/  # نادیده گرفته شد، منطبق با الگوی حساس نبودن به حروف \(dq(?i)my pictures\(dq
    Img15.PNG # نادیده گرفته شد، به دلیل نادیده گرفته شدن والد
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
لطفاً توجه داشته باشید که الگوهای دایرکتوری که با اسلش پایان می‌یابند مانند
\fBsome/directory/\fP با محتوای دایرکتوری تطابق می‌یابند، نه خود دایرکتوری. اگر می‌خواهید الگو هم با دایرکتوری و هم با محتوای آن مطابقت یابد، اطمینان حاصل کنید که اسلش \fB/\fP در انتهای الگو نباشد.
.UNINDENT
.UNINDENT
.sp
اضافه‌شده در نسخه 1.19.0: می‌توان الگوهای پیش‌فرضی را پیکربندی کرد که هنگام پذیرش خودکار پوشه از یک دستگاه راه دور اعمال شوند. واسط گرافیکی (GUI) هنگام افزودن دستی پوشه نیز همین الگوها را پیشنهاد می‌دهد. در هر صورت، اگر فایلی وجود نداشته باشد، فایل \fB\&.stignore\fP با این مقادیر پیش‌فرض ایجاد می‌شود.

.sp
اضافه‌شده در نسخه 2.0.0: کاربران ویندوز اکنون می‌توانند از نویسه خط عمودی (\fB|\fP) برای اسکیپ کردن نویسه‌های خاص در فایل \fB\&.stignore\fP استفاده کنند. علاوه بر این، افزودن \fB#escape=X\fP به بالای فایل به کاربران امکان می‌دهد \fBX\fP را به عنوان نویسه اسکیپ برای آن فایل مشخص کنند.

.SH "نویسنده (AUTHOR)"
نویسندگان سینک‌تینگ (The Syncthing Authors)
.SH "حق نشر (COPYRIGHT)"
2014-2026, The Syncthing Authors
.\" Generated by docutils manpage writer.
.