.\" Copyright (c) 2023, Sebastian Geiger (lanoxx@gmx.net) .\" .\" Copyright (c) 2012, Davide Truffa .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of .\" this manual under the conditions for verbatim copying, provided that .\" the entire resulting derived work is distributed under the terms of .\" a permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume. .\" no responsibility for errors or omissions, or for damages resulting. .\" from the use of the information contained herein. The author(s) may. .\" not have taken the same level of care in the production of this. .\" manual, which is licensed free of charge, as they might when working. .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .TH "TILDA" "1" "Jan 2024" "tilda 2.0.0" "User Commands" .SH "نام (NAME)" tilda \- یک شبیه‌ساز پایانه با قابلیت پیکربندی بسیار بالا .SH "خلاصه دستور (SYNOPSIS)" tilda [\fB\-b|\-\-background\-color\fR \fIcolor\fR] [\fB\-c|\-\-command\fR \fIcommand\fR] [\fB\-h|\-\-hidden\fR] [\fB\-f|\-\-font\fR \fIfont\fR] [\fB\-g|\-\-config-file\fR \fIfile\fR] [\fB\-l|\-\-lines\fR \fIfile\fR] [\fB\-s|\-\-scrollbar\fR] [\fB\-w|\-\-working\-dir\fR \fIdir\fR] [\fB\-x|\-\-x\-pos\fR \fIx_pos\fR] [\fB\-y|\-\-y\-pos\fR \fIy_pos\fR] [\fB\-t|\-\-background\-alpha\fR \fIalpha\fR] [\fB\-C|\-\-config\fR] [\fB\-\-display\fR \fIdisplay\fR] .PP tilda \fB\-\-dbus\fR .PP tilda \fB\-T|\-\-toggle\-window\fR [\fIinstance_id\fR] .PP tilda \fB\-\-version\fR .PP tilda \fB\-\-help\fR .PP tilda \fB\-\-help-all\fR .SH "توضیحات (DESCRIPTION)" برنامهٔ .BR Tilda یک شبیه‌ساز پایانه با قابلیت پیکربندی بسیار بالا است. ویژگی بارز و اصلی tilda این است که از یک میانبر صفحه‌کلید قابل تنظیم برای نمایش و پنهان کردن پنجرهٔ tilda استفاده می‌کند. این ویژگی به کاربران اجازه می‌دهد که تنها با استفاده از میانبرهای صفحه‌کلید، به‌سرعت بین tilda و دیگر پنجره‌ها جابه‌جا شوند. هنگامی که tilda پنهان می‌شود، به خارج از صفحه منتقل می‌گردد تا زمانی که کلید میانبر باز/بسته کردن دوباره فشرده شود تا پنجرهٔ tilda نمایان گردد. رفتار tilda را می‌توان از طریق پنجرهٔ ترجیحات که در منوی متنی در دسترس است پیکربندی کرد. زیرمجموعه‌ای از این گزینه‌ها را نیز می‌توان از طریق خط فرمان، همان‌طور که در ادامه مستند شده است، پیکربندی نمود. .PP لطفاً توجه داشته باشید که در حال حاضر، گزینه‌های خط فرمان بر تنظیمات موجود در فایل پیکربندی اولویت دارند و درون فایل پیکربندی ذخیره و ماندگار می‌شوند. .PP در میزکارهای مبتنی بر Xorg، برنامهٔ Tilda از یک تابع پالایهٔ X11 برای ثبت کلیدهای میانبر سراسری خود استفاده می‌کند. در Wayland، این روش فقط زمانی کار می‌کند که دیگر برنامه‌های مبتنی بر X11 فعال باشند، اما هنگامی که برنامه‌های بومی Wayland فوکوس دارند، نمی‌توان کلیدهای میانبر را به tilda ارسال کرد. بنابراین، در میزکارهای Wayland لازم است tilda با پشتیبانی از D-Bus (یعنی همراه با \fB\-\-dbus\fR) راه‌اندازی شود و یک کلید میانبر سراسری در تنظیمات محیط میزکار ثبت گردد تا یک کنش D-Bus را برای نمایش یا پنهان کردن پنجرهٔ Tilda ارسال کند. .PP .SH "گزینه‌ها (OPTIONS)" .SS "گزینه‌های راهنما (Help Options):" .TP \fB\-?\fR, \fB\-\-help\fR نمایش گزینه‌های راهنما .TP \fB\-\-help-all\fR نمایش تمام گزینه‌های راهنما، شامل گزینه‌های D-Bus و GTK. .SS "گزینه‌های برنامه (Application Options):" .TP \fB\-b\fR, \fB\-\-background\-color\fR \fIcolor\fR تنظیم رنگ پس‌زمینه (\fIcolor\fR). این مقدار می‌تواند یک نام رنگ استاندارد از X11 یا یک مقدار هگزادسیمال (مانند rgb#، rrggbb# و غیره) باشد. .TP \fB\-c\fR, \fB\-\-command\fR \fIcommand\fR اجرای یک دستور (\fIcommand\fR) در زمان راه‌اندازی، به‌جای شل پیش‌فرض. .TP \fB\-h\fR, \fB\-\-hidden\fR راه‌اندازی Tilda به‌صورت پنهان. .TP \fB\-f\fR, \fB\-\-font\fR \fIfont\fR تنظیم قلم روی Pango FontDescription مشخص‌شده در \fIfont\fR. پیش‌فرض "Monospace 11" است. .TP \fB\-l\fR, \fB\-\-lines\fR \fIlines\fR تنظیم اندازهٔ بافر پیمایش به حداکثر \fIlines\fR سطر. .TP \fB\-s\fR, \fB\-\-scrollbar\fR نمایش یک نوار پیمایش در کنارهٔ پایانه. .TP \fB\-v\fR, \fB\-\-version\fR چاپ نسخه و سپس خروج. .TP \fB\-w\fR, \fB\-\-working\-dir\fR \fIdir\fR تنظیم دایرکتوری کاری اولیه روی \fIdir\fR. .TP \fB\-x\fR, \fB\-\-x\-pos\fR \fIx_pos\fR تنظیم موقعیت افقی (X) پنجرهٔ پایانهٔ tilda روی \fIx_pos\fR. .TP \fB\-y\fR, \fB\-\-y\-pos\fR \fIy_pos\fR تنظیم موقعیت عمودی (Y) پنجرهٔ پایانهٔ tilda روی \fIy_pos\fR. .TP \fB\-t\fR, \fB\-\-background\-alpha\fR \fIalpha\fR تنظیم میزان شفافیت پنجرهٔ پایانه روی \fIalpha\fR (یعنی بین ۰ تا ۱۰۰٪). مقادیر بالاتر میزان شفافیت را افزایش می‌دهند. .TP \fB\-C\fR, \fB\-\-config\fR نمایش ویزارد پیکربندی. .TP \fB\-\-display\fR=\fIDISPLAY\fR تنظیم نمایشگر X جهت استفاده (مانند :0، :0.0 و غیره). .SS "گزینه‌های D-Bus (D-Bus Options):" .TP \fB\-\-dbus\fR فعال‌سازی پشتیبانی از D-Bus (بخش \fID-Bus\fR را ببینید). .TP \fB\-T\fR, \fB\-\-toggle\-window\fR \fI[instance_id]\fR تغییر وضعیت نمایش پنجرهٔ Tilda با شناسهٔ نمونهٔ \fIinstance_id\fR و سپس خروج. اگر \fIinstance_id\fR مشخص نشود، به‌طور پیش‌فرض روی نمونهٔ 0 تنظیم می‌شود. این گزینه روشی راحت برای باز و بسته کردن پنجره‌های tilda در محیط‌های Wayland فراهم می‌کند و معادل دستور طولانی‌تر \fIdbus-send\fR است که در ادامه توضیح داده شده است. از این گزینه می‌توان برای تنظیم یک میانبر صفحه‌کلید در محیط‌های میزکار مبتنی بر Wayland استفاده کرد که سپس پنجرهٔ Tilda را باز و بسته می‌کند. توجه داشته باشید که این گزینه تحت تأثیر تنظیم "Non-Focus Pull Up Behaviour" قرار می‌گیرد. .SH "نکات (NOTES)" .SS D-Bus در صورت فعال بودن D-Bus، برنامهٔ Tilda متدی را روی D-Bus برای تغییر وضعیت نمایش پنجرهٔ Tilda فراهم می‌کند. هر پردازش Tilda نام D-Bus اختصاصی خود را ثبت می‌کند، بنابراین می‌توان چندین پردازش tilda را که هر کدام فایل پیکربندی خود را دارند اجرا کرد و آن‌ها را به‌طور جداگانه از طریق D-Bus کنترل نمود. هنگامی که D-Bus فعال باشد، میانبر پایین کشیدن پنجره به‌عنوان یک تابع پالایهٔ Xorg ثبت نمی‌شود و باید یک میانبر سراسری مناسب در محیط میزکار پیکربندی گردد (گزینهٔ \fB\-\-toggle\-window\fR را ببینید). در صورت فعال بودن پشتیبانی D-Bus، می‌توانید به‌صورت اختیاری میانبر پایین کشیدن را در تنظیمات پاک کنید. .PP هر نمونه از Tilda خود را با استفاده از یک نام گذرگاه و مسیر شیء تولیدشده به‌صورت پویا بر اساس شمارهٔ نمونه‌اش ثبت می‌کند. نخستین نمونهٔ Tilda روی نام گذرگاه زیر خواهد بود: .TP com.github.lanoxx.tilda.Actions0 .PP با مسیر شیء: .TP /com/github/lanoxx/tilda/Actions0 .PP نام رابط همیشه این مقدار است: .TP com.github.lanoxx.tilda.Actions .PP برای باز و بسته کردن پنجرهٔ tilda می‌توانید از گزینهٔ \fB\-T|\-\-toggle\-window\fR در tilda استفاده کنید: .TP .EX tilda -T # toggle default instance (i.e., 0) .EE .TP .EX tilda -T 0 # explicitly toggle the specified instance (i.e., 0) .EE .PP همچنین می‌توانید از دستور \fBdbus-send\fR استفاده نمایید: .TP .EX dbus-send --session --type=method_call \ --dest=com.github.lanoxx.tilda.Actions0 \ /com/github/lanoxx/tilda/Actions0 \ com.github.lanoxx.tilda.Actions.Toggle .EE .PP به ازای هر نمونهٔ اضافی از tilda، نام گذرگاه و مسیر شیء یک واحد افزایش می‌یابد (مانند Actions1، Actions2 و غیره). .PP می‌توانید از یکی از دستورهای بالا برای ثبت یک میانبر سراسری در نشست Wayland خود استفاده کنید. در Gnome، این کار را می‌توان از مسیر Settings -> Keyboard -> Keyboard Shortcuts انجام داد. .SS "فایل‌ها (FILES)" .PP برنامهٔ Tilda فایل‌های پیکربندی خود را زیر مسیر \fB~/.config/tilda/\fR ایجاد می‌کند. برای هر نمونه، یک فایل پیکربندی با نام \fBconfig_\fR ایجاد خواهد شد که در آن \fB\fR از 0 شروع می‌شود و به ازای هر پردازش اضافی که راه‌اندازی شود، یک واحد افزایش می‌یابد. .PP برنامهٔ Tilda همچنین یک دایرکتوری کِش در مسیر \fB~/.cache/tilda/locks\fR ایجاد می‌کند که در آن یک فایل قفل سراسری با نام \fBlock_0_0\fR و فایل‌های قفل اضافی ویژهٔ هر نمونه با نام \fBlock__\fR می‌سازد؛ در این نام‌گذاری، \fB\fR شناسهٔ پردازش و \fB\fR شناسهٔ نمونه است. .PP در صورتی که می‌خواهید ظاهر tilda را سفارشی‌سازی کنید، می‌توانید به‌صورت اختیاری فایلی با نام \fBstyle.css\fR بسازید و آن را درون دایرکتوری پیکربندی tilda قرار دهید. .SH "گزارش باگ‌ها (BUGS)" لطفاً باگ‌ها را از طریق گیت‌هاب در نشانی https://github.com/lanoxx/tilda/issues گزارش دهید. .SH "همچنین ببینید (SEE ALSO)" برای اطلاعات بیشتر، به مخزن پروژه مراجعه کنید یا نگاهی به ویکی بیاندازید: https://github.com/lanoxx/tilda/wiki