.\" Hey, EMACS: -*- nroff -*-
.TH Ptyxis 1 "16 January 2026"
.SH "نام (NAME)"
ptyxis \- شبیه‌ساز ترمینال متمرکز بر کانتینر

.SH "خلاصه دستور (SYNOPSIS)"
.B ptyxis
.RI [OPTION]...
[\-\- PROGRAM ARGUMENTS]
.br

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

.TP
.B \-\-version
نمایش نسخه برنامه.

.TP
.B \-\-preferences
نمایش پنجره تنظیمات.

.TP
.BR \-\-new\-window
باز کردن یک پنجره جدید در یک نمونه موجود از Ptyxis. اگر Ptyxis در حال اجرا نباشد، یک نمونه جدید راه‌اندازی می‌شود.
.sp
می‌تواند با گزینه‌های
.BR \-\-working\-directory ،
.B \-\-execute
و
.B \-\-title
ترکیب شود.

.TP
.BR \-\-tab
باز کردن یک زبانه جدید در آخرین پنجره استفاده‌شده از یک نمونه موجود Ptyxis. اگر Ptyxis در حال اجرا نباشد، یک نمونه جدید راه‌اندازی می‌شود.
.sp
می‌تواند با گزینه‌های
.BR \-\-working\-directory ،
.B \-\-execute
و
.B \-\-title
ترکیب شود.

.TP
.BR \-x ", " \-\-execute
اجرای یک دستور سفارشی.
.sp
این گزینه مشابه استفاده از
.B \-\-
برای ارسال دستور سفارشی است، با این تفاوت که کل خط دستور باید به عنوان یک آرگومان واحد ارائه شود.
.sp
به طور کلی، بهتر است به جای این گزینه از
.B \-\-
استفاده کنید. این گزینه عمدتاً برای شباهت با رفتار
.B "bash -c 'command'"
در نظر گرفته شده است.
.sp
می‌تواند با گزینه‌های
.B \-\-working\-directory
و
.B \-\-title
ترکیب شود.

.TP
.BR \-d ", " \-\-working\-directory
تنظیم دایرکتوری کاری جاری برای یک زبانه جدید [\-\-tab]، پنجره [\-\-window] یا دستور سفارشی [\-\- COMMAND...].

.TP
.BR \-\-title=TITLE
تنظیم عنوان برای صفحه ترمینال جدید ایجادشده با \-\-tab یا \-\-new\-window.

.TP
.BR \-\-maximize
بزرگ‌نمایی پنجره تازه ایجادشده.

.TP
.BR \-\-fullscreen
تمام‌صفحه کردن پنجره تازه ایجادشده.

.TP
.BR \-\-tab\-with\-profile=PROFILE
ایجاد یک زبانه جدید در یک نمونه موجود با استفاده از نمایه (Profile) مشخص‌شده. این نمایه باید یک رشته
.B UUID
معتبر باشد که در ویرایشگر نمایه‌ها در پنجره تنظیمات قابل مشاهده است.

.TP
.BR \-s ", " \-\-standalone
راه‌اندازی یک نمونه جدید از Ptyxis در حالت تک‌نمونه (Single Instance)، با نادیده گرفتن نمونه‌هایی که از قبل در حال اجرا هستند.
.sp
هنگام اجرای دستور با
.BR \-\-
حالت تک‌نمونه به صورت ضمنی اعمال می‌شود.

.TP
.BR \-s ", " \-\-gapplication\-app\-id=ID
بازنویسی
.B ID
برنامه در حالت تک‌نمونه.

.TP
.BR \-h ", " \-\-help
نمایش خلاصه گزینه‌ها.

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

.SH "فایل‌های پالت (PALETTE FILES)"
برنامه Ptyxis از پالت‌های رنگی سفارشی تعریف‌شده در فایل‌های سبک INI با پسوند
.B .palette
پشتیبانی می‌کند. فایل‌های پالت را می‌توان در مسیر
.B ~/.local/share/org.gnome.Ptyxis/palettes/
قرار داد تا در انتخاب‌گر پالت در دسترس باشند.
.PP
فایل‌های پالت از فرمت GKeyFile (مشابه فایل‌های INI) استفاده می‌کنند و باید حداقل شامل یک بخش
.B [Palette]
با کلید
.B Name
باشند. پالت می‌تواند رنگ‌ها را به دو روش تعریف کند:

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

.TP
.B طرح دوحالته (Dual Scheme)
اگر هر دو بخش
.B [Light]
و
.B [Dark]
وجود داشته باشند، هر بخش رنگ‌های مربوط به پوسته خود را تعریف می‌کند. هر دو بخش باید حاوی کلیدهای رنگی الزامی یکسانی باشند.

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

.TP
.B Name
(الزامی) نام نمایشی پالت همان‌طور که در انتخاب‌گر پالت نشان داده می‌شود.

.TP
.B Primary
(اختیاری) مقدار بولی (true/false). در صورت تنظیم روی true، این پالت برای گنجانده شدن در مجموعه اولیه پالت‌های نمایش‌داده‌شده به کاربر علامت‌گذاری می‌شود. این مورد عموماً برای مجموعه محدودی از پالت‌های ارائه‌شده همراه با Ptyxis به کار می‌رود.

.TP
.B UseSystemAccent
(اختیاری) مقدار بولی (true/false). در صورت تنظیم روی true، پالت از رنگ تأکیدی (Accent Color) سیستم استفاده خواهد کرد.

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

.TP
.B Foreground
رنگ پیش‌زمینه متن.

.TP
.B Background
رنگ پس‌زمینه ترمینال.

.TP
.B Color0
تا
.B Color15
۱۶ رنگ استاندارد ترمینال (۰ تا ۷ رنگ‌های معمولی و ۸ تا ۱۵ رنگ‌های روشن هستند).

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

.TP
.B Cursor
یا
.B CursorBackground
رنگ پس‌زمینه مکان‌نما. در صورت عدم تعیین، به طور پیش‌فرض همان رنگ پیش‌زمینه متن در نظر گرفته می‌شود.

.TP
.B CursorForeground
رنگ پیش‌زمینه مکان‌نما.

.TP
.B TitlebarBackground
رنگ پس‌زمینه نوار عنوان. به طور پیش‌فرض نسخه سایه‌دار شده‌ای از پس‌زمینه است.

.TP
.B TitlebarForeground
رنگ پیش‌زمینه نوار عنوان. به طور پیش‌فرض نسخه سایه‌دار شده‌ای از پیش‌زمینه است.

.TP
.B BellForeground
رنگ پیش‌زمینه زنگ بصری (Visual Bell). به طور پیش‌فرض همان رنگ پیش‌زمینه نوار عنوان است.

.TP
.B BellBackground
رنگ پس‌زمینه زنگ بصری. به طور پیش‌فرض ترکیبی از Color11 و پس‌زمینه نوار عنوان است.

.TP
.B SuperuserForeground
رنگ پیش‌زمینه هنگام اجرا با دسترسی مدیر سیستم (Superuser). به طور پیش‌فرض نسخه سایه‌دار شده‌ای از پیش‌زمینه نوار عنوان است.

.TP
.B SuperuserBackground
رنگ پس‌زمینه هنگام اجرا با دسترسی مدیر سیستم. به طور پیش‌فرض ترکیبی از Color1 و پس‌زمینه است.

.TP
.B RemoteForeground
رنگ پیش‌زمینه هنگام اتصال از راه دور. به طور پیش‌فرض نسخه سایه‌دار شده‌ای از پیش‌زمینه نوار عنوان است.

.TP
.B RemoteBackground
رنگ پس‌زمینه هنگام اتصال از راه دور. به طور پیش‌فرض ترکیبی از Color12 و پس‌زمینه است.

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

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

.nf
[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
.fi

.SH "همچنین ببینید (SEE ALSO)"
برای اطلاعات بیشتر، از وب‌سایت زیر دیدن کنید:
https://gitlab.gnome.org/chergert/ptyxis

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