.TH git-annex-import 1
.SH "نام (NAME)"
git-annex-import \- وارد کردن فایل‌ها از یک مخزن ویژه دوردست
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex import \-\-from remote branch[:subdir] | \fB[path ...]\fP
.PP
.SH "توضیحات (DESCRIPTION)"
این دستور روشی برای وارد کردن یک درخت از فایل‌ها از مکانی دیگر به مخزن git-annex شما است. این دستور می‌تواند فایل‌ها را از یک مخزن ویژه دوردست git-annex یا از یک دایرکتوری وارد کند.
.PP
.SH "وارد کردن از یک مخزن ویژه دوردست (IMPORTING FROM A SPECIAL REMOTE)"
وارد کردن از یک مخزن ویژه دوردست، ابتدا تمام محتوای جدید را از آن دانلود کرده یا درهم‌سازی (هش) می‌کند، و سپس یک کامیت git می‌سازد که بازتاب‌دهنده فایل‌های تغییریافته در مخزن ویژه دوردست از زمان آخرین بررسی git-annex است. ادغام (merge) آن کامیت در مخزن شما، آن را به‌روزرسانی می‌کند تا تغییرات اعمال‌شده در مخزن ویژه دوردست را منعکس کند.
.PP
به این ترتیب، یک برنامه یا سرویس می‌تواند از مخزن ویژه دوردست برای ذخیره‌سازی، افزودن، تغییر و حذف فایل‌ها استفاده کند و شما می‌توانید آن تغییرات را با استفاده از git-annex ردیابی کنید.
.PP
می‌توانید استفاده از \fBgit annex import\fP برای واکشی تغییرات از یک مخزن ویژه دوردست را با \fBgit annex export\fP برای ارسال تغییرات محلی خود به مخزن ویژه دوردست ترکیب کنید.
.PP
تنها می‌توانید از مخازن ویژه دوردستی فایل وارد کنید که هنگام راه‌اندازی با
.BR git-annex\-initremote (1)
با گزینه
.B importtree=yes
پیکربندی شده باشند. تنها برخی از انواع مخازن ویژه دوردست اجازه این نوع پیکربندی را می‌دهند؛ فهرستی احتمالاً غیرجامع شامل مخازن ویژه directory، s3 و adb است.
.PP
برای وارد کردن از یک مخزن ویژه دوردست، باید نام یک شاخه را مشخص کنید. یک شاخه ردیابی دوردست (remote tracking branch) متناظر توسط \fBgit annex import\fP به‌روزرسانی خواهد شد. پس از آن، وضعیت مشابه زمانی است که یک \fBgit fetch\fP را از یک ریموت معمولی git اجرا کرده باشید؛ می‌توانید تغییرات را در شاخه جاری که تحویل گرفته‌اید (checked out) ادغام کنید.
.PP
برای مثال:
.PP
.EX
git annex import master \-\-from myremote
git annex merge \-\-allow\-unrelated\-histories myremote/master
.EE
.PP
می‌توانید برای مرحله دوم به همان اندازه از \fBgit merge \-\-allow\-unrelated\-histories myremote/master\fP استفاده کنید، اما استفاده از \fBgit-annex merge\fP از چند مشکل غیرمنتظره جلوگیری می‌کند. هنگام استفاده از شاخه‌های تنظیم‌شده (adjusted branches)، شاخه را پیش از ادغام کردن از آن تنظیم می‌کند.
.PP
گزینه \-\-allow\-unrelated\-histories دست‌کم برای نخستین ادغامِ شاخه ردیابی دوردست واردشده لازم است، زیرا تاریخچه شاخه متصل نیست. این را مانند این در نظر بگیرید که ریموت یک مخزن جداگانه git با فایل‌های اختصاصی خود است. اگر ابتدا فایل‌ها را با \fBgit annex export\fP به یک ریموت صادر کنید و سپس با \fBgit annex import\fP از آن وارد کنید، نیازی به این گزینه نخواهید داشت.
.PP
می‌توانید با استفاده از نحو "branch:subdir" فایل‌ها را در یک زیردایرکتوری وارد کنید. برای مثال، اگر "camera" یک مخزن ویژه دوردست باشد که به یک دوربین دسترسی دارد، و بخواهید آن فایل‌ها را به جای ریشه مخزن، در دایرکتوری photos وارد کنید:
.PP
.EX
git annex import master:photos \-\-from camera
git merge camera/master
.EE
.PP
دستور \fBgit annex sync \-\-content\fP (و دستیار git-annex) نیز می‌تواند برای وارد کردن از یک مخزن ویژه دوردست استفاده شود. برای انجام این کار، باید "remote.<name>.annex\-tracking\-branch" را پیکربندی کنید تا مشخص شود چه شاخه‌ای باید ردیابی شود. برای مثال:
.PP
.EX
git config remote.myremote.annex\-tracking\-branch master
git annex sync \-\-content
.EE
.PP
هر فایلی که در gitignore نادیده گرفته شده باشد در وارد کردن گنجانده نخواهد شد، اما روی ریموت باقی می‌ماند.
.PP
هنگامی که برای مخزن ویژه دوردست عبارت محتوای ترجیحی توسط
.BR git-annex\-wanted (1)
تنظیم شده باشد، از آن برای انتخاب فایل‌هایی که باید وارد شوند استفاده می‌شود. فایل‌هایی که جزو محتوای ترجیحی ریموت نیستند از آن وارد نخواهند شد، بلکه روی ریموت باقی خواهند ماند.
.PP
بنابراین برای مثال، یک عبارت محتوای ترجیحی مانند
\fB"include=*.jpeg or largerthan=100mb"\fP
باعث می‌شود تنها فایل‌های jpeg و فایل‌های بزرگ وارد شوند.
.PP
بخش‌هایی از عبارت محتوای ترجیحی که به کلید مرتبط هستند، مانند "copies="، هنگام وارد کردن نادیده گرفته می‌شوند، زیرا کلید پیش از وارد کردن مشخص نیست.
.PP
مواردی مانند "include=" در عبارت، نسبت به بالاترین سطح درخت فایل‌ها در ریموت مطابقت داده می‌شوند، حتی هنگام وارد کردن به یک زیردایرکتوری.
.PP
.SH "گزینه‌های وارد کردن از یک مخزن ویژه دوردست (OPTIONS FOR IMPORTING FROM A SPECIAL REMOTE)"
.IP "\fB\-\-content\fP, \fB\-\-no\-content\fP"
.IP
کنترل می‌کند که آیا محتوای ضمیمه‌شده از مخزن ویژه دوردست دانلود شود یا خیر.
.IP
حالت پیش‌فرض، دانلود محتوا به مخزن git-annex است.
.IP
با \-\-no\-content، کلیدهای git-annex بر اساس اطلاعات ارائه‌شده توسط مخزن ویژه دوردست بدون دانلود آن تولید می‌شوند. دستوراتی مانند
\fBgit-annex get\fP
بعداً می‌توانند در صورت تمایل برای دانلود فایل‌ها استفاده شوند. گزینه \-\-no\-content توسط تمام مخازن ویژه دوردست پشتیبانی نمی‌شود.
.IP
.IP "\fB\-\-message=msg\fP \fB\-m msg\fP"
از این گزینه برای مشخص کردن پیام کامیت برای تغییراتی که از زمان آخرین وارد کردن در مخزن ویژه دوردست ایجاد شده است استفاده کنید.
.IP
اگر چندین گزینه \-m مشخص شود، مقادیر آن‌ها به عنوان پاراگراف‌های جداگانه به هم متصل می‌شوند.
.IP
.SH "وارد کردن از یک دایرکتوری (IMPORTING FROM A DIRECTORY)"
هنگامی که این دستور با یک مسیر اجرا شود، \fBgit annex import\fP فایل‌ها را از مکانی خارج از نسخه کاری git **منتقل** می‌کند و آن‌ها را به ضمیمه می‌افزاید. بر خلاف وارد کردن از یک مخزن ویژه دوردست از نوع دایرکتوری، فایل‌های واردشده **از مسیر داده‌شده حذف می‌شوند**.
.PP
این یک رابط قدیمی است. این رابط همچنان پشتیبانی می‌شود، اما لطفاً تغییر به وارد کردن از یک مخزن ویژه دوردست دایرکتوری را با استفاده از رابط مستندشده در بالا مد نظر قرار دهید.
.PP
فایل‌های مجزا برای وارد کردن می‌توانند مشخص شوند. اگر یک دایرکتوری مشخص شود، کل دایرکتوری وارد می‌شود. لطفاً توجه داشته باشید که دستور زیر **تمام فایل‌ها را از دایرکتوری مبدأ حذف خواهد کرد**.
.PP
.EX
git annex import /media/camera/DCIM/*
.EE
.PP
هنگام وارد کردن فایل‌ها، این احتمال وجود دارد که نسخه‌ای تکراری از فایلی وارد شود که از قبل برای git-annex شناخته شده است \-\- محتوای آن یا از قبل در مخزن محلی وجود دارد، یا git-annex از مخزن دیگری که حاوی آن است مطلع است، یا پیش‌تر در ضمیمه وجود داشته اما اکنون حذف شده است.
.PP
به‌طور پیش‌فرض، وارد کردن یک فایل تکراری شناخته‌شده منجر به افزودن نام فایل جدیدی به مخزن می‌شود، بنابراین فایل تکراری دو بار در مخزن حضور خواهد داشت. (با تمام backendهای مبتنی بر چکسام، از جمله SHA256E پیش‌فرض، تنها یک نسخه از داده ذخیره خواهد شد.)
.PP
چندین گزینه می‌توانند برای تنظیم نحوه مدیریت فایل‌های تکراری استفاده شوند؛ مستندات
\fB\-\-duplicate\fP،
\fB\-\-deduplicate\fP،
\fB\-\-skip\-duplicates\fP،
\fB\-\-clean\-duplicates\fP
و
\fB\-\-reinject\-duplicates\fP
را در زیر ببینید.
.PP
پیوندهای نمادین (symbolic links) درون دایرکتوری در حال واردسازی نادیده گرفته می‌شوند تا از وارد کردن تصادفی مواردی خارج از دایرکتوری که import روی آن اجرا شده است جلوگیری شود. با این حال، خود دایرکتوری که import روی آن اجرا می‌شود می‌تواند یک پیوند نمادین باشد و آن پیوند نمادین دنبال خواهد شد.
.PP
.SH "گزینه‌های وارد کردن از یک دایرکتوری (OPTIONS FOR IMPORTING FROM A DIRECTORY)"
.IP "\fB\-\-duplicate\fP"
.IP
فایل‌ها را از مکان واردسازی حذف نمی‌کند.
.IP
اجرای مکرر با این گزینه می‌تواند همان فایل‌ها را به مخازن، شاخه‌ها یا مکان‌های مختلفی در یک مخزن git وارد کند.
.IP
.IP "\fB\-\-deduplicate\fP"
فقط فایل‌هایی را که تکراری نیستند وارد می‌کند؛
فایل‌های تکراری از مکان واردسازی حذف خواهند شد.
.IP
.IP "\fB\-\-skip\-duplicates\fP"
فقط فایل‌هایی را که تکراری نیستند وارد می‌کند. از حذف هرگونه فایل از مکان واردسازی جلوگیری می‌کند.
.IP
.IP "\fB\-\-clean\-duplicates\fP"
هیچ فایلی را وارد نمی‌کند، اما هر فایلی که در مکان واردسازی یافت شود و تکراری باشد حذف می‌شود.
.IP
.IP "\fB\-\-reinject\-duplicates\fP"
فایل‌هایی را که تکراری نیستند وارد می‌کند. فایل‌هایی که تکراری هستند، محتوای آن‌ها مجدداً به ضمیمه تزریق می‌شود (مشابه
.BR git-annex\-reinject (1)).
.IP
.IP "\fB\-\-force\fP"
اجازه می‌دهد فایل‌های موجود توسط فایل‌های تازه‌واردشده بازنویسی شوند.
.IP
همچنین باعث می‌شود هنگام افزودن فایل‌ها، فایل .gitignore اعمال نشود.
.IP
.IP "گزینه‌های تطبیق فایل (file matching options)"
بسیاری از گزینه‌های
.BR git-annex\-matching\-options (1)
می‌توانند برای مشخص کردن فایل‌های واردشونده استفاده شوند.
.IP
.EX
git annex import /dir \-\-include='*.png'
.EE
.IP
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.IP "\fB\-\-jobs=N\fP \fB\-JN\fP"
.IP
فایل‌ها را به‌صورت موازی وارد می‌کند. این کار ممکن است سریع‌تر باشد. برای مثال:
.B \-J4
.IP
تنظیم این مقدار به "cpus" به ازای هر هسته پردازنده یک کار اجرا خواهد کرد.
.IP
.IP "\fB\-\-backend\fP"
مشخص می‌کند که از کدام backend کلید\-مقدار برای فایل‌های واردشده استفاده شود.
.IP
.IP "\fB\-\-no\-check\-gitignore\fP"
فایل‌های نادیده‌گرفته‌شده در gitignore را اضافه می‌کند.
.IP
.IP "\fB\-\-json\fP"
خروجی JSON را فعال می‌کند. این قابلیت برای پردازش توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
.IP
.IP "\fB\-\-json\-progress\fP"
اشیاء پیشرفت را در خروجی JSON می‌گنجاند.
.IP
.IP "\fB\-\-json\-error\-messages\fP"
پیام‌هایی که معمولاً در خروجی خطای استاندارد نمایش داده می‌شدند، در عوض در داخل JSON گنجانده می‌شوند.
.IP
.IP "همچنین می‌توان از گزینه‌های \fBgit-annex\-common\-options\fP(1) نیز استفاده کرد."
.SH "نکات و هشدارها (CAVEATS)"
توجه داشته باشید که استفاده از \fB\-\-deduplicate\fP یا \fB\-\-clean\-duplicates\fP با backend از نوع WORM، محتوای فایل را بررسی نمی‌کند، بلکه نام فایل و mtime را در نظر می‌گیرد.
.PP
اگر annex.largefiles پیکربندی شده باشد و با فایلی مطابقت نداشته باشد، git annex import فایل غیربزرگ (non\-large) را به جای ضمیمه، مستقیماً به مخزن git اضافه خواهد کرد.
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR git-annex (1)
.PP
.BR git-annex\-add (1)
.PP
.BR git-annex\-export (1)
.PP
.BR git-annex\-preferred\-content (1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>