نام (NAME)

ptyxis - شبیه‌ساز ترمینال متمرکز بر کانتینر

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

ptyxis [OPTION]... [-- PROGRAM ARGUMENTS]

توضیحات (DESCRIPTION)

ptyxis یک شبیه‌ساز ترمینال متمرکز بر کانتینر است که برای میزکار گنوم (GNOME) طراحی شده است. این برنامه یکپارچگی نزدیکی با podman، toolbox، distrobox و jhbuild ارائه می‌دهد تا توسعه مبتنی بر کانتینر و مدیریت سیستم را ساده‌تر کند.

--version

نمایش نسخه برنامه.

--preferences

نمایش پنجره تنظیمات.

--new-window

باز کردن یک پنجره جدید در یک نمونه موجود از Ptyxis. اگر Ptyxis در حال اجرا نباشد، یک نمونه جدید راه‌اندازی می‌شود.

می‌تواند با گزینه‌های --working-directory، --execute و --title ترکیب شود.

--tab

باز کردن یک زبانه جدید در آخرین پنجره استفاده‌شده از یک نمونه موجود Ptyxis. اگر Ptyxis در حال اجرا نباشد، یک نمونه جدید راه‌اندازی می‌شود.

می‌تواند با گزینه‌های --working-directory، --execute و --title ترکیب شود.

-x, --execute

اجرای یک دستور سفارشی.

این گزینه مشابه استفاده از -- برای ارسال دستور سفارشی است، با این تفاوت که کل خط دستور باید به عنوان یک آرگومان واحد ارائه شود.

به طور کلی، بهتر است به جای این گزینه از -- استفاده کنید. این گزینه عمدتاً برای شباهت با رفتار bash -c 'command' در نظر گرفته شده است.

می‌تواند با گزینه‌های --working-directory و --title ترکیب شود.

-d, --working-directory

تنظیم دایرکتوری کاری جاری برای یک زبانه جدید [--tab]، پنجره [--window] یا دستور سفارشی [-- COMMAND...].

--title=TITLE

تنظیم عنوان برای صفحه ترمینال جدید ایجادشده با --tab یا --new-window.

--maximize

بزرگ‌نمایی پنجره تازه ایجادشده.

--fullscreen

تمام‌صفحه کردن پنجره تازه ایجادشده.

--tab-with-profile=PROFILE

ایجاد یک زبانه جدید در یک نمونه موجود با استفاده از نمایه (Profile) مشخص‌شده. این نمایه باید یک رشته UUID معتبر باشد که در ویرایشگر نمایه‌ها در پنجره تنظیمات قابل مشاهده است.

-s, --standalone

راه‌اندازی یک نمونه جدید از Ptyxis در حالت تک‌نمونه (Single Instance)، با نادیده گرفتن نمونه‌هایی که از قبل در حال اجرا هستند.

هنگام اجرای دستور با -- حالت تک‌نمونه به صورت ضمنی اعمال می‌شود.

-s, --gapplication-app-id=ID

بازنویسی ID برنامه در حالت تک‌نمونه.

-h, --help

نمایش خلاصه گزینه‌ها.

سایر گزینه‌های استاندارد گنوم که در اینجا فهرست نشده‌اند نیز پشتیبانی می‌شوند.

فایل‌های پالت (PALETTE FILES)

برنامه Ptyxis از پالت‌های رنگی سفارشی تعریف‌شده در فایل‌های سبک INI با پسوند .palette پشتیبانی می‌کند. فایل‌های پالت را می‌توان در مسیر ~/.local/share/org.gnome.Ptyxis/palettes/ قرار داد تا در انتخاب‌گر پالت در دسترس باشند.

فایل‌های پالت از فرمت GKeyFile (مشابه فایل‌های INI) استفاده می‌کنند و باید حداقل شامل یک بخش [Palette] با کلید Name باشند. پالت می‌تواند رنگ‌ها را به دو روش تعریف کند:

طرح تک‌حالته (Single Scheme): اگر هیچ‌یک از بخش‌های [Light] یا [Dark] وجود نداشته باشند، کلیدهای رنگ را می‌توان مستقیماً در بخش [Palette] قرار داد. در این صورت همان رنگ‌ها برای هر دو پوسته روشن و تیره استفاده خواهند شد و Ptyxis به طور خودکار بر اساس طرح رنگ سیستم، پوسته مناسب را تعیین می‌کند.
طرح دوحالته (Dual Scheme): اگر هر دو بخش [Light] و [Dark] وجود داشته باشند، هر بخش رنگ‌های مربوط به پوسته خود را تعریف می‌کند. هر دو بخش باید حاوی کلیدهای رنگی الزامی یکسانی باشند.

بخش [Palette] از کلیدهای زیر پشتیبانی می‌کند:

Name: (الزامی) نام نمایشی پالت همان‌طور که در انتخاب‌گر پالت نشان داده می‌شود.
Primary: (اختیاری) مقدار بولی (true/false). در صورت تنظیم روی true، این پالت برای گنجانده شدن در مجموعه اولیه پالت‌های نمایش‌داده‌شده به کاربر علامت‌گذاری می‌شود. این مورد عموماً برای مجموعه محدودی از پالت‌های ارائه‌شده همراه با Ptyxis به کار می‌رود.
UseSystemAccent: (اختیاری) مقدار بولی (true/false). در صورت تنظیم روی true، پالت از رنگ تأکیدی (Accent Color) سیستم استفاده خواهد کرد.

هر بخش از طرح رنگ (شامل [Palette]، [Light] یا [Dark] ) باید شامل کلیدهای رنگی الزامی زیر باشد:

Foreground: رنگ پیش‌زمینه متن.
Background: رنگ پس‌زمینه ترمینال.
Color0: تا Color15 ۱۶ رنگ استاندارد ترمینال (۰ تا ۷ رنگ‌های معمولی و ۸ تا ۱۵ رنگ‌های روشن هستند).

کلیدهای رنگی زیر اختیاری هستند و در صورت ذکر نشدن، از مقادیر پیش‌فرض محاسبه‌شده استفاده خواهند کرد:

Cursor: یا CursorBackground رنگ پس‌زمینه مکان‌نما. در صورت عدم تعیین، به طور پیش‌فرض همان رنگ پیش‌زمینه متن در نظر گرفته می‌شود.
CursorForeground: رنگ پیش‌زمینه مکان‌نما.
TitlebarBackground: رنگ پس‌زمینه نوار عنوان. به طور پیش‌فرض نسخه سایه‌دار شده‌ای از پس‌زمینه است.
TitlebarForeground: رنگ پیش‌زمینه نوار عنوان. به طور پیش‌فرض نسخه سایه‌دار شده‌ای از پیش‌زمینه است.
BellForeground: رنگ پیش‌زمینه زنگ بصری (Visual Bell). به طور پیش‌فرض همان رنگ پیش‌زمینه نوار عنوان است.
BellBackground: رنگ پس‌زمینه زنگ بصری. به طور پیش‌فرض ترکیبی از Color11 و پس‌زمینه نوار عنوان است.
SuperuserForeground: رنگ پیش‌زمینه هنگام اجرا با دسترسی مدیر سیستم (Superuser). به طور پیش‌فرض نسخه سایه‌دار شده‌ای از پیش‌زمینه نوار عنوان است.
SuperuserBackground: رنگ پس‌زمینه هنگام اجرا با دسترسی مدیر سیستم. به طور پیش‌فرض ترکیبی از Color1 و پس‌زمینه است.
RemoteForeground: رنگ پیش‌زمینه هنگام اتصال از راه دور. به طور پیش‌فرض نسخه سایه‌دار شده‌ای از پیش‌زمینه نوار عنوان است.
RemoteBackground: رنگ پس‌زمینه هنگام اتصال از راه دور. به طور پیش‌فرض ترکیبی از Color12 و پس‌زمینه است.

تمام مقادیر رنگ باید در قالب هگزادسیمال مشخص شوند، به صورت #RRGGBB یا #RRGGBBAA (با کانال آلفای اختیاری). برای مثال: #ffffff (سفید) یا #000000ff (سیاه با کدر بودن کامل).

نمونه فایل پالت:

[Palette]
Name=My Custom Palette
[Light]
Foreground=#000000
Background=#ffffff
Color0=#000000
Color1=#cc0000
Color2=#00cc00
Color3=#cccc00
Color4=#0000cc
Color5=#cc00cc
Color6=#00cccc
Color7=#cccccc
Color8=#808080
Color9=#ff0000
Color10=#00ff00
Color11=#ffff00
Color12=#0000ff
Color13=#ff00ff
Color14=#00ffff
Color15=#ffffff
[Dark]
Foreground=#ffffff
Background=#000000
Color0=#000000
Color1=#cc0000
Color2=#00cc00
Color3=#cccc00
Color4=#0000cc
Color5=#cc00cc
Color6=#00cccc
Color7=#cccccc
Color8=#808080
Color9=#ff0000
Color10=#00ff00
Color11=#ffff00
Color12=#0000ff
Color13=#ff00ff
Color14=#00ffff
Color15=#ffffff

همچنین ببینید (SEE ALSO)

برای اطلاعات بیشتر، از وب‌سایت زیر دیدن کنید: https://gitlab.gnome.org/chergert/ptyxis

اشکالات (BUGS)

گزارش‌های اشکال را می‌توان در نشانی زیر مشاهده و ثبت کرد: https://gitlab.gnome.org/chergert/ptyxis/issues