.TH "AERC-BINDS" "5" "2025-08-29"
.PP
.SH "نام (NAME)"
aerc-binds \- قالب فایل پیکربندی کلیدهای میانبر برای \fBaerc\fR(1)
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
فایل \fIbinds.\&conf\fR برای پیکربندی کلیدهای میانبر استفاده‌شده در کلاینت تعاملی aerc به کار می‌رود.\& انتظار می‌رود این فایل در دایرکتوری پیکربندی XDG کاربری به علاوه \fIaerc\fR قرار داشته باشد که پیش‌فرض آن \fI~/.\&config/aerc/binds.\&conf\fR است.\& اگر فایل وجود نداشته باشد، پیش‌فرض داخلی برنامه نصب خواهد شد.\& یک فایل جایگزین را می‌توان از طریق آرگومان خط فرمان \fI\-\-binds\-conf\fR مشخص کرد؛ به \fBaerc\fR(1) مراجعه کنید.\&
.PP
این فایل در قالب ini نوشته می‌شود و کلیدهای میانبر به این صورت تعریف می‌گردند:
.PP
.RS 4
\fB<ترتیب کلیدها>\fR = \fI<دستور>\fR
.PP
.RE
که در آن \fB<ترتیب کلیدها>\fR کلیدهای فشرده‌شده (به ترتیب) برای فراخوانی این میانبر است، و \fI<دستور>\fR کلیدهایی را مشخص می‌کند که aerc هنگام فراخوانی میانبر شبیه‌سازی خواهد کرد.\& به‌طور کلی از این قابلیت برای اجرای دستورات استفاده می‌شود، به عنوان مثال:
.PP
.RS 4
\fBrq\fR = \fI:reply -q<Enter>\fR
.PP
.RE
فشردن \fBr\fR، و سپس \fBq\fR، تایپ کردن \fI:reply \-q<Enter>\fR را شبیه‌سازی کرده و متناسب با آن دستور \fB:reply \-q\fR را اجرا می‌کند.\& همچنین می‌توان کلیدهای میانبر را به روشی مشابه به صورت بازگشتی فراخوانی کرد.\&
.PP
می‌توانید با نوشتن کلیدهای میانبر در \fB[sections]\fR مختلف از فایل ini، میانبرهای متفاوتی را برای زمینه‌های گوناگون پیکربندی کنید.\&
.PP
.SH "زمینه‌ها (CONTEXTS)"
.PP
زمینه‌های موجود عبارتند از:
.PP
\fB[messages]\fR
.RS 4
کلیدهای میانبر برای فهرست پیام‌ها
.PP
.RE
\fB[view]\fR
.RS 4
کلیدهای میانبر برای مشاهده‌گر پیام
.PP
.RE
\fB[view::passthrough]\fR
.RS 4
کلیدهای میانبر برای مشاهده‌گر، در حالت عبور مستقیم کلیدها
(تغییر وضعیت با \fB:toggle-key-passthrough\fR)
.PP
.RE
\fB[compose]\fR
.RS 4
کلیدهای میانبر برای بخش نگارش پیام
.PP
.RE
\fB[compose::editor]\fR
.RS 4
کلیدهای میانبر برای بخش نگارش، زمانی که ویرایشگر فعال است
.PP
.RE
\fB[compose::review]\fR
.RS 4
کلیدهای میانبر برای بخش نگارش، هنگام بازبینی رایانامه پیش از ارسال آن
.PP
برای سفارشی‌سازی توضیحات نمایش‌داده‌شده در صفحه بازبینی، یک کامنت (\fI" # "\fR) در انتهای کلید میانبر اضافه کنید.\& مثال:
.PP
.RS 4
p = :postpone<Enter> # I\(aqll work on it later
.PP
.RE
ترتیب تعریف میانبرها در صفحه بازبینی حفظ می‌شود.\& اگر یک میانبر غیرپیش‌فرض یادداشت‌گذاری نشده باشد، بدون هیچ توضیحی نمایش داده خواهد شد.\&
.PP
برای پنهان کردن یک میانبر از صفحه بازبینی، آن را صریحاً با یک کامنت \fI" # -"\fR مشخص کنید.\& مثال:
.PP
.RS 4
<C-e> = :encrypt<Enter> # -
.PP
.RE
.RE
\fB[terminal]\fR
.RS 4
کلیدهای میانبر برای زبانه‌های ترمینال
.PP
.RE
همچنین می‌توانید برای هر زمینه کلیدهای میانبر ویژه یک حساب خاص را پیکربندی کنید:
.PP
\fB[context:account=\fR\fIAccountName\fR\fB]\fR
.RS 4
کلیدهای میانبر برای این زمینه و حساب، که در آن \fIAccountName\fR یک عبارت باقاعده است که با نام حساب ارائه‌شده در \fIaccounts.\&conf\fR مطابقت دارد.\&
.PP
.RE
میانبرهای ویژه پوشه و زمینه را می‌توان برای فهرست پیام‌ها پیکربندی کرد:
.PP
\fB[messages:folder=\fR\fIFolderName\fR\fB]\fR
.br
\fB[view:folder=\fR\fIFolderName\fR\fB]\fR
.br
\fB[compose:folder=\fR\fIFolderName\fR\fB]\fR
.br
\fB[compose::editor:folder=\fR\fIFolderName\fR\fB]\fR
.br
\fB[compose::review:folder=\fR\fIFolderName\fR\fB]\fR
.RS 4
کلیدهای میانبر در این بخش مخصوص پوشه‌ای خواهند بود که با عبارت باقاعده \fIFolderName\fR مطابقت دارد.\&
میانبرهای حاصل از مشخص‌کننده پوشه نسبت به مشخص‌کننده‌های حساب اولویت خواهند داشت.
.PP
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
[messages:account=Mailbox]
c = :cf path:mailbox/** and<space>

[compose::editor:account=Mailbox2]

[compose::editor:folder=aerc]
y = :send -t aerc

[messages:folder=Drafts]
<Enter> = :recall<Enter>

[messages:folder=Archive/d+/.*]
gi = :cf Inbox<Enter>
...
.fi
.RE
.PP
همچنین می‌توانید با قرار دادن میانبرهای سراسری در ابتدای فایل، پیش از تعیین هر بخش وابسته به زمینه، آن‌ها را پیکربندی کنید.\&
.PP
میانبرهای کلیدی والد را می‌توان در میانبرهای زمینه‌ای با مشخص کردن یک میانبر "خالی" پاک کرد:
.PP
.nf
.RS 4
[compose::review]
a = :attach<space>
d = :detach<space>

[compose::review:account=no-attachments]
a =
d =
.fi
.RE
.PP
اگر می‌خواهید اقدام پیش‌فرض Delete را تغییر دهید تا به جای حذف دائمی به پوشه Trash منتقل شود:
.PP
.nf
.RS 4
d = :read<Enter>:move Trash<Enter>
#...
[messages:folder=Trash]
d = :choose -o y 'Permanently delete?' delete-message<Enter>
# And similarly for Spam
.fi
.RE
.PP
.SH "گزینه‌های ویژه (SPECIAL OPTIONS)"
.PP
علاوه بر توالی کلیدهای تعریف‌شده توسط کاربر، گزینه‌های ویژه زیر در هر زمینه کلیدهای میانبر در دسترس هستند:
.PP
\fB$noinherit\fR = \fItrue\fR|\fIfalse\fR
.RS 4
اگر روی \fItrue\fR تنظیم شود، کلیدهای میانبر سراسری در این زمینه مؤثر نخواهند بود.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fB$ex\fR = \fI<key-stroke>\fR
.RS 4
این گزینه می‌تواند روی کلیدی تنظیم شود که خط فرمان ورود دستور را در این زمینه فعال می‌کند.\&
.PP
پیش‌فرض: \fI:\fR
.PP
.RE
\fB$complete\fR = \fI<key-stroke>\fR
.RS 4
این گزینه می‌تواند روی کلیدی تنظیم شود که تکمیل خودکار دستور را در این زمینه برای ورودی‌های متنی پشتیبانی‌کننده فعال می‌سازد.\&
.PP
پیش‌فرض: \fI<tab>\fR
.PP
نکته: تکمیل خودکار دستور هنگام شبیه‌سازی کلیدها غیرفعال می‌شود و در پایان دوباره فعال می‌گردد.\& هنگامی که \fB[ui].\&completion-min-chars\fR روی \fImanual\fR تنظیم شده باشد (به \fBaerc-config\fR(5) مراجعه کنید)، می‌توان انتهای یک کلید میانبر را با کلید تکمیل قرار داد تا منوی تکمیل دستور به‌طور صریح نمایش داده شود.\& به عنوان مثال:
.PP
.RS 4
\fBo\fR = \fI:cf<space><tab>\fR
.PP
.RE
.RE
.SH "کلیدهای پشتیبانی‌شده (SUPPORTED KEYS)"
.PP
علاوه بر حروف و برخی کاراکترها (مانند \fBa\fR، \fBRR\fR، \fBgu\fR، \fB?\fR، \fB!\fR و غیره)، کلیدهای ویژه را می‌توان در \fB<angle brackets>\fR مشخص کرد.\& نحو کلیدهای تغییریافته (modified) یا ویژه به این صورت است:
.PP
.RS 4
<C-A-S-key>
.PP
.RE
که در آن C کلید control، A کلید alt، S کلید shift، و key کلید یا کاراکتر نام‌گذاری‌شده است.\&
.PP
نام‌های معتبر کلیدها عبارتند از:
.PP
.TS
allbox;l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c
l c.
T{
\fBنام\fR
T}	T{
\fBتوضیحات\fR
T}
T{
\fB<space>\fR
T}	T{
" "
T}
T{
\fB<semicolon>\fR
T}	T{
;
T}
T{
\fB<tab>\fR
T}	T{
Tab
T}
T{
\fB<enter>\fR
T}	T{
Enter
T}
T{
\fB<up>\fR
T}	T{
Up arrow (کلید جهت‌نما بالا)
T}
T{
\fB<down>\fR
T}	T{
Down arrow (کلید جهت‌نما پایین)
T}
T{
\fB<right>\fR
T}	T{
Right arrow (کلید جهت‌نما راست)
T}
T{
\fB<left>\fR
T}	T{
Left arrow (کلید جهت‌نما چپ)
T}
T{
\fB<pgup>\fR
T}	T{
Page Up (صفحه بالا)
T}
T{
\fB<pgdn>\fR
T}	T{
Page Down (صفحه پایین)
T}
T{
\fB<home>\fR
T}	T{
Home
T}
T{
\fB<end>\fR
T}	T{
End
T}
T{
\fB<insert>\fR
T}	T{
Insert
T}
T{
\fB<delete>\fR
T}	T{
Delete
T}
T{
\fB<backspace>\fR
T}	T{
Backspace
T}
T{
\fB<exit>\fR
T}	T{
Exit
T}
T{
\fB<cancel>\fR
T}	T{
Cancel
T}
T{
\fB<print>\fR
T}	T{
Print screen
T}
T{
\fB<pause>\fR
T}	T{
Pause
T}
T{
\fB<backtab>\fR
T}	T{
Shift+Tab
T}
T{
\fB<esc>\fR
T}	T{
Escape
T}
.TE
.sp 1
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBaerc\fR(1) \fBaerc-config\fR(5)
.PP
.SH "نویسندگان (AUTHORS)"
.PP
در ابتدا توسط Drew DeVault ایجاد شده و توسط Robin Jarry نگهداری می‌شود که توسط سایر مشارکت‌کنندگان متن‌باز یاری می‌گردد.\& برای اطلاعات بیشتر در مورد توسعه aerc، به \fIhttps://sr.ht/~rjarry/aerc\fR مراجعه کنید.\&