نام (NAME)

aerc-binds - قالب فایل پیکربندی کلیدهای میانبر برای aerc(1)

خلاصه دستور (SYNOPSIS)

فایل binds.conf برای پیکربندی کلیدهای میانبر استفاده‌شده در کلاینت تعاملی aerc به کار می‌رود. انتظار می‌رود این فایل در دایرکتوری پیکربندی XDG کاربری به علاوه aerc قرار داشته باشد که پیش‌فرض آن ~/.config/aerc/binds.conf است. اگر فایل وجود نداشته باشد، پیش‌فرض داخلی برنامه نصب خواهد شد. یک فایل جایگزین را می‌توان از طریق آرگومان خط فرمان --binds-conf مشخص کرد؛ به aerc(1) مراجعه کنید.

این فایل در قالب ini نوشته می‌شود و کلیدهای میانبر به این صورت تعریف می‌گردند:

<ترتیب کلیدها> = <دستور>

که در آن <ترتیب کلیدها> کلیدهای فشرده‌شده (به ترتیب) برای فراخوانی این میانبر است، و <دستور> کلیدهایی را مشخص می‌کند که aerc هنگام فراخوانی میانبر شبیه‌سازی خواهد کرد. به‌طور کلی از این قابلیت برای اجرای دستورات استفاده می‌شود، به عنوان مثال:

rq = :reply -q<Enter>

فشردن r، و سپس q، تایپ کردن :reply -q<Enter> را شبیه‌سازی کرده و متناسب با آن دستور :reply -q را اجرا می‌کند. همچنین می‌توان کلیدهای میانبر را به روشی مشابه به صورت بازگشتی فراخوانی کرد.

می‌توانید با نوشتن کلیدهای میانبر در [sections] مختلف از فایل ini، میانبرهای متفاوتی را برای زمینه‌های گوناگون پیکربندی کنید.

زمینه‌ها (CONTEXTS)

زمینه‌های موجود عبارتند از:

[messages]

کلیدهای میانبر برای فهرست پیام‌ها

[view]

کلیدهای میانبر برای مشاهده‌گر پیام

[view::passthrough]

کلیدهای میانبر برای مشاهده‌گر، در حالت عبور مستقیم کلیدها (تغییر وضعیت با :toggle-key-passthrough)

[compose]

کلیدهای میانبر برای بخش نگارش پیام

[compose::editor]

کلیدهای میانبر برای بخش نگارش، زمانی که ویرایشگر فعال است

[compose::review]

کلیدهای میانبر برای بخش نگارش، هنگام بازبینی رایانامه پیش از ارسال آن

برای سفارشی‌سازی توضیحات نمایش‌داده‌شده در صفحه بازبینی، یک کامنت (" # ") در انتهای کلید میانبر اضافه کنید. مثال:

p = :postpone<Enter> # I'll work on it later

ترتیب تعریف میانبرها در صفحه بازبینی حفظ می‌شود. اگر یک میانبر غیرپیش‌فرض یادداشت‌گذاری نشده باشد، بدون هیچ توضیحی نمایش داده خواهد شد.

برای پنهان کردن یک میانبر از صفحه بازبینی، آن را صریحاً با یک کامنت " # -" مشخص کنید. مثال:

<C-e> = :encrypt<Enter> # -

[terminal]

کلیدهای میانبر برای زبانه‌های ترمینال

همچنین می‌توانید برای هر زمینه کلیدهای میانبر ویژه یک حساب خاص را پیکربندی کنید:

[context:account=AccountName]

کلیدهای میانبر برای این زمینه و حساب، که در آن AccountName یک عبارت باقاعده است که با نام حساب ارائه‌شده در accounts.conf مطابقت دارد.

میانبرهای ویژه پوشه و زمینه را می‌توان برای فهرست پیام‌ها پیکربندی کرد:

[messages:folder=FolderName]
[view:folder=FolderName]
[compose:folder=FolderName]
[compose::editor:folder=FolderName]
[compose::review:folder=FolderName]

کلیدهای میانبر در این بخش مخصوص پوشه‌ای خواهند بود که با عبارت باقاعده FolderName مطابقت دارد. میانبرهای حاصل از مشخص‌کننده پوشه نسبت به مشخص‌کننده‌های حساب اولویت خواهند داشت.

مثال‌ها (EXAMPLES)

[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>

همچنین می‌توانید با قرار دادن میانبرهای سراسری در ابتدای فایل، پیش از تعیین هر بخش وابسته به زمینه، آن‌ها را پیکربندی کنید.

میانبرهای کلیدی والد را می‌توان در میانبرهای زمینه‌ای با مشخص کردن یک میانبر "خالی" پاک کرد:

[compose::review]
a = :attach<space>
d = :detach<space>
[compose::review:account=no-attachments]
a =
d =

اگر می‌خواهید اقدام پیش‌فرض Delete را تغییر دهید تا به جای حذف دائمی به پوشه Trash منتقل شود:

d = :read<Enter>:move Trash<Enter>
#...
[messages:folder=Trash]
d = :choose -o y 'Permanently delete?' delete-message<Enter>
# And similarly for Spam

گزینه‌های ویژه (SPECIAL OPTIONS)

علاوه بر توالی کلیدهای تعریف‌شده توسط کاربر، گزینه‌های ویژه زیر در هر زمینه کلیدهای میانبر در دسترس هستند:

$noinherit = true|false

اگر روی true تنظیم شود، کلیدهای میانبر سراسری در این زمینه مؤثر نخواهند بود.

پیش‌فرض: false

$ex = <key-stroke>

این گزینه می‌تواند روی کلیدی تنظیم شود که خط فرمان ورود دستور را در این زمینه فعال می‌کند.

پیش‌فرض: :

$complete = <key-stroke>

این گزینه می‌تواند روی کلیدی تنظیم شود که تکمیل خودکار دستور را در این زمینه برای ورودی‌های متنی پشتیبانی‌کننده فعال می‌سازد.

پیش‌فرض: <tab>

نکته: تکمیل خودکار دستور هنگام شبیه‌سازی کلیدها غیرفعال می‌شود و در پایان دوباره فعال می‌گردد. هنگامی که [ui].completion-min-chars روی manual تنظیم شده باشد (به aerc-config(5) مراجعه کنید)، می‌توان انتهای یک کلید میانبر را با کلید تکمیل قرار داد تا منوی تکمیل دستور به‌طور صریح نمایش داده شود. به عنوان مثال:

o = :cf<space><tab>

کلیدهای پشتیبانی‌شده (SUPPORTED KEYS)

علاوه بر حروف و برخی کاراکترها (مانند a، RR، gu، ?، ! و غیره)، کلیدهای ویژه را می‌توان در <angle brackets> مشخص کرد. نحو کلیدهای تغییریافته (modified) یا ویژه به این صورت است:

<C-A-S-key>

که در آن C کلید control، A کلید alt، S کلید shift، و key کلید یا کاراکتر نام‌گذاری‌شده است.

نام‌های معتبر کلیدها عبارتند از:

نام	توضیحات
<space>	" "
<semicolon>	;
<tab>	Tab
<enter>	Enter
<up>	Up arrow (کلید جهت‌نما بالا)
<down>	Down arrow (کلید جهت‌نما پایین)
<right>	Right arrow (کلید جهت‌نما راست)
<left>	Left arrow (کلید جهت‌نما چپ)
<pgup>	Page Up (صفحه بالا)
<pgdn>	Page Down (صفحه پایین)
<home>	Home
<end>	End
<insert>	Insert
<delete>	Delete
<backspace>	Backspace
<exit>	Exit
<cancel>	Cancel
<print>	Print screen
<pause>	Pause
<backtab>	Shift+Tab
<esc>	Escape

همچنین ببینید (SEE ALSO)

aerc(1) aerc-config(5)

نویسندگان (AUTHORS)

در ابتدا توسط Drew DeVault ایجاد شده و توسط Robin Jarry نگهداری می‌شود که توسط سایر مشارکت‌کنندگان متن‌باز یاری می‌گردد. برای اطلاعات بیشتر در مورد توسعه aerc، به https://sr.ht/~rjarry/aerc مراجعه کنید.