.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "SAKURA 1"
.TH SAKURA 1 2025-04-13 3.8.9 ""
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
sakura \- شبیه‌ساز ترمینال ساده اما قدرتمند مبتنی بر libvte.
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
sakura [گزینه‌ها...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
برنامهٔ \fBsakura\fR یک شبیه‌ساز ترمینال مبتنی بر GTK+ و VTE است. این شبیه‌ساز وابستگی‌های بسیار کمی دارد، بنابراین برای داشتن یک ترمینال مناسب و کارآمد، نیازی به نصب کامل میزکار GNOME نخواهید داشت.
.SH "گزینه‌های راهنما (HELP OPTIONS)"
.IX Header "HELP OPTIONS"
.IP "\fB\-?, \-\-help\fR" 8
.IX Item "-?, --help"
نمایش گزینه‌های راهنما.
.IP \fB\-\-help\-all\fR 8
.IX Item "--help-all"
نمایش تمام گزینه‌های راهنما
.IP \fB\-\-help\-gtk\fR 8
.IX Item "--help-gtk"
نمایش گزینه‌های GTK+
.SH "گزینه‌های برنامه (APPLICATION OPTIONS)"
.IX Header "APPLICATION OPTIONS"
.IP "\fB\-v, \-\-version\fR" 8
.IX Item "-v, --version"
چاپ شماره نسخه
.IP "\fB\-f, \-\-font\fR" 8
.IX Item "-f, --font"
انتخاب قلم اولیه ترمینال
.IP "\fB\-n, \-\-ntabs\fR" 8
.IX Item "-n, --ntabs"
انتخاب تعداد زبانه‌های اولیه
.IP "\fB\-x, \-\-execute\fR" 8
.IX Item "-x, --execute"
اجرای دستور
.IP "\fB\-e, \-\-xterm\-execute\fR" 8
.IX Item "-e, --xterm-execute"
اجرای دستور (سازگار با گزینهٔ \-e در xterm)
.IP "\fB\-l, \-\-login\fR" 8
.IX Item "-l, --login"
پوسته ورود (login shell)
.IP "\fB\-c, \-\-columns\fR" 8
.IX Item "-c, --columns"
تنظیم تعداد ستون‌ها
.IP "\fB\-r, \-\-rows\fR" 8
.IX Item "-r, --rows"
تنظیم تعداد سطرها
.IP "\fB\-h, \-\-hold\fR" 8
.IX Item "-h, --hold"
باز نگه داشتن پنجره پس از اجرای دستور
.IP "\fB\-d, \-\-working\-directory\fR" 8
.IX Item "-d, --working-directory"
تنظیم دایرکتوری کاری
.IP "\fB\-m, \-\-maximize\fR" 8
.IX Item "-m, --maximize"
بیشینه‌کردن پنجره
.IP "\fB\-s, \-\-fullscreen\fR" 8
.IX Item "-s, --fullscreen"
حالت تمام‌صفحه
.IP \fB\-\-display=DISPLAY\fR 8
.IX Item "--display=DISPLAY"
نمایشگر X مورد استفاده
.IP \fB\-\-config\-file=FILENAME\fR 8
.IX Item "--config-file=FILENAME"
استفاده از فایل پیکربندی جایگزین. مسیر نسبت به پوشه پیکربندی sakura سنجیده می‌شود.
(مثال: ~/.config/sakura/FILENAME).
.SH "گزینه‌های GTK+ (GTK+ OPTIONS)"
.IX Header "GTK+ OPTIONS"
.IP \fB\-\-class=CLASS\fR 8
.IX Item "--class=CLASS"
کلاس برنامه مورد استفاده توسط مدیر پنجره
.IP \fB\-\-name=NAME\fR 8
.IX Item "--name=NAME"
نام برنامه مورد استفاده توسط مدیر پنجره
.IP \fB\-\-screen=SCREEN\fR 8
.IX Item "--screen=SCREEN"
صفحه نمایش X مورد استفاده
.IP \fB\-\-sync\fR 8
.IX Item "--sync"
همگام‌سازی فراخوانی‌های X
.IP \fB\-\-gtk\-module=MODULES\fR 8
.IX Item "--gtk-module=MODULES"
بارگذاری ماژول‌های اضافی GTK+
.IP \fB\-\-g\-fatal\-warnings\fR 8
.IX Item "--g-fatal-warnings"
مهلک در نظر گرفتن تمامی هشدارها
.SH "پیکربندی (CONFIGURATION)"
.IX Header "CONFIGURATION"
.IP "show_tab_bar=[always | multiple | never]" 8
.IX Item "show_tab_bar=[always | multiple | never]"
این فهرست گزینه‌ها در حال حاضر ناقص است.
.SH "پشتیبانی از کلیدهای میانبر (KEYBINDINGS SUPPORT)"
.IX Header "KEYBINDINGS SUPPORT"
\&\fBsakura\fR از کلیدهای میانبر صفحه‌کلید پشتیبانی می‌کند. این کلیدها از طریق تنظیم مشخصه‌های زیر در فایل پیکربندی sakura (در مسیر ~/.config/sakura/sakura.conf) قابل تنظیم هستند.
.SS "شتاب‌دهنده‌ها (ACCELERATORS)"
.IX Subsection "ACCELERATORS"
شتاب‌دهنده‌ها می‌توانند روی هر مقدار ماسکی از GdkModifierType در gdktypes.h تنظیم شوند؛ ببینید:
.PP
http://gtk.php.net/manual/en/html/gdk/gdk.enum.modifiertype.html
.PP
مقادیر ماسک را می‌توان با عملگر بیتی OR با یکدیگر ترکیب کرد.
.PP
برای مثال، جهت تنظیم شتاب‌دهنده حذف زبانه روی Ctrl + Shift:
.PP
del_tab_accelerator=5
.PP
زیرا GDK_SHIFT_MASK دارای مقدار ۱ (1 << 0) و GDK_CONTROL_MASK دارای مقدار ۴ (1 << 2) است؛ حاصل ترکیب OR آن‌ها برابر ۵ می‌شود.
.PP
می‌دانم که این شیوهٔ پیکربندی برای افراد غیربرنامه‌نویس چندان ساده نیست، اما شروع خوبی است. :)
.SS "کلیدها (KEYS)"
.IX Subsection "KEYS"
برای مثال، جهت تنظیم کلید افزودن زبانه به 'T':
.PP
add_tab_key=T
.PP
پیش‌تر sakura به‌جای رشته‌ها از کدهای کلید (keycodes) استفاده می‌کرد. آن‌ها همچنان معتبر هستند.
.SS "پیش‌فرض‌ها (DEFAULTS)"
.IX Subsection "DEFAULTS"
.Vb 10
\&    Ctrl + Shift + T                 \-> زبانه جدید
\&    Ctrl + Shift + W                 \-> بستن زبانه فعلی
\&    Ctrl + Shift + C                 \-> رونوشت از متن انتخاب‌شده
\&    Ctrl + Shift + V                 \-> چسباندن متن انتخاب‌شده
\&    Ctrl + Left cursor               \-> زبانه قبلی
\&    Ctrl + Right cursor              \-> زبانه بعدی
\&    Ctrl + [1\-9]                     \-> رفتن به زبانه N (1\-9)
\&    Ctrl + Shift + S                 \-> تغییر وضعیت نوار پیمایش
\&    Ctrl + Shift + Mouse left button \-> باز کردن پیوند
\&    F11                              \-> تمام‌صفحه
\&    Shift + PageUp                   \-> پیمایش صفحه به صفحه به بالا در تاریخچه
\&    Shift + PageDown                 \-> پیمایش صفحه به صفحه به پایین در تاریخچه
\&    Ctrl + Shift + Up                \-> پیمایش خط به خط به بالا در تاریخچه
\&    Ctrl + Shift + Down              \-> پیمایش خط به خط به پایین در تاریخچه
.Ve
.PP
همچنین می‌توانید اندازه قلم را به روش استاندارد GTK+ (غیرقابل پیکربندی) افزایش یا کاهش دهید:
.PP
.Vb 2
\&    Ctrl + \*(Aq+\*(Aq                       \-> افزایش اندازه قلم
\&    Ctrl + \*(Aq\-\*(Aq                       \-> کاهش اندازه قلم
.Ve
.SH "گزارش باگ‌ها (BUGS)"
.IX Header "BUGS"
پروژهٔ \&\fBsakura\fR در Launchpad میزبانی می‌شود. باگ‌ها را می‌توانید در نشانی زیر گزارش کنید:
.PP
https://bugs.launchpad.net/sakura
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
برنامهٔ \&\fBsakura\fR توسط David Gómez <david@pleyades.net> نوشته شده است.
.PP
این صفحهٔ راهنما توسط Andrew Starr-Bochicchio <a.starr.b@gmail.com> نوشته شده است.
.PP
هر دو تحت مجوز عمومی همگانی گنو (GNU General Public License)، نسخه ۲ یا بالاتر منتشر شده‌اند.