'\" t
.\"     Title: awesome
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-09-23
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "AWESOME" "1" "2025-09-23" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
awesome \- مدیر پنجره کاشیکار بسیار قابل تنظیم برای سامانه X
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBawesome\fP [\fB\-v\fP | \fB\-\-version\fP] [\fB\-h\fP | \fB\-\-help\fP] [\fB\-c\fP | \fB\-\-config\fP \fIفایل\fP] [\fB\-k\fP | \fB\-\-check\fP] [\fB\-\-search\fP \fIپوشه\fP] [\fB\-a\fP | \fB\-\-no\-argb\fP] [\fB\-r\fP | \fB\-\-replace\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه
.B awesome
یک مدیر پنجره برای سامانه X است. این برنامه پنجره‌ها را در چیدمان‌های مختلفی مانند
شناور یا کاشیکار مدیریت می‌کند. هر چیدمانی می‌تواند به‌صورت پویا اعمال شود
تا محیط برای برنامهٔ در حال استفاده و وظیفه‌ای که در حال انجام است بهینه‌سازی گردد.
.sp
در یک چیدمان کاشیکار، پنجره‌ها در دو ناحیه اصلی (master) و پشته‌ای (stacking) مدیریت می‌شوند. ناحیه
اصلی شامل پنجره‌هایی است که در حال حاضر به بیشترین توجه نیاز دارند، در حالی که
ناحیه پشته‌ای شامل سایر پنجره‌ها است. در یک چیدمان شناور، پنجره‌ها را می‌توان آزادانه
تغییر اندازه داد و جابه‌جا کرد. پنجره‌های محاوره‌ای صرف‌نظر از چیدمانِ در حال اجرا،
همواره به‌صورت شناور مدیریت می‌شوند. چیدمان‌های مارپیچی (spiral) و کاهشی (dwindle)
حالت‌های خاصی از چیدمان کاشیکار هستند که در اولی ناحیه پشته‌ای به شکل مارپیچ و در دومی
به‌صورت فراکتال مستطیلی مرتب می‌شود.
.sp
پنجره‌ها در awesome توسط برچسب‌ها (tags) گروه‌بندی می‌شوند. هر پنجره می‌تواند با یک یا
چند برچسب علامت‌گذاری شود. انتخاب برچسب‌های خاص، تمامی پنجره‌های دارای آن برچسب‌ها را نمایش می‌دهد.
.sp
برنامه
.B awesome
می‌تواند شامل جعبه‌های کوچک ویجت (wibox) باشد که هر چیزی را نمایش می‌دهند:
تمامی برچسب‌های موجود، چیدمان فعلی، عنوان پنجره‌های قابل مشاهده، متن و غیره.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-v\fP, \fB\-\-version\fP
.RS 4
نمایش اطلاعات نسخه در خروجی استاندارد و سپس خروج.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش اطلاعات راهنما و سپس خروج.
.RE
.sp
\fB\-c\fP, \fB\-\-config\fP \fIفایل\fP
.RS 4
استفاده از یک فایل پیکربندی جایگزین به جای \fI$XDG_CONFIG_HOME/awesome/rc.lua\fP.
.RE
.sp
\fB\-k\fP, \fB\-\-check\fP
.RS 4
بررسی ساختار نحوی (syntax) فایل پیکربندی.
.RE
.sp
\fB\-\-search\fP
.RS 4
افزودن یک دایرکتوری به مسیر جستجوی کتابخانه‌ها.
.RE
.sp
\fB\-a\fP, \fB\-\-no\-argb\fP
.RS 4
عدم استفاده از جلوه‌های بصری ARGB.
.RE
.sp
\fB\-r\fP, \fB\-\-replace\fP
.RS 4
جایگزینی یک مدیر پنجره موجود.
.RE
.SH "کلیدهای پیش‌فرض موشواره (DEFAULT MOUSE BINDINGS)"
.SS "پیمایش (Navigation)"
.sp
\fBButton1\fP روی نام برچسب
.RS 4
مشاهده برچسب.
.RE
.sp
\fBButton4\fP, \fBButton5\fP روی نام برچسب
.RS 4
جابه‌جایی به برچسب قبلی یا بعدی.
.RE
.sp
\fBButton4\fP, \fBButton5\fP روی پنجره ریشه (root window)
.RS 4
جابه‌جایی به برچسب قبلی یا بعدی.
.RE
.sp
\fBButton1\fP, \fBButton3\fP, \fBButton4\fP, \fBButton5\fP روی نماد چیدمان
.RS 4
جابه‌جایی به چیدمان قبلی یا بعدی.
.RE
.SS "تغییر چیدمان (Layout modification)"
.sp
\fBMod4 + Button1\fP روی نام برچسب
.RS 4
برچسب‌گذاری کلاینت فعلی فقط با این برچسب.
.RE
.sp
\fBMod4 + Button3\fP روی نام برچسب
.RS 4
تغییر وضعیت فعال/غیرفعال این برچسب برای کلاینت.
.RE
.sp
\fBButton3\fP روی نام برچسب
.RS 4
افزودن این برچسب به نمای فعلی.
.RE
.sp
\fBMod4 + Button1\fP روی پنجره کلاینت
.RS 4
انتقال پنجره.
.RE
.sp
\fBMod4 + Button3\fP روی پنجره کلاینت
.RS 4
تغییر اندازه پنجره.
.RE
.SH "کلیدهای میانبر پیش‌فرض (DEFAULT KEY BINDINGS)"
.SS "راهنما (Help)"
.sp
\fBMod4 + s\fP
.RS 4
نمایش کلیدهای میانبر تخصیص‌یافته فعلی.
.RE
.SS "کنترل مدیر پنجره (Window manager control)"
.sp
\fBMod4 + Control + r\fP
.RS 4
راه‌اندازی مجدد \fBawesome\fP.
.RE
.sp
\fBMod4 + Shift + q\fP
.RS 4
خروج از \fBawesome\fP.
.RE
.sp
\fBMod4 + r\fP
.RS 4
اجرای اعلان دستور (run prompt).
.RE
.sp
\fBMod4 + x\fP
.RS 4
اجرای اعلان کد Lua.
.RE
.sp
\fBMod4 + Return\fP
.RS 4
باز کردن شبیه‌ساز پایانه (ترمینال).
.RE
.sp
\fBMod4 + w\fP
.RS 4
باز کردن منوی اصلی.
.RE
.SS "کلاینت‌ها (Clients)"
.sp
\fBMod4 + m\fP
.RS 4
بزرگ‌نمایی حداکثری کلاینت (Maximize).
.RE
.sp
\fBMod4 + n\fP
.RS 4
کمینه‌سازی کلاینت (Minimize).
.RE
.sp
\fBMod4 + Control + n\fP
.RS 4
بازگردانی اندازه کلاینت (Restore).
.RE
.sp
\fBMod4 + f\fP
.RS 4
تمام‌صفحه کردن کلاینت.
.RE
.sp
\fBMod4 + Shift + c\fP
.RS 4
بستن کلاینت دارای فوکوس (Kill).
.RE
.sp
\fBMod4 + t\fP
.RS 4
قرار دادن کلاینت در بالاترین سطح (on\-top).
.RE
.SS "پیمایش (Navigation)"
.sp
\fBMod4 + j\fP
.RS 4
فوکوس روی کلاینت بعدی.
.RE
.sp
\fBMod4 + k\fP
.RS 4
فوکوس روی کلاینت قبلی.
.RE
.sp
\fBMod4 + u\fP
.RS 4
فوکوس روی اولین کلاینت اضطراری (urgent).
.RE
.sp
\fBMod4 + Left\fP
.RS 4
مشاهده برچسب قبلی.
.RE
.sp
\fBMod4 + Right\fP
.RS 4
مشاهده برچسب بعدی.
.RE
.sp
\fBMod4 + 1\-9\fP
.RS 4
جابه‌جایی به برچسب‌های ۱\-۹.
.RE
.sp
\fBMod4 + Control + j\fP
.RS 4
فوکوس روی نمایشگر بعدی.
.RE
.sp
\fBMod4 + Control + k\fP
.RS 4
فوکوس روی نمایشگر قبلی.
.RE
.sp
\fBMod4 + Escape\fP
.RS 4
فوکوس روی مجموعه برچسب‌های انتخاب‌شده قبلی.
.RE
.SS "تغییر چیدمان (Layout modification)"
.sp
\fBMod4 + Shift + j\fP
.RS 4
تعویض جایگاه کلاینت با کلاینت بعدی.
.RE
.sp
\fBMod4 + Shift + k\fP
.RS 4
تعویض جایگاه کلاینت با کلاینت قبلی.
.RE
.sp
\fBMod4 + o\fP
.RS 4
ارسال کلاینت به نمایشگر بعدی.
.RE
.sp
\fBMod4 + h\fP
.RS 4
کاهش ضریب عرض پنجره اصلی (master) به میزان ۵٪.
.RE
.sp
\fBMod4 + l\fP
.RS 4
افزایش ضریب عرض پنجره اصلی (master) به میزان ۵٪.
.RE
.sp
\fBMod4 + Shift + h\fP
.RS 4
افزایش تعداد پنجره‌های اصلی (master) به اندازه ۱ عدد.
.RE
.sp
\fBMod4 + Shift + l\fP
.RS 4
کاهش تعداد پنجره‌های اصلی (master) به اندازه ۱ عدد.
.RE
.sp
\fBMod4 + Control + h\fP
.RS 4
افزایش تعداد ستون‌ها برای پنجره‌های غیر اصلی به اندازه ۱ عدد.
.RE
.sp
\fBMod4 + Control + l\fP
.RS 4
کاهش تعداد ستون‌ها برای پنجره‌های غیر اصلی به اندازه ۱ عدد.
.RE
.sp
\fBMod4 + space\fP
.RS 4
جابه‌جایی به چیدمان بعدی.
.RE
.sp
\fBMod4 + Shift + space\fP
.RS 4
جابه‌جایی به چیدمان قبلی.
.RE
.sp
\fBMod4 + Control + space\fP
.RS 4
تغییر وضعیت شناور بودن کلاینت.
.RE
.sp
\fBMod4 + Control + Return\fP
.RS 4
جابه‌جایی کلاینت دارای فوکوس با پنجره اصلی (master).
.RE
.sp
\fBMod4 + Control + 1\-9\fP
.RS 4
تغییر وضعیت مشاهده برچسب.
.RE
.sp
\fBMod4 + Shift + 1\-9\fP
.RS 4
برچسب‌گذاری کلاینت با برچسب.
.RE
.sp
\fBMod4 + Shift + Control + 1\-9\fP
.RS 4
تغییر وضعیت برچسب روی کلاینت.
.RE
.SH "سفارشی‌سازی (CUSTOMIZATION)"
.sp
برنامه
.B awesome
با ایجاد یک فایل سفارشی
.I $XDG_CONFIG_HOME/awesome/rc.lua
سفارشی‌سازی می‌شود.
.SH "سیگنال‌ها (SIGNALS)"
.sp
برنامه
.B awesome
می‌تواند با ارسال سیگنال SIGHUP دوباره راه‌اندازی شود.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBawesomerc\fP(5) \fBawesome\-client\fP(1)
.SH "اشکالات (BUGS)"
.sp
مسلماً هیچ اشکالی در
.B awesome
وجود ندارد! اما ممکن است رفتارهای غیرمنتظره‌ای رخ دهد.
.SH "نویسندگان (AUTHORS)"
.sp
Julien Danjou \c
.MTO "julien\(atdanjou.info" "" ""
و دیگران.
.SH "تارنما (WWW)"
.sp
.URL "https://awesomewm.org" "" ""