.TH git-annex-addurl 1
.SH "نام (NAME)"
git-annex-addurl \- افزودن نشانی‌های وب به انکس
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex addurl \fB[url ...]\fP
.PP
.SH "توضیحات (DESCRIPTION)"
هر نشانی اینترنتی (url) را در فایل مخصوص خود بارگیری کرده و آن را به انکس اضافه می‌کند.
.PP
هنگامی که \fByt\-dlp\fP نصب باشد، می‌تواند برای بررسی ویدیوی جاسازی‌شده در یک صفحهٔ وب در نشانی موردنظر استفاده شود و به جای خود صفحه، آن ویدیو به انکس اضافه گردد. (البته این ویژگی به طور پیش‌فرض به دلیل خطرات احتمالی امنیتی غیرفعال است. برای جزئیات به مستندات annex.security.allowed\-ip\-addresses در
.BR git-annex (1)
مراجعه کنید.)
.PP
ریموت‌های ویژه می‌توانند نحوهٔ مدیریت خاصی را برای نشانی‌های وب مشخصی اضافه کنند. به عنوان مثال، ریموت‌های ویژهٔ bittorrent باعث می‌شوند نشانی‌های فایل‌های تورنت (از جمله پیوندهای مگنت) محتوای تورنت را با استفاده از \fBaria2c\fP بارگیری کنند.
.PP
به طور معمول نام فایل بر اساس نشانی کامل وب ساخته می‌شود، بنابراین چیزی شبیه به "www.example.com_dir_subdir_bigfile" خواهد بود. در برخی موارد، addurl می‌تواند بر اساس اطلاعات دیگر نام فایل بهتری ایجاد کند. همچنین می‌توان از گزینه‌های مختلف برای دستیابی به نام‌های فایل مناسب‌تر استفاده کرد.
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-fast\fP"
.IP
جلوگیری از بارگیری فوری نشانی وب. نشانی وب همچنان (از طریق درخواست HEAD) بررسی می‌شود تا وجود آن تأیید شده و در صورت امکان اندازهٔ آن دریافت شود.
.IP
.IP "\fB\-\-relaxed\fP"
از بارگیری فوری نشانی وب و همچنین ذخیره کردن اندازهٔ محتوای نشانی خودداری می‌کند. این امر باعث می‌شود git-annex در آینده هر محتوایی را که در آن نشانی موجود باشد بپذیرد.
.IP
این سریع‌ترین گزینه است، اما همچنان باید به شبکه دسترسی داشته باشد تا بررسی کند آیا نشانی حاوی رسانهٔ جاسازی‌شده است یا خیر. هنگام افزودن تعداد زیادی نشانی، استفاده از \fB\-\-relaxed \-\-raw\fP بسیار سریع‌تر خواهد بود.
.IP
.IP "\fB\-\-verifiable\fP \fB\-V\fP"
می‌توان از این گزینه همراه با گزینه‌های \fB\-\-fast\fP یا \fB\-\-relaxed\fP استفاده کرد. این کار با امکان‌پذیر ساختن اعتبارسنجی محتوا از طریق چکسام در هنگام انتقال بین مخازن git-annex و همچنین توسط دستوراتی مانند \fBgit-annex fsck\fP، امنیت فایل پیوست‌شده حاصل را بهبود می‌بخشد.
.IP
هنگام استفاده همراه با \-\-relaxed، محتوا از ریموت ویژهٔ وب همیشه پذیرفته می‌شود، حتی اگر تغییر کرده باشد، و چکسام آن برای اعتبارسنجی‌های بعدی ثبت می‌گردد.
.IP
هنگام استفاده همراه با \-\-fast، چکسام در اولین بارگیری محتوا از ریموت ویژهٔ وب ثبت می‌شود. پس از ثبت چکسام، بارگیری‌های بعدی از ریموت ویژهٔ وب باید همان چکسام را داشته باشند.
.IP
اگر addurl قبلاً بدون این گزینه استفاده شده باشد، فایل اضافه‌شده را می‌توان با انتقال به بک‌اند VURL به حالت قابل‌اعتبارسنجی تبدیل کرد. برای مثال: \fBgit-annex migrate foo \-\-backend=VURL\fP
.IP
.IP "\fB\-\-raw\fP"
جلوگیری از مدیریت ویژهٔ نشانی‌های وب توسط yt\-dlp، بیت‌تورنت و سایر ریموت‌های ویژه. برای نمونه، این گزینه باعث می‌شود addurl خودِ فایل .torrent را بارگیری کند و نه محتوایی را که به آن اشاره دارد.
.IP
.IP "\fB\-\-no\-raw\fP"
الزام بارگیری محتوایی که نشانی وب به آن اشاره دارد از طریق yt\-dlp یا یک ریموت ویژه، به جای محتوای خام نشانی. در صورتی که این کار ممکن نباشد، عملیات افزودن با شکست مواجه می‌شود.
.IP
.IP "\fB\-\-raw\-except=remote\fP"
جلوگیری از مدیریت ویژهٔ نشانی‌های وب توسط تمام ریموت‌های ویژه به جز ریموت مشخص‌شده. برای مجاز کردن مدیریت ویژه تنها توسط yt\-dlp، از \fB\-\-raw\-except=web\fP استفاده کنید.
.IP
.IP "\fB\-\-file=name\fP"
همراه با نام فایلی که هنوز وجود ندارد استفاده می‌شود تا فایل جدیدی با نام مشخص‌شده و محتوای بارگیری‌شده از نشانی وب اضافه کند.
.IP
اگر فایل از قبل وجود داشته باشد، addurl ثبت می‌کند که این فایل می‌تواند از نشانی‌های مشخص‌شده بارگیری شود.
.IP
.IP "\fB\-\-preserve\-filename\fP"
هنگامی که سرور وب (یا تورنت و غیره) نام فایلی را ارائه می‌دهد، از همان نام بدون تغییر استفاده می‌کند و از پاک‌سازی کاراکترهای نامعمول، کوتاه کردن طول آن یا هرگونه تغییر دیگر خودداری می‌نماید.
.IP
دستور git-annex همچنان نام فایل را از نظر امنیت بررسی می‌کند و در صورت وجود مشکل امنیتی مانند پیمایش مسیر (path traversal) یا کاراکترهای کنترلی، از افزودن آن خودداری خواهد کرد.
.IP
.IP "\fB\-\-pathdepth=N\fP"
به جای این‌که نام فایل بر اساس کل نشانی ساخته شود، این گزینه مسیری را می‌سازد که از عمق مشخص‌شده در مسیر نشانی وب آغاز می‌شود.
.IP
برای مثال، افزودن نشانی http://www.example.com/dir/subdir/bigfile با \fB\-\-pathdepth=1\fP نام "dir/subdir/bigfile" را استفاده می‌کند، در حالی که \fB\-\-pathdepth=3\fP از "bigfile" استفاده خواهد کرد.
.IP
این مقدار می‌تواند منفی نیز باشد؛ \fB\-\-pathdepth=\-2\fP از دو بخش آخر نشانی وب استفاده می‌کند.
.IP
.IP "\fB\-\-prefix=foo\fP \fB\-\-suffix=bar\fP"
برای تنظیم و سفارشی‌سازی نام فایل‌های ایجادشده توسط addurl استفاده می‌شود. برای مثال، \fB\-\-suffix=.mp3\fP می‌تواند برای افزودن پسوند به فایل به کار رود.
.IP
.IP "\fB\-\-no\-check\-gitignore\fP"
به طور پیش‌فرض، قوانین gitignore رعایت می‌شوند و دستور از بارگیری نشانی وب در فایلی که نادیده گرفته می‌شود خودداری می‌کند. این گزینه باعث می‌شود چنین فایل‌هایی علی‌رغم قوانین نادیده‌گرفتن اضافه شوند.
.IP
.IP "\fB\-\-jobs=N\fP \fB\-JN\fP"
فعال‌سازی بارگیری موازی در هنگام افزودن چندین نشانی وب. برای مثال: \fB\-J4\fP
.IP
تنظیم این گزینه روی "cpus" به ازای هر هستهٔ پردازنده یک کار را اجرا می‌کند.
.IP
.IP "\fB\-\-batch\fP"
حالت دسته‌ای (batch) را فعال می‌کند که در آن خطوط حاوی نشانی‌های وب برای افزودن، از ورودی استاندارد (stdin) خوانده می‌شوند.
.IP
.IP "\fB\-z\fP"
باعث می‌شود ورودی \fB\-\-batch\fP به جای خطوط جدید معمول، با نویسهٔ تهی (null) از هم جدا شوند.
.IP
.IP "\fB\-\-with\-files\fP"
هنگامی که حالت دسته‌ای فعال است، خطوطی به قالب "$url $file" را تجزیه می‌کند.
.IP
این کار نشانی وب مشخص‌شده را به فایل تعیین‌شده اضافه می‌کند و در صورتی که فایل هنوز وجود نداشته باشد، محتوای آن را بارگیری می‌کند؛ دقیقاً مشابه با
\fBgit annex addurl $url \-\-file $file\fP
.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 "\fB\-\-backend\fP"
مشخص می‌کند که از کدام بک‌اند کلید\-مقدار استفاده شود.
.IP
.IP "همچنین می‌توان از git-annex\-common\-options(1) نیز استفاده کرد."
.SH "هشدارها (CAVEATS)"
اگر annex.largefiles پیکربندی شده باشد و با فایلی مطابقت نداشته باشد، git annex addurl فایل غیربزرگ را مستقیماً به مخزن گیت اضافه می‌کند، به جای این‌که آن را به انکس اضافه کند. با این حال، هنگام استفاده از \-\-fast یا \-\-relaxed این کار انجام نمی‌شود.
.PP
.SH "همچنین ببینید (SEE ALSO)"
git-annex(1)
.PP
git-annex\-rmurl(1)
.PP
git-annex\-registerurl(1)
.PP
git-annex\-importfeed(1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>
.PP
.PP