.\" Process this file with
.\" groff -man -Tascii dhex.1
.\"
.Dd May 12, 2012
.Os
.Dt DHEXRC 5
.
.
.Sh "نام (NAME)"
.Nm dhexrc
.Nd پرونده پیکربندی برای dhex
.Sh "توضیحات (DESCRIPTION)"
پرونده
.Nm dhexrc
پرونده پیکربندی است که طرح رنگی و جدول تبدیل کلیدها را برای
.Xr dhex 1
مشخص می‌کند.
هنگام آغاز به کار برنامه، این پرونده خوانده و تجزیه می‌شود. همچنین پس از فراخوانی پیکربندی صفحه‌کلید، ایجاد یا بازنویسی می‌گردد.
.Ss "مثال (EXAMPLE)"
یک پرونده معمولی dhexrc به این صورت است:
.
.br
.Ql #DHEXCOLORSCHEME
.br
.Ql #VERSION 0
.br
.Ql #possible colors are: BLACK,RED,GREEN,YELLOW,BLUE,MAGENTA,CYAN,WHITE
.br
.Ql #possible extra flags are: UNDERLINE,REVERSE,BLINK,DIM,BOLD
.br
.br
.Ql BRACKETS:       FG=BLACK,BG=BLACK,BOLD
.br
.Ql HEXFIELD:       FG=WHITE,BG=BLACK
.br
.Ql INPUT:          FG=BLACK,BG=WHITE
.br
.Ql CURSOR:         FG=WHITE,BG=BLACK
.br
.Ql TEXT:           FG=WHITE,BG=BLACK,BOLD
.br
.Ql MENU_NORMAL:    FG=CYAN,BG=BLACK
.br
.Ql MENU_HIGHLIGHT: FG=BLACK,BG=CYAN
.br
.Ql MENU_HOTKEY:    FG=YELLOW,BG=BLACK,BOLD
.br
.Ql MENU_HOTKEY_HI: FG=YELLOW,BG=CYAN,BOLD
.br
.Ql FRAME:          FG=BLUE,BG=BLACK,BOLD
.br
.Ql NORMAL_DIFF:    FG=YELLOW,BG=BLACK
.br
.Ql CURSOR_DIFF:    FG=YELLOW,BG=WHITE,BOLD
.br
.Ql HEADLINE:       FG=BLUE,BG=BLACK,BOLD
.br
.Ql HEADER:         FG=BLACK,BG=CYAN
.br
.br
.Ql KEYF1:1b 5b 31 31 7e
.br
.Ql KEYF2:1b 5b 31 32 7e
.br
.Ql KEYF3:1b 5b 31 33 7e
.br
.Ql KEYF4:1b 5b 31 34 7e
.br
.Ql KEYF5:1b 5b 31 35 7e
.br
.Ql KEYF6:1b 5b 31 37 7e
.br
.Ql KEYF7:1b 5b 31 38 7e
.br
.Ql KEYF8:1b 5b 31 39 7e
.br
.Ql KEYF9:1b 5b 32 30 7e
.br
.Ql KEYF10:1b 5b 32 31 7e
.br
.Ql KEYESC:1b
.br
.Ql KEYBACKSPACE:08
.br
.Ql KEYDEL:7f
.br
.Ql KEYENTER:0a
.br
.Ql KEYTAB:09
.br
.Ql KEYUP:1b 5b 41
.br
.Ql KEYDOWN:1b 5b 42
.br
.Ql KEYRIGHT:1b 5b 43
.br
.Ql KEYLEFT:1b 5b 44
.br
.Ql KEYPGUP:1b 5b 35 7e
.br
.Ql KEYPGDOWN:1b 5b 36 7e
.br
.Ql KEYHOME:1b 5b 37 7e
.br
.Ql KEYEND:1b 5b 38 7e
.br
.Sh "گزینه‌ها (OPTIONS)"
در مثال بالا، پرونده dhexrc دارای سه بخش متمایز است: بخش کامنت‌ها (توضیحات)، بخش رنگ‌ها و بخش جدول تبدیل کلیدها.
.Ss "کامنت‌ها (Comments)"
کامنت‌ها با نویسه «#» مشخص می‌شوند. هر متنی که پس از این نویسه در یک خط بیاید، هنگام تجزیه پرونده نادیده گرفته می‌شود.
.Ss "بخش رنگ‌ها (Color section)"
۱۴ گروه رنگی وجود دارد. هر یک از گروه‌های رنگی دارای یک رنگ پیش‌زمینه، یک رنگ پس‌زمینه و تعدادی پرچم اختیاری برگرفته از ncurses است. رنگ پیش‌زمینه با
.Nm FG=
مشخص می‌شود در حالی که رنگ پس‌زمینه با
.Nm BG=
تعریف می‌گردد.
آن‌ها و پرچم‌های اضافی با «,» از یکدیگر جدا می‌شوند. رنگ‌های مجاز عبارتند از:
.Nm BLACK ,
.Nm GREEN ,
.Nm RED ,
.Nm YELLOW ,
.Nm BROWN ,
.Nm BLUE ,
.Nm MAGENTA ,
.Nm WHITE ,
و منحصراً به عنوان رنگ‌های پیش‌زمینه:
.Nm LIGHTBLACK ,
.Nm LIGHTGREEN ,
.Nm LIGHTRED ,
.Nm LIGHTYELLOW ,
.Nm LIGHTBROWN ,
.Nm LIGHTBLUE ,
.Nm LIGHTMAGENTA
و
.Nm LIGHTWHITE .
پرچم‌های اضافی معتبر عبارتند از:
.Nm UNDERLINE ,
.Nm REVERSE ,
.Nm BLINK ,
.Nm DIM
و
.Nm BOLD .
.Pp
جفت‌های رنگی به شرح زیر هستند:
.Bl -tag -width 10
.It BRACKETS:
رنگ براکت‌های اطراف فیلدهای متنی را مشخص می‌کند.
.It HEXFIELD:
رنگی که محتوای پرونده با آن نمایش داده می‌شود را مشخص می‌کند.
.It INPUT:
هنگام وارد کردن متن، از این رنگ استفاده می‌شود.
.It CURSOR:
مکان‌نما در فیلد هگز این رنگ را دارد.
.It TEXT:
این رنگ برای متن‌های اطلاع‌رسانی و همچنین فیلدهای متنی که هنوز ورودی دریافت نمی‌کنند به کار می‌رود.
.It MENU_NORMAL:
گزینه‌های منو که انتخاب نشده‌اند به این گروه رنگی تعلق دارند.
.It MENU_HIGHLIGHT:
گزینه انتخاب‌شده منو با این رنگ ویژه نمایش داده می‌شود.
.It MENU_HOTKEY:
کلیدهای میانبر گزینه‌های منو به خاطر داشتن این رنگ از سایر متن‌ها متمایز هستند.
.It MENU_HOTKEY_HI:
اگر گزینه فعلی منو دارای کلید میانبر باشد، با این رنگ نمایش داده می‌شود.
.It FRAME:
برخی صفحه‌ها دارای قاب (frame) هستند. آن قاب‌ها این رنگ را دارند.
.It NORMAL_DIFF:
تفاوت‌های محتوای پرونده (ناشی از تغییرات یا اجرای dhex در حالت diff) با این رنگ مشخص می‌شوند.
.It CURSOR_DIFF:
اگر مکان‌نما روی یکی از این تفاوت‌ها قرار گیرد، این رنگ را خواهد داشت.
.It HEADLINE:
در بالای صفحه، یک تیتر (headline) وجود دارد که با این رنگ نشان داده می‌شود.
.It HEADER:
درون تیتر، براکت‌هایی قرار دارند. درون آن براکت‌ها سربرگ (header) قرار گرفته است که هدف پنجره را بیان می‌کند.
.El
.Ss "بخش جدول تبدیل کلیدها (Key conversion tab section)"
هنگام فشردن یک کلید «استاندارد» (چیزی که بتواند مستقیماً به یک نویسه اسکی نگاشت شود)، تنها آن نویسه وارد بافر ncurses می‌شود. با این حال، فشردن کلیدهای ویژه (برای نمونه
.Nm F1
یا
.Nm ALT+6 )
دنباله‌های طولانی‌تری تولید می‌کند. نگاشت دوباره این دنباله‌ها به یک کلید مشخص، وظیفه جدول تبدیل کلیدها است (نویسنده برنامه از نحوه مدیریت خودکار این موضوع در ncurses رضایت نداشته است). این دنباله‌ها (به ترتیب) نامیده می‌شوند:
.Nm KEYF1 ,
.Nm KEYF2 ,
.Nm KEYF3 ,
.Nm KEYF4 ,
.Nm KEYF5 ,
.Nm KEYF6 ,
.Nm KEYF7 ,
.Nm KEYF8 ,
.Nm KEYF9 ,
.Nm KEYF10 ,
.Nm KEYESC ,
.Nm KEYBACKSPACE ,
.Nm KEYDEL ,
.Nm KEYENTER ,
.Nm KEYTAB ,
.Nm KEYUP ,
.Nm KEYDOWN ,
.Nm KEYRIGHT ,
.Nm KEYLEFT ,
.Nm KEYPGUP ,
.Nm KEYPGDOWN ,
.Nm KEYHOME
و
.Nm KEYEND .
.Pp
دنباله‌ها خود رشته‌ای از مقادیر هگز با حروف کوچک هستند که طول هر کدام دو نیم‌بایت (nibble) است. در حال حاضر، روشی برای افزودن یک دنباله جایگزین برای یک کلید یکسان وجود ندارد.
.Pp
این احتمال وجود دارد که دنباله ساخته‌شده از مقادیر هگز، واقعاً به آن کلید تعلق نداشته باشد (برای نمونه اگر هنگام درخواست F1 در برنامه پیکربندی، کلید F2 فشرده شده باشد).
با این وجود، هنگامی که این دنباله وارد بافر ncurses می‌شود، به گونه‌ای تفسیر خواهد شد که گویی آن کلید فشرده شده است.
.Sh "اشکالات (BUGS)"
گزارش اشکالات را به
.An Aq dettus@dettus.net
ارسال نمایید.
حتماً عبارت DHEX را در بخشی از عنوان موضوع (subject) درج کنید.
.Sh "نویسنده (AUTHOR)"
نوشته شده توسط
.An Thomas Dettbarn
.Sh "همچنین ببینید (SEE ALSO)"
.Xr dhex 1 ,
.Xr dhex_markers 5 ,
.Xr dhex_searchlog 5