DIFFUSE(1) Diffuse Manual DIFFUSE(1) نام (NAME) diffuse - ابزار گرافیکی برای ادغام و مقایسه فایل‌های متنی خلاصه دستور (SYNOPSIS) diffuse [-h | -? | --help | -v | --version] diffuse [--no-rcfile | --rcfile file] [[option...] | [file...]...] توضیحات (DESCRIPTION) برنامه Diffuse یک ابزار گرافیکی برای ادغام و مقایسه فایل‌های متنی است. برنامه Diffuse قادر است تعداد دلخواهی از فایل‌ها را در کنار یکدیگر مقایسه کند و به کاربران امکان می‌دهد تطابق خطوط را به صورت دستی تنظیم کرده و فایل‌ها را مستقیماً ویرایش نمایند. برنامه Diffuse همچنین می‌تواند نسخه‌های مختلف فایل‌ها را از مخازن Bazaar، CVS، Darcs، Git، Mercurial، Monotone، RCS و Subversion برای مقایسه و ادغام دریافت کند. گزینه‌ها (OPTIONS) گزینه‌های راهنما (Help Options) اگر یک گزینه راهنما مشخص شود، باید تنها آرگومان مشخص‌شده در خط فرمان باشد. برنامه Diffuse بلافاصله پس از نمایش اطلاعات راهنما خارج خواهد شد. -h, -?, --help نمایش اطلاعات نحوه استفاده. -v, --version نمایش شماره نسخه و اطلاعات حق نشر. گزینه‌های پیکربندی (Configuration Options) اگر یک گزینه پیکربندی مشخص شود، باید اولین آرگومان مشخص‌شده در خط فرمان باشد. --no-rcfile هیچ‌یک از فایل‌های راه‌اندازی اولیه خوانده نشوند. --rcfile file دستورات راه‌اندازی اولیه تنها از فایل file خوانده شوند. گزینه‌های عمومی (General Options) -c, --commit rev باز کردن برگه‌های مقایسه فایل جداگانه برای تمام فایل‌های تحت تأثیر کامیت rev از مسیرهای باقی‌مانده مشخص‌شده در آرگومان‌های خط فرمان. -D, --close-if-same بستن تمام برگه‌هایی که هیچ تفاوتی ندارند. -e, --encoding codec استفاده از codec برای خواندن و نوشتن فایل‌ها. -L, --label label نمایش label به جای نام فایل. -m, --modified باز کردن برگه‌های مقایسه فایل جداگانه برای تمام فایل‌های تغییریافته از مسیرهای باقی‌مانده مشخص‌شده در آرگومان‌های خط فرمان. -r, --revision rev شامل کردن نسخه rev از فایل بعدیِ ذکرشده در آرگومان‌های خط فرمان در یک برگه مقایسه فایل. -s, --separate باز کردن تمام فایل‌های باقی‌مانده مشخص‌شده در آرگومان‌های خط فرمان در برگه‌های مقایسه فایل جداگانه. -t, --tab شروع یک برگه جدید برای هر فایل باقی‌مانده ذکرشده در آرگومان‌های خط فرمان. -V, --vcs vcs-list جستجو برای سامانه‌های کنترل نسخه به ترتیب: vcs-list. --line line شروع با انتخاب خط line. --null-file ایجاد یک قاب (pane) مقایسه فایل خالی. گزینه‌های نمایش (Display Options) گزینه‌های نمایش مشخص‌شده در آرگومان‌های خط فرمان، مقادیر تنظیمات ذخیره‌شده را بازنویسی خواهند کرد. -b, --ignore-space-change نادیده گرفتن تغییرات در میزان فاصله‌های خالی (white space). -B, --ignore-blank-lines نادیده گرفتن تغییراتی که تمام خطوط آن‌ها خالی است. -E, --ignore-end-of-line نادیده گرفتن تفاوت‌های انتهای خط. -i, --ignore-case نادیده گرفتن تفاوت‌های حروف کوچک و بزرگ در محتوای فایل. -w, --ignore-all-space نادیده گرفتن تمام فاصله‌های خالی. مقایسه فایل (FILE COMPARISON) از گزینه‌های منوی File → New 2-Way File Merge، File → New 3-Way File Merge، و File → New N-Way File Merge برای ایجاد برگه‌های بیشتر جهت مقایسه فایل‌های متنی استفاده کنید. نام فایل‌ها و نسخه‌ها را می‌توان در آرگومان‌های خط فرمانِ مورداستفاده برای فراخوانی Diffuse یا در فیلدهای پنجره گفتگوی Open File مشخص کرد. برنامه Diffuse فایل‌ها را در کنار هم نمایش داده و فاصله‌هایی (gap) برای تراز کردن خطوط متنی مشابه درج می‌کند. تفاوت‌ها با رنگ پس‌زمینه متفاوتی برجسته می‌شوند. خلاصه مقایسه (Comparison Summary) خلاصه‌ای از فایل‌های مقایسه‌شده در حاشیه سمت راست قرار دارد. این خلاصه نشان می‌دهد که کجا فاصله‌ها برای تراز کردن خطوط متنی منطبق درج شده‌اند و تفاوت‌ها را با استفاده از رنگ برجسته می‌کند. ویرایش‌های دستی نیز با رنگ سبز مشخص می‌شوند. یک مکان‌نمای آبی ناحیه‌ای را که در حال حاضر مشاهده می‌شود مشخص می‌کند. ناحیه دیده‌شده را می‌توان با کلیک در هر نقطه از این خلاصه تغییر داد. انتخاب (Selecting) خطوط متن را می‌توان با استفاده از نشانگر ماوس یا صفحه‌کلید انتخاب کرد. خطوط متن را با کلیک روی یک خط با نشانگر ماوس انتخاب کنید. برای انتخاب چند خط، کلیک کرده و بکشید (drag کنید). نگه داشتن کلید Shift هنگام کلیک کردن، انتخاب فعلی را گسترش می‌دهد. خطوط را با استفاده از صفحه‌کلید و فشردن کلیدهای Page Up/Down یا کلیدهای جهت‌نما انتخاب کنید. با نگه داشتن کلید Shift و فشردن کلیدهای Page Up/Down یا کلیدهای جهت‌نما، انتخاب فعلی را گسترش دهید. با استفاده از کلیدهای جهت‌نمای چپ و راست، انتخاب را به فایل مجاور منتقل کنید. تطبیق خطوط (Matching Lines) می‌توان از نشانگر ماوس یا صفحه‌کلید برای تراز دستی خطوط متن با فایل‌های مجاور استفاده کرد. برای تراز کردن خطوط متن با نشانگر ماوس، یک خط متن را با کلیک چپ ماوس انتخاب کنید، روی خطی از متن از یک فایل مجاور راست‌کلیک کرده و گزینه Align with Selection را انتخاب نمایید. برای تراز کردن خطوط متن با صفحه‌کلید، انتخاب را با کلیدهای جهت‌نما حرکت دهید، کلید فاصله (Space) را فشار دهید تا خط متن فعلی علامت‌گذاری شود، انتخاب را با کلیدهای جهت‌نما به یک خط متن در فایل مجاور منتقل کرده و دوباره کلید فاصله را فشار دهید تا خط مقصد انتخاب شود. فشردن کلید Escape عملیات را لغو خواهد کرد. از گزینه منوی Isolate برای جلوگیری از تطبیق خطوط انتخاب‌شده با هر خطی از فایل‌های مجاور استفاده کنید. ویرایش (Editing) کلید Enter را فشار دهید یا روی ناحیه متن دوبار کلیک کنید تا وارد حالت ویرایش متن شوید. مکان‌نما تغییر خواهد کرد تا حالت ویرایش متن را نشان دهد و نوار وضعیت در پایین پنجره موقعیت ستون مکان‌نما را نمایش خواهد داد. در حالت ویرایش متن، متن را می‌توان با نشانگر ماوس با کلیک کردن و کشیدن انتخاب کرد. انتخاب فعلی را می‌توان با نگه داشتن کلید Shift و جابجایی مکان‌نما با کلیک ماوس یا فشردن هریک از کلیدهای جهت‌نما، Home، End یا Page Up/Down گسترش داد. کلمات منفرد را می‌توان با دوبار کلیک روی آن‌ها با نشانگر ماوس انتخاب کرد. کل خطوط را می‌توان با سه بار کلیک روی آن‌ها با نشانگر ماوس انتخاب کرد. متن را با تایپ روی صفحه‌کلید تغییر دهید. خطوط تغییریافته با رنگ سبز برجسته می‌شوند. از گزینه‌های منوی Undo و Redo برای واگردانی و بازانجام عملیات‌های قبلی استفاده کنید. کلید Escape را فشار دهید یا با کلیک چپ ماوس روی ناحیه متن فایلی دیگر کلیک کنید تا از حالت ویرایش خارج شوید. ادغام (Merging) از دکمه‌های تفاوت یا گزینه‌های منو برای پیمایش بین بلوک‌های تفاوت در یک فایل استفاده کنید. هنگام پیمایش، Diffuse انتخاب را به مجموعه پیوسته بعدی از خطوط دارای تفاوت یا ویرایش منتقل می‌کند. از دکمه‌های ادغام یا گزینه‌های منو برای کپی کردن بلوک‌های متن در محدوده خطوط انتخاب‌شده استفاده کنید. از گزینه‌های منوی Undo و Redo می‌توان برای واگردانی و بازانجام عملیات‌های قبلی استفاده کرد. تمام تغییرات اعمال‌شده بر روی یک مجموعه از خطوط را می‌توان با استفاده از گزینه منوی Clear Edits صرف نظر از ترتیب انجام ویرایش‌ها، بازگرداند. کنترل نسخه (VERSION CONTROL) برنامه Diffuse می‌تواند نسخه‌های فایل را از چندین سامانه کنترل نسخه از طریق رابط خط فرمان آن‌ها دریافت کند. نگارش مایکروسافت ویندوزِ Diffuse قادر است از هر دو نسخه بومی و Cygwin سامانه‌های پشتیبانی‌شده کنترل نسخه استفاده کند. هنگام استفاده از Diffuse با Cygwin، اطمینان حاصل کنید که تنظیمات Cygwin در Diffuse سیستم شما را به درستی توصیف می‌کنند. اگر گزینه ترجیحی Update paths for Cygwin برای یک سامانه کنترل نسخه وجود داشته باشد، برای استفاده از نگارش Cygwin باید فعال گردد. سامانه‌های کنترل نسخه نسبت به مسیر سیستم (PATH) و سایر تنظیمات متغیرهای محیطی حساس هستند. گزینه ترجیحی Launch from a Bash login shell می‌تواند برای تنظیم آسان محیط سامانه‌های کنترل نسخه Cygwin استفاده شود. مشاهده تغییرات ثبت‌نشده (Viewing Uncommitted Modifications) گزینه -m باعث می‌شود Diffuse برگه‌های مقایسه‌ای را برای هر فایلی که طبق اعلام سامانه کنترل نسخه دارای تغییرات ثبت‌نشده (کامیت‌نشده) است، باز کند. این ویژگی برای بازبینی تمام تغییرات پیش از ثبت یا حل تداخل‌های ادغام بسیار مناسب است. اگر هیچ مسیری مشخص نشود، دایرکتوری کاری فعلی استفاده خواهد شد. به عنوان مثال، تمام تغییرات ثبت‌نشده خود را با این دستور خط فرمان مشاهده کنید: $ diffuse -m اگر تنها یک فایل مشخص شود، نسخه پیش‌فرض فایل برای مقایسه استفاده خواهد شد. برای مثال، دستور زیر یک ادغام ۲-طرفه بین نسخه پیش‌فرض foo.C و فایل محلی foo.C را نمایش می‌دهد: $ diffuse foo.C مشخص کردن نسخه‌ها (Specifying Revisions) گزینه -r همچنین می‌تواند برای مشخص کردن صریح یک نسخه خاص از فایل استفاده شود. هر مشخص‌کننده نسخه‌ای که برای سامانه کنترل نسخه قابل فهم باشد می‌تواند به کار رود. اگر تنها یک نسخه از فایل مشخص شده باشد، فایل محلی برای مقایسه استفاده خواهد شد. برای مثال، دستور زیر یک ادغام ۲-طرفه بین نسخه 123 از foo.C و فایل محلی foo.C را نمایش می‌دهد: $ diffuse -r 123 foo.C با مشخص کردن چندین گزینه -r می‌توان نسخه‌های متعددی از فایل را با هم مقایسه کرد. برای مثال، دستور زیر یک ادغام ۲-طرفه بین نسخه 123 از foo.C و نسخه 321 از foo.C را نمایش می‌دهد: $ diffuse -r 123 -r 321 foo.C فایل‌های محلی را می‌توان با فایل‌های سامانه کنترل نسخه ترکیب کرد. برای مثال، دستور زیر یک ادغام ۳-طرفه بین نسخه MERGE_HEAD از foo.C، فایل محلی foo.C، و نسخه HEAD از foo.C را نمایش می‌دهد: $ diffuse -r MERGE_HEAD foo.C foo.C -r HEAD foo.C گزینه -c می‌تواند برای مشخص کردن آسان یک جفت نسخه متوالی استفاده شود. برای مثال، دستور زیر یک ادغام ۲-طرفه بین نسخه 1.2.2 از foo.C و نسخه 1.2.3 از foo.C را نمایش می‌دهد: $ diffuse -c 1.2.3 foo.C برنامه Diffuse تعداد قاب‌های مورد استفاده برای مقایسه فایل‌ها را محدود نمی‌کند. ورودی‌های یک ادغام چندگانه (octopus merge) در گیت را می‌توان با خط فرمانی مانند این مشاهده کرد: $ diffuse -r HEAD^1 -r HEAD^2 -r HEAD^3 -r HEAD^4 -r HEAD^5 foo.C منابع (RESOURCES) منابع می‌توانند برای سفارشی‌سازی جنبه‌های مختلف ظاهر و رفتار Diffuse مانند تغییر رنگ‌های مورد استفاده در رابط کاربری، سفارشی‌سازی کلیدهای میانبر صفحه‌کلید، افزودن یا جایگزینی قواعد برجسته‌سازی نحوی، یا تغییر نگاشت پسوندهای فایل به قواعد برجسته‌سازی نحوی به کار روند. هنگامی که Diffuse شروع به کار می‌کند، ابتدا دستورات را از فایل راه‌اندازی اولیه سراسری سیستم /etc/diffuserc (%INSTALL_DIR%\diffuserc در مایکروسافت ویندوز) و سپس از فایل راه‌اندازی اولیه شخصی ~/.config/diffuse/diffuserc (%HOME%\.config\diffuse\diffuserc در مایکروسافت ویندوز) می‌خواند. این رفتار را می‌توان با گزینه‌های پیکربندی --no-rcfile و --rcfile تغییر داد. یک تحلیل‌گر لغوی مشابه Bourne shell برای تجزیه دستورات راه‌اندازی اولیه استفاده می‌شود. توضیحات (کامنت‌ها) و نویسه‌های خاص را می‌توان با همان شیوه اسکیپ موجود در اسکریپت‌های Bourne shell درج کرد. عمومی (General) import file دستورات راه‌اندازی اولیه را از file پردازش می‌کند. فایل‌های راه‌اندازی اولیه تنها یک بار پردازش خواهند شد. ترکیب کلیدها (Key Bindings) keybinding context action key_combination یک ترکیب کلید را به action هنگامی که در context استفاده می‌شود متصل می‌کند. کلیدهای تبدیل‌کننده Shift و Control را به ترتیب با افزودن پیشوند Shift+ و Ctrl+ به key_combination مشخص کنید. کلیدهایی که معمولاً توسط کلید Shift تغییر می‌یابند، در صورتی که key_combination شامل کلید Shift باشد، باید با استفاده از مقدار تغییریافته خود مشخص شوند؛ به عنوان مثال: Ctrl+g و Shift+Ctrl+G. با مشخص کردن None برای action، اتصال کلید برای key_combination را حذف کنید. کلیدهای میانبر گزینه‌های منو (Menu Item Key Bindings) از menu برای context جهت تعریف کلیدهای میانبر گزینه‌های منو استفاده کنید. مقادیر زیر برای action معتبر هستند: open_file File → Open File... گزینه منو Default: Ctrl+o open_file_in_new_tab File → Open File In New Tab... گزینه منو Default: Ctrl+t open_modified_files File → Open Modified Files... گزینه منو Default: Shift+Ctrl+O open_commit File → Open Commit... گزینه منو Default: Shift+Ctrl+T reload_file File → Reload File گزینه منو Default: Shift+Ctrl+R save_file File → Save File گزینه منو Default: Ctrl+s save_file_as File → Save File As... گزینه منو Default: Shift+Ctrl+A save_all File → Save All گزینه منو Default: Shift+Ctrl+S new_2_way_file_merge File → New 2-Way File Merge گزینه منو Default: Ctrl+2 new_3_way_file_merge File → New 3-Way File Merge گزینه منو Default: Ctrl+3 new_n_way_file_merge File → New N-Way File Merge گزینه منو Default: Ctrl+4 close_tab File → Close Tab گزینه منو Default: Ctrl+w undo_close_tab File → Undo Close Tab گزینه منو Default: Shift+Ctrl+w quit File → Quit گزینه منو Default: Ctrl+q undo Edit → Undo گزینه منو Default: Ctrl+z redo Edit → Redo گزینه منو Default: Shift+Ctrl+Z cut Edit → Cut گزینه منو Default: Ctrl+x copy Edit → Copy گزینه منو Default: Ctrl+c paste Edit → Paste گزینه منو Default: Ctrl+v select_all Edit → Select All گزینه منو Default: Ctrl+a clear_edits Edit → Clear Edits گزینه منو Default: Ctrl+r dismiss_all_edits Edit → Dismiss All Edits گزینه منو Default: Ctrl+d find Edit → Find... گزینه منو Default: Ctrl+f find_next Edit → Find Next گزینه منو Default: Ctrl+g find_previous Edit → Find Previous گزینه منو Default: Shift+Ctrl+G go_to_line Edit → Go To Line... گزینه منو Default: Shift+Ctrl+L preferences Edit → Preferences گزینه منو Default: None no_syntax_highlighting View → Syntax Highlighting → None گزینه منو Default: None syntax_highlighting_syntax View → Syntax Highlighting → syntax گزینه منو Default: None realign_all View → Realign All گزینه منو Default: Ctrl+l isolate View → Isolate گزینه منو Default: Ctrl+i first_difference View → First Difference گزینه منو Default: Shift+Ctrl+Up previous_difference View → Previous Difference گزینه منو Default: Ctrl+Up next_difference View → Next Difference گزینه منو Default: Ctrl+Down last_difference View → Last Difference گزینه منو Default: Shift+Ctrl+Down first_tab View → First Tab گزینه منو Default: Shift+Ctrl+Page_Up previous_tab View → Previous Tab گزینه منو Default: Ctrl+Page_Up next_tab View → Next Tab گزینه منو Default: Ctrl+Page_Down last_tab View → Last Tab گزینه منو Default: Shift+Ctrl+Page_Down shift_pane_right View → Shift Pane Right گزینه منو Default: Shift+Ctrl+parenleft shift_pane_left View → Shift Pane Left گزینه منو Default: Shift+Ctrl+parenright convert_to_upper_case Format → Convert To Upper Case گزینه منو Default: Ctrl+u convert_to_lower_case Format → Convert To Lower Case گزینه منو Default: Shift+Ctrl+U sort_lines_in_ascending_order Format → Sort Lines In Ascending Order گزینه منو Default: Ctrl+y sort_lines_in_descending_order Format → Sort Lines In Descending Order گزینه منو Default: Shift+Ctrl+Y remove_trailing_white_space Format → Remove Trailing White Space گزینه منو Default: Ctrl+k convert_tabs_to_spaces Format → Convert Tabs To Spaces گزینه منو Default: Ctrl+b convert_leading_spaces_to_tabs Format → Convert Leading Spaces To Tabs گزینه منو Default: Shift+Ctrl+B increase_indenting Format → Increase Indenting گزینه منو Default: Shift+Ctrl+greater decrease_indenting Format → Decrease Indenting گزینه منو Default: Shift+Ctrl+less convert_to_dos Format → Convert To DOS Format گزینه منو Default: Shift+Ctrl+E convert_to_mac Format → Convert To Mac Format گزینه منو Default: Shift+Ctrl+C convert_to_unix Format → Convert To Unix Format گزینه منو Default: Ctrl+e copy_selection_right Merge → Copy Selection Right گزینه منو Default: Shift+Ctrl+Right copy_selection_left Merge → Copy Selection Left گزینه منو Default: Shift+Ctrl+Left copy_left_into_selection Merge → Copy Left Into Selection گزینه منو Default: Ctrl+Right copy_right_into_selection Merge → Copy Right Into Selection گزینه منو Default: Ctrl+Left merge_from_left_then_right Merge → Merge From Left Then Right گزینه منو Default: Ctrl+m merge_from_right_then_left Merge → Merge From Right Then Left گزینه منو Default: Shift+Ctrl+M help_contents Help → Help Contents گزینه منو Default: F1 about Help → About گزینه منو Default: None کلیدهای میانبر حالت ویرایش خط (Line Editing Mode Key Bindings) از line_mode برای context جهت تعریف کلیدهای میانبر حالت ویرایش خط استفاده کنید. مقادیر زیر برای action معتبر هستند: enter_align_mode ورود به حالت ویرایش تراز Default: space enter_character_mode ورود به حالت ویرایش نویسه Defaults: Return, KP_Enter first_line انتقال مکان‌نما به خط اول Defaults: Home, g extend_first_line انتقال مکان‌نما به خط اول، همراه با گسترش انتخاب Default: Shift+Home last_line انتقال مکان‌نما به خط آخر Defaults: End, Shift+G extend_last_line انتقال مکان‌نما به خط آخر، همراه با گسترش انتخاب Default: Shift+End up انتقال مکان‌نما یک خط به بالا Defaults: Up, k extend_up انتقال مکان‌نما یک خط به بالا، همراه با گسترش انتخاب Defaults: Shift+Up, Shift+K down انتقال مکان‌نما یک خط به پایین Defaults: Down, j extend_down انتقال مکان‌نما یک خط به پایین، همراه با گسترش انتخاب Defaults: Shift+Down, Shift+J left انتقال مکان‌نما یک فایل به چپ Defaults: Left, h extend_left انتقال مکان‌نما یک فایل به چپ، همراه با گسترش انتخاب Default: Shift+Left right انتقال مکان‌نما یک فایل به راست Defaults: Right, l extend_right انتقال مکان‌نما یک فایل به راست، همراه با گسترش انتخاب Default: Shift+Right page_up انتقال مکان‌نما یک صفحه به بالا Defaults: Page_Up, Ctrl+u extend_page_up انتقال مکان‌نما یک صفحه به بالا، همراه با گسترش انتخاب Defaults: Shift+Page_Up, Shift+Ctrl+u page_down انتقال مکان‌نما یک صفحه به پایین Defaults: Page_Down, Ctrl+d extend_page_down انتقال مکان‌نما یک صفحه به پایین، همراه با گسترش انتخاب Defaults: Shift+Page_Down, Shift+Ctrl+d delete_text حذف متن انتخاب‌شده Defaults: BackSpace, Delete, x first_difference انتخاب اولین تفاوت Defaults: Ctrl+Home, Shift+P previous_difference انتخاب تفاوت قبلی Default: p next_difference انتخاب تفاوت بعدی Default: n last_difference انتخاب آخرین تفاوت Defaults: Ctrl+End, Shift+N clear_edits پاک کردن تمام ویرایش‌ها از خطوط انتخاب‌شده Default: r copy_selection_left کپی خطوط از بخش انتخاب‌شده به فایل سمت چپ Default: None copy_selection_right کپی خطوط از بخش انتخاب‌شده به فایل سمت راست Default: None copy_left_into_selection کپی خطوط از فایل سمت چپ به بخش انتخاب‌شده Default: Shift+L copy_right_into_selection کپی خطوط از فایل سمت راست به بخش انتخاب‌شده Default: Shift+H merge_from_left_then_right ادغام خطوط ابتدا از فایل سمت چپ و سپس از فایل سمت راست Default: m merge_from_right_then_left ادغام خطوط ابتدا از فایل سمت راست و سپس از فایل سمت چپ Default: Shift+M isolate جداسازی خطوط انتخاب‌شده Default: i کلیدهای میانبر حالت ویرایش تراز (Alignment Editing Mode Key Bindings) از align_mode برای context جهت تعریف کلیدهای میانبر حالت ویرایش تراز استفاده کنید. مقادیر زیر برای action معتبر هستند: enter_line_mode ورود به حالت ویرایش خط Default: Escape enter_character_mode ورود به حالت ویرایش نویسه Defaults: Return, KP_Enter first_line انتقال مکان‌نما به خط اول Default: g last_line انتقال مکان‌نما به خط آخر Default: Shift+G up انتقال مکان‌نما یک خط به بالا Defaults: Up, k down انتقال مکان‌نما یک خط به پایین Defaults: Down, j left انتقال مکان‌نما یک فایل به چپ Defaults: Left, h right انتقال مکان‌نما یک فایل به راست Defaults: Right, l page_up انتقال مکان‌نما یک صفحه به بالا Defaults: Page_Up, Ctrl+u page_down انتقال مکان‌نما یک صفحه به پایین Defaults: Page_Down, Ctrl+d align تراز کردن خط انتخاب‌شده با موقعیت مکان‌نما Default: space کلیدهای میانبر حالت ویرایش نویسه (Character Editing Mode Key Bindings) از character_mode برای context جهت تعریف کلیدهای میانبر حالت ویرایش نویسه استفاده کنید. مقادیر زیر برای action معتبر هستند: enter_line_mode ورود به حالت ویرایش خط Default: Escape رشته‌ها (Strings) string name value یک منبع رشته‌ای به نام name با مقدار value اعلان می‌کند. منابع رشته‌ای استفاده‌شده (Used String Resources) منابع رشته‌ای زیر توسط Diffuse استفاده می‌شوند: difference_colours فهرستی از منابع رنگی مورد استفاده برای نشان دادن تفاوت‌ها Default: difference_1 difference_2 difference_3 رنگ‌ها (Colours) [ colour | color ] name red green blue یک منبع رنگی به نام name اعلان می‌کند. مؤلفه‌های رنگ منفرد باید به عنوان مقداری بین 0 و 1 بیان شوند. منابع رنگی استفاده‌شده (Used Colour Resources) منابع رنگی زیر توسط Diffuse استفاده می‌شوند: alignment رنگ مورد استفاده برای نشان دادن خطی که برای تراز دستی انتخاب شده است Default: 1 1 0 character_selection رنگ مورد استفاده برای نشان دادن نویسه‌های انتخاب‌شده Default: 0.7 0.7 1 cursor رنگ مورد استفاده برای مکان‌نما Default: 0 0 0 difference_1 رنگ مورد استفاده برای مشخص کردن تفاوت‌های بین اولین جفت از فایل‌ها Default: 1 0.625 0.625 difference_2 رنگ مورد استفاده برای مشخص کردن تفاوت‌های بین دومین جفت از فایل‌ها Default: 0.85 0.625 0.775 difference_3 رنگ مورد استفاده برای مشخص کردن تفاوت‌های بین سومین جفت از فایل‌ها Default: 0.85 0.775 0.625 edited رنگ مورد استفاده برای نشان دادن خطوط ویرایش‌شده Default: 0.5 1 0.5 hatch رنگ مورد استفاده برای نشان دادن فاصله‌های تراز Default: 0.8 0.8 0.8 line_number رنگ مورد استفاده برای شماره خطوط Default: 0 0 0 line_number_background رنگ پس‌زمینه برای ناحیه شماره خط Default: 0.75 0.75 0.75 line_selection رنگ مورد استفاده برای نشان دادن خطوط انتخاب‌شده Default: 0.7 0.7 1 map_background رنگ پس‌زمینه برای ناحیه نقشه (خلاصه مقایسه) Default: 0.6 0.6 0.6 margin رنگ مورد استفاده برای نشان دادن حاشیه راست Default: 0.8 0.8 0.8 preedit رنگ متن پیش‌ویرایش Default: 0 0 0 text رنگ متن معمولی Default: 0 0 0 text_background رنگ پس‌زمینه برای ناحیه متن Default: 1 1 1 مقادیر ممیز شناور (Floating Point Values) float name value یک منبع ممیز شناور به نام name با مقدار value اعلان می‌کند. منابع ممیز شناور استفاده‌شده (Used Floating Point Resources) منابع ممیز شناور زیر توسط Diffuse استفاده می‌شوند: alignment_opacity میزان کدر بودن مورد استفاده هنگام ترکیب رنگ تراز دستی Defaults: 1 character_difference_opacity میزان کدر بودن مورد استفاده هنگام ترکیب رنگ‌های تفاوت نویسه‌ها Defaults: 0.4 character_selection_opacity میزان کدر بودن مورد استفاده هنگام ترکیب رنگ انتخاب نویسه Defaults: 0.4 edited_opacity میزان کدر بودن مورد استفاده هنگام ترکیب رنگ خط ویرایش‌شده Defaults: 0.4 line_difference_opacity میزان کدر بودن مورد استفاده هنگام ترکیب رنگ‌های تفاوت خطوط Defaults: 0.3 line_selection_opacity میزان کدر بودن مورد استفاده هنگام ترکیب رنگ انتخاب خط Defaults: 0.4 برجسته‌سازی نحوی (Syntax Highlighting) syntax name [initial_state default_tag] یک سبک نحوی جدید به نام name اعلان می‌کند. برجسته‌سازی نحوی از یک ماشین حالت ساده استفاده می‌کند که در هنگام تطبیق الگوهای خاص، بین حالت‌ها جابجا می‌شود. حالت اولیه برای ماشین حالت initial_state خواهد بود. تمام نویسه‌هایی که با هیچ الگویی تطبیق پیدا نکنند، با برچسب default_tag برای برجسته‌سازی علامت‌گذاری می‌شوند. سبک نحوی با نام name را می‌توان با حذف initial_state و default_tag حذف کرد. syntax_files name [pattern] مشخص می‌کند فایل‌هایی با نام مطابق با pattern باید با استفاده از سبک نحوی با نام name برجسته شوند. الگوهای مورد استفاده برای تطبیق فایل‌ها جهت استفاده با سبک نحوی name را می‌توان با حذف pattern حذف کرد. syntax_magic name [pattern [ignorecase]] مشخص می‌کند فایل‌هایی که خط اول آن‌ها با pattern مطابقت دارد، باید با استفاده از سبک نحوی با نام name برجسته شوند. الگوهای مورد استفاده برای تطبیق فایل‌ها جهت استفاده با سبک نحوی با نام name را می‌توان با حذف pattern حذف کرد. syntax_pattern name initial_state final_state tag pattern [ignorecase] الگویی را به سبک نحویِ قبلاً اعلان‌شده اضافه می‌کند. الگوها به ترتیبی که اعلان شده‌اند یک‌به‌یک بررسی می‌شوند تا اولین تطابق پیدا شود. یک الگو تنها زمانی برای تطبیق نویسه‌ها به کار می‌رود که ماشین حالت در وضعیت initial_state باشد. در صورت تطابق با الگوی تعریف‌شده توسط pattern، ماشین حالت به وضعیت final_state تغییر وضعیت می‌دهد. اگر ignorecase مشخص شده باشد، تطبیق الگو بدون حساسیت به حروف بزرگ و کوچک انجام خواهد شد. تمام نویسه‌های منطبق بر الگو با برچسب tag برای برجسته‌سازی علامت‌گذاری خواهند شد. فایل‌ها (FILES) فایل‌های زیر توسط Diffuse استفاده می‌شوند: /etc/diffuserc راه‌اندازی‌های اولیه سراسری سیستم (%INSTALL_DIR%\diffuserc در مایکروسافت ویندوز) /usr/share/diffuse/syntax/*.syntax فایل‌های نحو برای زبان‌های گوناگون (%INSTALL_DIR%\syntax\*.syntax در مایکروسافت ویندوز) ~/.config/diffuse/diffuserc راه‌اندازی‌های اولیه شخصی شما (%HOME%\.config\diffuse\diffuserc در مایکروسافت ویندوز) ~/.config/diffuse/prefs تنظیمات ذخیره‌شده شما (%HOME%\.config\diffuse\prefs در مایکروسافت ویندوز) ~/.local/share/diffuse/state داده‌های ماندگار بین نشست‌ها (%HOME%\.local\share\diffuse\state در مایکروسافت ویندوز) نویسنده (AUTHOR) برنامه Diffuse توسط Derrick Moser نوشته شده است. © 2006-2014 Derrick Moser. کلیه حقوق محفوظ است. کپی‌رایت و تکثیر (COPYING) برنامه Diffuse نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط GNU General Public License منتشرشده توسط بنیاد نرم‌افزار آزاد (Free Software Foundation) بازتوزیع کرده و/یا تغییر دهید؛ چه نسخه 2 مجوز و چه (به انتخاب خودتان) هر نسخه بعدی آن. diffuse 0.4.8 2014-07-18 DIFFUSE(1)