| asciinema-upload(1) | General Commands Manual | asciinema-upload(1) |
نام (NAME)
asciinema-upload - بارگذاری یک ضبط در کارساز asciinema
خلاصه دستور (SYNOPSIS)
asciinema upload [-t|--title] [--description] [--visibility] [--audio-url] [--server-url] [-q|--quiet] [-h|--help] <FILE>
توضیحات (DESCRIPTION)
بارگذاری یک ضبط در کارساز asciinema.
یک پرونده محلی asciicast را گرفته و آن را در یک کارساز asciinema (چه asciinema.org و چه یک کارساز با میزبانی شخصی) بارگذاری میکند، و یک نشانی اینترنتی (URL) بازمیگرداند که میتواند بهصورت عمومی به اشتراک گذاشته شود.
گزینهها (OPTIONS)
- -t, --title=TITLE
- تنظیم یک عنوان برای ضبط که در فرادادههای ضبط ذخیره شده و به بینندگان نمایش داده میشود. به عنوان مثال: --title "Installing Podman on Ubuntu". این گزینه بر فیلد "title" درون پرونده ضبط اولویت دارد.
- --description=DESCRIPTION
- تنظیم توضیحات برای ضبط. این توضیحات در صفحه ضبط نمایش داده میشود و میتواند شامل قالببندی، پیوندها و بلوکهای کد باشد. برای ارائه پیشزمینه، دستورالعملها یا مستندات به بینندگان مفید است.
- --visibility=VISIBILITY
- تنظیم سطح
نمایانی
برای ضبط.
ضبطهای
عمومی (public) در
فهرستها،
نتایج
جستجو و
صفحه نمایه
شما نمایش
داده
میشوند.
ضبطهای
فهرستنشده
(unlisted) از طریق
نشانی
مستقیم در
دسترس
هستند اما
در
فهرستها
ظاهر
نمیشوند.
ضبطهای
خصوصی (private)
فقط برای
مالک در
دسترس
هستند.
[مقادیر ممکن: public, unlisted, private]
- --audio-url=URL
- مشخص کردن نشانی یک پرونده صوتی (مانند MP3/OGG) جهت همگامسازی با پخش ترمینال. در صورت تنظیم، بینندگان میتوانند همزمان با تماشای ترمینال، توضیحات صوتی را گوش دهند. نشانی صوتی در فراداده ضبط ذخیره شده و توسط پخشکننده برای پخش همگام استفاده میشود. به عنوان مثال: --audio-url https://example.com/commentary.mp3
- --server-url=URL
- مشخص کردن نشانی اختصاصی کارساز asciinema جهت بارگذاری در کارسازهای با میزبانی شخصی. از نشانی پایه کارساز استفاده کنید (مانند https://asciinema.example.com). همچنین میتوان از طریق متغیر محیطی ASCIINEMA_SERVER_URL یا گزینه server.url در پرونده پیکربندی آن را تنظیم کرد. در صورت عدم تنظیم نشانی کارساز از طریق این گزینه، متغیر محیطی یا پرونده پیکربندی، از شما خواسته میشود یکی را انتخاب کنید (پیشفرض asciinema.org)، که به عنوان پیشفرض ذخیره خواهد شد.
- -q, --quiet
- فرونشاندن پیامهای تشخیصی و نشانگرهای پیشرفت. فقط پیامهای خطا نمایش داده خواهند شد.
- -h, --help
- چاپ راهنما (مشاهده خلاصه با '-h')
- <FILE>
- مسیر پرونده ضبط asciicast جهت بارگذاری، در یکی از قالبهای پشتیبانیشده asciicast (نسخههای v1، v2 یا v3)
| upload |