.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH asciinema-convert 1  "convert "
.SH "نام (NAME)"
asciinema\-convert \- تبدیل فایل‌های ضبط ترمینال asciinema بین فرمت‌های مختلف
.SH "خلاصه دستور (SYNOPSIS)"
\fBasciinema convert\fR [\fB\-f\fR|\fB\-\-output\-format\fR] [\fB\-\-overwrite\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIINPUT\fR> <\fIOUTPUT\fR>
.SH "توضیحات (DESCRIPTION)"
تبدیل یک ضبط به فرمتی دیگر.
.PP
تبدیل پرونده‌های asciicast میان قالب‌های مختلف (v1، v2، v3) یا صدور به قالب‌های دیگر مانند خروجی خام پایانه یا متن ساده. از خواندن از پرونده‌ها، نشانی‌های اینترنتی یا ورودی استاندارد (stdin) و نوشتن در پرونده‌ها یا خروجی استاندارد (stdout) پشتیبانی می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fR, \fB\-\-output\-format\fR=\fIFORMAT\fR
مشخص کردن قالب برای ضبط تبدیل‌شده. مقدار پیش‌فرض asciicast\-v3 است. اگر مسیر پرونده خروجی با .txt پایان یابد، قالب txt به‌طور خودکار انتخاب می‌شود مگر اینکه این گزینه صریحاً مشخص شده باشد.
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
asciicast\-v3: قالب نشست کامل، به همراه زمان‌بندی و فراداده (نسل فعلی) \- https://docs.asciinema.org/manual/asciicast/v3
.IP \(bu 2
asciicast\-v2: قالب نشست کامل، به همراه زمان‌بندی و فراداده (نسل قبلی) \- https://docs.asciinema.org/manual/asciicast/v2
.IP \(bu 2
raw: خروجی خام پایانه، شامل توالی‌های کنترلی، بدون زمان‌بندی و فراداده
.IP \(bu 2
txt: متن ساده بدون رنگ‌ها یا توالی‌های کنترلی، قابل خواندن توسط انسان
.RE
.TP
\fB\-\-overwrite\fR
بازنویسی پرونده خروجی در صورتی که از قبل وجود داشته باشد. به‌طور پیش‌فرض، asciinema برای جلوگیری از دست رفتن تصادفی داده‌ها از بازنویسی پرونده‌های موجود خودداری می‌کند. هنگام نوشتن در خروجی استاندارد (\*(Aq\-\*(Aq) تأثیری ندارد.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
فرونشاندن پیام‌های تشخیصی و نشانگرهای پیشرفت. تنها پیام‌های خطا نمایش داده خواهند شد.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
<\fIINPUT\fR>
ضبط مبدأ برای تبدیل. می‌تواند مسیر یک پرونده محلی، نشانی اینترنتی HTTP(S) برای پرونده‌های دوردست، یا \*(Aq\-\*(Aq برای خواندن از ورودی استاندارد باشد. نشانی‌های دوردست امکان تبدیل مستقیم ضبط‌ها از وب را بدون نیاز به بارگیری دستی فراهم می‌کنند. قالب‌های ورودی پشتیبانی‌شده شامل asciicast نسخه‌های v1، v2 و v3 هستند.
.TP
<\fIOUTPUT\fR>
مسیر خروجی برای ضبط تبدیل‌شده. می‌تواند مسیر یک پرونده یا \*(Aq\-\*(Aq برای نوشتن در خروجی استاندارد باشد.
.SH "اطلاعات اضافی (EXTRA)"
مثال‌ها:

  asciinema convert old.cast new.cast
      تبدیل یک ضبط به آخرین قالب asciicast (نسخه v3)

  asciinema convert demo.cast demo.txt
      صدور یک ضبط به عنوان گزارش متنی ساده \- قالب خروجی از پسوند .txt تشخیص داده می‌شود

  asciinema convert \-\-output\-format raw demo.cast demo.txt
      صدور به عنوان خروجی خام پایانه

  asciinema convert \-f txt demo.cast \-
      صدور به عنوان متن ساده به خروجی استاندارد (stdout)

  asciinema convert https://asciinema.org/a/569727 starwars.cast
      بارگیری یک ضبط دوردست و تبدیل آن به آخرین قالب asciicast (نسخه v3)