نام (NAME)

xdvi - پیش‌نمایشگر DVI برای سیستم پنجره‌ای X

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

xdvi [+[page]] [--help] [-allowshell] [-altfont font] [-anchorposition anchor] [-bg color] [-browser WWWbrowser] [-copy] [-cr color] [-debug bitmask|string[,string ...]] [-display host:display] [-dvipspath path] [-editor command] [-expert] [-expertmode flag] [-fg color] [-findstring string] [-font font] [-fullscreen ] [-gamma g] [-geometry geometry] [-gsalpha] [-gspalette palette] [-h] [-help] [-hl color] [-hush] [-hushbell] [-hushchars] [-hushchecksums] [-hushstdout] [-icongeometry geometry] [-iconic] [-install] [-interpreter path] [-keep] [-l] [-license] [-linkcolor color] [-linkstyle 0|1|2|3] [-margins dimen] [-mfmode mode-def[:dpi]] [-mgs[n] size] [-mousemode 0|1|2] [-nocolor] [-nofork] [-noghostscript] [-nogrey] [-nogssafer] [-noinstall] [-nomakepk] [-nomatchinverted] [-noomega] [-noscan] [-notempfile] [-notype1fonts] [-offsets dimen] [-p pixels] [-paper papertype] [-pause] [-pausespecial special-string] [-postscript flag] [-rulecolor color] [-rv] [-S density] [-s shrink] [-safer] [-sidemargin dimen] [-sourceposition line[:col][ ]filename] [-statusline] [-text-encoding encoding] [-thorough] [-topmargin dimen] [-unique] [-version] [-visitedlinkcolor color] [-warnspecials] [-watchfile secs] [-wheelunit pixels] [-xoffset dimen] [-yoffset dimen] [dvi_file] برنامهٔ Xdvi ابزاری برای پیش‌نمایش فایل‌های dvi (مانند فایل‌های تولیدشده توسط برنامهٔ tex(1)) تحت سیستم پنجره‌ای X است.

Xdvi می‌تواند فایل را با ضریب‌های صحیح گوناگون به‌صورت کوچک‌شده نمایش دهد و دارای یک «ذره‌بین» برای مشاهدهٔ بخش‌هایی از صفحه به‌صورت بزرگ‌نمایی‌شده است (بخش MAGNIFIER را در زیر ببینید). این نسخه از xdvi با نام xdvik نیز شناخته می‌شود، چرا که از کتابخانهٔ kpathsea برای مکان‌یابی و تولید فایل‌های فونت استفاده می‌کند. علاوه بر آن، از قابلیت‌های زیر پشتیبانی می‌کند:

Xdvi می‌تواند با جعبه‌ابزار Motif یا جعبه‌ابزار Xaw (Athena) (و گونه‌های آن) کامپایل شود و نسخهٔ Motif دارای واسط گرافیکی کاربر (GUI) کمی متفاوت است؛ این تفاوت‌ها در زیر ذکر شده‌اند.

پیش از نمایش یک صفحه از فایل DVI، برنامهٔ xdvi بررسی می‌کند که آیا فایل از زمان آخرین نمایش تغییر کرده است یا خیر. در این صورت، فایل را دوباره بارگذاری می‌کند. این ویژگی به شما اجازه می‌دهد تا بدون نیاز به اجرای مجدد، نسخه‌های متعددی از یک فایل را در حین اجرای تنها یک‌بارهٔ xdvi مشاهده کنید. از آنجا که این برنامه نمی‌تواند فایل‌های DVI ناقص را بخواند، نسخه‌های xdvik از نگارش 22.74.3 به بعد، یک رونوشت موقت از فایل DVI در حال مشاهده ایجاد می‌کنند تا اطمینان حاصل شود که فایل بدون وقفه قابل مشاهده است (گزینهٔ -notempfile می‌تواند برای غیرفعال کردن این ویژگی استفاده شود).

Xdvi می‌تواند دستورهای ویژهٔ PostScript<tm> را با هر یک از سه روش نمایش دهد. ابتدا تلاش می‌کند از Display PostScript<tm> استفاده کند، سپس NeWS، و در نهایت برای رندر کردن تصاویر از Ghostscript استفاده خواهد کرد. همهٔ این گزینه‌ها برای کارکرد درست به نرم‌افزارهای جانبی وابسته هستند؛ علاوه بر این، ممکن است برخی از آن‌ها در این نسخه از xdvi کامپایل نشده باشند.

به دلایل کارایی و عملکرد، xdvi دستورهای ویژهٔ PostScript را در ذره‌بین رندر نمی‌کند.

اگر هیچ نام فایلی در خط فرمان مشخص نشده باشد، xdvi تلاش می‌کند آخرین فایل بازشده را باز کند؛ اگر تاریخچهٔ فایل‌ها (قابل دسترسی از طریق منوی File > Open Recent ) خالی باشد، یا اگر هیچ‌یک از فایل‌های موجود در تاریخچه فایل‌های DVI معتبری نباشند، یک پنجرهٔ انتخاب فایل برای گزینش نام فایل باز خواهد شد. (در نسخه‌های پیشین که فاقد تاریخچهٔ فایل بودند، پنجرهٔ انتخاب فایل همواره استفاده می‌شد؛ می‌توانید منبع X با نام noFileArgUseHistory را برابر با false قرار دهید تا رفتار پیشین بازگردد.)

گزینه‌ها (OPTIONS)

علاوه بر مشخص کردن فایل dvi (با یا بدون پسوند .dvi)، برنامهٔ xdvi از گزینه‌های خط فرمان زیر پشتیبانی می‌کند. اگر گزینه‌ای به جای `-' با `+' آغاز شود، آن گزینه به مقدار پیش‌فرض خود بازمی‌گردد. به‌طور پیش‌فرض، این گزینه‌ها می‌توانند از طریق نام منابعی که در پرانتز جلوی توضیحات هر گزینه آمده است، تنظیم شوند.

+page

اولین صفحه‌ای را که باید نمایش داده شود مشخص می‌کند. اگر + بدون شماره داده شود، صفحهٔ آخر در نظر گرفته می‌شود؛ پیش‌فرض، صفحهٔ اول است.

-allowshell

(.allowShell) این گزینه گریز به پوسته (shell escape) را در دستورهای ویژهٔ PostScript فعال می‌کند. (به دلایل امنیتی، گریز به پوسته به‌طور پیش‌فرض غیرفعال است.) این گزینه باید به ندرت استفاده شود؛ به‌ویژه نباید صرفاً برای از حالت فشرده خارج کردن فایل‌ها به کار رود: این کار در صورتی که نام فایل به .Z، .gz یا .bz2 ختم شود، به‌طور خودکار انجام می‌پذیرد. گریز به پوسته در صورت استفاده از گزینهٔ -safer همواره غیرفعال خواهد بود.

-altfont font

(.altFont) یک فونت پیش‌فرض را تعیین می‌کند تا در صورتی که فونت موجود در فایل dvi پیدا نشد، از آن استفاده شود. این قابلیت برای مثال با فونت‌های PostScript <tm> مفید است.

-anchorposition anchor

پس از باز کردن فایل DVI، به anchor پرش می‌کند. این ویژگی تنها زمانی مفید است که xdvi از برنامه‌های دیگر فراخوانی شود.

-background color

(.background) رنگ پس‌زمینه را تعیین می‌کند. مشابه -bg است.

-bg color

(.background) رنگ پس‌زمینه را تعیین می‌کند.

-browser browser

(.wwwBrowser) مرورگر وبی را مشخص می‌کند که برای مدیریت URLهای خارجی استفاده می‌شود. مقدار این گزینه یا منبع دارای ساختار نحوی مشابه متغیر محیطی BROWSER است؛ برای شرح تفصیلی، توضیحات آن متغیر را در بخش «محیط (ENVIRONMENT)» در زیر ببینید. اگر نه این گزینه و نه منبع X با نام wwwBrowser مشخص نشده باشند، متغیرهای محیطی BROWSER و WWWBROWSER (به همین ترتیب) برای تعیین دستور مرورگر استفاده می‌شوند. اگر این متغیرها نیز تنظیم نشده باشند، مقدار پیش‌فرض زیر به کار می‌رود: xdg-open %s:htmlview %s:firefox -remote -remote "openURL(%s,new-window)":mozilla -remote "openURL(%s,new-window)":netscape -raise -remote "openURL(%s,new-window)":xterm -e w3m %s:xterm -e lynx %s:xterm -e wget %s

-copy

(.copy) هنگام نوشتن نویسه‌ها بر روی صفحهٔ نمایش، همواره از عملیات copy استفاده می‌کند. این گزینه ممکن است برای عملکرد درست در یک نمایشگر رنگی ضروری باشد، اما نویسه‌های چندبار چاپ شده (overstrike) نادرست خواهند بود. اگر هموارسازی (anti-aliasing) در مقیاس خاکستری در حال استفاده باشد، عملیات -copy استفاده از صفحه‌های رنگی (colorplanes) را غیرفعال کرده و باعث می‌شود overstrikeها نادرست نمایش یابند. همچنین ببینید: -thorough.

-cr color

(.cursorColor) رنگ مکان‌نمای موش‌واره را تعیین می‌کند. مقدار پیش‌فرض همان رنگ پیش‌زمینه است.

-debug bitmask|string[,string ...]

(.debugLevel) در صورت غیرصفر بودن، اطلاعات تکمیلی را در خروجی استاندارد چاپ می‌کند. آرگومان می‌تواند یک ماسک بیتی مشخص‌شده به‌صورت عدد ده‌دهی، یا فهرستی از رشته‌های جداشده با کاما باشد.
برای نمایش بر پایهٔ ماسک بیتی، مقادیر چندگانه را می‌توان با جمع‌کردن اعدادی که بیت‌های مجزا را نشان می‌دهند مشخص کرد؛ برای نمونه جهت اشکال‌زدایی تمام دستورهای جستجو و باز کردن فایل، از عدد 4032 (= 2048 + 1024 + 512 + 256 + 128 + 64) استفاده کنید. برای فعال کردن اشکال‌زدایی همه‌چیز از -1 استفاده کنید (که خروجی بسیار حجیمی تولید خواهد کرد).
برای نمایش بر پایهٔ رشته، از رشته‌های فهرست‌شده در جدول زیر استفاده کنید، به‌طوری‌که مقادیر با کاما از هم جدا شوند؛ برای نمونه جهت اشکال‌زدایی تمام دستورهای جستجو و باز کردن فایل، از search,expand,paths,hash,stat,open استفاده کنید. (گزینهٔ `kpathsea' به عنوان میان‌بری برای این موارد ارائه شده است.) توجه داشته باشید که ممکن است نیاز باشد چنین فهرستی در نقل‌قول قرار گیرد تا از تفسیر کاماها یا فاصله‌ها توسط پوسته جلوگیری شود.
اعداد و رشته‌های مجزا دارای معانی زیر هستند:

1	bitmap	ساخت نقشه‌بیتی (Bitmap)
2	dvi	ترجمهٔ DVI
4	pk	فونت‌های PK
8	batch	حالت دسته‌ای: خروج پس از
		خواندن فایل DVI
16	event	مدیریت رویداد
32	ps	فراخوانی‌های مفسر PostScript
64	stat	فراخوانی‌های stat(2) در Kpathsea
128	hash	جستجوهای جدول هش Kpathsea
256	open	باز کردن فایل Kpathsea
512	paths	تعاریف مسیر Kpathsea
1024	expand	بسط مسیر Kpathsea
2048	search	جستجوی Kpathsea
4032	kpathsea	تمام گزینه‌های Kpathsea
4096	htex	دستورهای ویژهٔ Hypertex
8192	src	دستورهای ویژهٔ مبدأ (Source specials)
16384	client	حالت کلاینت/سرور (گزینه‌های -unique
		و -sourceposition را ببینید)
32768	ft	پیام‌های کتابخانهٔ FreeType (فونت‌های Type 1)
65536	ft_verbose	پیام‌های پرجزئیات کتابخانهٔ FreeType (در حال حاضر استفاده نمی‌شود)
131072	gui	عناصر GUI
262144	find	جستجوی رشته‌ها در فایل DVI
524288	files	تاریخچهٔ فایل و باز کردن فایل‌های DVI

برخی از گزینه‌های اشکال‌زدایی Kpathsea در واقع توسط خود Kpathsea ارائه می‌شوند؛ برای اطلاعات بیشتر دربارهٔ آن‌ها، بخش Debugging را در راهنمای Kpathsea ببینید. -density density (.densityPercent) تراکم مورد استفاده هنگام کوچک‌سازی نقشه‌بیتی‌ها (bitmaps) برای فونت‌ها را تعیین می‌کند. مقدار بالاتر فونت روشن‌تری تولید می‌کند. مقدار پیش‌فرض 40 است. اگر مقیاس خاکستری (greyscaling) در حال استفاده باشد، این آرگومان اعمال نمی‌شود؛ به جای آن از -gamma استفاده کنید. همچنین کلید `S' را ببینید. معادل -S است.

-display host:display

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

-dvipspath path

(.dvipsPath) از path به عنوان برنامه dvips جهت چاپ استفاده می‌کند. مقدار پیش‌فرض برای این گزینه dvips است. برنامه یا اسکریپت باید فایل DVI را از ورودی استاندارد خوانده و فایل PostScript را در خروجی استاندارد بنویسد.

-editor editor

(.editor) ویرایشگری را مشخص می‌کند که هنگام فعال شدن کنش source-special() جهت آغاز یک جستجوی معکوس (به‌طور پیش‌فرض از طریق Ctrl-Mouse 1) فراخوانی می‌شود. آرگومان این گزینه یک رشته قالب‌بندی است که در آن رخدادهای ``%f'' با نام فایل، رخدادهای ``%l'' با شماره سطر درون فایل، و رخدادهای اختیاری ``%c'' با شماره ستون درون سطر جایگزین می‌شوند.

اگر نه این گزینه و نه منبع X مربوط به .editor مشخص نشده باشند، متغیرهای محیطی زیر به ترتیب برای تعیین دستور ویرایشگر بررسی می‌شوند: XEDITOR، VISUAL و EDITOR (با همین ترتیب). اگر رشته به عنوان مقدار متغیرهای محیطی VISUAL یا EDITOR یافت شود، عبارت ``xterm -e '' به ابتدای رشته افزوده می‌شود؛ اگر ویرایشگر به روش‌های دیگری مشخص شده باشد، باید به شکل یک دستور پوسته باشد تا پنجره‌ای از X را به همراه ویرایشگری درون آن باز کند. اگر هیچ‌یک از این متغیرها تنظیم نشده باشند، پیامی هشدارآمیز نمایش داده شده و از دستور ``xterm -e vi +%l %f'' استفاده می‌شود.

اگر هیچ ``%f'' یا ``%l'' در رشته وجود نداشته باشد، رشته‌های قالب‌بندی ناموجود به‌طور خودکار به انتهای آن افزوده می‌شوند. (این امر برای سازگاری با برنامه‌های دیگر هنگام استفاده از یکی از متغیرهای محیطی است).

هر بار که این دستور استفاده شود، نمونه جدیدی از ویرایشگر اجرا می‌شود؛ بنابراین ترجیح داده می‌شود از ویرایشگری استفاده شود که بتوان آن را در حالت «کلاینت» فراخوانی کرد تا فایل‌های جدید را در همان نمونه بارگذاری کند. تنظیمات نمونه عبارتند از:

-expert

این گزینه تنها برای سازگاری رو به عقب پشتیبانی می‌شود؛ این گزینه معادل -expertmode 0 است که باید در اولویت قرار گیرد.

-expertmode flag

(.expertMode) با آرگومان 0، این گزینه نمایش دکمه‌ها، نوارهای پیمایش، نوار ابزار (تنها در Motif)، خط وضعیت و فهرست صفحات را خاموش می‌کند. این عناصر رابط کاربری گرافیکی را می‌توان با ترکیب مقادیر مناسب در آرگومان flag به‌طور جداگانه نیز (غیر)فعال کرد. این گزینه رفتاری مشابه با گزینه -debug دارد: عدد صحیح flag مانند یک نقشه‌بیت رفتار می‌کند که در آن هر بیت نشان‌دهنده یک عنصر است. اگر مقدار بیت 1 باشد، عنصر روشن است و اگر مقدار آن 0 باشد، عنصر خاموش است. معنای بیت‌ها به شرح زیر است:

1	statusline
2	scrollbars
4	Motif: pagelist, Xaw: buttons and pagelist
8	toolbar (Motif only)
16	menubar (Motif only)

برای نمونه، جهت فعال کردن تنها سطر وضعیت و نوارهای پیمایش، از مقدار 3 (= 1 + 2) استفاده کنید. همچنین کلید `x' را ببینید که در آن بیت‌ها بر اساس موقعیتشان، به ترتیب از 1 تا 3 (در Xaw) یا 5 (در Motif) نشانه‌گذاری می‌شوند.

اگر سطر وضعیت فعال نباشد، تمام پیام‌هایی که معمولاً در سطر وضعیت نمایش داده می‌شدند در stdout چاپ خواهند شد، مگر اینکه گزینه -hushstdout به کار رفته باشد.

-fg color

(.foreground) رنگ متن (پیش‌زمینه) را تعیین می‌کند.

-findstring string

این گزینه جستجویی را برای string در فایل DVI ذکر شده در خط فرمان، مشابه با جستجوی مستقیم آغاز می‌کند (توضیحات گزینه sourceposition را ببینید): اگر در حال حاضر نمونه دیگری از xdvi در حال نمایش آن فایل DVI باشد، باعث می‌شود که آن نمونه به جای این، جستجو را انجام دهد. جستجو از بالای صفحه جاری در فایل DVI آغاز می‌شود.

-font font

(*font) فونت مورد استفاده در منوها، دکمه‌ها و غیره را مطابق توضیحات صفحه راهنمای X(7x) تنظیم می‌کند. فونت پنجره‌های فرزند را می‌توان جداگانه تنظیم کرد، مانند:

xdvi*statusline*font: \
   -*-helvetica-medium-r-*-*-12-*-*-*-*-*-*-*

-fullscreen

هنگامی که این گزینه استفاده شود، xdvi (تلاش خواهد کرد تا) در حالت تمام‌صفحه و بدون تزئینات پنجره اجرا شود. تضمینی وجود ندارد که این گزینه با همه مدیر پنجره‌ها/میزکارها کار کند؛ اگر با آن با مشکل مواجه شدید، لطفاً در عوض از گزینه -geometry و تنظیمات مناسب مدیر پنجره برای حذف تزئینات پنجره استفاده کنید. هنگام استفاده از این گزینه برای ارائه‌ها، ممکن است بخواهید تمام ابزارک‌های کنترلی را نیز با استفاده از گزینه -expertmode حذف کنید. این گزینه همچنین می‌تواند در زمان اجرا با استفاده از کنش fullscreen (که به‌طور پیش‌فرض به Ctrl-l مقید شده است) تغییر وضعیت دهد.

-gamma gamma

(.gamma) درونیابی رنگ‌ها در پالت رنگی ضدپلگی (anti-aliasing) در مقیاس خاکستری را کنترل می‌کند. مقدار پیش‌فرض 1.0 است. برای 0 < gamma < 1، قلم‌ها روشن‌تر خواهند بود (بیشتر شبیه به پس‌زمینه)، و برای gamma > 1، قلم‌ها تیره‌تر خواهند بود (بیشتر شبیه به پیش‌زمینه). مقادیر منفی رفتار مشابهی دارند، اما از الگوریتم متفاوتی استفاده می‌کنند. برای نمایشگرهای رنگی و مقیاس خاکستری؛ برای تک‌رنگ، گزینه -density را ببینید. همچنین کلید `S' را ببینید.

-geometry geometry

(.geometry) ابعاد و موقعیت اولیه پنجره اصلی را طبق توضیحات صفحه راهنمای X(7x) مشخص می‌کند. ابعاد و موقعیت پنجره‌های فرزند می‌تواند جداگانه تعیین شود، مانند:
xdvi*helpwindow.geometry: 600x800

-gsalpha

(.gsAlpha) باعث می‌شود Ghostscript به‌جای درایور x11 با درایور x11alpha فراخوانی شود. درایور x11alpha قابلیت anti-aliasing را در ویژگی‌های خاص (specials) PostScript برای ظاهری زیباتر فعال می‌کند. این درایور در نگارش‌های جدیدتر Ghostscript در دسترس است. این گزینه همچنین با کلید `V' قابل تغییر وضعیت است.

-gspalette palette

(.palette) پالتی را که هنگام استفاده از Ghostscript برای رندر ویژگی‌های خاص PostScript استفاده می‌شود مشخص می‌کند. مقادیر ممکن عبارتند از Color، Greyscale و Monochrome. پیش‌فرض Color است.

-h, -help, --help

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

-hl color

(.highlight) رنگ حاشیه صفحه، خط‌کش در «حالت خط‌کش» (`ruler mode`)، و نشانگرهای برجسته‌سازی در جستجوی رو به جلو و جستجوی رشته را تعیین می‌کند. پیش‌فرض رنگ پیش‌زمینه است.

-hush

(.Hush) باعث می‌شود xdvi تمام هشدارهای قابل چشم‌پوشی را نادیده بگیرد.

-hushbell

(.hushBell) هنگام رخ دادن خطا، زنگ X به صدا درنمی‌آید.

-hushchars

(.hushLostChars) باعث می‌شود xdvi هشدارهای مربوط به ارجاع به نویسه‌هایی که در قلم تعریف نشده‌اند را نادیده بگیرد.

-hushchecksums

(.hushChecksums) باعث می‌شود xdvi هشدارهای مربوط به عدم تطابق چکسام بین فایل dvi و فایل قلم را نادیده بگیرد.

-hushstdout

(.hushStdout) از چاپ پیام‌های وضعیت در stdout جلوگیری می‌کند. توجه داشته باشید که حتی در صورت استفاده از این گزینه، خطاها یا هشدارها همچنان در stderr چاپ خواهند شد.

-icongeometry geometry

(.iconGeometry) موقعیت اولیه آیکون را مشخص می‌کند.

-iconic

(.iconic) باعث می‌شود پنجره xdvi در حالت آیکون‌شده (iconic) آغاز به کار کند. پیش‌فرض این است که پنجره باز شروع به کار کند.

-install

(.install) اگر xdvi تحت یک نمای بصری PseudoColor اجرا شود، آنگاه (به‌طور پیش‌فرض) نماهای بصری TrueColor با عمق بیت بر پیکسل بیشتر را بررسی کرده و در صورت وجود، به چنین نمایی تغییر وضعیت می‌دهد. اگر چنین نمایی وجود نداشته باشد، از نما و نقشه رنگی (colormap) فعلی استفاده خواهد کرد. با این حال اگر -install انتخاب شده باشد، همچنان در صورت در دسترس بودن، از نمای TrueColor با عمق بیشتر استفاده خواهد کرد؛ در غیر این صورت، نقشه رنگی اختصاصی خود را بر روی نمای فعلی نصب می‌کند. اگر نمای فعلی PseudoColor نباشد، آنگاه xdvi صرف‌نظر از گزینه‌هایش، نما یا نقشه رنگی را تغییر نخواهد داد. مقدار پیش‌فرض منبع install مقدار ویژه maybe است. گزینه +install وجود ندارد. همچنین -noinstall و بخش GREYSCALING AND COLORMAPS را ببینید.

-interpreter filename

(.interpreter) از filename به عنوان مفسر Ghostscript استفاده می‌کند. به‌طور پیش‌فرض از gs استفاده می‌کند.

-keep

(.keepPosition) پرچمی را تنظیم می‌کند که نشان می‌دهد xdvi هنگام رفتن به صفحه‌ای جدید نباید به موقعیت مبدا برود. همچنین کلید `k' را ببینید. این پرچم توسط تمام کنش‌های تغییر صفحه و توسط up-or-previous() / down-or-next() رعایت می‌شود، اگرچه موارد اخیر تنها موقعیت افقی را در نظر می‌گیرند و نه عمودی را. این قابلیت امکان پیمایش «پیوسته» به جلو و عقب را در سندی که پنجره نمایش آن باریک‌تر از پهنای صفحه است فراهم می‌سازد.

-l

(.listFonts) فهرست کردن نام‌های تمام قلم‌های استفاده‌شده.

-license

اطلاعات مجوز را چاپ می‌کند. -linkcolor (.linkColor) رنگ استفاده‌شده برای پیوندهای یکپارچه بازدیدنشده (به‌طور پیش‌فرض `Blue2'). پیوندها پیش از کلیک روی آن‌ها، یا پس از بارگذاری مجدد فایل DVI، بازدیدنشده محسوب می‌شوند. مقدار باید نام معتبر یک رنگ در سامانه پنجره X (مانند DarkGoldenrod4) یا یک رشته رنگ هگزادسیمال (مانند #8b6508) باشد. همچنین ببینید: -visitedlinkcolor و -linkstyle.

-linkstyle

(.LinkStyle) سبک نمایش پیوندها را تعیین می‌کند. مقادیر ممکن و معانی آن‌ها عبارتند از:

0	بدون برجسته‌سازی پیوندها
1	خط زیر پیوندها با رنگ پیوند
2	بدون خط زیرین، رنگ‌آمیزی متن با رنگ پیوند
3	خط زیرین و نمایش متن به
	رنگ پیوند

مقادیر مربوط به رنگ پیوند توسط گزینه‌ها/منابع -linkcolor و -visitedlinkcolor (به آن‌ها مراجعه کنید) مشخص می‌شوند.

-margins dimen

(.Margin) اندازه هر دو حاشیه بالایی و حاشیه کناری را مشخص می‌کند. این گزینه موقعیت «آغازین» (home) صفحه در پنجره را به صورت زیر تعیین می‌کند. اگر کل صفحه در پنجره جا شود، تنظیمات حاشیه نادیده گرفته می‌شوند. اگر حتی پس از حذف حاشیه‌ها از چپ، راست، بالا و پایین، صفحه باز هم در پنجره جا نشود، صفحه به گونه‌ای در پنجره قرار می‌گیرد که حاشیه‌های بالا و چپ پنهان شوند، و قاعدتاً گوشه بالا سمت چپ متن صفحه در گوشه بالا سمت چپ پنجره قرار خواهد گرفت. در غیر این صورت، متن در پنجره وسط‌چین می‌شود. اندازه باید یک عدد اعشاری باشد که در صورت تمایل هر یک از اختصارات دوحرفی واحدهای پذیرفته‌شده توسط TeX (pt، pc، in، bp، cm، mm، dd، cc، یا sp) به دنبال آن می‌آید. به‌طور پیش‌فرض، واحد cm (سانتی‌متر) خواهد بود. همچنین ببینید: -sidemargin، -topmargin و کلید `M'.

-mfmode mode-def

(.mfMode) یک رشته mode-def را مشخص می‌کند که می‌تواند در جستجوی قلم‌ها به کار رود (بخش «محیط (ENVIRONMENT)» در ادامه را ببینید). به‌طور کلی، هنگام تغییر mode-def، لازم است اندازه قلم نیز به مقدار مناسب برای آن حالت تغییر داده شود. این کار با افزودن دونقطه و مقدار بر حسب نقطه در اینچ انجام می‌شود؛ برای نمونه: -mfmode ljfour:600. این روش هر مقداری را که توسط منبع pixelsPerInch یا آرگومان خط فرمان -p تعیین شده باشد لغو و جایگزین می‌کند. حالت metafont همچنین هنگام ساخت خودکار قلم‌ها به metafont ارسال می‌شود. به‌طور پیش‌فرض، مقدار آن unspecified (تعیین‌نشده) است.

-mgs size

مشابه -mgs1.

-mgs[n] size

(.magnifierSize[n]) اندازه پنجره مورد استفاده برای «ذره‌بین» را برای دکمه n مشخص می‌کند. اندازه ممکن است به عنوان یک عدد صحیح داده شود (که نشان می‌دهد ذره‌بین باید مربع باشد)، یا می‌تواند به صورت widthxheight مشخص شود. بخش «اقدامات موشواره (MOUSE ACTIONS)» را ببینید. مقادیر پیش‌فرض عبارتند از: 200x150، 400x250، 700x500، 1000x800 و 1200x1200.

-mousemode [0|1|2]

(.mouseMode) حالت پیش‌فرض xdvi را هنگام راه‌اندازی مشخص می‌کند: ذره‌بین (0)، حالت گزینش متن (1) یا حالت خط‌کش (2). برای اطلاعات بیشتر بخش MODES در زیر را ببینید.

-nocolor

(.color) استفاده از مشخصه‌های ویژه رنگ (color specials) را غیرفعال می‌کند. این گزینه را می‌توان با فشردن کلید `C' تغییر وضعیت داد (فعال/غیرفعال کرد). (توجه: -nocolor معادل color:off و +nocolor معادل color:on است.)

-nofork

(.fork) در صورت استفاده از گزینه‌های -sourceposition و -unique، رفتار پیش‌فرض xdvi این است که اگر نمونه مناسبی از xdvi از قبل در حال اجرا نباشد، خود را به پس‌زمینه بفرستد (مانند یک دیمن). این آرگومان باعث می‌شود که در عوض در پیش‌زمینه اجرا شود. این قابلیت برای اشکال‌زدایی مفید است، یا زمانی که برنامه کلاینت شما نتواند با برنامه‌ای که بدین شکل خود را به پس‌زمینه می‌برد به‌خوبی تعامل کند -- برای نمونه، مشخص شده که توابع IPC در emacs با این موضوع مشکل دارند. اگر هیچ آرگومان -sourceposition یا -unique داده نشود، این گزینه هیچ اثری ندارد. (توجه: -nofork معادل fork:off و +nofork معادل fork:on است.)

-noghostscript

(.ghostscript) از استفاده از Ghostscript برای نمایش مشخصه‌های ویژه PostScript<tm> جلوگیری می‌کند. (توجه: -noghostscript معادل ghostscript:off و +noghostscript معادل ghostscript:on است.)

-nogrey

(.grey) استفاده از هموارسازی (anti-aliasing) با طیف خاکستری را هنگام چاپ بیت‌مپ‌های کوچک‌شده غیرفعال می‌کند. (توجه: -nogrey معادل grey:off و +nogrey معادل grey:on است.) همچنین کلید `G' را ببینید.

-nogssafer

(.gsSafer) به‌طور معمول، اگر از Ghostscript برای پردازش مشخصه‌های ویژه PostScript استفاده شود، مفسر Ghostscript با گزینه -dSAFER اجرا می‌شود. گزینه -nogssafer برنامه Ghostscript را بدون -dSAFER اجرا می‌کند. گزینه -dSAFER در Ghostscript عملگرهای PostScript مانند deletefile را غیرفعال می‌سازد تا از اثرگذاری برنامه‌های مخرب احتمالی PostScript جلوگیری کند. اگر گزینه -safer مشخص شده باشد، این گزینه هیچ اثری نخواهد داشت؛ در آن حالت Ghostscript همواره با -dSAFER اجرا می‌شود. (توجه: -nogssafer معادل gsSafer:off و +nogssafer معادل gsSafer:on است.) -noinstall (.install) جلوگیری از رفتار پیش‌فرضِ جابجایی به یک نمای TrueColor در صورتی که نمایی با تعداد بیت بر پیکسلِ بیشتری نسبت به نمای فعلی در دسترس باشد. (نکته: -noinstall معادل install:off است؛ گزینه‌ای به نام +noinstall وجود ندارد.) همچنین ببینید: -install و بخش GREYSCALING AND COLORMAPS.

-nomakepk

(.makePk) تولید خودکار فایل‌های فونتی را که از روش‌های دیگر یافت نمی‌شوند، غیرفعال می‌کند. (نکته: -nomakepk معادل makePk:off و +nomakepk معادل makePK:on است.)

-nomatchinverted

(.matchInverted) تطابق‌های جستجوی رشته را با رنگ معکوس برجسته نمی‌کند؛ در عوض، مستطیلی با رنگ highlight (گزینهٔ -hl را ببینید) دور مورد منطبق رسم می‌کند. این گزینه در صورتی که نمایشگر در حالت TrueColor اجرا نشود، به طور خودکار فعال می‌شود. (نکته: -nomatchinverted معادل matchInverted:off و +nomatchinverted معادل matchInverted:on است.)

-noomega

(.omega) این گزینه استفاده از افزونه‌های Omega را هنگام تفسیر فایل‌های DVI غیرفعال می‌کند. به طور پیش‌فرض، کدهای دستور (opcodes) اضافی 129 و 134 توسط xdvi به عنوان افزونه‌های Omega شناخته شده و به عنوان درخواست‌هایی برای حروف‌چینی نویسه‌های ۲-بایتی تفسیر می‌شوند. تنها عیب این کار آن است که آرایهٔ فونت مجازی به جای ۲۵۶ موقعیت پیش‌فرض، به ۶۵۵۳۶ موقعیت نیاز خواهد داشت؛ یعنی نیازمندی‌های حافظهٔ xdvi اندکی بیشتر خواهد بود. اگر این موضوع برایتان غیرقابل قبول است یا با مشکل دیگری در افزونه‌های Omega مواجه شدید، می‌توانید با استفاده از -noomega این افزونه را غیرفعال کنید (اما لطفاً در صورت مشاهدهٔ چنین مشکلاتی یک گزارش باگ ارسال نمایید - نشانی گزارش باگ را در بخش AUTHORS در زیر ببینید).
(نکته: -noomega معادل omega: off و +noomega معادل omega: on است.)

-noscan

(.prescan) به طور پیش‌فرض، xdvi یک اسکن مقدماتی روی فایل dvi انجام می‌دهد تا دستورات ویژهٔ (specials) papersize را پردازش کند؛ این امر به ویژه هنگام راه‌اندازی بسیار حائز اهمیت است زیرا ممکن است اندازهٔ کاغذ برای تعیین اندازهٔ پنجره مورد نیاز باشد. اگر PostScript<tm> در حال استفاده باشد، پیش‌اسکن (prescanning) برای پردازش صحیح فایل‌های سرایند (header) نیز ضروری است. علاوه بر این، پیش‌اسکن برای تعیین صحیح رنگ پس‌زمینهٔ صفحه لازم است. این گزینه چنین پیش‌اسکنی را غیرفعال می‌کند. (در صورتی که xdvi هر یک از دستورات ویژهٔ ذکرشده در بالا را شناسایی کند، پیش‌اسکن به طور خودکار مجدداً فعال خواهد شد.) (نکته: -noscan معادل prescan:off و +noscan معادل prescan:on است.)

-notempfile

(.tempFile) همان‌طور که در بخش DESCRIPTION در بالا ذکر شد، xdvi یک نسخهٔ موقت از فایل DVI ایجاد می‌کند تا حتی در حین بازنویسی فایل توسط TeX، دسترسی به آن بدون وقفه امکان‌پذیر باشد. از آنجا که این کار در هر بار تغییر فایل، سربار کپی کردن را ایجاد می‌کند، گزینهٔ -notempfile به شما امکان می‌دهد این رفتار را غیرفعال کنید. در این حالت، نمایان شدن (expose) بخش‌هایی از پنجره در حالی که فایل DVI توسط TeX بازنویسی می‌شود، محتویات فعلی پنجره را تا زمانی که فایل DVI بتواند مجدداً به طور کامل خوانده شود، پاک خواهد کرد.
(نکته: -notempfile معادل tempFile:off و +notempfile معادل tempFile:on است.)

-notype1fonts

(.type1) این گزینه استفاده از کتابخانهٔ FreeType را برای نمایش فونت‌های PostScript<tm> Type 1 غیرفعال می‌کند. هنگام مواجهه با مشکل در نمایش فونت‌های Type 1، از این گزینه به عنوان یک راه‌حل موقت (workaround) استفاده کنید (اما لطفاً در این صورت، ارسال گزارش باگ به نشانی اینترنتی ذکرشده در بخش AUTHORS در زیر را فراموش نکنید).
(نکته: -notype1fonts معادل type1:off و +notype1fonts معادل type1:on است.)

-offsets dimen

(.Offset) اندازهٔ آفست‌های افقی و عمودی خروجی را روی صفحه مشخص می‌کند. طبق مصوبهٔ پروژهٔ استانفورد TeX، مبدأ پیش‌فرض صفحه در TeX همواره ۱ اینچ به سمت راست و ۱ اینچ به سمت پایین از گوشهٔ بالا-چپ صفحه است، حتی زمانی که اندازه‌های کاغذ غیرآمریکایی استفاده شوند. بنابراین، آفست‌های پیش‌فرض ۱٫۰ اینچ هستند. آرگومان dimen باید یک عدد اعشاری باشد که در صورت تمایل هر یک از اختصارات دو حرفیِ واحدهای پذیرفته‌شده توسط TeX می‌تواند در ادامهٔ آن بیاید (pt، pc، in، bp، cm، mm، dd، cc، یا sp). به طور پیش‌فرض، واحد cm (سانتی‌متر) خواهد بود. همچنین ببینید: -xoffset و -yoffset.

-p pixels

(.pixelsPerInch) اندازهٔ فونت‌های مورد استفاده را بر حسب پیکسل بر اینچ مشخص می‌کند. مقدار پیش‌فرض ۶۰۰ است. این گزینه صرفاً برای سازگاری با نسخه‌های قبلی ارائه شده است؛ روش ارجح این است که هم تفکیک‌پذیری و هم حالت Metafont را از طریق گزینهٔ -mfmode تنظیم کنید (به آن مراجعه کنید).

-paper papertype

(.paper) اندازهٔ صفحهٔ چاپ را مشخص می‌کند. توجه داشته باشید که در بیشتر موارد بهتر است اندازهٔ کاغذ در فایل ورودی TeX از طریق خطِ

\usepackage[dvips]{geometry}

مشخص شود که هم توسط dvips و هم xdvi شناخته خواهد شد؛ در این صورت استفاده از گزینهٔ «-paper» غیرضروری خواهد بود.
اندازهٔ کاغذ می‌تواند به شکل widthxheight همراه با یک واحد اختیاری مشخص شود، به طوری که width و height اعدادی اعشاری برای تعیین عرض و ارتفاع کاغذ هستند، و واحد نیز هر یک از اختصارات دو حرفیِ واحدهای پذیرفته‌شده توسط TeX است (pt، pc، in، bp، cm، mm، dd، cc، یا sp). به طور پیش‌فرض، واحد cm (سانتی‌متر) است.
مترادف‌هایی نیز وجود دارند که می‌توان از آن‌ها استفاده کرد: us (8.5x11in)، legal (8.5x14in)، foolscap (13.5x17in)، و همچنین اندازه‌های ISO شامل a1-a7، b1-b7، c1-c7. هر یک از این‌ها یک حالت افقی (landscape) یا «چرخانده‌شده» نیز دارند: usr (11x8.5in)، a1r-a7r و غیره. برای سازگاری با dvips، قالب‌های letter (8.5x11in)، ledger (17x11in) و tabloid (11x17in) نیز پشتیبانی می‌شوند (این موارد گونه‌های چرخانده‌شده ندارند).
پیش از هر یک از اندازه‌های فوق می‌توان علامت مثبت (`+') قرار داد؛ این کار باعث می‌شود اندازهٔ کاغذی که در اینجا مشخص شده، بر هر اندازهٔ کاغذی که در فایل dvi آمده اولویت یابد و جایگزین آن شود. اندازهٔ پیش‌فرض کاغذ 21 x 29.7 cm (اندازهٔ A4) است. -pause (.pause) این گزینه یک پیاده‌سازی ساده از نمایش افزایشی (گام‌به‌گام) را ارائه می‌دهد که می‌تواند برای ارائه‌ها استفاده شود. هنگامی که این گزینه به کار رود، xdvi هرگاه با یک special-string ویژه مواجه شود (به‌طور پیش‌فرض xdvi:pause ؛ این رشته می‌تواند از طریق -pausespecial سفارشی‌سازی شود، زیر را ببینید)، نمایش صفحهٔ کنونی را متوقف کرده و مکان‌نما شکل خود را تغییر می‌دهد. عمل unpause-or-next() (که به‌طور پیش‌فرض به کلید Space اختصاص یافته است) بخش بعدی صفحه را تا special-string بعدی، یا تا رسیدن به انتهای صفحه نمایش خواهد داد. هنگامی که از این گزینه استفاده نشود، دستورهای ویژهٔ حاوی special-string نادیده گرفته خواهند شد.

-pausespecial special-string

(.pauseSpecial) رشتهٔ ویژه‌ای را تعیین می‌کند که باعث توقف xdvi در هنگام فعال بودن گزینهٔ -pause می‌شود. مقدار پیش‌فرض special-string برابر با xdvi:pause است.

-postscript flag

(.postscript) اگر flag = 0 باشد، رندر دستورهای ویژهٔ PostScript<tm> غیرفعال می‌شود؛ در عوض، جعبه‌های احاطه‌کننده (در صورت وجود) نمایش داده خواهند شد. مقدار 1 (پیش‌فرض) دستورهای ویژهٔ PostScript<tm> را فعال می‌کند. با مقدار 2، دستورهای ویژهٔ PostScript<tm> همراه با جعبه‌های احاطه‌کننده‌شان نمایش داده می‌شوند؛ این به شما اجازه می‌دهد تا درستی جعبه‌های احاطه‌کننده را به‌صورت بصری بررسی کنید. این مقادیر همچنین می‌توانند در زمان اجرا با کلید `v' و آرگومان‌های عددی پیشوند متناظر 0، 1 و 2 تغییر وضعیت داده شوند.

-ps2pdfpath path

(.ps2pdfPath) از path به عنوان برنامهٔ تبدیل PostScript به PDF استفاده می‌کند. این برنامه یا اسکریپت باید دو آرگومان خط فرمانی را بپذیرد: فایل PostScript به عنوان آرگومان اول، و فایل خروجی PDF به عنوان آرگومان دوم.

-rulecolor color

(.ruleColor) رنگ خطوط مورد استفاده برای ذره‌بین را مشخص می‌کند (پیش‌فرض: رنگ پیش‌زمینه).

-q

(.noInitFile) فایل راه‌اندازی $HOME/.xdvirc را نادیده می‌گیرد (یعنی در هنگام راه‌اندازی خوانده نشود و در زمان خروج نوشته نشود). این کار باعث می‌شود مقادیر پیش‌فرض تعریف‌شده در $HOME/.Xdefaults استفاده شوند. برای اطلاعات بیشتر در مورد $HOME/.xdvirc، بخش FILES را ببینید.

-rv

(.reverseVideo) باعث می‌شود صفحه به جای حالت عادی، با نویسه‌های سفید در پس‌زمینهٔ سیاه نمایش داده شود.

-S density

(.densityPercent) مشابه -density (که به آن ارجاع داده می‌شود).

-s shrink

(.shrinkFactor) ضریب کوچک‌نمایی اولیه را مشخص می‌کند. مقدار پیش‌فرض 8 است. اگر shrink برابر با 0 داده شود، ضریب کوچک‌نمایی اولیه طوری محاسبه می‌شود که صفحه درون پنجره بگنجد (مانند زمانی که کلید `s' بدون عدد فشرده شود).

-safer

(.safer) این گزینه تمام گزینه‌های امنیتی موجود را فعال می‌کند؛ این گزینه برای استفاده در زمانی طراحی شده است که xdvi توسط یک مرورگر فراخوانی شود که فایل dvi یا TeX را از سایتی دیگر دریافت می‌کند. این گزینه +nogssafer و +allowshell را انتخاب می‌کند.

-sidemargin dimen

(.sideMargin) حاشیهٔ کناری را مشخص می‌کند (نگاه کنید به -margins).

-sourceposition line[:col][ ]filename

این گزینه باعث می‌شود xdvi در فایل dvi به دنبال مکانی بگردد که متناظر با سطر (و در صورت تمایل، ستون) مشخص‌شده در فایل منبع .tex باشد، و مکان یافته‌شده را با کشیدن یک مستطیل به رنگ highlight (گزینهٔ -hl را ببینید) دور متن متناظر برجسته کند. علاوه بر این، در صورت اجرا با این آرگومان (و زمانی که گزینهٔ -nofork داده نشده باشد، که به آن ارجاع داده می‌شود)، xdvi همیشه بلافاصله بازمی‌گردد: اگر نمونهٔ دیگری از xdvi را بیابد که از قبل در حال نمایش dvi_file است، باعث می‌شود آن نمونه پنجرهٔ خود را بالا بیاورد و به مکان داده‌شده در فایل dvi برود؛ در غیر این صورت نمونهٔ خود را در پس‌زمینه اجرا خواهد کرد. اگر چندین نمونه از xdvi در حال نمایش فایل dvi مربوطه باشند، نمونه‌ای که اخیراً به پیش‌زمینه آورده شده است استفاده خواهد شد.

فاصلهٔ قبل از filename تنها زمانی نیاز است که نام فایل با یک رقم شروع شود. هنگامی که از فاصله استفاده شود، باید آرگومان در نشانه‌های نقل‌قول قرار گیرد تا شل این فاصله را به عنوان جداکنندهٔ آرگومان تفسیر نکند.

این گزینه نیازمند آن است که dvi_file با اطلاعات دستورهای ویژهٔ منبع (source specials) آماده شده باشد. برای جزئیات در مورد نحوهٔ انجام این کار، بخش SOURCE SPECIALS را ببینید.

در اینجا شرح دقیق‌تری از چگونگی مطابقت دادن نام فایل در آرگومان -sourceposition با نام فایل در دستورهای ویژهٔ منبع آمده است:

-statusline

(.statusline) این گزینه منسوخ شده است؛ در عوض از -expertmode flag استفاده کنید (که به آن ارجاع داده می‌شود). -text-encoding encoding (.textEncoding) از encoding به‌عنوان کدگذاری متن رشته در پنجره‌ی «Find» استفاده می‌کند. معمولاً به این گزینه نیازی نیست، زیرا کدگذاری از روی تنظیمات محلی (locale) تعیین می‌شود.

-thorough

(.thorough) برنامهٔ Xdvi معمولاً تلاش می‌کند اطمینان حاصل کند که نویسه‌های روی‌هم‌افتاده (مانند \notin) به‌درستی چاپ می‌شوند. در نمایشگرهای تک‌رنگ، این کار همیشه با یک عملیات منطقی، یعنی and یا or امکان‌پذیر است. با این حال، در نمایشگرهای رنگی ممکن است این کار به دو عملیات نیاز داشته باشد؛ یکی برای تنظیم بیت‌های مناسب و دیگری برای پاک کردن بیت‌های دیگر. در این حالت، به‌طور پیش‌فرض xdvi در عوض از عملیات copy استفاده می‌کند که نویسه‌های روی‌هم‌افتاده را به‌درستی مدیریت نمی‌کند. گزینهٔ -thorough روش کُندتر اما دقیق‌تر را انتخاب می‌کند. همچنین ببینید: -copy.

-topmargin dimen

(.topMargin) حاشیه‌های بالا و پایین را مشخص می‌کند (ببینید: -margins).

-unique

(.unique) این گزینه باعث می‌شود نمونهٔ دیگری از xdvi که روی همان نمایشگر (display) اجرا می‌شود، به‌عنوان یک «کارساز» عمل کند. برای مثال، فراخوانی

xdvi -unique +5 file.dvi

باعث می‌شود آن نمونهٔ دیگر، file.dvi را در صفحهٔ ۵ به جای فایلی که هم‌اکنون نمایش می‌دهد بارگذاری کند. اگر نمونهٔ دیگری از xdvi از پیش در حال نمایش فایل file.dvi باشد، تنها به صفحهٔ ۵ خواهد رفت. اگر نمونهٔ دیگر xdvi در حال نمایش فایل متفاوتی باشد، در عوض file.dvi را بارگذاری می‌کند. در غیر این صورت، اگر در حال حاضر هیچ نمونهٔ دیگری از xdvi روی نمایشگر اجرا نمی‌شود، این گزینه نمونهٔ جدیدی از xdvi را در پس‌زمینه اجرا کرده (مگر اینکه گزینهٔ -nofork مشخص شده باشد، که به آن ارجاع داده می‌شود) و صفحهٔ ۵ از file.dvi را نمایش می‌دهد.
نام فایل و گزینهٔ +n برای شمارهٔ صفحه، تنها گزینه‌های موجود برای کنترل یک نمونهٔ دوردست xdvi به این شیوه هستند؛ همهٔ گزینه‌های دیگر در حال حاضر نادیده گرفته می‌شوند.

-useTeXpages

از صفحه‌های منطقی TeX (مقادیر ثباتِ \count0) به‌جای صفحه‌های فیزیکی برای برچسب‌های فهرست صفحات و هنگام پرش به یک صفحه در سند با کلید «g» (یا کُنشِ goto-page()) استفاده می‌کند. این گزینه را می‌توان با فشردن کلید `T' تغییر وضعیت داد.

-version

اطلاعات نسخهٔ xdvi را چاپ می‌کند.

-visitedlinkcolor

(.visitedLinkColor) رنگ مورد استفاده برای پیوندهای دیده‌شده (به‌طور پیش‌فرض «Purple4»). پیوندها پس از کلیک روی آن‌ها، به وضعیت دیده‌شده درمی‌آیند. مانند linkColor، مقدار باید یک نام رنگ معتبر در X یا یک رشتهٔ رنگی هگزادسیمال باشد.

-warnspecials

(.warnSpecials) باعث می‌شود xdvi هشدارهایی دربارهٔ رشته‌های \special که قادر به پردازش آن‌ها نیست را در stderr چاپ کند. این هشدارها به‌طور پیش‌فرض سرکوب شده‌اند.

-watchfile n

(.watchFile) اگر این گزینه روی مقداری بزرگ‌تر از 0 تنظیم شود، xdvi هر n ثانیه تغییرات فایل DVI را بررسی خواهد کرد. اگر نوشتن فایل DVI توسط TeX به‌طور کامل به پایان رسیده باشد، به‌صورت خودکار مجدداً بارگذاری می‌شود. مقادیر اعشاری (مانند «2.5») نیز امکان‌پذیرند. مقدار پیش‌فرض این گزینه 0 است، یعنی بدون پایش.
از آنجا که xdvi نمی‌تواند فایل‌های DVI ناقص را مدیریت کند، تلاش می‌کند تا زمانی که فایل در حال بازنویسی است، آن را مجدداً بارگذاری نکند. با این وجود، استفاده از ذره‌بین یا تغییر صفحات نیازمند خواندن (بخشی از) فایل DVI است، و اگر گزینهٔ tempfile غیرفعال باشد، این کار محتویات کنونی پنجره را تا زمانی که فایل DVI بتواند به‌طور کامل خوانده شود پاک خواهد کرد.

-wheelunit pixels

(.wheelUnit) تعداد پیکسل‌هایی را تعیین می‌کند که با یک حرکت چرخ ماوس، تصویر به بالا، پایین، چپ یا راست جابه‌جا می‌شود. (برای اطلاعات بیشتر در این مورد، کُنش‌های wheel و hwheel را در زیر ببینید.) اگر روی صفر تنظیم شود، قابلیت چرخ ماوس (اساساً) غیرفعال می‌شود. مقدار پیش‌فرض 80 است.

-xoffset dimen

(.xOffset) میزان انحراف افقی خروجی روی صفحه را مشخص می‌کند. ببینید: -offsets.

-yoffset dimen

(.yOffset) میزان انحراف عمودی خروجی روی صفحه را مشخص می‌کند. ببینید: -offsets. Xdvi هنگامی که کلیدهای زیر در پنجره‌اش فشرده شوند، آن‌ها را تشخیص می‌دهد. هر کدام می‌توانند به‌طور اختیاری با یک عدد (مثبت یا منفی) همراه شوند؛ یک «آرگومان پیشوند» که تفسیر آن به کلید مربوطه بستگی خواهد داشت. این آرگومان پیشوند را می‌توان با فشردن کلید «Escape» لغو کرد. در صورت وجود، کلیدهای «Help»، «Prior» و «Next» به‌ترتیب مترادف‌هایی برای کلیدهای `?'، `b' و `f' هستند.

ترکیب‌های کلیدی فهرست‌شده در اینجا مواردی هستند که xdvi به‌طور پیش‌فرض اختصاص می‌دهد. نام‌هایی که در براکت‌ها در ابتدای توضیحات آمده‌اند، نام کنش‌های مرتبط با کلیدها هستند؛ از این نام‌ها می‌توان برای سفارشی‌سازی ترکیب‌های کلیدی استفاده کرد، همان‌طور که در بخش CUSTOMIZATION در زیر با جزئیات بیشتر توضیح داده شده است. اگر فقط یک ترکیب با حروف کوچک فهرست شده باشد، هر دو کلید با حروف کوچک و بزرگ برای آن ترکیب کار خواهند کرد.

ESC (کلید)

[discard-number()] کلید Escape پیشوند عددی را برای تمام کنش‌ها کنار می‌گذارد (زمانی که عددی را اشتباه تایپ کرده‌اید کاربردی است).

Return (کلید)

[forward-page()] به صفحهٔ بعدی (یا در صورت ارائهٔ عدد، به n-اُمین صفحهٔ بعدی) می‌رود. مترادف‌های آن `n'، `f' و Line Feed هستند.

Backspace (کلید)

[back-page()] به صفحهٔ قبلی (یا n صفحه به عقب) می‌رود. مترادف‌های آن `p'، `b' و Ctrl-h هستند.

Delete (کلید)

[up-or-previous()] به اندازهٔ دو سوم ظرفیت پنجره به بالا می‌رود، یا در صورتی که از پیش در بالای صفحه باشد، به بالای صفحهٔ قبلی می‌رود. با یک آرگومان اعشاری، به اندازهٔ کسر متناظر از یک پنجره به بالا حرکت می‌کند.

Space (کلید)

[unpause-or-next()] به اندازهٔ دو سوم ظرفیت پنجره به پایین می‌رود، یا اگر از پیش در پایین صفحه باشد، به صفحهٔ بعدی می‌رود.
هنگامی که گزینهٔ -pause special-string استفاده شده باشد و نمایش در حال حاضر متوقف شده باشد، این کلید در عوض بخش بعدی صفحه را تا رسیدن به special-string بعدی یا انتهای صفحه نمایش می‌دهد. برای جزئیات به شرح گزینهٔ -pause مراجعه کنید. کنش [down-or-next()] کار مشابهی انجام می‌دهد، اما بدون توقف؛ این کنش به‌طور پیش‌فرض به هیچ کلیدی اختصاص نیافته است.

Ctrl-Home (Xaw)، Ctrl-osfBeginLine (Motif)

[goto-page(1)] به اولین صفحهٔ سند می‌رود.

Ctrl-End (Xaw)، Ctrl-osfEndLine (Motif)

[goto-page()] به آخرین صفحهٔ سند می‌رود.

Home (Xaw)، osfBeginLine (Motif)

[home-or-top()] به موقعیت «home» صفحه می‌رود، یا در صورتی که پرچم keep تنظیم شده باشد، به بالای صفحه می‌رود (در این حالت، صفحه به‌صورت افقی پیمایش نمی‌شود).

End (Xaw)، osfEndLine (Motif)

[end-or-bottom()] به موقعیت «end» صفحه (گوشهٔ پایین سمت راست) می‌رود، یا اگر پرچم keep تنظیم شده باشد، به پایین صفحه می‌رود (در این حالت، صفحه به‌صورت افقی پیمایش نمی‌شود).

کلید جهت‌نمای پایین (Down arrow)

[down(0.015)] صفحه را به پایین پیمایش می‌کند.

کلید جهت‌نمای بالا (Up arrow)

[up(0.015)] صفحه را به بالا پیمایش می‌کند.

کلید جهت‌نمای راست (Right arrow)

[right(0.015)] صفحه را به راست پیمایش می‌کند.

کلید جهت‌نمای چپ (Left arrow)

[left(0.015)] صفحه را به چپ پیمایش می‌کند.

Alt-Ctrl-+

[change-density(25)] تیرگی قلم‌ها در پنجرهٔ DVI را با افزودن به مقدار گاما افزایش می‌دهد (همچنین کلید `S' را ببینید).

Alt-Ctrl--

[change-density(-25)] تیرگی قلم‌ها در پنجرهٔ DVI را با کاستن از مقدار گاما کاهش می‌دهد (همچنین کلید `S' را ببینید).

Ctrl-+

[set-shrink-factor(+)] ضریب کوچک‌نمایی را افزایش می‌دهد (همچنین کلید `s' را ببینید).

Ctrl--

[set-shrink-factor(-)] ضریب کوچک‌نمایی را کاهش می‌دهد (همچنین کلید `s' را ببینید).

Ctr-[

[pagehistory-delete-backward()] مورد فعلی در تاریخچهٔ صفحه را حذف می‌کند و به موردِ تاریخچه پیش از مورد حذف‌شده می‌رود. با یک آرگومان پیشوند n، تعداد n مورد قبلی در تاریخچه را حذف می‌کند. برای جزئیات به PAGE HISTORY مراجعه کنید.

[

[pagehistory-back()] در تاریخچهٔ صفحه به عقب بازمی‌گردد (برای جزئیات به PAGE HISTORY مراجعه کنید). با یک آرگومان پیشوند n، به اندازهٔ n مورد در تاریخچه به عقب می‌رود.

Ctr-]

[pagehistory-delete-forward()] مورد فعلی در تاریخچهٔ صفحه را حذف می‌کند و به موردِ تاریخچه پس از مورد حذف‌شده می‌رود. با یک آرگومان پیشوند n، تعداد n مورد بعدی در تاریخچه را حذف می‌کند. برای جزئیات به PAGE HISTORY مراجعه کنید. ] [pagehistory-forward()] حرکت به جلو در تاریخچه صفحات (برای جزئیات به PAGE HISTORY مراجعه کنید). با یک آرگومان پیشوندی n، به اندازه n مورد در تاریخچه به جلو حرکت می‌کند.

^

[home()] انتقال به موقعیت «آغازین» (home) صفحه. این موقعیت معمولاً گوشه بالا سمت چپ صفحه است، که بسته به حاشیه‌های شرح‌داده‌شده در گزینه -margins در بالا، تغییر می‌کند.

?

[help()] مشابه کلید h (که توضیح آن در ادامه آمده است).

B

[htex-back()] این کلید به لنگرگاه پیوند یکتای قبلی بازمی‌گردد. برای اطلاعات بیشتر در مورد پیمایش پیوندها به بخش HYPERLINKS مراجعه کنید.

b

[back-page()] رفتن به صفحه قبلی (یا بازگشت به اندازه n صفحه). کلیدهای مترادف عبارتند از `p'، Ctrl-h و Backspace.

C

[set-color()] این کلید استفاده از دستورات ویژه رنگ (color specials) را تغییر وضعیت می‌دهد. دنباله‌های کلیدی `0C' و `1C' به ترتیب تفسیر دستورات ویژه رنگ را غیرفعال و فعال می‌کنند. همچنین گزینه -nocolor را ببینید.

c

[center()] صفحه را طوری جابه‌جا می‌کند که نقطه زیر مکان‌نمای ماوس به وسط پنجره منتقل شود، و مکان‌نمای ماوس را نیز به همان نقطه منتقل می‌کند.

D

[toggle-grid-mode()] این کلید استفاده از شبکه (grid) را روی صفحه نمایش داده‌شده تغییر وضعیت می‌دهد. اگر هیچ عددی وارد نشود، حالت شبکه روشن یا خاموش می‌شود. با قرار دادن یک عدد از ۱ تا ۳ در ابتدا، می‌توان ۳ سطح شبکه مختلف را تنظیم کرد. واحدهای شبکه بسته به اینکه قالب کاغذ letter (اینچ) باشد یا a4 (سانتی‌متر)، اینچ یا سانتی‌متر خواهند بود.

d

[down()] صفحه را به اندازه دو سوم یک پنجره کامل به پایین جابه‌جا می‌کند. با یک آرگومان اعشاری برای «down»، به کسر متناظر از یک پنجره کامل به سمت پایین حرکت می‌کند.

Ctrl-f

[find()] پنجره‌ای را برای جستجوی یک رشته در فایل DVI باز می‌کند. برای جزئیات بیشتر به بخش STRING SEARCH در زیر مراجعه کنید.

f

[forward-page()] رفتن به صفحه بعدی (یا در صورت مشخص شدن عدد، به صفحه n-اُم بعدی). کلیدهای مترادف عبارتند از `n'، Return و Line Feed.

G

[set-greyscaling()] این کلید استفاده از هموارسازی خاکستری (greyscale anti-aliasing) را برای نمایش بیت‌مپ‌های کوچک‌شده تغییر وضعیت می‌دهد. علاوه بر این، دنباله‌های کلیدی `0G' و `1G' به ترتیب این پرچم را پاک و فعال می‌کنند. همچنین گزینه -nogrey را ببینید.

اگر یک آرگومان عددی غیر از 0 یا 1 داده شود، هموارسازی خاکستری فعال می‌شود و منبع گاما (gamma) روی مقدار تقسیم بر ۱۰۰ تنظیم می‌شود. به عنوان مثال، `150G' حالت خاکستری را فعال کرده و گاما را روی 1.5 تنظیم می‌کند.

Ctrl-g

[find-next()] یافتن تطابق بعدی رشته در فایل DVI؛ این کلید می‌تواند به جای کلیک بر روی دکمه «Find» در پنجره جستجو استفاده شود.

g

[goto-page()] رفتن به صفحه‌ای با شماره مشخص شده. اگر شماره صفحه‌ای داده نشود، xdvi به آخرین صفحه می‌پرد.
اگر گزینه/منبع useTeXpages فعال باشد، شماره‌ها مطابق با شماره صفحات واقعی در فایل TeX هستند؛ در غیر این صورت، از شماره صفحات مطلق (شروع از ۱) استفاده می‌شود. در حالت دوم، شماره صفحات را می‌توان با کلید `P' در زیر تغییر داد. توجه داشته باشید که با گزینه useTeXpages ممکن است یک شماره صفحه چندین بار تکرار شود؛ در چنین حالتی، xdvi از اولین شماره صفحه‌ای که مطابقت دارد استفاده خواهد کرد.

h

پنجره راهنمایی را با توضیحی کوتاه درباره مهم‌ترین کلیدها و مفاهیم باز می‌کند.

k

[set-keep-flag()] معمولاً زمانی که xdvi صفحات را تغییر می‌دهد، به موقعیت آغازین (home) نیز می‌رود. کلید `k' پرچم «keep-position» را تغییر وضعیت می‌دهد که در صورت فعال بودن، هنگام جابه‌جایی میان صفحات، موقعیت فعلی را حفظ می‌کند. همچنین `0k' و `1k' به ترتیب این پرچم را پاک و فعال می‌کنند. همچنین گزینه -keep را ببینید.

Ctrl-l

[fullscreen(toggle)] حالت تمام‌صفحه را تغییر وضعیت می‌دهد (برای اطلاعات بیشتر به توضیحات گزینه -fullscreen مراجعه کنید). این قابلیت حتی از استفاده از گزینه خط فرمان نیز ناپایدارتر است: هیچ استاندارد جهان‌شمولی درباره اینکه پنجره چگونه می‌تواند ابعاد یا تزیینات خود را در زمان اجرا تغییر دهد وجود ندارد، بنابراین در اکثر مدیران پنجره یا میزکارها کار نخواهد کرد. به‌طور کلی، بهتر است از کنترل‌های مدیر پنجره برای تغییر اندازه یا تزیینات پنجره xdvi استفاده کنید.

l

[left()] صفحه را به اندازه دو سوم یک پنجره کامل به چپ جابه‌جا می‌کند. M [set-margins()] حاشیه‌ها را به‌گونه‌ای تنظیم می‌کند که نقطه فعلی زیر مکان‌نمای ماوس، گوشه بالا سمت چپ متن صفحه را تعیین نماید. توجه داشته باشید که این دستور تصویر را جابه‌جا نمی‌کند بلکه فقط حاشیه‌ها را برای دستورهای تعویض صفحه مشخص می‌سازد. برای جزئیات مربوط به نحوه استفاده از حاشیه‌ها، گزینه -margins را ببینید.

m

[toggle-mark()] وضعیت علامت صفحه فعلی را در فهرست صفحات تغییر می‌دهد. هنگامی که صفحه‌ای علامت‌گذاری شود، با یک ستاره کوچک «*» در کنار شماره صفحه نمایش داده می‌شود. سپس صفحات علامت‌گذاری‌شده را می‌توان چاپ کرد یا در یک فایل ذخیره نمود. همچنین می‌توان با کلیک یا کشیدن Mouse-2 در فهرست صفحات، یک یا چند صفحه را علامت‌گذاری کرد.

Ctrl-n

[toggle-mark()forward-page()] وضعیت علامت صفحه فعلی را در فهرست صفحات تغییر می‌دهد و به صفحه بعد می‌رود. این امکان به شما اجازه می‌دهد رشته‌ای از صفحات متوالی را به‌سرعت علامت‌گذاری کنید.

n

[forward-page()] به صفحه بعدی (یا در صورت ارائه یک عدد، به n-امین صفحه بعد) می‌رود. مترادف‌های آن عبارتند از `f'، Return و Line Feed.

Ctrl-o

[select-dvi-file()] یک فایل dvi جدید می‌خواند. یک ابزارک انتخاب فایل به‌صورت پنجره پاپ‌آپ باز می‌شود تا فایل DVI را از آن انتخاب کنید. اگر یک آرگومان پیشوندی n داده شود، در عوض n-امین فایل از تاریخچه فایل‌ها باز می‌شود.

P

[declare-page-number()] «این شماره صفحه n است.» از این کلید می‌توان استفاده کرد تا فشردن کلید `g' به شماره صفحه‌ای متفاوت از صفحه فیزیکی اشاره کند. (اگر می‌خواهید به‌جای صفحات فیزیکی از شماره صفحات «منطقی» یا TeX استفاده کنید، در عوض استفاده از گزینه -useTeXpages را در نظر داشته باشید.) آرگومان n باید به‌عنوان پیشوند برای این کلید ارائه شود.

Ctrl-p

[print()] یک پنجره پاپ‌آپ برای چاپ فایل DVI یا بخش‌هایی از آن باز می‌کند. برای توضیح گزینه‌های موجود و منابع جهت سفارشی‌سازی رفتار پیش‌فرض، بخش PRINT DIALOG را ببینید.

p

[back-page()] به صفحه قبلی می‌رود (یا n صفحه به عقب بازمی‌گردد). مترادف‌های آن عبارتند از `b'، Ctrl-h و Backspace.

q

[quit()] از برنامه خارج می‌شود.

Ctrl-r

[forward-page(0)] صفحه فعلی را دوباره نمایش می‌دهد.

R

[reread-dvi-file()] فایل dvi را وادار به بازخوانی می‌کند. این ویژگی به شما امکان می‌دهد نسخه‌های متعددی از یک فایل را در حالی که xdvi تنها یک بار اجرا شده است پیش‌نمایش کنید.

r

[right()] صفحه را به اندازه دو سوم یک پنجره کامل به راست می‌برد.

Ctrl-s

[save()] یک پنجره پاپ‌آپ برای ذخیره فایل DVI یا بخش‌هایی از آن باز می‌کند. برای اطلاعات بیشتر در این مورد، بخش SAVE DIALOG را در زیر ببینید.

S

[set-density()] ضریب تراکم را برای استفاده در هنگام کوچک‌سازی bitmapها تنظیم می‌کند. این مقدار باید عددی بین 0 و 100 باشد؛ اعداد بزرگ‌تر نویسه‌های کم‌رنگ‌تری تولید می‌کنند. اگر حالت طیف خاکستری فعال باشد، این دستور در عوض مقدار گاما را تغییر می‌دهد. مقدار جدید گاما برابر با عدد داده‌شده تقسیم بر 100 است؛ مقادیر منفی نیز مجاز هستند.

s

[set-shrink-factor()] ضریب کوچک‌سازی را به عدد داده‌شده تغییر می‌دهد. اگر عددی مشخص نشود، کوچک‌ترین ضریبی که باعث شود کل صفحه در پنجره جا بگیرد استفاده خواهد شد. (حاشیه‌ها در این محاسبه نادیده گرفته می‌شوند.)

T

[use-tex-pages()] برای برچسب‌های فهرست صفحات و هنگام پرش به یک صفحه در سند از طریق goto-page()، به‌جای صفحات فیزیکی از صفحات منطقی TeX (مقادیر ثبات \count0) استفاده می‌کند. همچنین گزینه -useTeXpages را ببینید.

t

[switch-magnifier-units()] واحدهای مورد استفاده برای درجه‌بندی‌های ذره‌بین و گزارش فاصله بین اشاره‌گر ماوس و مرکز خط‌کش را در حالت خط‌کش تعویض می‌کند (بخش MODES را ببینید). مقدار پیش‌فرض توسط منبع X با نام tickUnits (به‌طور پیش‌فرض `mm') تعیین می‌شود. واحدها بین مقادیر زیر جابه‌جا می‌شوند؛ به جز `px'، همگی متناظر با واحدهای TeX هستند: mm (میلی‌متر) pt (نقطه‌های TeX)، in (اینچ)، sp (نقطه‌های مقیاس‌بندی‌شده، واحدی که به‌طور داخلی در TeX استفاده می‌شود) bp (نقطه‌های بزرگ یا `PostScript points')، cc (نقطه‌های cicero)، dd (نقطه‌های didot)، pc (pica)، و px (پیکسل‌های صفحه نمایش).

Ctrl-u

[back-page()toggle-mark()] به صفحه قبلی می‌رود و وضعیت علامت آن صفحه را تغییر می‌دهد. این عمل قرینه Ctrl-n است.

u

[up()] صفحه را به اندازه دو سوم یک پنجره کامل به بالا می‌برد. با ارائه یک آرگومان اعشاری (float) به «up»، به اندازه کسر متناظر از یک پنجره کامل به بالا حرکت می‌کند.

Ctrl-v

[show-source-specials()] کادرهای احاطه‌کننده (bounding boxes) را برای تمام منبع‌های special در صفحه فعلی نشان می‌دهد و رشته‌های موجود در این specialها را در stderr چاپ می‌کند. با پیشوند 1، تمام کادرهای احاطه‌کننده صفحه را نمایش می‌دهد. این قابلیت عمدتاً برای اهداف اشکال‌زدایی است. V [set-gs-alpha()] این کلید وضعیت صاف‌سازی لبه‌ها (anti-aliasing) را برای دستورهای ویژهٔ PostScript<tm> در زمانی که Ghostscript به‌عنوان رندرکننده استفاده می‌شود، تغییر می‌دهد. علاوه بر این، دنباله کلیدهای `0V' و `1V' به‌ترتیب این پرچم را پاک و فعال می‌کنند. همچنین گزینهٔ -gsalpha را ببینید.

v

[set-ps()] این کلید رندر دستورهای ویژهٔ PostScript<tm> را میان ۳ وضعیت تغییر می‌دهد:

Ctrl-x

[source-what-special()] اطلاعات مربوط به دستور ویژهٔ سورس (source special) در کنار مکان‌نمای موش‌واره را در خط وضعیت نمایش می‌دهد. این همان دستور ویژه‌ای است که توسط source-special() یافت می‌شود، اما بدون فراخوانی ویرایشگر. برای مقاصد اشکال‌زدایی.

x

[set-expert-mode()] حالت کارشناس (expert mode) را فعال/غیرفعال می‌کند؛ حالتی که در آن خط وضعیت، نوارهای پیمایش، دکمه‌های منو، نوار ابزار (تنها در Motif) و فهرست صفحات نمایش داده نمی‌شوند. فشردن `1x' نمایش خط وضعیت در پایین پنجره را تغییر می‌دهد. فشردن `2x' نوارهای پیمایش را (در صورت وجود) تغییر می‌دهد. در Xaw، کلید `3x' دکمه‌های منو و فهرست صفحات را تغییر می‌دهد؛ در Motif، فهرست صفحات را تغییر می‌دهد. در Motif، مقیدسازی‌های اضافی `4x' نوار ابزار، و `5x' نوار منو را تغییر می‌دهند.
بدون آرگومان پیشوندی، همهٔ عناصر واسط گرافیکی یادشده یا روشن می‌شوند (اگر قبلاً پنهان بوده‌اند) یا خاموش.
تغییر وضعیت نوارهای پیمایش ممکن است در ابزارک‌های Xaw رفتاری نامنظم داشته باشد؛ برای نمونه، ممکن است نوارهای پیمایش پس از تغییر اندازهٔ پنجره دوباره پدیدار شوند، و در اندازه‌های خاصی از پنجره، یکی از نوارهای پیمایش ممکن است پنهان نشود.
همچنین گزینهٔ -expertmode را ببینید (شماره‌های بالا متناظر با بیت‌های موجود در آرگومانِ -expertmode هستند).

کنش‌های موش‌واره در پنجره اصلی (MOUSE ACTIONS IN THE MAIN WINDOW)

کنش‌های موش‌واره را می‌توان با تنظیم منبع X با نام mouseTranslations سفارشی‌سازی کرد. از آنجا که سه حالت مختلف موش‌واره وجود دارد (بخش MODES در زیر را ببینید)، کنش ویژه‌ای به نام mouse-modes وجود دارد که کنش‌ها را برای هر یک از این سه حالت فهرست می‌کند: mouse-modes("ACTIONS-FOR-MODE1", "ACTIONS-FOR-MODE2", "ACTIONS-FOR-MODE3"). اگر تنها یک آرگومان تعیین شود، این کنش برای تمامی حالت‌ها استفاده خواهد شد. مقیدسازی‌های پیش‌فرض به‌صورت زیر هستند:

xdvi.mouseTranslations: \
Shift<Btn1Down>:mouse-modes("drag(+)")\n\
Shift<Btn2Down>:mouse-modes("drag(|)")\n\
Shift<Btn3Down>:mouse-modes("drag(-)")\n\
Ctrl<Btn1Down>:mouse-modes("source-special()")\n\
<Btn1Down>: mouse-modes("do-href()magnifier(*2)", "text-selection()", "ruler()")\n\
<Btn2Down>: mouse-modes("do-href-newwindow()magnifier(*2)", "text-selection()", "ruler()")\n\
<Btn3Down>: mouse-modes("magnifier(*3)")\n\
<Btn4Down>: mouse-modes("wheel(-0.2)")\n\
<Btn5Down>: mouse-modes("wheel(0.2)")\n\
<Btn6Down>: mouse-modes("hwheel(-0.2)")\n\
<Btn7Down>: mouse-modes("hwheel(0.2)")\n\

توابع X Toolkit که نگاشت‌ها (translations) را پیاده‌سازی می‌کنند، از انواع رویداد Btn6Down یا Btn7Down پشتیبانی نمی‌کنند. به همین دلیل، xdvi تجزیه‌کنندهٔ خودش را برای نگاشت‌های ارائه‌شده در mouseTranslations پیاده‌سازی می‌کند. این تجزیه‌کننده محدودتر از تجزیه‌کنندهٔ توکار X Toolkit است. رشتهٔ ارائه‌شده در mouseTranslations نباید با ``#replace''، ``#augment''، یا ``#override'' آغاز شود. تغییردهنده‌هایی به‌شکل @keysym پشتیبانی نمی‌شوند، و نوع رویداد باید به‌شکل BtnDown یا BtnnDown، باشد، که در آن n یک عدد صحیح مثبت بدون صفرهای ابتدایی است. همچنین، محدودیت‌هایی بر روی فیلد کنش اعمال می‌شود.

do-href()

do-href-newwindow()

معمولاً اگر یک مقیدسازی بیش از یک کنش را مشخص کند، همهٔ کنش‌ها به‌ترتیب اجرا می‌شوند. مقیدسازی‌های ابرپیوند do-href() و do-href-newwindow() از این جهت خاص هستند که اگر موش‌واره هم‌اکنون روی یک ابرپیوند قرار داشته باشد، به‌عنوان یک جایگزین برای سایر کنش‌هایی که ممکن است پس از آن‌ها بیایند استفاده می‌شوند. در این صورت، هیچ‌یک از کنش‌های دیگر اجرا نخواهند شد؛ در غیر این صورت، تنها سایر کنش‌ها اجرا می‌شوند.
کنش do-href() به مقصد پیوند در پنجرهٔ فعلی xdvi می‌پرد (و در نهایت صفحه را تغییر می‌دهد)، و do-href-newwindow() نمونهٔ جدیدی از xdvi را برای مقصد پیوند باز می‌کند. در هر دو حالت، موقعیت مقصد با یک پیکان کوچک که به همان رنگ پیوند دیده‌شده در گوشهٔ سمت چپ پنجره ترسیم می‌شود، مشخص می‌گردد.

magnifier(n x m)

magnifier(*n)

این کنش یک «ذره‌بین» را ظاهر می‌کند که تصویر فشرده‌نشدهٔ ناحیهٔ اطراف نشانگر موش‌واره را نشان می‌دهد. با رها کردن دکمهٔ موش‌واره، ذره‌بین ناپدید می‌شود. حرکت دادن مکان‌نمای موش‌واره حین نگه داشتن دکمه، ذره‌بین را جابه‌جا می‌کند.
دکمه‌های مختلف موش‌واره پنجره‌هایی با اندازه‌های متفاوت ایجاد می‌کنند، همان‌گونه که با آرگومان کنشِ magnifier() مشخص می‌شود. آرگومان آن یا رشته‌ای به‌شکل widthxheight است، مانند گزینهٔ خط فرمان -mgsn، یا یکی از رشته‌های *1 تا *5 است، که به مقدار مشخص‌شده توسط گزینهٔ متناظرِ -mgsn اشاره دارد. drag(+)

drag(|)

drag(-)

صفحه را با ماوس می‌کشد. این کنش باید یک پارامتر داشته باشد، نویسهٔ ``|''، ``-''، یا ``+''، که به ترتیب نشان‌دهندهٔ فقط کشیدن عمودی، فقط کشیدن افقی، یا کشیدن در تمام جهت‌ها است.

source-special()

این کنش یک «جستجوی معکوس» (reverse search) را آغاز می‌کند، و ویرایشگر را در مکانی از فایل TeX باز می‌کند که متناظر با مکان اشاره‌گر در فایل DVI است. برای اطلاعات بیشتر در این باره، بخش SOURCE SPECIALS را در ادامه ببینید.

wheel()

این کنش می‌تواند برای پیمایش تصویر با چرخ ماوس استفاده شود، جایی که معمولاً به دکمهٔ ۴ ماوس (چرخش به بالا) یا ۵ (چرخش به پایین) مقید شده است. این کنش یک پارامتر می‌گیرد که مسافت پیمایش تصویر را مشخص می‌کند. اگر پارامتر شامل ممیز اعشاری باشد، مسافت بر حسب واحدهای چرخ (wheel units) ارائه می‌شود؛ در غیر این صورت، بر حسب پیکسل است. مقدار منفی به بالا و مقدار مثبت به پایین پیمایش می‌کند.

hwheel()

این کنش می‌تواند برای پیمایش افقی تصویر با چرخ ماوس به کار رود، جایی که معمولاً به دکمهٔ ۶ ماوس (چرخش به چپ) یا ۷ (چرخش به راست) مقید شده است. این کنش یک پارامتر می‌گیرد که مسافت پیمایش تصویر را مشخص می‌کند. اگر پارامتر شامل ممیز اعشاری باشد، مسافت بر حسب واحدهای چرخ ارائه می‌شود؛ در غیر این صورت، بر حسب پیکسل است. مقدار منفی به چپ و مقدار مثبت به راست پیمایش می‌کند. همهٔ ماوس‌ها از پیمایش افقی پشتیبانی نمی‌کنند؛ این قابلیت بیشتر برای تاچ‌پدها، ترک‌پدها و غیره کاربرد دارد.

text-selection()

این کنش به شما امکان می‌دهد یک ناحیهٔ مستطیلی از متن را در فایل DVI مشخص کنید. متن در بافر انتخاب X قرار می‌گیرد و می‌تواند در برنامه‌های دیگر (مانند ویرایشگرهای متن) جای‌گذاری شود. این عملکرد شبیه به گزینهٔ Plain text در گفتگوی Save است؛ برای اطلاعات بیشتر دربارهٔ مسائل کدگذاری، توضیحات آن بخش را ببینید.

ruler()

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

کنش‌های مقیدنشده (UNBOUND ACTIONS)

کنش‌های زیر به‌طور پیش‌فرض به کلیدی مقید نشده‌اند، اما برای سفارشی‌سازی در دسترس هستند.

quit-confirm()

یک پنجرهٔ تأیید برای خروج از xdvi نمایش می‌دهد. برای مقید کردن آن به کلید `q' به‌جای کنش پیش‌فرض `quit()' عبارت زیر را در فایل ~/.Xdefaults خود قرار دهید:

xdvi.mainTranslations: #override\
<Key>q: quit-confirm()\n

down-or-next()

مشابه unpause-or-next(): به اندازهٔ دو سوم یک پنجرهٔ کامل به پایین حرکت می‌کند، یا اگر در پایین صفحه باشد، به صفحهٔ بعدی می‌رود.

shrink-to-dpi()

این کنش یک آرگومان (الزامی) می‌پذیرد. ضریب کوچک‌نمایی را روی یک عدد صحیح تنظیم می‌کند تا استفاده از قلم‌ها با تعداد نقاط در اینچ متناظر تقریب زده شود. اگر xdvi از قلم‌های مقیاس‌بندی‌شده برای p نقطه در اینچ استفاده کند، و آرگومان ورودی به shrink-to-dpi برابر با n باشد، آنگاه ضریب کوچک‌نمایی متناظر، نسبت p/n خواهد بود که به نزدیک‌ترین عدد صحیح گرد شده است.

user-exec()

این کنش یک آرگومان (الزامی) می‌پذیرد. برنامهٔ خارجی مشخص‌شده توسط آرگومان را اجرا می‌کند، که بر اساس فاصله‌ها بخش‌بندی می‌شود. متغیر محیطی XDVI_FILE روی مسیر مطلق فایل DVI تنظیم می‌شود تا برنامه بتواند فایل DVI را پیدا کند. به عنوان مثال، برای تخصیص کلید `m' به عنوان کلید میانبری که فایل DVI را با `make' بازتولید می‌کند، خطوط زیر را در فایل ~/.Xdefaults خود قرار دهید:

xdvi.mainTranslations: #override\
<Key>m: user-exec(xdvi-remake)\n

که در آن `xdvi-remake' نام برنامه‌ای در PATH شما، مشابه `cd $(dirname $XDVI_FILE) && make $(basename $XDVI_FILE)' است. (همچنین بخش SIGNALS را برای روشی جهت وادار کردن xdvi به بازخوانی فایل DVI پس از بازتولید آن ببینید.)

تخصیص‌های کلید و دکمه‌های ماوس را می‌توان با تنظیم منبع mainTranslations به رشته‌ای از ترجمه‌ها (translations) آن‌گونه که در مستندات جعبه‌ابزار X تعریف شده است، تغییر داد. عملیات‌ها باید به شکل نام‌های عملیاتی فهرست‌شده در بخش‌های KEYSTROKES و MOUSE ACTIONS باشند.

یک استثنا برای این موضوع، کلیدهای Motif شامل osfPageUp (PgUp)، osfPageDown (PgDown)، osfBeginLine (Home) و osfEndLine (End) هستند که در حال حاضر در نسخهٔ Motif قابل سفارشی‌سازی نیستند.

عملیات‌های کلید معمولاً بدون آرگومان هستند؛ اگر به آن‌ها آرگومانی داده شود، بیانگر عدد اختیاری یا «آرگومان پیشوندی» تایپ‌شده پیش از عملیات است.

برخی عملیات‌های کلید ممکن است آرگومان‌های ویژه‌ای به شرح زیر بگیرند: آرگومان goto-page می‌تواند حرف `e' باشد که بیانگر عملیات رفتن به انتهای سند است. آرگومان set-shrink-factor می‌تواند حرف `a' باشد که نشان می‌دهد ضریب کوچک‌نمایی باید روی کوچک‌ترین مقداری تنظیم شود که در آن صفحه درون پنجره جا بگیرد، یا یکی از علامت‌های `+' یا `-' باشد که به ترتیب نشان‌دهندهٔ افزایش یا کاهش ضریب کوچک‌نمایی است. در نهایت، عملیات‌هایی که تغییر وضعیت (toggle) انجام می‌دهند، مانند set-keep-flag، می‌توانند آرگومان `t' را دریافت کنند که نشان می‌دهد عملیات باید صرف‌نظر از آرگومان پیشوندی فعلی، وضعیت را تغییر دهد.

عملیات‌های ماوس تنها باید به رویدادهای ButtonPress اشاره داشته باشند (برای نمونه <Btn1Down>:magnifier(*1)). رویدادهای حرکت و رهاسازی متناظر به صورت درونی مدیریت خواهند شد. یک عملیات کلید می‌تواند به یک رویداد ماوس متصل (bind) شود، اما برعکس آن ممکن نیست.

معمولاً رشتهٔ ترجمه‌ها باید با ``#override'' آغاز شود، که نشان می‌دهد تخصیص‌های پیش‌فرض کلید و دکمهٔ ماوس نباید نادیده گرفته شوند.

هنگامی که کلیدها یا دکمه‌های ماوسِ شامل کلیدهای تبدیل (مانند Ctrl یا Shift) همراه با معادل‌های بدون تبدیل خود سفارشی‌سازی می‌شوند، کلیدهای تبدیل‌یافته باید ابتدا بیایند، برای مثال:

xdvi.mainTranslations: #override \
Shift<Key>s: select-dvi-file()\n\
Ctrl<Key>s: save()\n\
<Key>s: find()\n

از آنجا که xdvi باید رویدادهای حرکت نشانگر را دریافت کند، و به این دلیل که سازوکار ترجمه‌های X Toolkit نمی‌تواند هم‌زمان رویدادهای حرکت و رویدادهای دوبار کلیک را پشتیبانی کند، تعیین عملیات‌های دوبار کلیک در سفارشی‌سازی‌های xdvi امکان‌پذیر نیست. برای اطلاعات دربارهٔ این موضوع و دیگر جنبه‌های ترجمه‌ها، مستندات X Toolkit Intrinsics را ببینید.

هیچ گزینهٔ خط فرمانی برای تنظیم منبع mainTranslations وجود ندارد، چرا که تغییر این منبع در خط فرمان دشوار خواهد بود. برای تنظیم این منبع به منظور آزمایش، از گزینهٔ خط فرمان -xrm ارائه‌شده توسط X toolkit استفاده کنید. برای مثال، xdvi -xrm 'XDvi.mainTranslations: #override "z":quit()' ... یا xdvi -xrm 'XDvi.mainTranslations: #override <Key>z:quit()' ... باعث می‌شود کلید `z' موجب خروج از xdvi شود.

برخی منابع برای امکان سفارشی‌سازی هندسهٔ دکمه‌های فرمان Xaw ارائه شده‌اند. مجدداً، این منابع از طریق گزینه‌های خط فرمان، به غیر از گزینهٔ -xrm قابل تغییر نیستند. تمامی این منابع مقادیر عدد صحیح می‌پذیرند.

buttonSideSpacing

تعداد پیکسل‌هایی که در هر دو طرف دکمه‌ها قرار می‌گیرد. مقدار پیش‌فرض ۶ است.

buttonTopSpacing

تعداد پیکسل‌های بین دکمهٔ بالایی و بالای پنجره. مقدار پیش‌فرض ۵۰ است.

buttonBetweenSpacing

تعداد پیکسل‌های بین دکمه‌ها. مقدار پیش‌فرض ۲۰ است.

buttonBetweenExtra

تعداد پیکسل‌های فضای اضافی که درج می‌شود اگر رشتهٔ منبع buttonTranslations شامل یک نویسهٔ خط جدید اضافی باشد. مقدار پیش‌فرض ۵۰ است.

buttonBorderWidth

عرض حاشیهٔ پنجره‌های دکمه. مقدار پیش‌فرض ۱ است.

فهرست صفحات (PAGE LIST)

فهرست طومارپذیر صفحات در سمت راست پنجرهٔ اصلی به شما امکان می‌دهد تا مستقیماً به صفحه‌ای در فایل DVI بپرید.

Mouse-1

به صفحه‌ای که ماوس روی آن قرار دارد می‌پرد.

Mouse-2

[toggle-mark()] وضعیت نشانه‌گذاری صفحهٔ فعلی را تغییر می‌دهد. این نشانه‌ها توسط پنجره‌های گفت‌وگوی «Print» و «Save to file» استفاده می‌شوند تا تنها صفحات نشانه‌گذاری‌شده از فایل DVI انتخاب شوند.

هنگامی که نشانگر ماوس درون فهرست صفحات قرار دارد، چرخ ماوس به صفحهٔ بعدی یا قبلی جابه‌جا می‌شود.

نوارهای پیمایش (در صورت وجود) به شیوه استاندارد عمل می‌کنند: فشردن Button 2 در یک نوار پیمایش، لبه بالایی یا چپ نوار پیمایش را به آن نقطه منتقل کرده و در صورت نگه‌داشتن و کشیدن، آن را جابه‌جا می‌کند؛ فشردن Button 1 تصویر را به اندازه فاصله نقطه کلیک تا گوشه بالا-چپ پنجره، به سمت بالا یا راست جابه‌جا می‌کند؛ فشردن Button 3 تصویر را به همان میزان به سمت پایین یا چپ جابه‌جا می‌کند.

نوارهای پیمایش را می‌توان از طریق پرچم یا فشردن کلید -expertmode حذف کرد (به توضیحات آن مراجعه کنید).

ذره‌بین (MAGNIFIER)

به‌طور پیش‌فرض، دکمه‌های ۱ تا ۵ موشواره یک «ذره‌بین» را باز می‌کنند که تصویری کوچک‌نشده از صفحه (یعنی تصویری با تفکیک‌پذیری تعیین‌شده توسط گزینه یا منبع اکس pixels یا mfmode) را در اندازه‌های گوناگون نمایش می‌دهد. هنگام جابه‌جایی ذره‌بین، نشانه‌های کوچک خط‌کش‌مانندی در لبه‌های ذره‌بین نمایش داده می‌شوند (مگر اینکه منبع اکس delayRulers روی false تنظیم شده باشد، که در این حالت نشانه‌ها همواره نمایش داده خواهند شد). واحد این نشانه‌ها توسط منبع اکس tickUnits تعیین می‌شود (به‌طور پیش‌فرض mm). این واحد را می‌توان در زمان اجرا از طریق کنش switch-magnifier-units()، که به‌طور پیش‌فرض به کلید `t' اختصاص یافته است تغییر داد (برای جزئیات بیشتر درباره واحدهای موجود، به توضیحات آن کلید و switch-magnifier-units() مراجعه کنید).
طول نشانه‌ها را می‌توان از طریق منبع اکس tickLength تغییر داد (به‌طور پیش‌فرض ۴). یک مقدار صفر یا منفی، نمایش نشانه‌ها را غیرفعال می‌کند.

تاریخچه صفحه (PAGE HISTORY)

برنامه Xdvi تاریخچه‌ای از صفحات مشاهده‌شده را نگه می‌دارد، و شما می‌توانید با استفاده از کلیدهای [ (pagehistory-back())، ] (pagehistory-forward())، Ctr-[ (pagehistory-delete-backward()) و Ctr-] (pagehistory-delete-forward()) در طول تاریخچه جابه‌جا شده و موارد را حذف کنید.

هنگامی که یکی از دستورهای تاریخچه به کار می‌رود، تاریخچه صفحه در خط وضعیت واقع در پایین پنجره نمایش داده می‌شود؛ به این صورت که مورد فعلی فهرست با قلاب‌های `[' و `]' مشخص شده و حداکثر تا ۱۰ مورد از محتوای قبل و بعد آن نشان داده می‌شود. مرزهای فایل با `#' علامت‌گذاری می‌شوند.

اندازه تاریخچه را می‌توان از طریق منبع اکس pageHistorySize سفارشی‌سازی کرد (اندازه پیش‌فرض ۱۰۰۰ مورد است). اگر مقدار اندازه روی ۰ تنظیم شود، دستورهای تاریخچه غیرفعال می‌گردند.

ابرپیوندها (HYPERLINKS)

کنش‌های do-href() و do-href-newwindow() (که در صورت قرار داشتن اشاره‌گر روی یک ابرپیوند، به‌طور پیش‌فرض به Mouse-1 و Mouse-2 متصل هستند) می‌توانند برای باز کردن مقصد پیوند در همان پنجره (do-href()) یا در یک پنجره جدید (do-href-newwindow()) استفاده شوند.

اگر مقصد پیوند فایلی روی دیسک محلی نباشد، xdvi تلاش می‌کند یک مرورگر وب (به ترتیبی که با گزینه خط فرمان -browser ، متغیر محیطی BROWSER یا منبع اکس wwwBrowser مشخص شده است) را برای دریافت سند اجرا کند. برای مشاهده نمونه تنظیمات، به توضیحات متغیر محیطی BROWSER در ادامه مراجعه کنید.

اگر فایل محلی باشد، xdvi تلاش می‌کند بررسی کند که آیا یک فایل DVI است یا خیر. در صورت مثبت بودن، xdvi تلاش می‌کند فایل را نمایش دهد؛ در غیر این صورت، نوع MIME فایل و از روی آن برنامه مناسب برای باز کردن فایل را تعیین می‌کند. این کار از طریق بررسی و تجزیه فایل‌های مشخص‌شده توسط متغیر محیطی EXTENSIONMAPS برای نگاشت پسوندهای نام فایل به انواع MIME، و فایل‌های تعیین‌شده توسط متغیر محیطی MAILCAPS برای نگاشت انواع MIME به برنامه‌های کاربردی انجام می‌گیرد. برای توضیحات دقیق‌تر و مقادیر پیش‌فرض این متغیرها، به توضیحات آن‌ها در بخش ENVIRONMENT در ادامه مراجعه کنید. اگر هیچ فایل مناسبی یافت نشود، از مجموعه‌ای توکار از انواع MIME و برنامه‌های پیش‌فرض استفاده می‌شود.

در حال حاضر Xdvi به‌جز پسوند نام فایل، از هیچ روش ابتکاری دیگری برای تشخیص نوع MIME یک فایل استفاده نمی‌کند. اگر نام فایل فاقد پسوند باشد، مقدار منبع noMimeSuffix استفاده می‌شود (به‌طور پیش‌فرض application/x-unknown). اگر پسوند فایل با هیچ‌یک از پسوندهای موجود در mime.types تطابق نداشته باشد، مقدار منبع unknownMimeSuffix به کار می‌رود (به‌طور پیش‌فرض application/x-unknown). اگر ورودی‌های mailcap نمایشگری برای یک نوع MIME مشخص فهرست نکرده باشند، xdvi یک پنجره بازشوی هشدار نمایش می‌دهد. اگر می‌خواهید از این هشدار جلوگیری کنید، و برای مثال مایلید برای انواع MIME ناشناخته همواره از مرورگر netscape استفاده شود، می‌توانید خط زیر را به فایل ~/.mailcap خود بیفزایید:

application/xdvi-unknown; \
    netscape -raise -remote 'openURL(%s,new-window)'

به‌طور پیش‌فرض، موارد منطبق با رنگ معکوس برجسته می‌شوند. اگر نمایشگر در حالت TrueColor اجرا نشود، یا منبع X با نام matchHighlightInverted روی false تنظیم شده باشد یا گزینهٔ خط فرمان -nomatchinverted استفاده شود، xdvi در عوض مستطیلی با رنگ highlight (گزینهٔ -hl را ببینید) به دور مورد منطبق رسم می‌کند.

اگر یک تطابق از مرز صفحه عبور کند، تنها بخش واقع در صفحهٔ اول برجسته می‌شود. Xdvi تا ۲ صفحهٔ مجاور را برای تطبیق رشته‌هایی که از مرزهای صفحه عبور می‌کنند پویش خواهد کرد؛ اما توجه داشته باشید که خطوط سربرگ یا پانویس، یا صفحات شناور میانی به عنوان بخشی از متن پویش‌شده در نظر گرفته می‌شوند. چنین متنی معمولاً باعث شکست در تطابق‌های چندصفحه‌ای خواهد شد.

این موضوع بر این واقعیت تأکید دارد که جستجو در متن قالب‌بندی‌شده (خروجی DVI) متفاوت از جستجو در متن منبع عمل می‌کند: جستجو در فایل DVI رد شدن از دستورالعمل‌های قالب‌بندی را آسان‌تر کرده و امکان جستجوی مواردی چون خط‌فاصله‌گذاری (hyphenation) و شماره‌های معادلات را فراهم می‌سازد؛ اما گاهی اوقات نتایج قالب‌بندی نیز می‌توانند مانع شوند، مانند پاورقی‌ها. در این موارد بهتر است در عوض در منبع TeX جستجو کنید. استفاده از source specials جابجایی میان نمایشگر xdvi و ویرایشگر حاوی منبع TeX را آسان‌تر می‌کند؛ برای اطلاعات بیشتر در این مورد، بخش SOURCE SPECIALS را در ادامه ببینید.

متن استخراج‌شده از فایل DVI با کدگذاری UTF-8 کدگذاری شده است (می‌توانید آن متن را با ذخیرهٔ فایل در قالب UTF-8 از طریق آیتم منوی File > Save as ... مشاهده کنید). اگر xdvi به همراه پشتیبانی از locale، nl_langinfo() و iconv کامپایل شده باشد، عبارت جستجو از مجموعه نویسه‌های تعیین‌شده توسط locale جاری به UTF-8 تبدیل می‌شود. (خروجی locale -a را برای فهرستی از تنظیمات محلی موجود در سیستم خود بررسی کنید). اگر nl_langinfo() در دسترس نباشد اما iconv موجود باشد، می‌توانید کدگذاری ورودی برای iconv را از طریق منبع X با نام textEncoding مشخص کنید (خروجی iconv -l را برای فهرستی از کدگذاری‌های معتبر بررسی کنید). اگر پشتیبانی از iconv در دسترس نباشد، تنها کدگذاری‌های ISO-8859-1 و UTF-8 پشتیبانی می‌شوند (این نام‌ها به بزرگی و کوچکی حروف حساس نیستند).

با نویسه‌های اندیشه‌نگاشت (Ideographic) قلم‌های CJKV به طور ویژه‌ای رفتار می‌شود: تمام فضاهای خالی (فاصله‌ها و خطوط جدید) قبل و بعد از این نویسه‌ها در رشتهٔ جستجو و در فایل DVI نادیده گرفته می‌شوند.

برای تطبیق با نویسهٔ خط جدید، از \n در رشتهٔ جستجو استفاده کنید؛ برای تطبیق با رشتهٔ \n، از \\n استفاده کنید.

اگر چک‌باکس Regular Expression فعال باشد، با رشته به عنوان یک عبارت منظم با نحو گسترش‌یافتهٔ POSIX رفتار می‌شود که دارای ویژگی‌های زیر است:

این پنجرهٔ محاوره‌ای همچنین چک‌باکس‌هایی را برای موارد زیر فراهم می‌کند:

تنظیمات فعلی چک‌باکس در فایل ~/.xdvirc ذخیره می‌شوند. پنجره محاوره‌ای چاپ به شما امکان می‌دهد همه صفحه‌ها، صفحه‌های نشانه‌گذاری‌شده (با کلیک یا کشیدن Mouse-2 در فهرست صفحه‌ها برای نشانه‌گذاری آن‌ها)، یا بازه‌ای از صفحه‌ها را چاپ کنید. توجه داشته باشید که شماره صفحه‌ها همواره به صفحه‌های فیزیکی اشاره دارند؛ بنابراین اگر از گزینه “use TeX pages” استفاده می‌کنید، ممکن است بخواهید آن را غیرفعال کنید تا تعیین شماره صفحه‌های درست آسان‌تر شود (یا با نشانه‌گذاری صفحاتی که باید چاپ شوند، به‌کلی از بروز این مشکل جلوگیری کنید).

مقدار فیلد متنی Printer از طریق سازوکار -o! به‌عنوان یک آرگومان تکی پس از «!» به dvips ارسال می‌شود. هرگونه آرگومان واردشده در فیلد Dvips options در فاصله‌های خالی (whitespace) تفکیک شده و به‌عنوان آرگومان‌های مجزا به dvips تحویل داده می‌شود. برای نمونه، اگر می‌خواهید فایل را به‌صورت ۲ صفحه در یک برگه (2-up) چاپ کنید، باید رشته زیر را در فیلد Printer وارد کنید:

psnup -2 -q | lpr -Plp

چندین منبع برای سفارشی‌سازی رفتار و مقادیر پیش‌فرض پنجره چاپ وجود دارد:

dvipsPrinterString

dvipsOptionsString

این منابع می‌توانند به‌ترتیب برای تعیین مقادیر پیش‌فرض فیلدهای متنی Printer و Dvips options استفاده شوند. اگر اندازه کاغذ در فایل DVI مشخص نشده باشد (مثلاً از طریق \usepackage[dvips]{geometry} - که روش ارجح است)، فیلد ورودی با مقدار فعلی گزینه خط فرمان/منبع اکس paper مقداردهی اولیه می‌شود. به‌عنوان مثال، گزینه -paper a4r به گزینه‌های dvips به‌صورت -t a4 -t landscape ترجمه می‌شود. توجه داشته باشید که هیچ بررسی انجام نمی‌شود که آیا dvips واقعاً این گزینه‌ها را پشتیبانی می‌کند یا خیر (اگر پشتیبانی نکند، آن‌ها را نادیده می‌گیرد)؛ در حال حاضر تمام گزینه‌هایی که xdvi به کار می‌برد توسط dvips پوشش داده نمی‌شوند.

dvipsHangTime

dvipsFailHangTime

این منابع مدت‌زمانی (به میلی‌ثانیه) را مشخص می‌کنند که پنجره پیشرفت چاپ پس از پایان فرآیند dvips باز خواهد ماند. مقدار dvipsHangTime در صورتی اعمال می‌شود که فرآیند با موفقیت پایان یابد؛ dvipsFailHangTime نیز هنگامی استفاده می‌شود که فرآیند با خطا متوقف شود. مقادیر پیش‌فرض به‌ترتیب ۱٫۵ و ۵ ثانیه هستند. اگر هر دو مقدار منفی باشند، پنجره تا زمانی که توسط کاربر بسته نشود باز می‌ماند.

پنجره ذخیره (SAVE DIALOG)

این پنجره به شما امکان می‌دهد تمام یا صفحه‌های انتخاب‌شده/نشانه‌گذاری‌شده در فایل DVI جاری را ذخیره کنید. شما می‌توانید در یکی از قالب‌های زیر ذخیره‌سازی را انجام دهید:

برنامه‌های مورد استفاده برای تبدیل به PostScript و PDF می‌توانند به‌ترتیب از طریق گزینه‌های خط فرمان یا منابع اکس -dvipspath/.dvipsPath و -ps2pdfpath/.ps2pdfPath سفارشی‌سازی شوند؛ برای جزئیات بیشتر به شرح این گزینه‌ها در بخش‌های بالاتر مراجعه کنید.

حالت‌ها (MODES)

فشردن کلید Ctrl-m [switch-mode()] بین سه حالت مختلف نگاشت کلیدهای ماوس جابه‌جا می‌شود، که همچنین می‌توان آن را از طریق منوی Modes فعال کرد (در Motif، این یک زیرمنو از منوی Options تحت عنوان Mouse Mode است). حالت پیش‌فرض در زمان راه‌اندازی می‌تواند از طریق منبع اکس mouseMode یا گزینه خط فرمان -mousemode تنظیم شود. حالت راه‌اندازی پیش‌فرض Magnifier Mode است.

نکته: این حالت‌ها با تغییر دادن کنش magnifier() پیاده‌سازی شده‌اند. در صورتی که Mouse-1 برای دنباله‌ای از کنش‌ها سفارشی‌سازی شده باشد که شامل کنش magnifier() نیست، تغییر حالت کار نخواهد کرد.

حالت ذره‌بین (Magnifier Mode)

در این حالت، دکمه‌های ۱ تا ۵ ماوس پنجره شناور «ذره‌بین» را باز می‌کنند که تصویری کوچک‌نشده (در اندازه اصلی) از صفحه را (یعنی تصویری با تفکیک‌پذیری تعیین‌شده توسط گزینه/منبع اکس pixels یا mfmode) در اندازه‌های گوناگون نمایش می‌دهد. هنگامی که ذره‌بین حرکت داده می‌شود، درجه‌بندی‌های کوچک خط‌کش‌مانندی در لبه‌های ذره‌بین نمایش داده می‌شوند (مگر آنکه منبع اکس delayRulers روی false تنظیم شده باشد، که در این صورت نشانه‌های درجه‌بندی همواره نمایش می‌یابند). واحد درجه‌بندی‌ها توسط منبع اکس tickUnits تعیین می‌شود (پیش‌فرض mm است). این واحد را می‌توان در زمان اجرا از طریق کنش switch-magnifier-units() تغییر داد که به‌طور پیش‌فرض به کلید `t' اختصاص داده شده است (برای جزئیات بیشتر درباره واحدهای موجود، شرح آن کلید و کنش switch-magnifier-units() را ببینید).
طول نشانه‌های درجه‌بندی را می‌توان از طریق منبع اکس tickLength تغییر داد (پیش‌فرض ۴ است). مقدار صفر یا منفی نمایش نشانه‌ها را غیرفعال می‌سازد.

حالت انتخاب متن (Text Selection Mode)

این حالت به شما امکان می‌دهد با نگه داشتن کلید Mouse-1 و حرکت دادن ماوس، ناحیه‌ای مستطیلی از متن را در فایل DVI انتخاب کنید. متن در انتخاب اولیه (primary selection) اکس قرار می‌گیرد تا بتوان آن را طبق معمول با Mouse-2 در دیگر برنامه‌های X چسباند (paste کرد).
اگر xdvi به همراه پشتیبانی از locale، nl_langinfo() و iconv کامپایل شده باشد، متن انتخاب‌شده به مجموعه نویسه locale جاری تبدیل می‌شود (برای مشاهده فهرستی از تنظیمات locale موجود در سیستم خود، خروجی دستور locale -a را بررسی کنید). اگر nl_langinfo() در دسترس نباشد اما iconv موجود باشد، می‌توانید کدگذاری ورودی iconv را از طریق منبع اکس textEncoding مشخص کنید (برای دیدن فهرست کدگذاری‌های معتبر، خروجی iconv -l را ببینید). اگر پشتیبانی از iconv موجود نباشد، تنها کدگذاری‌های ISO-8859-1 و UTF-8 پشتیبانی می‌شوند (این نام‌ها به بزرگ و کوچکی حروف حساس نیستند).
توجه داشته باشید که UTF-8 تنها کدگذاری‌ای است که می‌تواند تمام نویسه‌های یک فایل DVI (مانند نمادهای ریاضی) را ارائه دهد. در صورت فعال بودن ISO-8859-1، نویسه‌هایی که قابل نمایش نیستند با «\» و به دنبال آن کد شانزده‌شانزدهی نویسه جایگزین می‌شوند. برای سایر کدگذاری‌ها، چنین نویسه‌هایی ممکن است باعث نمایش پیام‌های خطای iconv شوند. اگر نویسه‌ای اصلاً شناسایی نشود، با «?» جایگزین می‌شود.
جهت استخراج بخش‌های بزرگ‌تری از متن، می‌توانید به‌جای این کار، صفحات انتخاب‌شده یا کل فایل را در قالب متنی از طریق منوی File > Save as ... ذخیره کنید. حالت خط‌کش (Ruler Mode) این حالت روشی ساده برای اندازه‌گیری فاصله‌ها در صفحه فراهم می‌کند.
هنگامی که این حالت فعال می‌شود، مکان‌نمای موشواره به یک علامت بعلاوهٔ باریک تبدیل می‌شود، و یک خط‌کش صلیبی‌شکل بزرگ‌تر با رنگ برجسته‌سازی در محل موشواره رسم می‌گردد. این خط‌کش فاقد واحدهای مشخص روی خود است؛ در عوض، فاصلهٔ فعلی بین خط‌کش و مکان‌نمای موشواره به‌طور پیوسته در سطر وضعیت (statusline) چاپ می‌شود.
هنگام فعال‌سازی حالت خط‌کش، خط‌کش در ابتدا به موشواره متصل است و می‌توان آن را جابه‌جا کرد. سپس می‌توان با کلیک روی Mouse-1 آن را در مکانی ثابت قرار داد. پس از آن، مکان‌نمای موشواره را می‌توان برای اندازه‌گیری فاصلهٔ افقی (dx)، عمودی (dy) و مستقیم (کوتاه‌ترین) (dr) بین نقطهٔ مرکزی خط‌کش و موشواره حرکت داد.
کلیک دوبارهٔ Mouse-1 خط‌کش را به موقعیت فعلی موشواره منتقل می‌کند، و پایین نگه‌داشتن Mouse-1 خط‌کش را جابه‌جا خواهد کرد.
در حالت خط‌کش، کلیدهای میانبر ویژهٔ زیر، کلیدهای پیش‌فرض را گسترش داده یا جایگزین آن‌ها می‌شوند:

نوار ابزار (TOOLBAR (Motif only))

نوار ابزار Motif را نیز می‌توان سفارشی‌سازی کرد. فایل XPM استفاده‌شده برای شمایل‌های نوار ابزار را می‌توان از طریق منبع toolbarPixmapFile مشخص کرد، که باید شامل نام فایلی باشد که بتوان آن را در یکی از متغیرهای XFILESEARCHPATH یا XDVIINPUTS یافت (برای اطلاعات بیشتر در مورد این متغیرها، بخش FILE SEARCHING در زیر را ببینید). Xdvi تلاش خواهد کرد تا این pixmap را به‌صورت افقی به n تکه تقسیم کند، که در آن پهنای هر تکه به اندازهٔ ارتفاع pixmap است و به عنوان تصویری در نظر گرفته می‌شود برای دکمهٔ نوار ابزار n. این بدان معناست که هر شمایل باید مربع باشد، و کل pixmap باید دارای پهنای n x h باشد اگر h ارتفاع pixmap باشد.

منبع toolbarTranslations می‌تواند برای نگاشت شمایل‌ها/دکمه‌ها به کنش‌های مشخص به کار رود. این منبع باید شامل رشته‌ای باشد که با نویسه‌های خط جدید از هم جدا شده‌اند، مشابه منابع mainTranslations و menuTranslations. هر خط باید شامل تعریف فاصله‌گذار (spacer) یا تعریف شمایل (icon) باشد:

تعریف فاصله‌گذار رشته‌ای به صورت SPACER(n) است، که در آن n تعداد پیکسل‌هایی است که به عنوان جداکننده تا دکمهٔ بعدی درج می‌شود.

تعریف شمایل فهرستی جداشده با دونقطه (:) است که شامل عناصر زیر می‌باشد:

برای روشن‌تر شدن این موضوع، مقدار پیش‌فرض toolbarTranslations به صورت زیر است:

xdvi.toolbarTranslations: \
   SPACER(5)\n\
   0:Open a new document   (Key\\: Ctrl-f):\
        Open file:select-dvi-file()\n\
   SPACER(10)\n\
   1:Reread this document   (Key\\: R):\
        Reread file:reread-dvi-file()\n\
   SPACER(10)\n\
   2:Go to the first page of this document   (Key\\: 1g):\
        Go to first page:goto-page(1)\n\
   3:Go to the previous page of this document   (Key\\: p):\
        Go to previous page:back-page(1)\n\
   4:Go to the next page of this document   (Key\\: n):\
        Go to next page:forward-page(1)\n\
   5:Go to the last page of this document   (Key\\: g):\
        Go to last page:goto-page()\n\
   SPACER(10)\n\
   6:Enlarge the display   (Key\\: Ctrl-+):Zoom in:\
        set-shrink-factor(+)\n\
   7:Shrink the display   (Key\\: Ctrl--):Zoom out:\
        set-shrink-factor(-)\n\
   SPACER(10)\n\
   8:Jump back to the previous hyperlink   (Key\\: B):\
        Back hyperlink:htex-back()\n\
   SPACER(10)\n\
   10:Print this document:Print:print()\n\
   SPACER(10)\n\
   11:Toggle marks for odd pages   (Key\\: 1m):\
        Toggle odd:toggle-mark(1)\n\
   12:Toggle marks for even pages   (Key\\: 2m):\
        Toggle even:toggle-mark(2)\n\
   13:Toggle mark for current page   (Key\\: 2m):\
        Toggle current:toggle-mark()\n\
   14:Unmark all pages   (Key\\: 0m):\
        Unmark all:toggle-mark(0)\n\
   SPACER(10)\n\
   18:Display fonts darker   (Key\\: Alt-Ctrl-+):\
        Fonts darker:change-density(5)\n\
   19:Display fonts lighter   (Key\\: Alt-Ctrl--):\
        Fonts lighter:change-density(-5)\n

هنگامی که موشواره برای مدت معینی روی یک دکمهٔ نوار ابزار باقی بماند، پنجرهٔ «راهنمای ابزار» (tooltip) نمایش داده می‌شود، که کارایی دکمه را با استفاده از رشتهٔ راهنمای ابزار کوتاه از منبع بالا شرح می‌دهد. هم‌زمان، رشتهٔ راهنمای ابزار طولانی در سطر وضعیت نمایش داده می‌شود. ظاهر و رفتار این راهنماهای ابزار را می‌توان از طریق منابع زیر سفارشی‌سازی کرد:

tipShell.background

رنگ پس‌زمینهٔ پنجرهٔ راهنمای ابزار.

tipShell.fontSet

قلم مورد استفاده برای راهنمای ابزار.

tipShell.waitPeriod

مدت زمانی (به میلی‌ثانیه) که نشانگر موشواره باید روی دکمه قرار گیرد تا راهنمای ابزار نمایش داده شود. برای جلوگیری کامل از نمایش راهنماهای ابزار، آن را روی یک مقدار منفی تنظیم کنید. قابلیت هموارسازی لبه‌ها با مقیاس خاکستری (greyscale anti-aliasing) در xdvi در صورتی که نمایشگر رنگ‌های کافی در دسترس نداشته باشد، به بهترین شکل عمل نخواهد کرد. این مسئله می‌تواند هنگامی رخ دهد که برنامه‌های دیگر بیشتر نقشهٔ رنگ (colormap) را اشغال کرده باشند (حتی اگر آیکون یا کمینه شده باشند). در صورت وقوع این حالت، xdvi پیام خطایی چاپ کرده و گزینهٔ -copy را فعال می‌کند. این کار منجر به نمایش نادرست نویسه‌های با چاپ مجدد روی یکدیگر (overstrike) خواهد شد؛ همچنین اگر تعداد رنگ‌های موجود بسیار اندک باشد، ممکن است به کیفیت پایین نمایش بیانجامد.

معمولاً این مشکل در نمایشگرهایی رخ می‌دهد که هشت بیت از حافظهٔ ویدئویی را به هر پیکسل اختصاص می‌دهند. برای مشاهدهٔ اینکه نمایشگر شما از چند بیت در هر پیکسل استفاده می‌کند، در یک پنجرهٔ xterm دستور xwininfo را تایپ کنید، و سپس هنگام درخواست، با موشواره روی پنجرهٔ ریشه (root window) کلیک نمایید. مدخل ``Depth:'' مشخص خواهد کرد چه تعداد بیت به هر پیکسل اختصاص یافته است.

نمایشگرهایی که از دست‌کم ۱۵ بیت در هر پیکسل استفاده می‌کنند، معمولاً جلوه‌های بصری TrueColor هستند که این مشکل را ندارند، چرا که نقشهٔ رنگ آن‌ها به طور دائم اختصاص یافته و در دسترس همهٔ برنامه‌ها است. (کلاس بصری نیز توسط xwininfo نمایش داده می‌شود.) برای اطلاعات بیشتر دربارهٔ کلاس‌های بصری، به مستندات سامانه پنجره X مراجعه کنید.

بنابراین برای برطرف کردن این مشکل، می‌توان (الف) سیستم را با بیت‌های بیشتری در هر پیکسل اجرا کرد (این امر ممکن است نیازمند افزایش حافظهٔ ویدئویی یا تعویض کارت گرافیک باشد)، (ب) برنامه‌های دیگری که بخش عمده‌ای از نقشهٔ رنگ را مصرف می‌کنند بست و سپس xdvi را دوباره اجرا کرد، یا (ج) xdvi را با گزینهٔ -install اجرا نمود.

یکی از برنامه‌هایی که اغلب علت این مشکل است Netscape می‌باشد. در این مورد، دو راهکار دیگر برای چاره‌جویی وضعیت وجود دارد. می‌توان دستور ``netscape -install'' را اجرا کرد تا Netscape یک نقشهٔ رنگ خصوصی را نصب کند. این کار می‌تواند هنگامی که موشواره به پنجرهٔ دیگری منتقل می‌شود، باعث تغییرات عجیب در رنگ‌ها شود. یا می‌توان دستور ``netscape -ncols 220'' را اجرا کرد تا Netscape به تعداد رنگ کمتری محدود شود. تعداد کمتر تضمین می‌کند که برنامه‌های دیگر رنگ‌های بیشتری در دسترس داشته باشند، اما کیفیت رنگ را در پنجرهٔ Netscape کاهش خواهد داد.

مدیریت اشکال پست‌اسکریپت (HANDLING OF POSTSCRIPT FIGURES)

Xdvi می‌تواند فایل‌های Encapsulated PostScript (EPS) گنجانده‌شده در فایل dvi را نمایش دهد. این‌گونه فایل‌ها ابتدا در همان پوشه‌ای که فایل dvi در آن قرار دارد جستجو می‌شوند، و سپس با استفاده از قوانین عادی Kpathsea جستجو می‌گردند. با این وجود، یک استثنا وجود دارد: اگر نام فایل با یک بک‌تیک (`) شروع شود، نویسه‌های باقی‌مانده در نام فایل به عنوان یک دستور شل (اغلب zcat) در نظر گرفته شده و اجرا می‌شوند؛ سپس خروجی استاندارد آن برای تفسیر به عنوان PostScript ارسال می‌گردد. از آنجا که اجرای دستورات دلخواه شل با مجوزهای کاربر یک ریسک امنیتی بسیار بزرگ است، ارزیابی این دستورات بک‌تیک به صورت پیش‌فرض غیرفعال شده است. فعال‌سازی آن باید از طریق گزینهٔ خط فرمان -allowshell انجام گیرد. نکته: هرگز نباید هنگام مشاهدهٔ اسنادی که خودتان کامپایل نکرده‌اید از این گزینه استفاده کنید. نویسه‌های ویژهٔ بک‌تیک برای غیرفشرده‌سازی فایل‌های PostScript فشرده با gzip لازم نیستند، زیرا xdvi اگر نام فایل با .eps.gz یا .eps.Z پایان یابد (و بایت‌های آغازین فایل نشان دهند که فایل واقعاً فشرده شده است)، می‌تواند این کار را بی‌درنگ در هنگام اجرا انجام دهد. این روش نسبت به رویکرد بک‌تیک هم امن‌تر و هم منعطف‌تر است، زیرا قوانین پیش‌فرض جستجوی فایل برای چنین نام‌هایی نیز اعمال خواهند شد.

قلم‌های TYPE 1 (TYPE 1 FONTS)

با استفاده از FreeType (نسخه ۲)، xdvi می‌تواند قلم‌های PostScript<tm> Type 1 را مستقیماً، بدون نیاز به عبور از مسیر قلم‌های پیکسلی (pk) متعلق به TeX رندر کند. مزیت این امر این است که تنها باید یک اندازه از هر قلم روی دیسک ذخیره شود. مگر اینکه از گزینهٔ -notype1fonts استفاده شود، xdvi تلاش خواهد کرد هر قلمی را با استفاده از FreeType رندر کند. تنها به عنوان جایگزین نهایی (fallback)، برنامه‌ای خارجی (مانند mktexpk که خود ممکن است ابزارهایی مانند ps2pk یا gsftopk) را فراخوانی کند، اجرا خواهد شد تا قلم پیکسلی را از منبع Type 1 تولید نماید. رندر مستقیم قلم‌های Computer Modern باید بدون نیاز به تنظیمات اضافی کار کند، در حالی که سایر قلم‌های Type 1 مانند ۳۵ قلم استاندارد PostScript<tm> مقیم در چاپگرها ممکن است نیاز به در دسترس قرار گرفتن برای استفاده در xdvi داشته باشند، مگر آنکه مدیر سیستم یا توزیع TeX شما پیشاپیش این کار را انجام داده باشد (که به عنوان نمونه در سیستم‌های کنونی TeX Live چنین است). برای ۳۵ قلم مقیم PostScript<tm>، در صورت نیاز xdvik با استفاده از Fontmap ارائه‌شده به همراه Ghostscript جستجو خواهد کرد. همچنین، توزیع xdvik با ابزاری به نام t1mapper عرضه می‌شود تا این قلم‌ها را برای xdvi در دسترس قرار دهد؛ برای جزئیات استفاده به صفحهٔ راهنمای t1mapper(1) مراجعه کنید. با این وجود، احتمالاً این برنامه در آینده حذف خواهد شد، زیرا به احتمال قوی دیگر نیازی به آن نیست. هر یک از دستورات ویژه (specials) مورد استفاده توسط xdvi می‌توانند با نویسه‌های ``xdvi:'' آغاز شوند. انجام این کار رفتار دستور ویژه را تحت xdvi تغییر نمی‌دهد، اما به سایر راه‌اندازهای dvi (مانند dvips) اعلام می‌کند که آن دستور ویژه را نادیده بگیرند.

دستورات ویژه مبدأ (SOURCE SPECIALS)

برخی از پیاده‌سازی‌های TeX یا بسته‌های ماکرو این امکان را فراهم می‌کنند که به‌اصطلاح «دستورات ویژه مبدأ» (source specials) به‌طور خودکار درون یک فایل DVI گنجانده شوند. این دستورات شامل شماره خط، در مواردی شماره ستون، و نام فایل مبدأ .tex هستند. این قابلیت پرش از یک فایل .dvi به مکان متناظر در مبدأ .tex و بالعکس را امکان‌پذیر می‌سازد (که «جستجوی معکوس» نیز نامیده می‌شود - پرش از فایل DVI به فایل TeX تحت عنوان «جستجوی وارون» (reverse search) و پرش از فایل TeX به فایل DVI با عنوان «جستجوی مستقیم» (forward search) شناخته می‌شود).

برای قابل استفاده بودن در xdvi، دستورات ویژه مبدأ در فایل dvi باید یکی از قالب‌های زیر را داشته باشند:

src:line[ ]filename
src:line:col[ ]filename
src:line
src:line:col
src::col

برای درج چنین دستورات ویژه مبدأ در فایل DVI، به یک پیاده‌سازی TeX نیاز خواهید داشت که سوییچ مناسبی ارائه دهد (مانند -src) یا یک بسته ماکرو (مانند srcltx.sty یا srctex.sty، موجود در CTAN:macros/latex/contrib/supported/srcltx/).

برای جستجوی وارون، ترکیب کلیدهای Ctrl-Mouse 1 باعث می‌شود xdvi یک ویرایشگر (مقدار تعیین‌شده در گزینه خط فرمان -editor) را به همراه فایل و شماره خط مبدأ .tex باز کند. برای اطلاعات بیشتر و نمونه تنظیمات، به توضیحات گزینه -editor مراجعه کنید.

برای جستجوی مستقیم، xdvi دارای گزینه -sourceposition است که باعث می‌شود xdvi به صفحه متناظر با خط داده‌شده (یا نزدیک‌ترین خط دارای دستور ویژه مبدأ) از فایل مشخص‌شده در فایل DVI بپرد و ناحیه یافت‌شده را برجسته کند. برای جزئیات بیشتر به توضیحات گزینه -sourceposition مراجعه فرمایید.

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

دستورات ویژه اندازه کاغذ (PAPERSIZE SPECIALS)

xdvi دستورات ویژه‌ای را جهت تعیین اندازه کاغذ سند می‌پذیرد. این دستورات ویژه باید به شکل زیر باشند:

papersize=[*]width,height

که در آن width و height به‌ترتیب پهنا و ارتفاع کاغذ را مشخص می‌کنند. هر یک از این مقادیر باید به صورت یک عدد اعشاری ظاهر شوند که در پی آن یکی از اختصارات دوحرفی یکاهای پذیرفته‌شده توسط TeX می‌آید (pt، pc، in، bp، cm، mm، dd، cc، یا sp). اگر یک علامت ستاره (*) درست قبل از پهنا قرار گیرد، اندازه‌گیری‌ها به ابعاد سند ارجاع داده می‌شوند (مثلاً pt در مقایسه با truept). این امر به یک بسته ماکرو امکان می‌دهد تا اندازه صفحه را متناسب با اجزای سند تغییر دهد؛ به عنوان مثال:

\special{xdvi: papersize=*\number\wd\mybox sp,
         \number\ht\mybox sp}

به‌جز علامت ستاره، این قالب کاملاً با dvips سازگار است.

آخرین دستور ویژه papersize در یک صفحه، اندازه آن صفحه را تعیین می‌کند. اگر چنین دستور ویژه‌ای در صفحه‌ای معین وجود نداشته باشد، تازه‌ترین papersize استفاده می‌شود؛ یا اگر در هیچ‌یک از صفحات پیشین نیز دستور ویژه papersize وجود نداشته باشد، مقدار منبع paper (یا گزینه -paper در خط فرمان) به کار گرفته خواهد شد. بدین ترتیب اندازه کاغذ ممکن است برای صفحات مختلف فایل dvi متفاوت باشد.

اگر مقدار منبع paper (یا گزینه خط فرمان -paper) با علامت علامت جمع (`+') آغاز شود، تمام دستورات ویژه papersize موجود در فایل dvi نادیده گرفته می‌شوند. دستورهای ویژه رنگ (color specials) پشتیبانی‌شده توسط xdvi مشابه مواردی است که توسط dvips پشتیبانی می‌شوند، به جز اینکه مشخصات رنگ دائمی PostScript (مانند مثال AggiePattern در مستندات dvips) پشتیبانی نمی‌شود. همچنین محدودیت‌هایی به دلیل نحوه پیاده‌سازی روتین‌های رسم xdvi وجود دارد؛ به عنوان مثال ماکروهای \colorbox و \fcolorbox با xdvi کار نمی‌کنند. برای اطلاعات بیشتر درباره این محدودیت‌ها، بخش «محدودیت‌ها (LIMITATIONS)» در ادامه را ببینید. Xdvi از همان فهرست نام‌های رنگی که dvips پشتیبانی می‌کند، پشتیبانی می‌نماید، یعنی:

Apricot, Aquamarine, Bittersweet, Black, Blue, BlueGreen, BlueViolet, BrickRed, Brown, BurntOrange, CadetBlue, CarnationPink, Cerulean, CornflowerBlue, Cyan, Dandelion, DarkOrchid, Emerald, ForestGreen, Fuchsia, Goldenrod, Gray, Green, GreenYellow, JungleGreen, Lavender, LimeGreen, Magenta, Mahogany, Maroon, Melon, MidnightBlue, Mulberry, NavyBlue, OliveGreen, Orange, OrangeRed, Orchid, Peach, Periwinkle, PineGreen, Plum, ProcessBlue, Purple, RawSienna, Red, RedOrange, RedViolet, Rhodamine, RoyalBlue, RoyalPurple, RubineRed, Salmon, SeaGreen, Sepia, SkyBlue, SpringGreen, Tan, TealBlue, Thistle, Turquoise, Violet, VioletRed, White, WildStrawberry, Yellow, YellowGreen, YellowOrange.

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

مستندات بسته color در LaTeX جزئیات بیشتری درباره نحوه استفاده از این دستورهای ویژه با LaTeX ارائه می‌دهد؛ برای شرح تفصیلی نحو و معناشناسی دستورهای ویژه رنگ، مستندات dvips را ببینید.

سیگنال‌ها (SIGNALS)

هنگامی که xdvi یک سیگنال SIGUSR1 دریافت می‌کند، فایل dvi را مجدداً بازخوانی می‌کند.

محیط (ENVIRONMENT)

Xdvik برای جستجوی فایل‌های قلم از همان متغیرهای محیطی و الگوریتم‌هایی استفاده می‌کند که TeX و متعلقات آن به کار می‌برند. برای شرح تفصیلی این موارد، مستندات کتابخانه Kpathsea، یعنی kpathsea.dvi را ببینید.

علاوه بر این، xdvik متغیرهای زیر را می‌پذیرد:

DISPLAY

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

KPATHSEA_DEBUG

ردیابی جستجوهای Kpathsea؛ برای ردیابی کامل آن را روی -1 (= روشن بودن همه بیت‌ها) تنظیم کنید.

EXTENSIONMAPS

فهرستی از فایل‌ها که برای ورودی‌های انواع mime (مانند Acrobat Reader) جستجو می‌شوند. مدخل‌های پیشین در یکی از این فایل‌ها بر مدخل‌های پسین اولویت دارند. اگر این متغیر تنظیم نشده باشد، مسیر پیش‌فرض زیر استفاده می‌شود:

$HOME/.mime.types:/etc/mime.types:\
    /usr/etc/mime.types:/usr/local/etc/mime.types

MAILCAPS

فهرستی از فایل‌ها برای جستجوی مدخل‌های mailcap، طبق تعریف RFC 1343. برای شرح تفصیلی قالب فایل mailcap به این RFC یا صفحه راهنمای mailcap(4) مراجعه کنید. در حال حاضر تنها ویژگی‌های mailcap زیر پشتیبانی می‌شوند:

$HOME/.mailcap:/etc/mailcap:/usr/etc/mailcap:\
    /usr/local/etc/mailcap

BROWSER

مرورگر وب مورد استفاده برای باز کردن پیوندهای خارجی (یعنی تمام نشانی‌های وب که با طرح‌واره `file:' شروع نمی‌شوند و پیوندهای نسبی در فایل DVI محلی نیستند)، و برای باز کردن پیوندهایی که هیچ نمایشگری برای آن‌ها در فایل‌های mailcap مشخص نشده است را تعیین می‌کند. مقدار این متغیر فهرستی از دستورها است که با دونقطه از هم جدا شده‌اند. Xdvi هر یک از آن‌ها را به ترتیب امتحان می‌کند تا یکی از آن‌ها موفق شود (یعنی بلافاصله با وضعیت 0 بازنگردد). این قابلیت به شما امکان می‌دهد تا مرورگر دلخواه خود را در ابتدا، و مرورگرهای جایگزین را در انتها مشخص کنید. هر بار تکرار %s در این رشته با نشانی وب هدف جایگزین می‌شود؛ هر بار تکرار %% با یک % تکی جایگزین می‌شود. اگر هیچ %s وجود نداشته باشد، رشته نشانی وب به عنوان یک آرگومان اضافی افزوده می‌شود.
یک نمونه تنظیمات به این صورت است:

GS_LIB

فهرستی از دایرکتوری‌های جداشده با دونقطه (:) برای جستجوی فایل‌های Fontmap و غیره، همان‌طور که برای Ghostscript استفاده می‌شود. این متغیر همان معنایی را دارد که هنگام اجرای Ghostscript دارد. در xdvik، هنگامی که فایل نگاشت (map file) نام فایلی را برای قلم مشخص نمی‌کند (که این مورد باید بسیار نادر باشد)، برای جستجوی فایل‌های قلم استفاده می‌شود. دستور gs -h مقدار پیش‌فرضی را که Ghostscript استفاده می‌کند فهرست خواهد کرد. همچنین متغیر محیطی XDVI_GS_LIB (در ادامه) را ببینید.

XDVI_GS_LIB

این متغیر اثر مشابهی با GS_LIB دارد اما تنها بر xdvi تأثیر می‌گذارد. هنگامی از این متغیر استفاده کنید که می‌خواهید در زمان اجرای xdvi، مقدار متفاوتی را برای GS_LIB به‌کار ببرید، اما هنگام اجرای Ghostscript از مقدار پیش‌فرض کامپایل‌شده یا مقداری دیگر استفاده کنید. اگر هر دو متغیر GS_LIB و XDVI_GS_LIB تنظیم شده باشند، آن‌گاه xdvi از XDVI_GS_LIB استفاده می‌کند. برای استفاده از مقدار پیش‌فرض کامپایل‌شده در xdvi در عین حفظ توانایی تنظیم GS_LIB برای استفاده با Ghostscript، می‌توانید XDVI_GS_LIB را برابر با یک رشته خالی قرار دهید.

TMPDIR

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

XEDITOR

دستور ویرایشگری را تعیین می‌کند که برای «جستجوی معکوس» (reverse search) در source special استفاده می‌شود، در صورتی که نه گزینه خط فرمان -editor و نه منبع .editor مشخص نشده باشند. برای جزئیات در مورد قالب آن، توضیحات گزینه خط فرمان -editor را ببینید.

VISUAL

ویرایشگری را برای باز شدن در یک پنجره xterm تعیین می‌کند، در صورتی که هیچ‌یک از -editor، .editor، یا XEDITOR مشخص نشده باشند.

EDITOR

ویرایشگری را برای باز شدن در یک پنجره xterm تعیین می‌کند، در صورتی که هیچ‌یک از -editor، .editor، XEDITOR یا VISUAL مشخص نشده باشند.

WWWBROWSER

منسوخ شده است؛ به‌جای آن از BROWSER استفاده کنید.

محدودیت‌ها (LIMITATIONS)

xdvi بسیاری از انواع PostScript specials را که توسط dvips پذیرفته می‌شوند قبول می‌کند، اما نه همه آن‌ها را. برای نمونه، بیشتر ویژه‌دستورهای (specials) تولیدشده توسط epsf و psfig را می‌پذیرد. با این حال، از bop-hook یا eop-hook پشتیبانی نمی‌کند، و همچنین اجازه نمی‌دهد دستورات PostScript بر رندر مواردی که PostScript نیستند تأثیر بگذارند (برای نمونه، مثال‌های «NEAT» و «A» چرخانده‌شده در راهنمای dvips). این محدودیت‌ها ناشی از طراحی xdvi هستند؛ و به احتمال زیاد همواره باقی خواهند ماند.

ویژه‌دستورهای (specials) چرخش LaTeX2e در حال حاضر پشتیبانی نمی‌شوند.

فایل‌های MetaPost حاوی متن گنجانده‌شده پشتیبانی نمی‌شوند.

مدیریت رنگ در xdvi از ماکروهای \colorbox و \fcolorbox پشتیبانی نمی‌کند؛ احتمال تغییر این موضوع در آینده نزدیک اندک است. این همچنین بدین معناست که برای نمونه، جدول‌های رنگی (مانند آنچه توسط بسته colortbl ایجاد می‌شود) ممکن است به نادرستی رندر شوند: متن در رنگ‌هایی متفاوت از رنگ پیش‌فرض پیش‌زمینه ممکن است نمایش داده نشود. هنگامی که صفحه مجدداً بازترسیم می‌شود (مثلاً پس از استفاده از ذره‌بین)، ممکن است رنگ پس‌زمینه سلول‌ها روی متن را بپوشاند..SH "فایل‌ها (FILES)"

$HOME/.xdvirc

فایلی شامل تمام تنظیماتی که کاربر از طریق کلیدها، منوی “Options”، منوی “Modes” در Xaw و کادرهای محاوره تغییر داده است و به عنوان منابع X نگهداری می‌شوند. این منابع، تنظیمات موجود در $HOME/.Xdefaults را بازنویسی می‌کنند. در صورت استفاده از گزینهٔ -q یا تنظیم منبع X با عنوان noInitFile، این فایل نادیده گرفته می‌شود.

config.xdvi

یک فایل پیکربندی اختیاری برای راه‌اندازی قلم‌های Type 1 که فایل‌های نگاشت به سبک dvips را به صورت ویژه برای xdvik مشخص می‌کند. در صورت استفاده، این فایل باید در دایرکتوری تعیین‌شده توسط متغیر محیطی TEXCONFIG وجود داشته باشد. قالب آن شبیه فایل‌های پیکربندی dvips است، با این تفاوت که فقط برای یافتن نام فایل‌های نگاشت (دستورالعمل‌های p و p+) پیمایش می‌شود.

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

X(1), dvips(1), mktexpk(1), ps2pk(1), gsftopk(1), t1mapper(1), mailcap(4), مستندات Kpathsea، https://ctan.org/pkg/xdvi، و صفحهٔ اصلی Xdvik در http://xdvi.sourceforge.net.

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

Eric Cooper از CMU نسخه‌ای برای خروجی مستقیم به QVSS ایجاد کرد. توسط Bob Scheifler از MIT Laboratory for Computer Science برای X بازنویسی شد. توسط Mark Eichin از MIT SIPB برای X11 اصلاح شد. بهبودهای افزودهٔ دیگری نیز توسط افراد بسیاری انجام گرفته است.

نگه‌دارندهٔ کنونی نسخهٔ اصلی xdvi Paul Vojta از دانشگاه U.C. Berkeley است.

کد مربوط به گونهٔ xdvik توسط افراد بسیاری مشارکت شده است که نام آن‌ها در سراسر فایل‌های منبع پراکنده است.

برای به‌روزترین اطلاعات، لطفاً ببینید:

http://xdvi.sourceforge.net

لطفاً تمام باگ‌ها را به سامانهٔ ردیابی باگ SourceForge گزارش دهید:

http://sourceforge.net/tracker/?func=add&group_id=23164&atid=377580