.\" Process this file with .\" groff -man -Tascii bashrun.1 .\" .TH BASHRUN 1 "June 2009" Linux "User Manuals" .SH "نام (NAME)" bashrun \- راه‌انداز برنامه‌ها و ابزار اجرای دستورات مبتنی بر بش .SH "خلاصه دستور (SYNOPSIS)" .B bashrun .I [گزینه‌ها] .SH "توضیحات (DESCRIPTION)" .B bashrun یک راه‌انداز ساده برنامه‌ها برای X11 است. این ابزار یک نشست bash را درون یک پنجره کوچک XTerminal اجرا می‌کند و به‌راحتی تمام قابلیت‌های متداول bash مانند readline، تکمیل با کلید Tab و تاریخچه را فراهم می‌سازد، در حالی که ویژگی‌های بیشتری مانند نشانک‌ها (bookmarks)، گرداننده‌های مبتنی بر عبارات باقاعده (regexp)، جستجو در فرهنگ لغت و جستجوی گوگل را نیز اضافه می‌کند. .PP .B bashrun بسته به این‌که آیا .BR xdotool (1) روی سیستم نصب شده باشد یا خیر، دو حالت عملکرد پایه را ارائه می‌دهد. .PP اگر .BR xdotool (1) در دسترس باشد، پنجره ترمینال میزبان نشست bash در پس‌زمینه و پنهان از دید در حال اجرا باقی می‌ماند. فراخوانی .B bashrun یا .B bashrun \-\-show پنجره را نمایان کرده و فوکوس را به آن می‌دهد؛ پس از صدور یک دستور، پنجره ترمینال دوباره از دید پنهان خواهد شد. این روش زمان راه‌اندازی را کاهش داده و در منابع سیستم صرفه‌جویی می‌کند. .PP اگر .BR xdotool (1) نصب نشده باشد، در هر بار فراخوانی یک نمونه جدید ایجاد می‌شود و بلافاصله پس از اجرای اولین دستور خاتمه می‌یابد. .SH "گزینه‌ها (OPTIONS)" .B .IP \-v,\ \-\-version چاپ اطلاعات نسخه .B .IP \-h,\ \-\-help چاپ اطلاعات نحوه استفاده .B .IP \-d,\ \-\-debug شروع در حالت اشکال‌زدایی (debug) .PP اگر .BR xdotool (1) در دسترس باشد، گزینه‌های زیر یک نمونه در حال اجرای bashrun را از فراخوانی‌های بعدی کنترل می‌کنند. توجه داشته باشید که اگر نمونه قبلی از bashrun یافت نشود، گزینه‌های \fB\-\-show\fP، \fB\-\-toggle\fP، \fB\-\-restart\fP، \fB\-\-su\fP و \fB\-\-debug\fP یک نشست جدید bashrun را آغاز خواهند کرد. .RS .B .IP \-\-show نمایش پنجره و فوکوس روی آن .B .IP \-\-hide پنهان کردن پنجره .B .IP \-\-toggle تغییر وضعیت نمایان یا پنهان بودن پنجره .B .IP \-\-exit خاتمه دادن به یک فرآیند موجود bashrun .B .IP \-\-restart راه‌اندازی مجدد bashrun (برای اعمال تغییرات فایل پیکربندی الزامی است) .B .IP \-\-su\ command اجرای دستور با دسترسی‌های ریشه (root). پنجره ترمینال bashrun را برای ورود گذرواژه باز می‌کند. .B .IP \-\-remote\ type\ \ key\ \ ... تایپ متن در bashrun و فراخوانی توالی کلیدها از راه دور. برای نحو ساختاری \fB\fP، به دستور \fBkey\fP در .BR xdotool (1) مراجعه کنید. .B .IP \-\-wid چاپ شناسه پنجره (window id) ترمینال .B .IP \-\-wait صبر کردن تا زمانی که پنجره ترمینال پنهان (unmapped) شود .B .IP \-\-debug تغییر وضعیت حالت اشکال‌زدایی .RE .SH "اجرای دستورات (RUNNING COMMANDS)" اجرای دستورات ساده سرراست است. پوسته گسترش‌های معمول را انجام می‌دهد و دستور حاصل مطابق با کنش درخواستی و اولویت‌های کاربر پردازش و راه‌اندازی می‌شود. .PP چندین دستور که با \fB;\fP از هم جدا شده‌اند به همین ترتیب متوالی پردازش می‌شوند. .PP اگر دستورات با یک علامت لوله (\fB|\fP) یا با عملگرهای منطقی \fB||\fP یا \fB&&\fP جدا شوند، رفتار bashrun تفاوت چشمگیری با رفتار معمول پوسته خواهد داشت. برای پوسته bashrun، هر دستور ساده در یک عبارت مرکب به گونه‌ای به نظر می‌رسد که گویی بلافاصله با موفقیت پایان یافته است. این بدان معنی است که جدا کردن دستورات با \fB&&\fP یا \fB|\fP عملاً معادل استفاده از \fB;\fP است. جدا کردن دستورات با \fB||\fP مانع از اجرای دستورات سمت راست عبارت خواهد شد. .PP برای دور زدن این رفتار، کاراکترهای \fB;\fP، \fB&\fP و \fB|\fP را می‌توان با یک کاراکتر بک‌اسلش (\fB\\\fP) اسکیپ کرد. لطفاً توجه داشته باشید که در این حالت قواعد ترمینال تنها بر اساس نام دستور اول اعمال می‌شوند. برای نمونه، دستوری مانند \fB$ cat textfile | wc -l \fP آن‌طور که در نظر گرفته شده کار نخواهد کرد و در عوض خروجی هر دو دستور را در ترمینال‌های جداگانه صفحه‌بندی می‌کند، بدون این‌که لوله‌ای میان دستورات ایجاد شود. برای این‌که تعداد خطوط موجود در \fBtextfile\fP مطابق انتظار در یک پنجره واحد ترمینال صفحه‌بندی شود، باید از دستور زیر استفاده کنید: \fB$ cat textfile \\| wc -l \fP .PP ویرایش چندخطی در bashrun کار نمی‌کند. اگر احیاناً بستن علامت نقل‌قول (quote) را در خط فرمان فراموش کنید، bashrun از شما می‌خواهد که \fBC-c\fP را فشار دهید. پس از این کار ممکن است آخرین خط تاریخچه شما نامعتبر شود. .PP برای اجرای دستورات در زمینه نشست پوسته bashrun به جای پردازش آن‌ها توسط bashrun، از کنش \fB\fP (پیش‌فرض: \fBM-w\fP) استفاده کنید. .SH "فایل پیکربندی صفحه‌کلید (KEYBOARD CONFIGURATION FILE)" کلیدهای میانبر را می‌توان در فایل پیکربندی صفحه‌کلید \fI$XDG_CONFIG_HOME/bashrun/keys\fP پیکربندی کرد. این فایل شامل دستورالعمل‌های \fBkeymap\fP و تعاریف \fBkeybinding\fP است. .PP دستورالعمل \fBkeymap\fP مشخص می‌کند که تعاریف بعدی \fBkeybinding\fP به کدام نگاشت کلید readline متصل شوند. ساختار دستوری به صورت زیر است: \fBKEYMAP \fP که در آن \fB\fP یکی از مقادیر \fIemacs\fP، \fIvi-insert\fP یا \fIvi-command\fP است. .PP ساختار دستوری برای تعاریف \fBkeybinding\fP به صورت زیر است: \fB []\fP که در آن \fB\fP نام کنش bashrun است (بخش \fBکنش‌ها (ACTIONS)\fP در زیر را ببینید)، \fBkeyseq\fP یک توالی کلید معتبر در .BR readline (1) است، و \fB\fP یک نام اختیاری و خوانا برای توالی کلید است (که برای نمایش میانبرها به کاربر استفاده می‌شود). .PP لطفاً توجه داشته باشید که تمام توالی‌های کلیدی که با \fBC-x[0-9]\fP شروع می‌شوند و همچنین کاراکترهای دقیق .B \\\\201 تا .B \\\\209 برای استفاده داخلی رزرو شده‌اند و قابل استفاده نیستند. .PP خطوطی که با \fB#\fP شروع می‌شوند توضیح (کامنت) هستند و نادیده گرفته می‌شوند. .SH "کنش‌ها (ACTIONS)" این بخش تمام کنش‌هایی را که می‌توان به توالی‌های کلید متصل کرد فهرست می‌کند. برای نمایش کلیدهای میانبر فعلی، از کنش \fB\fP (پیش‌فرض: \fBF1\fP) استفاده کنید. .B .IP quit خروج از bashrun. نشست پوسته bashrun را خاتمه می‌دهد. .B .IP abort پنهان کردن پنجره (با استفاده از xdotool) یا خروج. .B .IP pass اجرای دستور در زمینه نشست پوسته bashrun؛ بررسی و مدیریت دستور را دور می‌زند. .B .IP run اجرای دستور. .B .IP term-run اجرای دستور در یک ترمینال. .B .IP term-hold اجرای دستور در یک ترمینال و باز نگه‌داشتن آن پس از پایان. .B .IP term-page اجرای دستور در یک ترمینال و صفحه‌بندی خروجی با استفاده از \fBPAGER\fP. .B .IP su-run اجرای دستور با دسترسی ریشه (root). ابتدا گذرواژه از شما پرسیده می‌شود. .B .IP su-term-run اجرای دستور با دسترسی ریشه در یک ترمینال. .B .IP su-term-hold اجرای دستور با دسترسی ریشه در یک ترمینال و باز نگه‌داشتن آن پس از پایان. .B .IP su-term-page اجرای دستور با دسترسی ریشه در یک ترمینال و صفحه‌بندی خروجی با استفاده از \fBPAGER\fP. .B .IP show-manual نمایش صفحه راهنمای دستور در یک ترمینال. .B .IP show-info نمایش صفحه info برای دستور در یک ترمینال. .B .IP show-help صفحه‌بندی راهنمای دستورات داخلی بش (bash builtins) در ترمینال. اگر دستور از دستورات داخلی بش نباشد، تلاش می‌کند تا صفحه راهنما (man) را نشان دهد. .B .IP copy کپی کردن خروجی دستور به کلیپ‌بورد (با استفاده از xclip). .B .IP copy-paste کپی کردن خروجی دستور و الصاق آن در پنجره زیر نشانگر ماوس (با استفاده از xclip و xdotool). .B .IP filter هدایت محتویات کلیپ‌بورد به ورودی دستور از طریق پایپ و کپی کردن خروجی به کلیپ‌بورد (با استفاده از xclip). .B .IP filter-paste هدایت محتویات کلیپ‌بورد به ورودی دستور از طریق پایپ و کپی خروجی در کلیپ‌بورد، سپس الصاق آن در پنجره زیر نشانگر ماوس (با استفاده از xclip و xdotool). .B .IP browse مرور کلمات در \fBBROWSER\fP، بخش \fBفایل پیکربندی (CONFIGURATION FILE)\fP را ببینید. .B .IP google-search جستجوی کلمات در گوگل با استفاده از \fBBROWSER\fP، بخش \fBفایل پیکربندی (CONFIGURATION FILE)\fP را ببینید. .B .IP dict-lookup جستجوی کلمات در فرهنگ لغت، نیازمند .BR dict (1) یا ابزار مشابه است. برای استفاده از کلاینت دیگر، از گزینه پیکربندی \fBDICT_CLIENT\fP استفاده کنید، بخش \fBفایل پیکربندی (CONFIGURATION FILE)\fP را ببینید. .B .IP bashrun-bindings نمایش کلیدهای میانبر فعلی در یک ترمینال. .B .IP bashrun-manual نمایش این راهنما در یک ترمینال. .B .IP bashrun-handlers نمایش \fBHANDLERS\fP فعلی در یک ترمینال. .B .IP bashrun-debug فعال یا غیرفعال کردن پیام‌های اشکال‌زدایی. متغیر .B KEEP_OPEN را تنظیم کرده و در صورت پشتیبانی، اندازه ترمینال را به 80x24 تغییر می‌دهد. .B .IP toggle-size جابه‌جایی بین اندازه‌های "کوچک" (small) و "بزرگ" (large) (فقط برای xterm و rxvt*). بخش \fBفایل پیکربندی (CONFIGURATION FILE)\fP را ببینید. .B .IP resize-[up|down|left|right] تغییر اندازه ترمینال (فقط برای xterm و rxvt*). .PP .SH "فایل پیکربندی (CONFIGURATION FILE)" فایل پیکربندی کاربر .I $XDG_CONFIG_HOME/bashrun/rc به عنوان فایل rc برای نشست bash مورد استفاده توسط bashrun بارگذاری (source) می‌شود. به غیر از متغیرهای محیطی شرح داده شده در این‌جا، می‌توانید هر چیزی را که معمولاً به فایل .I ~/.bashrc خود اضافه می‌کنید به این فایل نیز بیافزایید. به عنوان مثال، ممکن است بخواهید توابع یا نام‌های مستعار اضافه کنید، کلیدهای تابعی دیگر را اختصاص دهید یا به سادگی فایل .I ~/.bashrc موجود خود را source کنید. .PP لطفاً اطمینان حاصل کنید که با تنظیمات tty/bash و میانبرهای رزرو شده توسط bashrun تداخلی ایجاد نمی‌کنید. بخش‌های .B فایل پیکربندی صفحه‌کلید (KEYBOARD CONFIGURATION FILE) و .B متغیرهای محیطی (ENVIRONMENT) را ببینید یا نگاهی به \fI$PREFIX/share/bashrun/bashrc\fP بیندازید. .PP .B XTERM=[xterm|rxvt|urxvt|urxvtc|mrxvt|aterm|mlterm] (پیش‌فرض: xterm) .RS ترمینال مورد استفاده برای bashrun. .RE .PP .B XTERM_OPTIONS=[...] (پیش‌فرض: خالی) .RS گزینه‌های خط فرمان اضافی برای ارسال به ترمینال. .RE .PP .B KEEP_OPEN=[yes|no] (پیش‌فرض: no) .RS در صورت تنظیم روی "yes"، ترمینال پس از هر دستور پنهان نخواهد شد. فراخوانی‌های بعدی .B bashrun یا .B bashrun \-\-show روی پنجره ترمینال فوکوس می‌کنند، و .B یا .B bashrun \-\-hide فوکوس را از پنجره برداشته و به برنامه‌ای که قبلاً فوکوس داشته است بازمی‌گردانند. .RE .PP .B SMALL_COLUMNS=n, SMALL_LINES=n (پیش‌فرض: 40x1) .RS اندازه ترمینال در حالت پیش‌فرض "کوچک" (small). .RE .PP .B LARGE_COLUMNS=n, LARGE_LINES=n (پیش‌فرض: 40x8) .RS اندازه ترمینال در حالت "بزرگ" (large) که از طریق .B تغییر می‌کند (فقط xterm و rxvt*). .RE .PP .B FGCOLOR=color, BGCOLOR=color (پیش‌فرض: grey on black) .RS رنگ پیش‌زمینه و پس‌زمینه ترمینال. برای مقادیر ممکن به مستندات ترمینال خود مراجعه کنید. .RE .PP .B PS1=[...] (پیش‌فرض: '>') .RS رشته اعلان (prompt)، به .BR bash (1) مراجعه کنید. .RE .PP .B HISTCONTROL (پیش‌فرض: ignoredups:erasedups) .RS تنظیمات تاریخچه، به .BR bash (1) مراجعه کنید. .RE .PP .B COMPLETION_TYPE=[complete|menu-complete|quiet-complete] (پیش‌فرض: menu-complete) .RS برای \fBcomplete\fP و \fBmenu-complete\fP، به \fBbash\fP(1) مراجعه کنید. حالت \fBquiet-complete\fP از \fBcomplete\fP استفاده کرده و علاوه بر آن متغیرهای readline زیر را تنظیم می‌کند: page-completions off print-completions-horizontally on completion-query-items -1 .PP حالت \fBquiet-complete\fP زمانی مفید است که می‌خواهید تکمیل خودکار رفتاری شبیه به \fBcomplete\fP داشته باشد اما خطوط اعلان readline مزاحم آن نشوند. اگرچه گزینه‌های تکمیل در واقع چاپ می‌شوند، اما در یک ترمینال تک‌خطی عملاً آن‌ها را نخواهید دید. .RE .PP .B ALTERNATIVE_COMPLETION_TYPE=[complete|menu-complete|quiet-complete] (پیش‌فرض: complete) .RS نوع تکمیل خودکار برای جابه‌جایی به آن در صورتی که LINES >= COMPLETION_THRESHOLD باشد، توضیحات زیر را ببینید. .RE .PP .B COMPLETION_THRESHOLD=[num_lines] (پیش‌فرض: LARGE_LINES) .RS اگر تعداد LINES در ترمینال برابر یا بیشتر از این مقدار باشد، به ALTERNATIVE_COMPLETION_TYPE تغییر وضعیت می‌دهد. اگر مقدار کمتر از ۱ باشد، این قابلیت غیرفعال می‌شود. .RE .PP (نکته: تنظیمات پیش‌فرض برای این گزینه‌ها منجر به استفاده از \fBmenu-complete\fP در حالت "کوچک" و \fBcomplete\fP در حالت "بزرگ" می‌شود.) .PP .B USE_EXTENDED_BASH_COMPLETION=[yes|no] (پیش‌فرض: no) .RS آیا از تکمیل خودکار گسترش‌یافته bash استفاده شود یا خیر. .RE .PP .B EXTENDED_BASH_COMPLETION_PATH=[path] .PP .RS .B (پیش‌فرض: /etc/profile.d/bash_completion.sh) مسیر اسکریپتی که تکمیل خودکار گسترش‌یافته bash را فعال می‌کند. به مستندات توزیع خود مراجعه کنید. .RE .PP .B POST_MAP_COMMAND=[command] (پیش‌فرض: تنظیم نشده) .RS دستوری که مستقیماً پس از نمایان ساختن پنجره توسط xdotool اجرا می‌شود. به عنوان مثال هنگام اجرای \fBxcompmgr\fP می‌توانید با استفاده از دستور .B transset -a 0.75 شفافیت پنجره را روی ۷۵٪ تنظیم کنید. .RE .PP .B DICT_CLIENT=[command] (پیش‌فرض: dict --pager $PAGER) .RS کلاینت دیکشنری مورد استفاده برای کنش \fB\fP. در صورت لزوم، کلاینت خود را به TERMINAL_RULES اضافه کنید. .RE .PP .B DIRHANDLER=[command] (پیش‌فرض: تنظیم نشده) .RS دستوری که هنگام وارد کردن مسیر یک دایرکتوری و در صورت خوانا بودن آن دایرکتوری اجرا می‌شود. مسیر به عنوان اولین آرگومان به دستور مشخص‌شده ارسال خواهد شد. .RE .PP .B BROWSER=[command] (پیش‌فرض: firefox) .RS مرورگر مورد استفاده برای جستجوی گوگل و گرداننده‌های پیش‌فرض (توضیحات زیر را ببینید). .RE .PP .B GOOGLE_FALLBACK=[yes|no] (پیش‌فرض: no) .RS اگر روی .B yes تنظیم شود، در صورتی که دستور واردشده قابل اجرا نباشد یا توسط .B HANDLERS یا .B DIRHANDLER مدیریت نشود، bashrun به طور خودکار خط فرمان را در گوگل جستجو می‌کند. .RE .PP .B TERMINAL_RULES=('RUN:[progs]' 'PAGE:[progs]' 'HOLD:[progs]') .RS آرایه‌ای شامل رشته‌های قواعد که تعیین می‌کنند کدام برنامه‌ها باید همیشه در یک پنجره ترمینال اجرا شوند. فهرستی از نام برنامه‌ها را که با فاصله از هم جدا شده‌اند بعد از \fB:\fP در رشته قاعده مورد نظر وارد کنید. برنامه‌های موجود در قاعده \fBRUN\fP همیشه در یک ترمینال اجرا می‌شوند. برنامه‌های موجود در قاعده \fBPAGE\fP خروجی‌شان در \fBPAGER\fP صفحه‌بندی می‌شود. برای برنامه‌های موجود در قاعده \fBHOLD\fP، پنجره ترمینال پس از پایان برنامه باز می‌ماند. .PP مثال: TERMINAL_RULES=( "RUN:watch top htop less man info ncftp links" "HOLD:ps su" "PAGE:echo ls which uname lsusb lshal lsmod fortune" ) .RE .PP .B HANDLERS=([regexp handler]...) (پیش‌فرض‌ها: در زیر آمده است) .RS آرایه‌ای شامل عبارات باقاعده bash و رشته‌های گرداننده مرتبط با آن‌ها. اگر خط فرمان واردشده در bashrun قابل اجرا نباشد (یعنی یک تابع، نام مستعار یا فایل اجرایی در \fPPATH\fP نباشد)، آن‌گاه تلاشی برای تطبیق پی‌درپی خط فرمان با الگوهای موجود در \fBHANDLERS\fP صورت می‌گیرد. اگر الگویی مطابقت داشته باشد، یا رشته گرداننده پس از الگو به عنوان دستور اجرا استفاده می‌شود و خود خط فرمان به عنوان آرگومان به آن ارسال می‌گردد، یا اگر عبارت باقاعده شامل زیرالگوهایی درون پرانتز باشد، تلاشی برای جایگزینی رخدادهای .B $[1-9] در رشته گرداننده با محتویات زیرالگوی منطبق متناظر صورت می‌گیرد. سپس رشته گرداننده تغییریافته به عنوان خط فرمان بدون افزودن آرگومان‌های بیشتر استفاده می‌شود. .PP اگر تعداد زیرالگوهای منطبق برای جایگزینی هر رخداد \fB$[0-9]\fP در رشته گرداننده کافی نباشد، گرداننده اجرا نخواهد شد و یک پیام خطا برای کاربر صادر می‌شود. .PP رشته گرداننده علاوه بر این می‌تواند با یک عبارت آزمون فایل پیشوند شود که مجموعه‌ای از آزمون‌های فایل را تعیین می‌کند که باید پیش از اعمال گرداننده روی محتویات خط فرمان انجام شوند. اگر هر یک از این آزمون‌ها شکست بخورد، گرداننده اعمال نخواهد شد. .PP عبارت آزمون مجموعه‌ای از کاراکترها است که متناظر با عملگرهای آزمون تک‌عضوی فایل تعریف‌شده در بخش .B عبارات شرطی (CONDITIONAL EXPRESSIONS) راهنمای .BR bash (1) است و با علامت \fB:\fP خاتمه می‌یابد. آزمون‌های فایل را می‌توان با قرار دادن یک پیشوند \fB!\fP منفرد نقیض کرد. به عنوان مثال، یک گرداننده با پیشوند \fBf!x:\fP تنها زمانی اعمال می‌شود که خط فرمان مسیری به یک فایل معمولی و غیرقابل اجرا باشد. .PP به عنوان مثال، برای تعریف ارتباط فایل‌ها برای فایل‌های jpeg می‌توانید از یک الگو و گرداننده مانند زیر استفاده کنید: \fB'\\.jpe?g$' 'f!x:gimp'\fP این الگو خطوطی را که به \fB.jpg\fP یا \fB.jpeg\fP ختم می‌شوند با استفاده از \fBgimp\fP(1) باز می‌کند. آزمون فایل تضمین می‌کند که همچنان می‌توانید خطی مانند \fB$ convert foo.tif foo.jpg\fP را تایپ کنید و پردازش نشود، اگرچه این خط نیز به \fB.jpg\fP ختم می‌شود. این به این دلیل است که عبارت آزمون روی کل خط اعمال می‌شود، بنابراین آزمون \fBf!x\fP ناموفق خواهد بود. .PP برای باز کردن خطوطی که با \fBhttp\fP یا \fBhttps\fP شروع می‌شوند در \fBBROWSER\fP، خطی مانند زیر را به آرایه \fBHANDLERS\fP اضافه کنید: \fB'^https?' "$BROWSER"\fP برای پیاده‌سازی میانبرهای وب شبیه به مرورگر konqueror در KDE، از الگویی حاوی زیرالگو مانند زیر استفاده کنید: \fB'^gg:(.+)'\fP و از خطی مانند این به عنوان رشته گرداننده استفاده کنید: \fB"$BROWSER 'http://www.google.com/search?q=\\$1'"\fP ابزار bashrun بخش \fB$1\fP در رشته گرداننده را با هر آن‌چه کاربر پس از \fBgg:\fP وارد کرده باشد جایگزین خواهد کرد. .PP برای مثال‌های بیشتر به فایل پیکربندی پیش‌فرض کاربر مراجعه کنید. اگر گرداننده‌های شما طبق انتظار کار نمی‌کنند، حالت اشکال‌زدایی را فعال کنید تا متوجه شوید چه روندی در جریان است. .PP اگر از فایل پیکربندی پیش‌فرض استفاده شود یا .B HANDLERS در فایل پیکربندی کاربر تنظیم نشده باشد، گرداننده‌های زیر به طور پیش‌فرض تنظیم می‌شوند: .B .IP ^www,\ ^https? باز کردن خطوط شروع‌شده با www، http یا https در \fBBROWSER\fP .B .IP ^gg:(.+) جستجو در گوگل .B .IP ^ggl:(.+) جستجو در گوگل با استفاده از "I'm feeling lucky" .B .IP ^fm:(.+) جستجوی پروژه در freshmeat.net .B .IP ^sf:(.+) مشاهده صفحه پروژه در sourceforge.net .B .IP ^sfw:(.+) مشاهده وب‌سایت پروژه در sourceforge.net .B .IP \e.jpe?g$ باز کردن فایل‌های JPEG در gimp، با استفاده از \fBf!x\fP به عنوان عبارت آزمون .B .IP ^ftp:(.+) شروع \fBncftp $1\fP در xterm .B .IP ^\e?(.+) صفحه‌بندی \fB$1 --help\fP در xterm .B .IP ^\e?\e?(.+) نمایش \fBman $1\fP در xterm .RE .PP .B BOOKMARKS=([bookmark]...) (پیش‌فرض: مثال را ببینید) .RS آرایه‌ای از رشته‌ها که به گزینه‌های ممکن برای تکمیل دستور اضافه می‌شوند. اطمینان حاصل کنید که برای هر یک از رشته‌هایی که به عنوان نشانک استفاده می‌شوند، یک گرداننده در .B HANDLERS تعریف شده باشد. مثال: BOOKMARKS=( www.google.com www.archlinux.org www.slashdot.org www.linux.com http://bashrun.sourceforge.net ) .RE .B LOGFILE=[path] (پیش‌فرض: /dev/null) .RS خروجی دستورات (خروجی استاندارد و خطای استاندارد) به انتهای LOGFILE الحاق می‌شود. اگر فایل وجود نداشته باشد، bashrun برای ایجاد آن تلاش خواهد کرد. اگر قابل نوشتن نباشد، خروجی در عوض به \fB/dev/null\fP هدایت می‌شود. .PP ثبت وقایع (لاگینگ) برای دستوراتی که با دسترسی ریشه اجرا می‌شوند غیرفعال است. .RE .SH "فایل‌ها (FILES)" .I $XDG_CONFIG_HOME/bashrun/rc .RS فایل پیکربندی کاربر. اگر وجود نداشته باشد، ایجاد شده و با پیکربندی پیش‌فرض مقداردهی اولیه می‌شود. .PP .RE .I $XDG_CONFIG_HOME/bashrun/keys .RS فایل پیکربندی صفحه‌کلید. اگر وجود نداشته باشد، ایجاد شده و با کلیدهای میانبر پیش‌فرض مقداردهی اولیه می‌شود. .PP .RE اگر از .BR xdotool (1) استفاده می‌شود، برای اعمال تغییرات این فایل‌ها باید bashrun مجدداً راه‌اندازی شود. .PP اگر .B XDG_CONFIG_HOME تنظیم نشده یا خالی باشد، در عوض از .B ~/.config استفاده خواهد شد. .RE .PP .I $XDG_DATA_HOME/bashrun/history .RS فایل تاریخچه استفاده‌شده توسط bashrun. اگر .B XDG_DATA_HOME تنظیم نشده یا خالی باشد، در عوض از .B ~/.local/share استفاده خواهد شد. .RE .PP .I $XDG_CACHE_HOME/bashrun/ .RS دایرکتوری فایل‌های موقت ایجاد شده توسط bashrun. اگر .B XDG_CACHE_HOME تنظیم نشده یا خالی باشد، در عوض از .B ~/.cache استفاده خواهد شد. .RE .SH "متغیرهای محیطی (ENVIRONMENT)" .IP X11 مشخصه‌های مدیر پنجره .B WM_CLASS و .B WM_NAME روی "bashrun" تنظیم می‌شوند. این مشخصه‌ها می‌توانند با امکانات مدیر پنجره شما برای پیکربندی بیشتر ظاهر bashrun استفاده شوند. توجه داشته باشید که اگر از .BR xdotool (1) استفاده می‌کنید، توصیه می‌شود پنجره bashrun را چسبان (sticky) کنید تا مطمئن شوید همیشه در دسکتاپ فعلی ظاهر می‌شود. .IP BASH .RS گزینه پوسته .B extdebug فعال است. هر بار که خط فرمانی صادر می‌شود یک تله (trap) روی .B DEBUG تنظیم می‌گردد. این تله پس از پردازش خط فرمان دوباره غیرفعال می‌شود تا از تداخل آن با ویرایش تعاملی خط فرمان جلوگیری کند. .PP ارسال .B ^D (eof) روی یک خط خالی در صورتی که از .BR xdotool (1) استفاده شود، پوسته را خاتمه نمی‌دهد. به .BR stty (1) مراجعه کنید. .PP کنترل جریان \fBXON/XOFF\fP (تعلیق/ازسرگیری ترمینال از طریق \fBC-s\fP و \fBC-q\fP) غیرفعال است. در صورت استفاده از میانبرهای پیش‌فرض، \fBC-s\fP در بافر تاریخچه به سمت جلو جستجو می‌کند (پیش‌فرض readline) در حالی که \fBC-q\fP به کنش \fB\fP متصل است. به .BR stty (1) مراجعه کنید. .PP .RE .SH "مشکلات شناخته‌شده (KNOWN ISSUES)" برخی از ترمینال‌ها نیاز به نقل‌قول (quoting) خط فرمان در حال اجرا دارند. این بدان معنی است که اجرای خطوط فرمان با تعداد زیادی نقل‌قول ممکن است در این ترمینال‌ها با شکست مواجه شود، هرچند دو سطح از نقل‌قول معمولاً باید کار کند. می‌توانید از حالت اشکال‌زدایی برای یافتن دقیق دلیل و چگونگی شکست یک دستور با نقل‌قول‌های سنگین استفاده کنید. .PP تنها .BR xterm (1) و .BR *rxvt (1) از تغییر اندازه با استفاده از میانبرها پشتیبانی می‌کنند. مشاهده شده است که xterm گاهی اوقات در حین تغییر اندازه دچار انجماد (freeze) می‌شود که برای بستن آن دست‌کم به سیگنال SIGTERM نیاز است. .PP برای XTerm، منبع \fBallowWindowOps\fP باید روی \fBTrue\fP تنظیم شود تا امکان تغییر اندازه پنجره فراهم گردد. این قابلیت از نسخه 0.14 bashrun در پیکربندی پیش‌فرض xterm فعال شده است. توجه داشته باشید که تنظیم \fBallowSendEvents\fP روی \fBTrue\fP، منبع \fBallowWindowOps\fP را در XTerm اجباراً غیرفعال خواهد کرد. .PP برای این‌که کلیدهای میانبر متا (پیشوند با \fB\\e\fP یا \fB\\M-\fP) با کلید Alt یا Meta کار کنند، ترمینال باید طوری پیکربندی شود که کلید meta را به یک escape ترجمه کند. برای XTerm، این ویژگی را می‌توان با تنظیم منبع \fBmetaSendsEscape\fP روی \fBTrue\fP فعال کرد. این ویژگی از نسخه 0.14 bashrun در پیکربندی پیش‌فرض xterm فعال است. برای URxvt، منبع \fBmeta8\fP باید روی \fBFalse\fP تنظیم شود (که تنظیم پیش‌فرض URxvt است). .SH "گزارش خطاها (BUGS)" لطفاً هرگونه خطایی را که پیدا می‌کنید با استفاده از نشانی رایانامه زیر گزارش دهید. نظرات و پیشنهادات نیز با کمال میل پذیرفته می‌شوند. .SH "نویسنده (AUTHOR)" Henning Bekel (انگلیسی و آلمانی) .SH "مشارکت‌کنندگان (CONTRIBUTORS)" .B .IP Daniel\ J.\ Griffiths\ (aka\ Ghost1227)\ میزبانی Sourceforge، طراحی وب‌سایت، بسته‌بندی ArchLinux .B .IP Shapeshifter پیشنهادات، کد، گزارش خطاها .B .IP Bernard\ Walle گزارش خطاها، بسته‌بندی OpenSuse .B .IP Dieter\ Plaetinck گزارش خطاها .B .IP Wouter\ Koersen پیشنهادات، کد .B .IP Mathias\ Dahl پیشنهادات، گزارش خطاها .B .IP Reuben\ Thomas پیشنهادات، گزارش خطاها .SH "منابع (REFERENCES)" bashrun \- http://bashrun.sourceforge.net .PP xdotool \- http://www.semicomplete.com/projects/xdotool .PP dict \- http://www.dict.org .SH "همچنین ببینید (SEE ALSO)" .BR Xorg (1), .BR xterm (1), .BR xdotool (1), .BR dict (1), .BR stty (1), .BR bash (1), .BR readline (3)