DIFFUSE(1) Diffuse Manual DIFFUSE(1)

diffuse - ابزار گرافیکی برای ادغام و مقایسه فایل‌های متنی

diffuse [-h | -? | --help | -v | --version]

diffuse [--no-rcfile | --rcfile file] [[option...] | [file...]...]

برنامه Diffuse یک ابزار گرافیکی برای ادغام و مقایسه فایل‌های متنی است. برنامه Diffuse قادر است تعداد دلخواهی از فایل‌ها را در کنار یکدیگر مقایسه کند و به کاربران امکان می‌دهد تطابق خطوط را به صورت دستی تنظیم کرده و فایل‌ها را مستقیماً ویرایش نمایند. برنامه Diffuse همچنین می‌تواند نسخه‌های مختلف فایل‌ها را از مخازن Bazaar، CVS، Darcs، Git، Mercurial، Monotone، RCS و Subversion برای مقایسه و ادغام دریافت کند.

اگر یک گزینه راهنما مشخص شود، باید تنها آرگومان مشخص‌شده در خط فرمان باشد. برنامه Diffuse بلافاصله پس از نمایش اطلاعات راهنما خارج خواهد شد.

-h, -?, --help

نمایش اطلاعات نحوه استفاده.

-v, --version

نمایش شماره نسخه و اطلاعات حق نشر.

اگر یک گزینه پیکربندی مشخص شود، باید اولین آرگومان مشخص‌شده در خط فرمان باشد.

--no-rcfile

هیچ‌یک از فایل‌های راه‌اندازی اولیه خوانده نشوند.

--rcfile file

دستورات راه‌اندازی اولیه تنها از فایل file خوانده شوند.

-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) مقایسه فایل خالی.

گزینه‌های نمایش مشخص‌شده در آرگومان‌های خط فرمان، مقادیر تنظیمات ذخیره‌شده را بازنویسی خواهند کرد.

-b, --ignore-space-change

نادیده گرفتن تغییرات در میزان فاصله‌های خالی (white space).

-B, --ignore-blank-lines

نادیده گرفتن تغییراتی که تمام خطوط آن‌ها خالی است.

-E, --ignore-end-of-line

نادیده گرفتن تفاوت‌های انتهای خط.

-i, --ignore-case

نادیده گرفتن تفاوت‌های حروف کوچک و بزرگ در محتوای فایل.

-w, --ignore-all-space

نادیده گرفتن تمام فاصله‌های خالی.

از گزینه‌های منوی File → New 2-Way File Merge، File → New 3-Way File Merge، و File → New N-Way File Merge برای ایجاد برگه‌های بیشتر جهت مقایسه فایل‌های متنی استفاده کنید. نام فایل‌ها و نسخه‌ها را می‌توان در آرگومان‌های خط فرمانِ مورداستفاده برای فراخوانی Diffuse یا در فیلدهای پنجره گفتگوی Open File مشخص کرد.

برنامه Diffuse فایل‌ها را در کنار هم نمایش داده و فاصله‌هایی (gap) برای تراز کردن خطوط متنی مشابه درج می‌کند. تفاوت‌ها با رنگ پس‌زمینه متفاوتی برجسته می‌شوند.

خلاصه‌ای از فایل‌های مقایسه‌شده در حاشیه سمت راست قرار دارد. این خلاصه نشان می‌دهد که کجا فاصله‌ها برای تراز کردن خطوط متنی منطبق درج شده‌اند و تفاوت‌ها را با استفاده از رنگ برجسته می‌کند. ویرایش‌های دستی نیز با رنگ سبز مشخص می‌شوند. یک مکان‌نمای آبی ناحیه‌ای را که در حال حاضر مشاهده می‌شود مشخص می‌کند. ناحیه دیده‌شده را می‌توان با کلیک در هر نقطه از این خلاصه تغییر داد.

خطوط متن را می‌توان با استفاده از نشانگر ماوس یا صفحه‌کلید انتخاب کرد. خطوط متن را با کلیک روی یک خط با نشانگر ماوس انتخاب کنید. برای انتخاب چند خط، کلیک کرده و بکشید (drag کنید). نگه داشتن کلید Shift هنگام کلیک کردن، انتخاب فعلی را گسترش می‌دهد. خطوط را با استفاده از صفحه‌کلید و فشردن کلیدهای Page Up/Down یا کلیدهای جهت‌نما انتخاب کنید. با نگه داشتن کلید Shift و فشردن کلیدهای Page Up/Down یا کلیدهای جهت‌نما، انتخاب فعلی را گسترش دهید. با استفاده از کلیدهای جهت‌نمای چپ و راست، انتخاب را به فایل مجاور منتقل کنید.

می‌توان از نشانگر ماوس یا صفحه‌کلید برای تراز دستی خطوط متن با فایل‌های مجاور استفاده کرد. برای تراز کردن خطوط متن با نشانگر ماوس، یک خط متن را با کلیک چپ ماوس انتخاب کنید، روی خطی از متن از یک فایل مجاور راست‌کلیک کرده و گزینه Align with Selection را انتخاب نمایید. برای تراز کردن خطوط متن با صفحه‌کلید، انتخاب را با کلیدهای جهت‌نما حرکت دهید، کلید فاصله (Space) را فشار دهید تا خط متن فعلی علامت‌گذاری شود، انتخاب را با کلیدهای جهت‌نما به یک خط متن در فایل مجاور منتقل کرده و دوباره کلید فاصله را فشار دهید تا خط مقصد انتخاب شود. فشردن کلید Escape عملیات را لغو خواهد کرد.

از گزینه منوی Isolate برای جلوگیری از تطبیق خطوط انتخاب‌شده با هر خطی از فایل‌های مجاور استفاده کنید.

کلید Enter را فشار دهید یا روی ناحیه متن دوبار کلیک کنید تا وارد حالت ویرایش متن شوید. مکان‌نما تغییر خواهد کرد تا حالت ویرایش متن را نشان دهد و نوار وضعیت در پایین پنجره موقعیت ستون مکان‌نما را نمایش خواهد داد.

در حالت ویرایش متن، متن را می‌توان با نشانگر ماوس با کلیک کردن و کشیدن انتخاب کرد. انتخاب فعلی را می‌توان با نگه داشتن کلید Shift و جابجایی مکان‌نما با کلیک ماوس یا فشردن هریک از کلیدهای جهت‌نما، Home، End یا Page Up/Down گسترش داد. کلمات منفرد را می‌توان با دوبار کلیک روی آن‌ها با نشانگر ماوس انتخاب کرد. کل خطوط را می‌توان با سه بار کلیک روی آن‌ها با نشانگر ماوس انتخاب کرد.

متن را با تایپ روی صفحه‌کلید تغییر دهید. خطوط تغییریافته با رنگ سبز برجسته می‌شوند. از گزینه‌های منوی Undo و Redo برای واگردانی و بازانجام عملیات‌های قبلی استفاده کنید.

کلید Escape را فشار دهید یا با کلیک چپ ماوس روی ناحیه متن فایلی دیگر کلیک کنید تا از حالت ویرایش خارج شوید.

از دکمه‌های تفاوت یا گزینه‌های منو برای پیمایش بین بلوک‌های تفاوت در یک فایل استفاده کنید. هنگام پیمایش، Diffuse انتخاب را به مجموعه پیوسته بعدی از خطوط دارای تفاوت یا ویرایش منتقل می‌کند.

از دکمه‌های ادغام یا گزینه‌های منو برای کپی کردن بلوک‌های متن در محدوده خطوط انتخاب‌شده استفاده کنید. از گزینه‌های منوی Undo و Redo می‌توان برای واگردانی و بازانجام عملیات‌های قبلی استفاده کرد. تمام تغییرات اعمال‌شده بر روی یک مجموعه از خطوط را می‌توان با استفاده از گزینه منوی Clear Edits صرف نظر از ترتیب انجام ویرایش‌ها، بازگرداند.

برنامه Diffuse می‌تواند نسخه‌های فایل را از چندین سامانه کنترل نسخه از طریق رابط خط فرمان آن‌ها دریافت کند. نگارش مایکروسافت ویندوزِ Diffuse قادر است از هر دو نسخه بومی و Cygwin سامانه‌های پشتیبانی‌شده کنترل نسخه استفاده کند. هنگام استفاده از Diffuse با Cygwin، اطمینان حاصل کنید که تنظیمات Cygwin در Diffuse سیستم شما را به درستی توصیف می‌کنند. اگر گزینه ترجیحی Update paths for Cygwin برای یک سامانه کنترل نسخه وجود داشته باشد، برای استفاده از نگارش Cygwin باید فعال گردد.

سامانه‌های کنترل نسخه نسبت به مسیر سیستم (PATH) و سایر تنظیمات متغیرهای محیطی حساس هستند. گزینه ترجیحی Launch from a Bash login shell می‌تواند برای تنظیم آسان محیط سامانه‌های کنترل نسخه Cygwin استفاده شود.

گزینه -m باعث می‌شود Diffuse برگه‌های مقایسه‌ای را برای هر فایلی که طبق اعلام سامانه کنترل نسخه دارای تغییرات ثبت‌نشده (کامیت‌نشده) است، باز کند. این ویژگی برای بازبینی تمام تغییرات پیش از ثبت یا حل تداخل‌های ادغام بسیار مناسب است. اگر هیچ مسیری مشخص نشود، دایرکتوری کاری فعلی استفاده خواهد شد. به عنوان مثال، تمام تغییرات ثبت‌نشده خود را با این دستور خط فرمان مشاهده کنید:

$ diffuse -m

اگر تنها یک فایل مشخص شود، نسخه پیش‌فرض فایل برای مقایسه استفاده خواهد شد. برای مثال، دستور زیر یک ادغام ۲-طرفه بین نسخه پیش‌فرض foo.C و فایل محلی foo.C را نمایش می‌دهد:

$ diffuse foo.C

گزینه -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

منابع می‌توانند برای سفارشی‌سازی جنبه‌های مختلف ظاهر و رفتار Diffuse مانند تغییر رنگ‌های مورد استفاده در رابط کاربری، سفارشی‌سازی کلیدهای میانبر صفحه‌کلید، افزودن یا جایگزینی قواعد برجسته‌سازی نحوی، یا تغییر نگاشت پسوندهای فایل به قواعد برجسته‌سازی نحوی به کار روند.

هنگامی که Diffuse شروع به کار می‌کند، ابتدا دستورات را از فایل راه‌اندازی اولیه سراسری سیستم /etc/diffuserc (%INSTALL_DIR%\diffuserc در مایکروسافت ویندوز) و سپس از فایل راه‌اندازی اولیه شخصی ~/.config/diffuse/diffuserc (%HOME%\.config\diffuse\diffuserc در مایکروسافت ویندوز) می‌خواند. این رفتار را می‌توان با گزینه‌های پیکربندی --no-rcfile و --rcfile تغییر داد. یک تحلیل‌گر لغوی مشابه Bourne shell برای تجزیه دستورات راه‌اندازی اولیه استفاده می‌شود. توضیحات (کامنت‌ها) و نویسه‌های خاص را می‌توان با همان شیوه اسکیپ موجود در اسکریپت‌های Bourne shell درج کرد.

import file

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

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

string name value

یک منبع رشته‌ای به نام name با مقدار value اعلان می‌کند.

منابع رشته‌ای استفاده‌شده (Used String Resources)

منابع رشته‌ای زیر توسط Diffuse استفاده می‌شوند:

difference_colours

فهرستی از منابع رنگی مورد استفاده برای نشان دادن تفاوت‌ها

Default: difference_1 difference_2 difference_3

[ 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

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 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 برای برجسته‌سازی علامت‌گذاری خواهند شد.

فایل‌های زیر توسط 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 در مایکروسافت ویندوز)

برنامه Diffuse توسط Derrick Moser <derrick_moser@yahoo.com> نوشته شده است.

© 2006-2014 Derrick Moser. کلیه حقوق محفوظ است.

برنامه Diffuse نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط GNU General Public License منتشرشده توسط بنیاد نرم‌افزار آزاد (Free Software Foundation) بازتوزیع کرده و/یا تغییر دهید؛ چه نسخه 2 مجوز و چه (به انتخاب خودتان) هر نسخه بعدی آن.

2014-07-18 diffuse 0.4.8