نام (NAME)

hg archive - ایجاد یک بایگانی بدون نسخه از بازبینی مخزن

خلاصه دستور (SYNOPSIS)

hg archive [OPTION]... DEST

توضیحات (DESCRIPTION)

به‌طور پیش‌فرض، بازبینی مورد استفاده، والد دایرکتوری کاری است؛ برای تعیین یک بازبینی متفاوت از -r/--rev استفاده کنید.

نوع بایگانی به‌طور خودکار بر اساس پسوند فایل تشخیص داده می‌شود (برای لغو این رفتار و تعیین دستی، از -t/--type استفاده کنید).

مثال‌ها:

ایجاد یک فایل zip حاوی نسخه انتشار 1.0:
```
hg archive -r 1.0 project-1.0.zip
```
ایجاد یک فایل tarball با مستثنی کردن فایل‌های .hg:
```
hg archive project.tar.gz -X ".hg*"
```
انواع معتبر عبارتند از:

files

یک دایرکتوری پر از فایل‌ها (پیش‌فرض)

tar

بایگانی tar، فشرده‌نشده

tbz2

بایگانی tar، فشرده‌شده با bzip2

tgz

بایگانی tar، فشرده‌شده با gzip

txz

بایگانی tar، فشرده‌شده با lzma (تنها در Python 3)

uzip

بایگانی zip، فشرده‌نشده

zip

بایگانی zip، فشرده‌شده با deflate

نام دقیق بایگانی یا دایرکتوری مقصد با استفاده از یک رشته قالب مشخص می‌شود؛ برای جزئیات به hg help export مراجعه کنید.

به هر عضوی که به یک فایل بایگانی افزوده می‌شود، یک پیشوند دایرکتوری اضافه می‌گردد. برای تعیین رشته قالب پیشوند از -p/--prefix استفاده کنید. مقدار پیش‌فرض، نام پایه (basename) بایگانی با حذف پسوندها است.

در صورت موفقیت مقدار 0 بازگردانده می‌شود.

گزینه‌ها (OPTIONS)

--no-decode: فایل‌ها از رمزگشاها عبور داده نشوند
-p,--prefix <PREFIX>: پیشوند دایرکتوری برای فایل‌های درون بایگانی
-r,--rev <REV>: بازبینی برای توزیع
-t,--type <TYPE>: نوع توزیع برای ایجاد
-S, --subrepos: پیمایش بازگشتی در زیرمخزن‌ها (subrepositories)
-I,--include <PATTERN[+]>: شامل کردن نام‌های منطبق با الگوهای مشخص‌شده
-X,--exclude <PATTERN[+]>: مستثنی کردن نام‌های منطبق با الگوهای مشخص‌شده
گزینه‌های مشخص‌شده با [+] را می‌توان چندین بار تعیین کرد