.TH git-annex-config 1
.SH "نام (NAME)"
git-annex-config \- پیکربندی ذخیره‌شده در شاخه git-annex
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex config \-\-set name value
.PP
git annex config \-\-get name
.PP
git annex config \-\-unset name
.PP
git annex config \-\-show\-origin name
.PP
.SH "توضیحات (DESCRIPTION)"
تنظیم یا دریافت تنظیمات پیکربندی ذخیره‌شده در شاخه git-annex.
.PP
برخلاف تنظیمات
\fBgit config\fP،
این تنظیمات پس از همگام‌سازی شاخه‌های git-annex، در تمامی رونوشت‌های (clones) مخزن قابل مشاهده هستند.
.PP
این تنظیمات را می‌توان بر اساس هر مخزن با استفاده از
\fBgit config\fP
بازنویسی کرد.
.PP
برنامه git-annex شاخه git-annex را برای همه تنظیمات
\fBgit config\fP
که بر آن تاثیر می‌گذارند بررسی نمی‌کند (تنظیماتی که در بخش CONFIGURATION صفحه راهنمای git-annex فهرست شده‌اند). تنها برای تعداد کمی از آن‌ها منطقی است که طوری تنظیم شوند که تمامی کلون‌های یک مخزن آن را ببینند، بنابراین git-annex فقط به دنبال همین موارد می‌گردد.
.PP
.SH "تنظیمات پشتیبانی‌شده (SUPPORTED SETTINGS)"
.IP "\fBannex.numcopies\fP"
.IP
به git-annex اعلام می‌کند که چه تعداد رونوشت از فایل‌ها را باید در تمام مخازن نگهداری کند. مقدار پیش‌فرض 1 است.
.IP
هنگامی که از git-annex خواسته می‌شود فایلی را رها (drop) کند، ابتدا بررسی می‌کند که آیا تعداد رونوشت‌های لازم در میان تمامی مخازن دیگری که رونوشتی از فایل را دارند برآورده می‌شود یا خیر.
.IP
در شرایط غیرعادی، شامل ریموت‌های ویژه‌ای که از قفل‌گذاری پشتیبانی نمی‌کنند و حذف هم‌زمان محتوای یکسان از چندین مخزن، ممکن است git-annex تنظیم numcopies را نقض کند. با این حال همچنان تضمین می‌کند که دست‌کم 1 رونوشت حفظ شود. این رفتار را می‌توان با تنظیم annex.mincopies پیکربندی کرد.
.IP
این همان تنظیمی است که دستور git-annex\-numcopies(1) آن را پیکربندی می‌کند. این مقدار را می‌توان به ازای هر فایل توسط تنظیم annex.numcopies در فایل‌های
\fB.gitattributes\fP
بازنویسی کرد.
.IP
.IP "\fBannex.mincopies\fP"
به git-annex اعلام می‌کند که ملزم به نگهداری چه تعداد رونوشت از فایل‌ها در تمام مخازن است. مقدار پیش‌فرض 1 است.
.IP
این گزینه مکمل تنظیم annex.numcopies است. در شرایط غیرعادی، شامل ریموت‌های ویژه‌ای که از قفل‌گذاری پشتیبانی نمی‌کنند و حذف هم‌زمان محتوای یکسان از چندین مخزن، ممکن است git-annex تنظیم numcopies را نقض کند. در این شرایط غیرعادی، git-annex تضمین می‌کند که تعداد رونوشت‌ها هرگز به کمتر از mincopies نرسد.
.IP
ایده خوبی است که فقط به تنظیم mincopies اتکا نکنید. numcopies را نیز روی عددی بزرگ‌تر تنظیم کنید و mincopies را روی حداقل مقداری که با آن آسوده‌خاطر هستید نگه دارید. تنظیم mincopies روی عددی بزرگ، به جای تنظیم numcopies، در برخی موارد مانع از رها کردن محتوا در شرایط کاملاً امن خواهد شد.
.IP
این همان تنظیمی است که دستور git-annex\-mincopies(1) آن را پیکربندی می‌کند. این مقدار را می‌توان به ازای هر فایل توسط تنظیم annex.mincopies در فایل‌های
\fB.gitattributes\fP
بازنویسی کرد.
.IP
.IP "\fBannex.largefiles\fP"
برای پیکربندی اینکه چه فایل‌هایی به اندازه کافی بزرگ هستند تا به annex اضافه شوند استفاده می‌شود. این یک عبارت تطبیق با فایل‌های بزرگ است، مانند
"\fBinclude=*.mp3 or largerthan(500kb)\fP".
برای جزئیات بیشتر درباره نحو، git-annex\-matching\-expression(1) را ببینید.
.IP
این گزینه رفتار هر دو ابزار git-annex و git را هنگام اضافه کردن فایل‌ها به مخزن پیکربندی می‌کند. به‌طور پیش‌فرض،
\fBgit-annex add\fP
همه فایل‌ها را به annex اضافه می‌کند (به جز فایل‌های نقطه‌دار و فایل‌های داخل دایرکتوری‌های نقطه‌دار)، و
\fBgit add\fP
فایل‌ها را به git اضافه می‌کند (مگر اینکه پیش‌تر به annex افزوده شده باشند). زمانی که annex.largefiles پیکربندی شده باشد، هر دو دستور
\fBgit annex add\fP
و
\fBgit add\fP
فایل‌های بزرگ منطبق را به annex و سایر فایل‌ها را به git اضافه خواهند کرد.
.IP
سایر دستورات git-annex نیز از annex.largefiles پیروی می‌کنند، از جمله
\fBgit annex import\fP،
\fBgit annex addurl\fP،
\fBgit annex importfeed\fP،
\fBgit-annex assist\fP
و
\fBgit-annex assistant\fP.
.IP
این گزینه یک مقدار پیش‌فرض تعیین می‌کند که می‌تواند توسط مشخصه‌های annex.largefiles در فایل‌های
\fB.gitattributes\fP
یا توسط
\fBgit config\fP
بازنویسی شود.
.IP
.IP "\fBannex.dotfiles\fP"
به‌طور معمول، فرض می‌شود فایل‌های نقطه‌دار و فایل‌های درون پوشه‌های نقطه‌دار، فایل‌های پیکربندی مانند .gitignore هستند که محتوای آن‌ها همیشه باید بخشی از مخزن git باشد، بنابراین به annex اضافه نخواهند شد. تنظیم annex.dotfiles روی true باعث می‌شود این فایل‌ها همانند هر فایل دیگری به annex افزوده شوند.
.IP
این گزینه یک مقدار پیش‌فرض تعیین می‌کند که می‌تواند توسط annex.dotfiles در
\fBgit config\fP
بازنویسی شود.
.IP
.IP "\fBannex.addunlocked\fP"
دستوراتی مانند
\fBgit-annex add\fP
به‌طور پیش‌فرض فایل‌ها را به شکل قفل‌شده به مخزن اضافه می‌کنند. این تنظیم می‌تواند باعث شود آن‌ها فایل‌ها را به صورت قفل‌نشده اضافه کنند، درست همانند زمانی که دستور git-annex\-unlock(1) روی فایل‌ها اجرا شده باشد.
.IP
این گزینه می‌تواند روی "true" تنظیم شود تا همه فایل‌ها به صورت قفل‌نشده اضافه شوند، یا می‌تواند عبارت پیچیده‌تری باشد که فایل‌ها را بر اساس نام، اندازه یا محتوا مطابقت دهد. برای جزئیات، git-annex\-matching\-expression(1) را ببینید.
.IP
این گزینه یک مقدار پیش‌فرض تعیین می‌کند که می‌تواند توسط annex.addunlocked در
\fBgit config\fP
بازنویسی شود.
.IP
.IP "\fBannex.autocommit\fP"
روی false تنظیم کنید تا از ثبت (commit) خودکار تغییرات فایل‌ها در مخزن توسط
\fBgit-annex assistant\fP،
\fBgit-annex assist\fP
و
\fBgit-annex sync\fP
جلوگیری شود.
.IP
این گزینه یک مقدار پیش‌فرض تعیین می‌کند که می‌تواند توسط annex.autocommit در
\fBgit config\fP
بازنویسی شود.
.IP
.IP "\fBannex.resolvemerge\fP"
روی false تنظیم کنید تا از حل خودکار تداخل‌های ادغام در شاخه جاری توسط
\fBgit-annex assistant\fP،
\fBgit-annex sync\fP،
\fBgit-annex pull\fP،
\fBgit-annex merge\fP
و قلاب
\fBgit-annex post\-receive\fP
جلوگیری شود.
.IP
این گزینه یک مقدار پیش‌فرض تعیین می‌کند که می‌تواند توسط annex.resolvemerge در
\fBgit config\fP
بازنویسی شود.
.IP
.IP "\fBannex.synccontent\fP"
روی true تنظیم کنید تا
\fBgit-annex sync\fP
به‌طور پیش‌فرض محتوای ضمیمه‌شده (annexed content) را انتقال دهد.
.IP
روی false تنظیم کنید تا از انتقال محتوای ضمیمه‌شده توسط
\fBgit-annex pull\fP
و
\fBgit-annex push\fP
جلوگیری شود.
.IP
این گزینه یک مقدار پیش‌فرض تعیین می‌کند که می‌تواند توسط annex.synccontent در
\fBgit config\fP
بازنویسی شود.
.IP
.IP "\fBannex.synconlyannex\fP"
روی true تنظیم کنید تا
\fBgit-annex sync\fP،
\fBgit-annex pull\fP
و
\fBgit-annex push\fP
به‌طور پیش‌فرض تنها بر روی شاخه git-annex و محتوای ضمیمه‌شده عمل کنند.
.IP
این گزینه یک مقدار پیش‌فرض تعیین می‌کند که می‌تواند توسط annex.synconlyannex در
\fBgit config\fP
بازنویسی شود.
.IP
.IP "\fBannex.securehashesonly\fP"
روی true تنظیم کنید تا نشان دهد مخزن تنها باید از هش‌های از نظر رمزنگاری امن (SHA2، SHA3) استفاده کند و از هش‌های ناامن (MD5، SHA1) برای محتوا استفاده نکند.
.IP
هنگامی که این گزینه تنظیم شود، به محتوای فایل‌هایی که از هش‌های ناامن رمزنگاری استفاده می‌کنند، اجازه اضافه شدن به مخزن داده نخواهد شد.
.IP
همچنین،
\fBgit-annex fsck\fP
در مورد هرگونه فایل موجود در مخزن که از هش‌های ناامن استفاده کند اخطار خواهد داد.
.IP
توجه داشته باشید که این مقدار فقط توسط
\fBgit annex init\fP
از شاخه git-annex خوانده می‌شود و در تنظیم متناظر git config رونوشت می‌گردد. بنابراین، تغییرات این مقدار در شاخه git-annex پس از مقداردهی اولیه مخزن، تاثیری بر آن نخواهد داشت.
.IP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-set name value\fP"
.IP
تنظیم یک مقدار.
.IP
.IP "\fB\-\-get name\fP"
دریافت یک مقدار.
.IP
.IP "\fB\-\-unset\fP"
حذف تنظیم یک مقدار.
.IP
.IP "\fB\-\-show\-origin name\fP"
توضیح می‌دهد که مقدار در کجا پیکربندی شده است؛ خواه در شاخه git-annex، در یک فایل
\fBgit config\fP
یا در فایل
\fB.gitattributes\fP.
زمانی که یک مقدار در چندین مکان پیکربندی شده باشد، مکان و مقداری که استفاده خواهد شد را نمایش می‌دهد.
.IP
توجه داشته باشید که این پارامتر می‌تواند نام یکی از تنظیمات فهرست‌شده در بالا باشد، اما همچنین می‌تواند هر تنظیم پیکربندی دیگری باشد که توسط git-annex پشتیبانی می‌شود. برای نمونه، "annex.backend" را نمی‌توان در شاخه git-annex تنظیم کرد، اما می‌توان آن را در
\fB.gitattributes\fP
یا
\fBgit config\fP
تنظیم کرد و این گزینه می‌تواند مشخص کند کدام تنظیم برای آن به کار خواهد رفت.
.IP
.IP "\fB\-\-for\-file file\fP"
می‌تواند در ترکیب با
\fB\-\-show\-origin\fP
استفاده شود تا مشخص کند چه نام فایلی باید در
\fB.gitattributes\fP
بررسی شود.
.IP
.IP "همچنین گزینه‌های git-annex\-common\-options(1) نیز قابل استفاده هستند."
.SH "مثال (EXAMPLE)"
فرض کنید می‌خواهید از کامیت خودکار تغییرات فایل‌ها توسط git annex sync جلوگیری کنید، به طوری که یک گردش کار کامیت دستی git در تمامی کلون‌های مخزن استفاده شود. سپس اجرا کنید:
.PP
 git annex config \-\-set annex.autocommit false
.PP
اگر می‌خواهید آن را در یک کلون خاص بازنویسی کنید، کافی است از git config در آن کلون استفاده کنید:
.PP
 git config annex.autocommit true
.PP
و برای بازگشت به رفتار پیش‌فرض:
.PP
 git annex config \-\-unset annex.autocommit
.PP
.SH "همچنین ببینید (SEE ALSO)"
git-annex(1)
.PP
git\-config(1)
.PP
git-annex\-vicfg(1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>