.\" Copyright 1990-2022 Paul Vojta and others .\" .\" This is Paul's license, included here only for reference, it does not apply .\" to all parts of the k version. .\" ---- .\" Permission is hereby granted, free of charge, to any person obtaining a copy .\" of this software and associated documentation files (the "Software"), to .\" deal in the Software without restriction, including without limitation the .\" rights to use, copy, modify, merge, publish, distribute, sublicense, and/or .\" sell copies of the Software, and to permit persons to whom the Software is .\" furnished to do so, subject to the following conditions: .\" .\" The above copyright notice and this permission notice shall be included in .\" all copies or substantial portions of the Software. .\" .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR .\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, .\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL .\" PAUL VOJTA OR ANY OTHER AUTHOR OF THIS SOFTWARE BE LIABLE FOR ANY CLAIM, .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER .\" DEALINGS IN THE SOFTWARE. .\" ---- .\" This is the xdvik license: .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" following is UGLY ... use La\*(Te\& instead: .\" .if t .ds La L\\h'-0.1667m'\\v'-0.20v'A\\v'0.20v'\\h'-0.1667m'T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X .\" .if n .ds La LaTeX .if t .ds Te T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X .if n .ds Te TeX .\" # small and boldface (not all -man's provide it) .de SB \&\fB\s-1\&\\$1 \\$2\s0\fR .. .TH XDVI 1 "2022-02-17" "Xdvik 22.87.06" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "نام (NAME)" xdvi \- پیش‌نمایشگر DVI برای سیستم پنجره‌ای X .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "خلاصه دستور (SYNOPSIS)" .B xdvi .nh [\fB+\fP[\fIpage\fP]] [\fB\--help\fP] [\fB\-allowshell\fP] [\fB\-altfont\fP \fIfont\fP] [\fB\-anchorposition\fP \fIanchor\fP] [\fB\-bg\fP \fIcolor\fP] [\fB\-browser\fP \fIWWWbrowser\fP] [\fB\-copy\fP] [\fB\-cr\fP \fIcolor\fP] [\fB\-debug\fP \fIbitmask\fP|\fIstring[,string ...]\fP] [\fB\-display\fP \fIhost:display\fP] [\fB\-dvipspath\fP \fIpath\fP] [\fB\-editor\fP \fIcommand\fP] [\fB\-expert\fP] [\fB\-expertmode\fP \fIflag\fP] [\fB\-fg\fP \fIcolor\fP] [\fB\-findstring\fP \fIstring\fP] [\fB\-font\fP \fIfont\fP] [\fB\-fullscreen \fP] [\fB\-gamma\fP \fIg\fP] [\fB\-geometry\fP \fIgeometry\fP] [\fB\-gsalpha\fP] [\fB\-gspalette\fP \fIpalette\fP] [\fB\-h\fP] [\fB\-help\fP] [\fB\-hl\fP \fIcolor\fP] [\fB\-hush\fP] [\fB\-hushbell\fP] [\fB\-hushchars\fP] [\fB\-hushchecksums\fP] [\fB\-hushstdout\fP] [\fB\-icongeometry\fP \fIgeometry\fP] [\fB\-iconic\fP] [\fB\-install\fP] [\fB\-interpreter\fP \fIpath\fP] [\fB\-keep\fP] [\fB\-l\fP] [\fB\-license\fP] [\fB\-linkcolor\fP \fIcolor\fP] [\fB\-linkstyle\fP \fI0|1|2|3\fP] [\fB\-margins\fP \fIdimen\fP] [\fB\-mfmode\fP \fImode-def\fP[\fB:\fP\fIdpi\fP]] [\fB\-mgs\fP[\fIn\fP] \fIsize\fP] [\fB\-mousemode\fP \fI0|1|2\fP] [\fB\-nocolor\fP] [\fB\-nofork\fP] [\fB\-noghostscript\fP] [\fB\-nogrey\fP] [\fB\-nogssafer\fP] [\fB\-noinstall\fP] [\fB\-nomakepk\fP] [\fB\-nomatchinverted\fP] [\fB\-noomega\fP] [\fB\-noscan\fP] [\fB\-notempfile\fP] [\fB\-notype1fonts\fP] [\fB\-offsets\fP \fIdimen\fP] [\fB\-p\fP \fIpixels\fP] [\fB\-paper\fP \fIpapertype\fP] [\fB\-pause\fP] [\fB\-pausespecial\fP \fIspecial-string\fP] [\fB\-postscript\fP \fIflag\fP] [\fB\-rulecolor\fP \fIcolor\fP] [\fB\-rv\fP] [\fB\-S\fP \fIdensity\fP] [\fB\-s\fP \fIshrink\fP] [\fB\-safer\fP] [\fB\-sidemargin\fP \fIdimen\fP] [\fB\-sourceposition\fP \fIline\fP[\fB:\fP\fIcol\fP][\ ]\fIfilename\fP] [\fB\-statusline\fP] [\fB\-text-encoding\fP \fIencoding\fP] [\fB\-thorough\fP] [\fB\-topmargin\fP \fIdimen\fP] [\fB\-unique\fP] [\fB\-version\fP] [\fB\-visitedlinkcolor\fP \fIcolor\fP] [\fB\-warnspecials\fP] [\fB\-watchfile\fP \fIsecs\fP] [\fB\-wheelunit\fP \fIpixels\fP] [\fB\-xoffset\fP \fIdimen\fP] [\fB\-yoffset\fP \fIdimen\fP] [\fIdvi_file\fP] .hy .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".SH "توضیحات (DESCRIPTION)" برنامهٔ .B Xdvi ابزاری برای پیش‌نمایش فایل‌های .I dvi (مانند فایل‌های تولیدشده توسط برنامهٔ .BR tex (1)) تحت سیستم پنجره‌ای X است. .PP .B Xdvi می‌تواند فایل را با ضریب‌های صحیح گوناگون به‌صورت کوچک‌شده نمایش دهد و دارای یک «ذره‌بین» برای مشاهدهٔ بخش‌هایی از صفحه به‌صورت بزرگ‌نمایی‌شده است (بخش MAGNIFIER را در زیر ببینید). این نسخه از .B xdvi با نام .B xdvik نیز شناخته می‌شود، چرا که از کتابخانهٔ kpathsea برای مکان‌یابی و تولید فایل‌های فونت استفاده می‌کند. علاوه بر آن، از قابلیت‌های زیر پشتیبانی می‌کند: .RS 2 .TP 2 - پیوندهای یکتا در فایل‌های DVI (بخش HYPERLINKS)، .TP - رندر مستقیم فونت‌های نوع ۱ PostScript (بخش TYPE 1 FONTS)، .TP - دستورهای ویژهٔ مبدأ (source specials) در فایل DVI (بخش SOURCE SPECIALS)، .TP - جستجوی رشته در فایل‌های DVI (بخش STRING SEARCH)، .TP - ذخیره یا چاپ (بخش‌هایی از) فایل DVI (بخش‌های PRINT DIALOG و SAVE DIALOG). .RE .PP .B Xdvi می‌تواند با جعبه‌ابزار Motif یا جعبه‌ابزار Xaw (Athena) (و گونه‌های آن) کامپایل شود و نسخهٔ Motif دارای واسط گرافیکی کاربر (GUI) کمی متفاوت است؛ این تفاوت‌ها در زیر ذکر شده‌اند. .PP پیش از نمایش یک صفحه از فایل DVI، برنامهٔ .B xdvi بررسی می‌کند که آیا فایل از زمان آخرین نمایش تغییر کرده است یا خیر. در این صورت، فایل را دوباره بارگذاری می‌کند. این ویژگی به شما اجازه می‌دهد تا بدون نیاز به اجرای مجدد، نسخه‌های متعددی از یک فایل را در حین اجرای تنها یک‌بارهٔ .B xdvi مشاهده کنید. از آنجا که این برنامه نمی‌تواند فایل‌های DVI ناقص را بخواند، نسخه‌های .B xdvik از نگارش 22.74.3 به بعد، یک رونوشت موقت از فایل DVI در حال مشاهده ایجاد می‌کنند تا اطمینان حاصل شود که فایل بدون وقفه قابل مشاهده است (گزینهٔ .B \-notempfile می‌تواند برای غیرفعال کردن این ویژگی استفاده شود). .PP .B Xdvi می‌تواند دستورهای ویژهٔ PostScript را با هر یک از سه روش نمایش دهد. ابتدا تلاش می‌کند از Display PostScript استفاده کند، سپس NeWS، و در نهایت برای رندر کردن تصاویر از Ghostscript استفاده خواهد کرد. همهٔ این گزینه‌ها برای کارکرد درست به نرم‌افزارهای جانبی وابسته هستند؛ علاوه بر این، ممکن است برخی از آن‌ها در این نسخه از .BR xdvi کامپایل نشده باشند. .PP به دلایل کارایی و عملکرد، .B xdvi دستورهای ویژهٔ PostScript را در ذره‌بین رندر نمی‌کند. .PP اگر هیچ نام فایلی در خط فرمان مشخص نشده باشد، xdvi تلاش می‌کند آخرین فایل بازشده را باز کند؛ اگر تاریخچهٔ فایل‌ها (قابل دسترسی از طریق منوی .B File > Open Recent ) خالی باشد، یا اگر هیچ‌یک از فایل‌های موجود در تاریخچه فایل‌های DVI معتبری نباشند، یک پنجرهٔ انتخاب فایل برای گزینش نام فایل باز خواهد شد. (در نسخه‌های پیشین که فاقد تاریخچهٔ فایل بودند، پنجرهٔ انتخاب فایل همواره استفاده می‌شد؛ می‌توانید منبع X با نام .B noFileArgUseHistory را برابر با .I false قرار دهید تا رفتار پیشین بازگردد.) .PP .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "گزینه‌ها (OPTIONS)" علاوه بر مشخص کردن فایل .I dvi (با یا بدون پسوند .BR .dvi )، برنامهٔ .B xdvi از گزینه‌های خط فرمان زیر پشتیبانی می‌کند. اگر گزینه‌ای به جای .RB ` \- ' با .RB ` + ' آغاز شود، آن گزینه به مقدار پیش‌فرض خود بازمی‌گردد. به‌طور پیش‌فرض، این گزینه‌ها می‌توانند از طریق نام منابعی که در پرانتز جلوی توضیحات هر گزینه آمده است، تنظیم شوند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI + page اولین صفحه‌ای را که باید نمایش داده شود مشخص می‌کند. اگر .B + بدون شماره داده شود، صفحهٔ آخر در نظر گرفته می‌شود؛ پیش‌فرض، صفحهٔ اول است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-allowshell .RB ( .allowShell ) این گزینه گریز به پوسته (shell escape) را در دستورهای ویژهٔ PostScript فعال می‌کند. (به دلایل امنیتی، گریز به پوسته به‌طور پیش‌فرض غیرفعال است.) این گزینه باید به ندرت استفاده شود؛ به‌ویژه نباید صرفاً برای از حالت فشرده خارج کردن فایل‌ها به کار رود: این کار در صورتی که نام فایل به .BR .Z ، .BR .gz یا .BR .bz2 ختم شود، به‌طور خودکار انجام می‌پذیرد. گریز به پوسته در صورت استفاده از گزینهٔ .B \-safer همواره غیرفعال خواهد بود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-altfont " font" .RB ( .altFont ) یک فونت پیش‌فرض را تعیین می‌کند تا در صورتی که فونت موجود در فایل .I dvi پیدا نشد، از آن استفاده شود. این قابلیت برای مثال با فونت‌های PostScript مفید است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-anchorposition " anchor" پس از باز کردن فایل DVI، به .I anchor پرش می‌کند. این ویژگی تنها زمانی مفید است که .B xdvi از برنامه‌های دیگر فراخوانی شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-background " color" .RB ( .background ) رنگ پس‌زمینه را تعیین می‌کند. مشابه .BR -bg است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-bg " color" .RB ( .background ) رنگ پس‌زمینه را تعیین می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-browser " browser" .RB ( .wwwBrowser ) مرورگر وبی را مشخص می‌کند که برای مدیریت URLهای خارجی استفاده می‌شود. مقدار این گزینه یا منبع دارای ساختار نحوی مشابه متغیر محیطی .B BROWSER است؛ برای شرح تفصیلی، توضیحات آن متغیر را در بخش «محیط (ENVIRONMENT)» در زیر ببینید. اگر نه این گزینه و نه منبع X با نام .I wwwBrowser مشخص نشده باشند، متغیرهای محیطی .B BROWSER و .B WWWBROWSER (به همین ترتیب) برای تعیین دستور مرورگر استفاده می‌شوند. اگر این متغیرها نیز تنظیم نشده باشند، مقدار پیش‌فرض زیر به کار می‌رود: \fBxdg-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\fP .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-copy .RB ( .copy ) هنگام نوشتن نویسه‌ها بر روی صفحهٔ نمایش، همواره از عملیات .I copy استفاده می‌کند. این گزینه ممکن است برای عملکرد درست در یک نمایشگر رنگی ضروری باشد، اما نویسه‌های چندبار چاپ شده (overstrike) نادرست خواهند بود. اگر هموارسازی (anti-aliasing) در مقیاس خاکستری در حال استفاده باشد، عملیات .B \-copy استفاده از صفحه‌های رنگی (colorplanes) را غیرفعال کرده و باعث می‌شود overstrikeها نادرست نمایش یابند. همچنین ببینید: .BR \-thorough . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-cr " color" .RB ( .cursorColor ) رنگ مکان‌نمای موش‌واره را تعیین می‌کند. مقدار پیش‌فرض همان رنگ پیش‌زمینه است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-debug " bitmask|string[,string ...]" .RB ( .debugLevel ) در صورت غیرصفر بودن، اطلاعات تکمیلی را در خروجی استاندارد چاپ می‌کند. آرگومان می‌تواند یک ماسک بیتی مشخص‌شده به‌صورت عدد ده‌دهی، یا فهرستی از رشته‌های جداشده با کاما باشد. .br برای نمایش بر پایهٔ ماسک بیتی، مقادیر چندگانه را می‌توان با جمع‌کردن اعدادی که بیت‌های مجزا را نشان می‌دهند مشخص کرد؛ برای نمونه جهت اشکال‌زدایی تمام دستورهای جستجو و باز کردن فایل، از عدد 4032 (= 2048 + 1024 + 512 + 256 + 128 + 64) استفاده کنید. برای فعال کردن اشکال‌زدایی همه‌چیز از \-1 استفاده کنید (که خروجی بسیار حجیمی تولید خواهد کرد). .br برای نمایش بر پایهٔ رشته، از رشته‌های فهرست‌شده در جدول زیر استفاده کنید، به‌طوری‌که مقادیر با کاما از هم جدا شوند؛ برای نمونه جهت اشکال‌زدایی تمام دستورهای جستجو و باز کردن فایل، از .BR search,expand,paths,hash,stat,open استفاده کنید. (گزینهٔ `kpathsea' به عنوان میان‌بری برای این موارد ارائه شده است.) توجه داشته باشید که ممکن است نیاز باشد چنین فهرستی در نقل‌قول قرار گیرد تا از تفسیر کاماها یا فاصله‌ها توسط پوسته جلوگیری شود. .br اعداد و رشته‌های مجزا دارای معانی زیر هستند: .nf .sp 1n .ta 1L +8L +12L 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 .sp 1n .fi برخی از گزینه‌های اشکال‌زدایی Kpathsea در واقع توسط خود Kpathsea ارائه می‌شوند؛ برای اطلاعات بیشتر دربارهٔ آن‌ها، بخش Debugging را در راهنمای Kpathsea ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .BI \-density " density" .RB ( .densityPercent ) تراکم مورد استفاده هنگام کوچک‌سازی نقشه‌بیتی‌ها (bitmaps) برای فونت‌ها را تعیین می‌کند. مقدار بالاتر فونت روشن‌تری تولید می‌کند. مقدار پیش‌فرض 40 است. اگر مقیاس خاکستری (greyscaling) در حال استفاده باشد، این آرگومان اعمال نمی‌شود؛ به جای آن از .B \-gamma استفاده کنید. همچنین کلید .RB ` S ' را ببینید. معادل .BR \-S است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-display " host" : display میزبان و صفحه‌نمایش مورد استفاده برای نمایش فایل .I dvi را مشخص می‌کند. به‌طور پیش‌فرض این مقدار از متغیر محیطی .SB DISPLAY گرفته می‌شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-dvipspath " path" .RB ( .dvipsPath ) از .I path به عنوان برنامه .B dvips جهت چاپ استفاده می‌کند. مقدار پیش‌فرض برای این گزینه .BR dvips است. برنامه یا اسکریپت باید فایل DVI را از ورودی استاندارد خوانده و فایل PostScript را در خروجی استاندارد بنویسد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-editor " editor" .RB ( .editor ) ویرایشگری را مشخص می‌کند که هنگام فعال شدن کنش .I source-special() جهت آغاز یک جستجوی معکوس (به‌طور پیش‌فرض از طریق Ctrl-Mouse 1) فراخوانی می‌شود. آرگومان این گزینه یک رشته قالب‌بندی است که در آن رخدادهای .RB `` %f '' با نام فایل، رخدادهای .RB `` %l '' با شماره سطر درون فایل، و رخدادهای اختیاری .RB `` %c '' با شماره ستون درون سطر جایگزین می‌شوند. .sp اگر نه این گزینه و نه منبع X مربوط به .I .editor مشخص نشده باشند، متغیرهای محیطی زیر به ترتیب برای تعیین دستور ویرایشگر بررسی می‌شوند: .BR XEDITOR "،" .BR VISUAL و .B EDITOR (با همین ترتیب). اگر رشته به عنوان مقدار متغیرهای محیطی .SB VISUAL یا .SB EDITOR یافت شود، عبارت .RI `` "xterm -e "'' به ابتدای رشته افزوده می‌شود؛ اگر ویرایشگر به روش‌های دیگری مشخص شده باشد، باید به شکل یک دستور پوسته باشد تا پنجره‌ای از X را به همراه ویرایشگری درون آن باز کند. اگر هیچ‌یک از این متغیرها تنظیم نشده باشند، پیامی هشدارآمیز نمایش داده شده و از دستور .RI `` "xterm -e vi +%l %f"'' استفاده می‌شود. .sp اگر هیچ .RB `` %f '' یا .RB `` %l '' در رشته وجود نداشته باشد، رشته‌های قالب‌بندی ناموجود به‌طور خودکار به انتهای آن افزوده می‌شوند. (این امر برای سازگاری با برنامه‌های دیگر هنگام استفاده از یکی از متغیرهای محیطی است). .sp هر بار که این دستور استفاده شود، نمونه جدیدی از ویرایشگر اجرا می‌شود؛ بنابراین ترجیح داده می‌شود از ویرایشگری استفاده شود که بتوان آن را در حالت «کلاینت» فراخوانی کرد تا فایل‌های جدید را در همان نمونه بارگذاری کند. تنظیمات نمونه عبارتند از: .RS 7 .TP 7 .SB emacsclient --no-wait (برای نگارش‌های قدیمی‌تر Emacs) .TP .SB gnuclient -q (برای XEmacs و نگارش‌های جدیدتر Emacs) .TP .SB gvim --servername xdvi --remote (برای VIM نسخه 6.0 به بالا؛ گزینه `--servername xdvi' باعث می‌شود gvim یک نمونه اختصاصی برای فایل‌های باز شده توسط xdvi اجرا کند.) .TP .SB nc (برای nedit) .PP .sp توجه داشته باشید که این رشته‌ها هنگام استفاده در خط فرمان باید درون علامت نقل‌قول قرار گیرند تا از تفسیر توسط پوسته محافظت شوند؛ اما هنگام استفاده از آن‌ها به عنوان آرگومان منبع .I .editor در یک فایل منبع X، نباید از علامت نقل‌قول استفاده شود. .sp .B "نکته امنیتی:" آرگومان این گزینه به عنوان یک دستور پوسته اجرا نمی‌شود، بلکه از طریق .I exec() اجرا می‌گردد تا از ترفندهای مخرب با محتویات source specials جلوگیری شود. .RE .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-expert این گزینه تنها برای سازگاری رو به عقب پشتیبانی می‌شود؛ این گزینه معادل .BR "\-expertmode 0" است که باید در اولویت قرار گیرد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-expertmode " flag" .RB ( .expertMode ) با آرگومان .IR 0 "،" این گزینه نمایش دکمه‌ها، نوارهای پیمایش، نوار ابزار (تنها در Motif)، خط وضعیت و فهرست صفحات را خاموش می‌کند. این عناصر رابط کاربری گرافیکی را می‌توان با ترکیب مقادیر مناسب در آرگومان .I flag به‌طور جداگانه نیز (غیر)فعال کرد. این گزینه رفتاری مشابه با گزینه .B \-debug دارد: عدد صحیح .I flag مانند یک نقشه‌بیت رفتار می‌کند که در آن هر بیت نشان‌دهنده یک عنصر است. اگر مقدار بیت .IR 1 باشد، عنصر روشن است و اگر مقدار آن .IR 0 باشد، عنصر خاموش است. معنای بیت‌ها به شرح زیر است: .nf .sp 1n .ta 1L +8L +12L 1 statusline 2 scrollbars 4 Motif: pagelist, Xaw: buttons and pagelist 8 toolbar (Motif only) 16 menubar (Motif only) .sp 1n .fi برای نمونه، جهت فعال کردن تنها سطر وضعیت و نوارهای پیمایش، از مقدار 3 (= 1 + 2) استفاده کنید. همچنین کلید .RB ` x ' را ببینید که در آن بیت‌ها بر اساس موقعیتشان، به ترتیب از 1 تا 3 (در Xaw) یا 5 (در Motif) نشانه‌گذاری می‌شوند. .PP اگر سطر وضعیت فعال نباشد، تمام پیام‌هایی که معمولاً در سطر وضعیت نمایش داده می‌شدند در .IR stdout چاپ خواهند شد، مگر اینکه گزینه .B \-hushstdout به کار رفته باشد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-fg " color" .RB ( .foreground ) رنگ متن (پیش‌زمینه) را تعیین می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-findstring\fP \fIstring\fP این گزینه جستجویی را برای .I string در فایل DVI ذکر شده در خط فرمان، مشابه با جستجوی مستقیم آغاز می‌کند (توضیحات گزینه .B sourceposition را ببینید): اگر در حال حاضر نمونه دیگری از .B xdvi در حال نمایش آن فایل DVI باشد، باعث می‌شود که آن نمونه به جای این، جستجو را انجام دهد. جستجو از بالای صفحه جاری در فایل DVI آغاز می‌شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-font " font" .RB ( *font ) فونت مورد استفاده در منوها، دکمه‌ها و غیره را مطابق توضیحات صفحه راهنمای .I X(7x) تنظیم می‌کند. فونت پنجره‌های فرزند را می‌توان جداگانه تنظیم کرد، مانند: .RS 7 .nf .ft 3 .sp 1n xdvi*statusline*font: \e -*-helvetica-medium-r-*-*-12-*-*-*-*-*-*-* .sp 1n .ft .fi .RE .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .BI \-foreground " color" همانند .BR -fg . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-fullscreen هنگامی که این گزینه استفاده شود، xdvi (تلاش خواهد کرد تا) در حالت تمام‌صفحه و بدون تزئینات پنجره اجرا شود. تضمینی وجود ندارد که این گزینه با همه مدیر پنجره‌ها/میزکارها کار کند؛ اگر با آن با مشکل مواجه شدید، لطفاً در عوض از گزینه .B \-geometry و تنظیمات مناسب مدیر پنجره برای حذف تزئینات پنجره استفاده کنید. هنگام استفاده از این گزینه برای ارائه‌ها، ممکن است بخواهید تمام ابزارک‌های کنترلی را نیز با استفاده از گزینه .B -expertmode حذف کنید. این گزینه همچنین می‌تواند در زمان اجرا با استفاده از کنش .B fullscreen (که به‌طور پیش‌فرض به Ctrl-l مقید شده است) تغییر وضعیت دهد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-gamma " gamma" .RB ( .gamma ) درونیابی رنگ‌ها در پالت رنگی ضدپلگی (anti-aliasing) در مقیاس خاکستری را کنترل می‌کند. مقدار پیش‌فرض 1.0 است. برای 0 < .I gamma < 1، قلم‌ها روشن‌تر خواهند بود (بیشتر شبیه به پس‌زمینه)، و برای .I gamma > 1، قلم‌ها تیره‌تر خواهند بود (بیشتر شبیه به پیش‌زمینه). مقادیر منفی رفتار مشابهی دارند، اما از الگوریتم متفاوتی استفاده می‌کنند. برای نمایشگرهای رنگی و مقیاس خاکستری؛ برای تک‌رنگ، گزینه .BR \-density را ببینید. همچنین کلید .RB ` S ' را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-geometry " geometry" .RB ( .geometry ) ابعاد و موقعیت اولیه پنجره اصلی را طبق توضیحات صفحه راهنمای .I X(7x) مشخص می‌کند. ابعاد و موقعیت پنجره‌های فرزند می‌تواند جداگانه تعیین شود، مانند: .br .I xdvi*helpwindow.geometry: 600x800 .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-gsalpha .RB ( .gsAlpha ) باعث می‌شود .B Ghostscript به‌جای درایور .B x11 با درایور .B x11alpha فراخوانی شود. درایور .B x11alpha قابلیت anti-aliasing را در ویژگی‌های خاص (specials) PostScript برای ظاهری زیباتر فعال می‌کند. این درایور در نگارش‌های جدیدتر .BR Ghostscript در دسترس است. این گزینه همچنین با کلید .RB ` V ' قابل تغییر وضعیت است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-gspalette " palette" .RB ( .palette ) پالتی را که هنگام استفاده از Ghostscript برای رندر ویژگی‌های خاص PostScript استفاده می‌شود مشخص می‌کند. مقادیر ممکن عبارتند از .BR Color ، .BR Greyscale و .BR Monochrome . پیش‌فرض .BR Color است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR \-h , " \-help" , " \--help" متن راهنمای کوتاهی شامل نمایی کلی از گزینه‌های خط فرمان را در خروجی استاندارد چاپ می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-hl " color" .RB ( .highlight ) رنگ حاشیه صفحه، خط‌کش در «حالت خط‌کش» (`ruler mode`)، و نشانگرهای برجسته‌سازی در جستجوی رو به جلو و جستجوی رشته را تعیین می‌کند. پیش‌فرض رنگ پیش‌زمینه است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-hush .RB ( .Hush ) باعث می‌شود .B xdvi تمام هشدارهای قابل چشم‌پوشی را نادیده بگیرد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-hushbell .RB ( .hushBell ) هنگام رخ دادن خطا، زنگ X به صدا درنمی‌آید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-hushchars .RB ( .hushLostChars ) باعث می‌شود .B xdvi هشدارهای مربوط به ارجاع به نویسه‌هایی که در قلم تعریف نشده‌اند را نادیده بگیرد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-hushchecksums .RB ( .hushChecksums ) باعث می‌شود .B xdvi هشدارهای مربوط به عدم تطابق چکسام بین فایل .I dvi و فایل قلم را نادیده بگیرد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-hushstdout .RB ( .hushStdout ) از چاپ پیام‌های وضعیت در .IR stdout جلوگیری می‌کند. توجه داشته باشید که حتی در صورت استفاده از این گزینه، خطاها یا هشدارها همچنان در .I stderr چاپ خواهند شد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-icongeometry " geometry" .RB ( .iconGeometry ) موقعیت اولیه آیکون را مشخص می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-iconic .RB ( .iconic ) باعث می‌شود پنجره .B xdvi در حالت آیکون‌شده (iconic) آغاز به کار کند. پیش‌فرض این است که پنجره باز شروع به کار کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-install .RB ( .install ) اگر .B xdvi تحت یک نمای بصری .B PseudoColor اجرا شود، آنگاه (به‌طور پیش‌فرض) نماهای بصری .B TrueColor با عمق بیت بر پیکسل بیشتر را بررسی کرده و در صورت وجود، به چنین نمایی تغییر وضعیت می‌دهد. اگر چنین نمایی وجود نداشته باشد، از نما و نقشه رنگی (colormap) فعلی استفاده خواهد کرد. با این حال اگر .B \-install انتخاب شده باشد، همچنان در صورت در دسترس بودن، از نمای .B TrueColor با عمق بیشتر استفاده خواهد کرد؛ در غیر این صورت، نقشه رنگی اختصاصی خود را بر روی نمای فعلی نصب می‌کند. اگر نمای فعلی .BR PseudoColor نباشد، آنگاه .B xdvi صرف‌نظر از گزینه‌هایش، نما یا نقشه رنگی را تغییر نخواهد داد. مقدار پیش‌فرض منبع .B install مقدار ویژه .BR maybe است. گزینه .B +install وجود ندارد. همچنین .BR \-noinstall و بخش GREYSCALING AND COLORMAPS را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-interpreter " filename" .RB ( .interpreter ) از .I filename به عنوان مفسر Ghostscript استفاده می‌کند. به‌طور پیش‌فرض از .BR gs استفاده می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-keep .RB ( .keepPosition ) پرچمی را تنظیم می‌کند که نشان می‌دهد .B xdvi هنگام رفتن به صفحه‌ای جدید نباید به موقعیت مبدا برود. همچنین کلید .RB ` k ' را ببینید. این پرچم توسط تمام کنش‌های تغییر صفحه و توسط .B up-or-previous() / .BR down-or-next() رعایت می‌شود، اگرچه موارد اخیر تنها موقعیت افقی را در نظر می‌گیرند و نه عمودی را. این قابلیت امکان پیمایش «پیوسته» به جلو و عقب را در سندی که پنجره نمایش آن باریک‌تر از پهنای صفحه است فراهم می‌سازد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-l .RB ( .listFonts ) فهرست کردن نام‌های تمام قلم‌های استفاده‌شده. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-license اطلاعات مجوز را چاپ می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .B \-linkcolor .RB ( .linkColor ) رنگ استفاده‌شده برای پیوندهای یکپارچه بازدیدنشده (به‌طور پیش‌فرض `Blue2'). پیوندها پیش از کلیک روی آن‌ها، یا پس از بارگذاری مجدد فایل DVI، بازدیدنشده محسوب می‌شوند. مقدار باید نام معتبر یک رنگ در سامانه پنجره X (مانند .IR DarkGoldenrod4 ) یا یک رشته رنگ هگزادسیمال (مانند .IR #8b6508 ) باشد. همچنین ببینید: .B \-visitedlinkcolor و .BR \-linkstyle . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-linkstyle .RB ( .LinkStyle ) سبک نمایش پیوندها را تعیین می‌کند. مقادیر ممکن و معانی آن‌ها عبارتند از: .nf .sp 1n .ta 1L +8L 0 بدون برجسته‌سازی پیوندها 1 خط زیر پیوندها با \fIرنگ پیوند\fR 2 بدون خط زیرین، رنگ‌آمیزی متن با \fIرنگ پیوند\fR 3 خط زیرین و نمایش متن به \fIرنگ پیوند\fR .sp 1n .fi مقادیر مربوط به \fIرنگ پیوند\fR توسط گزینه‌ها/منابع .B \-linkcolor و .B \-visitedlinkcolor (به آن‌ها مراجعه کنید) مشخص می‌شوند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-margins " dimen" .RB ( .Margin ) اندازه هر دو حاشیه بالایی و حاشیه کناری را مشخص می‌کند. این گزینه موقعیت «آغازین» (home) صفحه در پنجره را به صورت زیر تعیین می‌کند. اگر کل صفحه در پنجره جا شود، تنظیمات حاشیه نادیده گرفته می‌شوند. اگر حتی پس از حذف حاشیه‌ها از چپ، راست، بالا و پایین، صفحه باز هم در پنجره جا نشود، صفحه به گونه‌ای در پنجره قرار می‌گیرد که حاشیه‌های بالا و چپ پنهان شوند، و قاعدتاً گوشه بالا سمت چپ متن صفحه در گوشه بالا سمت چپ پنجره قرار خواهد گرفت. در غیر این صورت، متن در پنجره وسط‌چین می‌شود. اندازه باید یک عدد اعشاری باشد که در صورت تمایل هر یک از اختصارات دوحرفی واحدهای پذیرفته‌شده توسط \*(Te\& .RB ( pt ، .BR pc ، .BR in ، .BR bp ، .BR cm ، .BR mm ، .BR dd ، .BR cc ، یا .BR sp ) به دنبال آن می‌آید. به‌طور پیش‌فرض، واحد .BR cm " (سانتی‌متر)" خواهد بود. همچنین ببینید: .BR \-sidemargin "، " \-topmargin و کلید .RB ` M '. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-mfmode " mode-def" .RB ( .mfMode ) یک رشته .I mode-def را مشخص می‌کند که می‌تواند در جستجوی قلم‌ها به کار رود (بخش «محیط (ENVIRONMENT)» در ادامه را ببینید). به‌طور کلی، هنگام تغییر .IR mode-def ، لازم است اندازه قلم نیز به مقدار مناسب برای آن حالت تغییر داده شود. این کار با افزودن دونقطه و مقدار بر حسب نقطه در اینچ انجام می‌شود؛ برای نمونه: .BR "\-mfmode ljfour:600" . این روش هر مقداری را که توسط منبع .B pixelsPerInch یا آرگومان خط فرمان .B \-p تعیین شده باشد لغو و جایگزین می‌کند. حالت metafont همچنین هنگام ساخت خودکار قلم‌ها به .B metafont ارسال می‌شود. به‌طور پیش‌فرض، مقدار آن .BR "unspecified" (تعیین‌نشده) است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-mgs " size" مشابه .BR \-mgs1 . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-mgs[ n ] " size" .RB ( .magnifierSize\fR[\fIn\fR] ) اندازه پنجره مورد استفاده برای «ذره‌بین» را برای دکمه .IR n مشخص می‌کند. اندازه ممکن است به عنوان یک عدد صحیح داده شود (که نشان می‌دهد ذره‌بین باید مربع باشد)، یا می‌تواند به صورت .IR width x height مشخص شود. بخش «اقدامات موشواره (MOUSE ACTIONS)» را ببینید. مقادیر پیش‌فرض عبارتند از: 200x150، 400x250، 700x500، 1000x800 و 1200x1200. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-mousemode " " [ 0 | 1 | 2 ] .RB ( .mouseMode ) حالت پیش‌فرض xdvi را هنگام راه‌اندازی مشخص می‌کند: ذره‌بین (0)، حالت گزینش متن (1) یا حالت خط‌کش (2). برای اطلاعات بیشتر بخش .BR MODES در زیر را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-nocolor .RB ( .color ) استفاده از مشخصه‌های ویژه رنگ (color specials) را غیرفعال می‌کند. این گزینه را می‌توان با فشردن کلید .RB ` C ' تغییر وضعیت داد (فعال/غیرفعال کرد). (توجه: .B \-nocolor معادل .BR color:off و .B +nocolor معادل .BR color:on است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-nofork .RB ( .fork ) در صورت استفاده از گزینه‌های .B \-sourceposition و .BR \-unique ، رفتار پیش‌فرض .B xdvi این است که اگر نمونه مناسبی از .B xdvi از قبل در حال اجرا نباشد، خود را به پس‌زمینه بفرستد (مانند یک دیمن). این آرگومان باعث می‌شود که در عوض در پیش‌زمینه اجرا شود. این قابلیت برای اشکال‌زدایی مفید است، یا زمانی که برنامه کلاینت شما نتواند با برنامه‌ای که بدین شکل خود را به پس‌زمینه می‌برد به‌خوبی تعامل کند -- برای نمونه، مشخص شده که توابع IPC در .B emacs با این موضوع مشکل دارند. اگر هیچ آرگومان .B \-sourceposition یا .B \-unique داده نشود، این گزینه هیچ اثری ندارد. (توجه: .B \-nofork معادل .BR fork:off و .B +nofork معادل .BR fork:on است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-noghostscript .RB ( .ghostscript ) از استفاده از Ghostscript برای نمایش مشخصه‌های ویژه PostScript جلوگیری می‌کند. (توجه: .B \-noghostscript معادل .BR ghostscript:off و .B +noghostscript معادل .BR ghostscript:on است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-nogrey .RB ( .grey ) استفاده از هموارسازی (anti-aliasing) با طیف خاکستری را هنگام چاپ بیت‌مپ‌های کوچک‌شده غیرفعال می‌کند. (توجه: .B \-nogrey معادل .BR grey:off و .B +nogrey معادل .BR grey:on است.) همچنین کلید .RB ` G ' را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-nogssafer .RB ( .gsSafer ) به‌طور معمول، اگر از Ghostscript برای پردازش مشخصه‌های ویژه PostScript استفاده شود، مفسر Ghostscript با گزینه .BR \-dSAFER اجرا می‌شود. گزینه .B \-nogssafer برنامه Ghostscript را بدون .BR \-dSAFER اجرا می‌کند. گزینه .B \-dSAFER در Ghostscript عملگرهای PostScript مانند .BR deletefile را غیرفعال می‌سازد تا از اثرگذاری برنامه‌های مخرب احتمالی PostScript جلوگیری کند. اگر گزینه .B \-safer مشخص شده باشد، این گزینه هیچ اثری نخواهد داشت؛ در آن حالت Ghostscript همواره با .BR \-dSAFER اجرا می‌شود. (توجه: .B \-nogssafer معادل .BR gsSafer:off و .B +nogssafer معادل .BR gsSafer:on است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .B \-noinstall .RB ( .install ) جلوگیری از رفتار پیش‌فرضِ جابجایی به یک نمای .B TrueColor در صورتی که نمایی با تعداد بیت بر پیکسلِ بیشتری نسبت به نمای فعلی در دسترس باشد. (نکته: \-noinstall معادل .BR install:off است؛ گزینه‌ای به نام .B +noinstall وجود ندارد.) همچنین ببینید: .BR \-install و بخش GREYSCALING AND COLORMAPS. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-nomakepk .RB ( .makePk ) تولید خودکار فایل‌های فونتی را که از روش‌های دیگر یافت نمی‌شوند، غیرفعال می‌کند. (نکته: .B \-nomakepk معادل .BR makePk:off و .B +nomakepk معادل .BR makePK:on است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-nomatchinverted .RB ( .matchInverted ) تطابق‌های جستجوی رشته را با رنگ معکوس برجسته نمی‌کند؛ در عوض، مستطیلی با رنگ .I highlight (گزینهٔ .B \-hl را ببینید) دور مورد منطبق رسم می‌کند. این گزینه در صورتی که نمایشگر در حالت TrueColor اجرا نشود، به طور خودکار فعال می‌شود. (نکته: .B \-nomatchinverted معادل .BR matchInverted:off و .B +nomatchinverted معادل .BR matchInverted:on است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-noomega .RB ( .omega ) این گزینه استفاده از افزونه‌های Omega را هنگام تفسیر فایل‌های DVI غیرفعال می‌کند. به طور پیش‌فرض، کدهای دستور (opcodes) اضافی .I 129 و .I 134 توسط xdvi به عنوان افزونه‌های Omega شناخته شده و به عنوان درخواست‌هایی برای حروف‌چینی نویسه‌های ۲\-بایتی تفسیر می‌شوند. تنها عیب این کار آن است که آرایهٔ فونت مجازی به جای ۲۵۶ موقعیت پیش‌فرض، به ۶۵۵۳۶ موقعیت نیاز خواهد داشت؛ یعنی نیازمندی‌های حافظهٔ xdvi اندکی بیشتر خواهد بود. اگر این موضوع برایتان غیرقابل قبول است یا با مشکل دیگری در افزونه‌های Omega مواجه شدید، می‌توانید با استفاده از .B \-noomega این افزونه را غیرفعال کنید (اما لطفاً در صورت مشاهدهٔ چنین مشکلاتی یک گزارش باگ ارسال نمایید \- نشانی گزارش باگ را در بخش .B AUTHORS در زیر ببینید). .br (نکته: .B \-noomega معادل .BR "omega: off" و .B +noomega معادل .BR "omega: on" است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-noscan .RB ( .prescan ) به طور پیش‌فرض، .B xdvi یک اسکن مقدماتی روی فایل .I dvi انجام می‌دهد تا دستورات ویژهٔ (specials) .B papersize را پردازش کند؛ این امر به ویژه هنگام راه‌اندازی بسیار حائز اهمیت است زیرا ممکن است اندازهٔ کاغذ برای تعیین اندازهٔ پنجره مورد نیاز باشد. اگر PostScript در حال استفاده باشد، پیش‌اسکن (prescanning) برای پردازش صحیح فایل‌های سرایند (header) نیز ضروری است. علاوه بر این، پیش‌اسکن برای تعیین صحیح رنگ پس‌زمینهٔ صفحه لازم است. این گزینه چنین پیش‌اسکنی را غیرفعال می‌کند. (در صورتی که .B xdvi هر یک از دستورات ویژهٔ ذکرشده در بالا را شناسایی کند، پیش‌اسکن به طور خودکار مجدداً فعال خواهد شد.) (نکته: .B \-noscan معادل .BR prescan:off و .B +noscan معادل .BR prescan:on است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-notempfile .RB ( .tempFile ) همان‌طور که در بخش .B DESCRIPTION در بالا ذکر شد، xdvi یک نسخهٔ موقت از فایل DVI ایجاد می‌کند تا حتی در حین بازنویسی فایل توسط .BR TeX ، دسترسی به آن بدون وقفه امکان‌پذیر باشد. از آنجا که این کار در هر بار تغییر فایل، سربار کپی کردن را ایجاد می‌کند، گزینهٔ .B \-notempfile به شما امکان می‌دهد این رفتار را غیرفعال کنید. در این حالت، نمایان شدن (expose) بخش‌هایی از پنجره در حالی که فایل DVI توسط \*(Te\& بازنویسی می‌شود، محتویات فعلی پنجره را تا زمانی که فایل DVI بتواند مجدداً به طور کامل خوانده شود، پاک خواهد کرد. .br (نکته: .B \-notempfile معادل .BR tempFile:off و .B +notempfile معادل .BR tempFile:on است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-notype1fonts .RB ( .type1 ) این گزینه استفاده از کتابخانهٔ FreeType را برای نمایش فونت‌های PostScript Type 1 غیرفعال می‌کند. هنگام مواجهه با مشکل در نمایش فونت‌های Type 1، از این گزینه به عنوان یک راه‌حل موقت (workaround) استفاده کنید (اما لطفاً در این صورت، ارسال گزارش باگ به نشانی اینترنتی ذکرشده در بخش AUTHORS در زیر را فراموش نکنید). .br (نکته: .B \-notype1fonts معادل .BR type1:off و .B +notype1fonts معادل .BR type1:on است.) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-offsets " dimen" .RB ( .Offset ) اندازهٔ آفست‌های افقی و عمودی خروجی را روی صفحه مشخص می‌کند. طبق مصوبهٔ پروژهٔ استانفورد \*(Te\&، مبدأ پیش‌فرض صفحه در \*(Te\& همواره ۱ اینچ به سمت راست و ۱ اینچ به سمت پایین از گوشهٔ بالا-چپ صفحه است، حتی زمانی که اندازه‌های کاغذ غیرآمریکایی استفاده شوند. بنابراین، آفست‌های پیش‌فرض ۱٫۰ اینچ هستند. آرگومان .I dimen باید یک عدد اعشاری باشد که در صورت تمایل هر یک از اختصارات دو حرفیِ واحدهای پذیرفته‌شده توسط \*(Te\& می‌تواند در ادامهٔ آن بیاید .RB ( pt ، .BR pc ، .BR in ، .BR bp ، .BR cm ، .BR mm ، .BR dd ، .BR cc ، یا .BR sp ). به طور پیش‌فرض، واحد .BR cm " (سانتی‌متر)" خواهد بود. همچنین ببینید: .B \-xoffset و .BR \-yoffset . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-p " pixels" .RB ( .pixelsPerInch ) اندازهٔ فونت‌های مورد استفاده را بر حسب پیکسل بر اینچ مشخص می‌کند. مقدار پیش‌فرض ۶۰۰ است. این گزینه صرفاً برای سازگاری با نسخه‌های قبلی ارائه شده است؛ روش ارجح این است که هم تفکیک‌پذیری و هم حالت Metafont را از طریق گزینهٔ .B \-mfmode تنظیم کنید (به آن مراجعه کنید). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-paper " papertype" .RB ( .paper ) اندازهٔ صفحهٔ چاپ را مشخص می‌کند. توجه داشته باشید که در بیشتر موارد بهتر است اندازهٔ کاغذ در فایل ورودی TeX از طریق خطِ .sp .B \eusepackage[dvips]{geometry} .sp مشخص شود که هم توسط dvips و هم xdvi شناخته خواهد شد؛ در این صورت استفاده از گزینهٔ «\-paper» غیرضروری خواهد بود. .br اندازهٔ کاغذ می‌تواند به شکل \fIwidth\fBx\fIheight\fR همراه با یک واحد اختیاری مشخص شود، به طوری که .I width و .I height اعدادی اعشاری برای تعیین عرض و ارتفاع کاغذ هستند، و واحد نیز هر یک از اختصارات دو حرفیِ واحدهای پذیرفته‌شده توسط \*(Te\& است .RB ( pt ، .BR pc ، .BR in ، .BR bp ، .BR cm ، .BR mm ، .BR dd ، .BR cc ، یا .BR sp ). به طور پیش‌فرض، واحد .BR cm " (سانتی‌متر)"\fR است. .br مترادف‌هایی نیز وجود دارند که می‌توان از آن‌ها استفاده کرد: .B us (8.5x11in)، .B legal (8.5x14in)، .B foolscap (13.5x17in)، و همچنین اندازه‌های ISO شامل .BR a1 \- a7 ، .BR b1 \- b7 ، .BR c1 \- c7 . هر یک از این‌ها یک حالت افقی (landscape) یا «چرخانده‌شده» نیز دارند: .B usr (11x8.5in)، .BR a1r \- a7r و غیره. برای سازگاری با .BR dvips ، قالب‌های .B letter (8.5x11in)، .B ledger (17x11in) و .B tabloid (11x17in) نیز پشتیبانی می‌شوند (این موارد گونه‌های چرخانده‌شده ندارند). .br پیش از هر یک از اندازه‌های فوق می‌توان علامت مثبت .RB (` + ') قرار داد؛ این کار باعث می‌شود اندازهٔ کاغذی که در اینجا مشخص شده، بر هر اندازهٔ کاغذی که در فایل .I dvi آمده اولویت یابد و جایگزین آن شود. اندازهٔ پیش‌فرض کاغذ 21 x 29.7 cm (اندازهٔ A4) است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .B \-pause .RB ( .pause ) این گزینه یک پیاده‌سازی ساده از نمایش افزایشی (گام‌به‌گام) را ارائه می‌دهد که می‌تواند برای ارائه‌ها استفاده شود. هنگامی که این گزینه به کار رود، .B xdvi هرگاه با یک .I special-string ویژه مواجه شود (به‌طور پیش‌فرض .RI xdvi:pause ؛ این رشته می‌تواند از طریق .IR \-pausespecial سفارشی‌سازی شود، زیر را ببینید)، نمایش صفحهٔ کنونی را متوقف کرده و مکان‌نما شکل خود را تغییر می‌دهد. عمل .B unpause-or-next() (که به‌طور پیش‌فرض به کلید .B Space اختصاص یافته است) بخش بعدی صفحه را تا .IR special-string بعدی، یا تا رسیدن به انتهای صفحه نمایش خواهد داد. هنگامی که از این گزینه استفاده نشود، دستورهای ویژهٔ حاوی .I special-string نادیده گرفته خواهند شد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-pausespecial " special-string" .RB ( .pauseSpecial ) رشتهٔ ویژه‌ای را تعیین می‌کند که باعث توقف xdvi در هنگام فعال بودن گزینهٔ .I -pause می‌شود. مقدار پیش‌فرض .I special-string برابر با .IR xdvi:pause است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-postscript " flag" .RB ( .postscript ) اگر .I flag = 0 باشد، رندر دستورهای ویژهٔ PostScript غیرفعال می‌شود؛ در عوض، جعبه‌های احاطه‌کننده (در صورت وجود) نمایش داده خواهند شد. مقدار .I 1 (پیش‌فرض) دستورهای ویژهٔ PostScript را فعال می‌کند. با مقدار .IR 2 ، دستورهای ویژهٔ PostScript همراه با جعبه‌های احاطه‌کننده‌شان نمایش داده می‌شوند؛ این به شما اجازه می‌دهد تا درستی جعبه‌های احاطه‌کننده را به‌صورت بصری بررسی کنید. این مقادیر همچنین می‌توانند در زمان اجرا با کلید .RB ` v ' و آرگومان‌های عددی پیشوند متناظر 0، 1 و 2 تغییر وضعیت داده شوند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-ps2pdfpath " path" .RB ( .ps2pdfPath ) از .I path به عنوان برنامهٔ تبدیل PostScript به PDF استفاده می‌کند. این برنامه یا اسکریپت باید دو آرگومان خط فرمانی را بپذیرد: فایل PostScript به عنوان آرگومان اول، و فایل خروجی PDF به عنوان آرگومان دوم. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-rulecolor " color" .RB ( .ruleColor ) رنگ خطوط مورد استفاده برای ذره‌بین را مشخص می‌کند (پیش‌فرض: رنگ پیش‌زمینه). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-q .RB ( .noInitFile ) فایل راه‌اندازی .I $HOME/.xdvirc را نادیده می‌گیرد (یعنی در هنگام راه‌اندازی خوانده نشود و در زمان خروج نوشته نشود). این کار باعث می‌شود مقادیر پیش‌فرض تعریف‌شده در .I $HOME/.Xdefaults استفاده شوند. برای اطلاعات بیشتر در مورد .IR $HOME/.xdvirc ، بخش .B FILES را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-rv .RB ( .reverseVideo ) باعث می‌شود صفحه به جای حالت عادی، با نویسه‌های سفید در پس‌زمینهٔ سیاه نمایش داده شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-S " density" .RB ( .densityPercent ) مشابه .B \-density (که به آن ارجاع داده می‌شود). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-s " shrink" .RB ( .shrinkFactor ) ضریب کوچک‌نمایی اولیه را مشخص می‌کند. مقدار پیش‌فرض 8 است. اگر .I shrink برابر با 0 داده شود، ضریب کوچک‌نمایی اولیه طوری محاسبه می‌شود که صفحه درون پنجره بگنجد (مانند زمانی که کلید `s' بدون عدد فشرده شود). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-safer .RB ( .safer ) این گزینه تمام گزینه‌های امنیتی موجود را فعال می‌کند؛ این گزینه برای استفاده در زمانی طراحی شده است که .B xdvi توسط یک مرورگر فراخوانی شود که فایل .I dvi یا \*(Te\& را از سایتی دیگر دریافت می‌کند. این گزینه .B +nogssafer و .BR +allowshell را انتخاب می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-sidemargin " dimen" .RB ( .sideMargin ) حاشیهٔ کناری را مشخص می‌کند (نگاه کنید به .BR \-margins ). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-sourceposition " line" [: col "][ ]" filename این گزینه باعث می‌شود .B xdvi در فایل .I dvi به دنبال مکانی بگردد که متناظر با سطر (و در صورت تمایل، ستون) مشخص‌شده در فایل منبع .tex باشد، و مکان یافته‌شده را با کشیدن یک مستطیل به رنگ .I highlight (گزینهٔ .B \-hl را ببینید) دور متن متناظر برجسته کند. علاوه بر این، در صورت اجرا با این آرگومان (و زمانی که گزینهٔ .B \-nofork داده نشده باشد، که به آن ارجاع داده می‌شود)، .B xdvi همیشه بلافاصله بازمی‌گردد: اگر نمونهٔ دیگری از .B xdvi را بیابد که از قبل در حال نمایش .I dvi_file است، باعث می‌شود آن نمونه پنجرهٔ خود را بالا بیاورد و به مکان داده‌شده در فایل .I dvi برود؛ در غیر این صورت نمونهٔ خود را در پس‌زمینه اجرا خواهد کرد. اگر چندین نمونه از xdvi در حال نمایش فایل .I dvi مربوطه باشند، نمونه‌ای که اخیراً به پیش‌زمینه آورده شده است استفاده خواهد شد. .sp فاصلهٔ قبل از .I filename تنها زمانی نیاز است که نام فایل با یک رقم شروع شود. هنگامی که از فاصله استفاده شود، باید آرگومان در نشانه‌های نقل‌قول قرار گیرد تا شل این فاصله را به عنوان جداکنندهٔ آرگومان تفسیر نکند. .sp این گزینه نیازمند آن است که .I dvi_file با اطلاعات دستورهای ویژهٔ منبع (source specials) آماده شده باشد. برای جزئیات در مورد نحوهٔ انجام این کار، بخش SOURCE SPECIALS را ببینید. .sp در اینجا شرح دقیق‌تری از چگونگی مطابقت دادن نام فایل در آرگومان .I \-sourceposition با نام فایل در دستورهای ویژهٔ منبع آمده است: .RS 7 .TP 3 1. اگر هیچ‌کدام از نام فایل‌ها شامل مؤلفهٔ مسیر نباشد، نام فایل‌ها بدون در نظر گرفتن پسوند .RI ` .tex ' در هر دو نام فایل با یکدیگر مقایسه می‌شوند. .TP 2. در غیر این صورت، اگر یکی از نام فایل‌ها حاوی مؤلفهٔ مسیر باشد (برای مثال: .IR ./test.tex ، .IR ../test.tex ، .I /my/homedir/tex/test.tex یا هر ترکیبی از این‌ها)، هر دو نام فایل به یک مسیر کامل بسط می‌یابند، به طوری که هرگونه وقوع .I ../ و .I ./ بسط یافته و اسلش‌های تکراری حذف می‌شوند. .br نام مسیر در .I \-sourceposition نسبت به پوشهٔ کاری فعلی فراخوانی .I xdvi \-sourceposition بسط می‌یابد، و نام مسیرها در دستورهای ویژهٔ منبع نسبت به مسیر فایل DVI فعلیِ در حال نمایش بسط داده می‌شوند. .br سپس نام مسیرها بدون در نظر گرفتن پسوند .RI ` .tex ' در هر دو نام مسیر با یکدیگر مقایسه می‌شوند. .RE .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-statusline\fP .RB ( .statusline ) این گزینه منسوخ شده است؛ در عوض از \fB\-expertmode \fP \fIflag\fP استفاده کنید (که به آن ارجاع داده می‌شود). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .BI \-text-encoding " encoding" .RB ( .textEncoding ) از .I encoding به‌عنوان کدگذاری متن رشته در پنجره‌ی «Find» استفاده می‌کند. معمولاً به این گزینه نیازی نیست، زیرا کدگذاری از روی تنظیمات محلی (locale) تعیین می‌شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-thorough .RB ( .thorough ) برنامهٔ .B Xdvi معمولاً تلاش می‌کند اطمینان حاصل کند که نویسه‌های روی‌هم‌افتاده (مانند .BR \enotin ) به‌درستی چاپ می‌شوند. در نمایشگرهای تک‌رنگ، این کار همیشه با یک عملیات منطقی، یعنی .I and یا .IR or امکان‌پذیر است. با این حال، در نمایشگرهای رنگی ممکن است این کار به دو عملیات نیاز داشته باشد؛ یکی برای تنظیم بیت‌های مناسب و دیگری برای پاک کردن بیت‌های دیگر. در این حالت، به‌طور پیش‌فرض .B xdvi در عوض از عملیات .I copy استفاده می‌کند که نویسه‌های روی‌هم‌افتاده را به‌درستی مدیریت نمی‌کند. گزینهٔ .B \-thorough روش کُندتر اما دقیق‌تر را انتخاب می‌کند. همچنین ببینید: .BR \-copy . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-topmargin " dimen" .RB ( .topMargin ) حاشیه‌های بالا و پایین را مشخص می‌کند (ببینید: .BR \-margins ). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-unique .RB ( .unique ) این گزینه باعث می‌شود نمونهٔ دیگری از xdvi که روی همان نمایشگر (display) اجرا می‌شود، به‌عنوان یک «کارساز» عمل کند. برای مثال، فراخوانی .sp .B xdvi -unique +5 file.dvi .sp باعث می‌شود آن نمونهٔ دیگر، .I file.dvi را در صفحهٔ ۵ به جای فایلی که هم‌اکنون نمایش می‌دهد بارگذاری کند. اگر نمونهٔ دیگری از xdvi از پیش در حال نمایش فایل .IR file.dvi باشد، تنها به صفحهٔ ۵ خواهد رفت. اگر نمونهٔ دیگر xdvi در حال نمایش فایل متفاوتی باشد، در عوض .I file.dvi را بارگذاری می‌کند. در غیر این صورت، اگر در حال حاضر هیچ نمونهٔ دیگری از xdvi روی نمایشگر اجرا نمی‌شود، این گزینه نمونهٔ جدیدی از xdvi را در پس‌زمینه اجرا کرده (مگر اینکه گزینهٔ .I \-nofork مشخص شده باشد، که به آن ارجاع داده می‌شود) و صفحهٔ ۵ از .IR file.dvi را نمایش می‌دهد. .br نام فایل و گزینهٔ .B +n برای شمارهٔ صفحه، تنها گزینه‌های موجود برای کنترل یک نمونهٔ دوردست xdvi به این شیوه هستند؛ همهٔ گزینه‌های دیگر در حال حاضر نادیده گرفته می‌شوند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-useTeXpages از صفحه‌های منطقی \*(Te\& (مقادیر ثباتِ .IR \ecount0 ) به‌جای صفحه‌های فیزیکی برای برچسب‌های فهرست صفحات و هنگام پرش به یک صفحه در سند با کلید «g» (یا کُنشِ .BR goto-page() ) استفاده می‌کند. این گزینه را می‌توان با فشردن کلید .RB ` T ' تغییر وضعیت داد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-version اطلاعات نسخهٔ .B xdvi را چاپ می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-visitedlinkcolor .RB ( .visitedLinkColor ) رنگ مورد استفاده برای پیوندهای دیده‌شده (به‌طور پیش‌فرض «Purple4»). پیوندها پس از کلیک روی آن‌ها، به وضعیت دیده‌شده درمی‌آیند. مانند .BR linkColor ، مقدار باید یک نام رنگ معتبر در X یا یک رشتهٔ رنگی هگزادسیمال باشد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B \-warnspecials .RB ( .warnSpecials ) باعث می‌شود .B xdvi هشدارهایی دربارهٔ رشته‌های .B \especial که قادر به پردازش آن‌ها نیست را در stderr چاپ کند. این هشدارها به‌طور پیش‌فرض سرکوب شده‌اند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-watchfile " n" .RB ( .watchFile ) اگر این گزینه روی مقداری بزرگ‌تر از 0 تنظیم شود، xdvi هر .I n ثانیه تغییرات فایل DVI را بررسی خواهد کرد. اگر نوشتن فایل DVI توسط TeX به‌طور کامل به پایان رسیده باشد، به‌صورت خودکار مجدداً بارگذاری می‌شود. مقادیر اعشاری (مانند «2.5») نیز امکان‌پذیرند. مقدار پیش‌فرض این گزینه 0 است، یعنی بدون پایش. .br از آنجا که xdvi نمی‌تواند فایل‌های DVI ناقص را مدیریت کند، تلاش می‌کند تا زمانی که فایل در حال بازنویسی است، آن را مجدداً بارگذاری نکند. با این وجود، استفاده از ذره‌بین یا تغییر صفحات نیازمند خواندن (بخشی از) فایل DVI است، و اگر گزینهٔ .B tempfile غیرفعال باشد، این کار محتویات کنونی پنجره را تا زمانی که فایل DVI بتواند به‌طور کامل خوانده شود پاک خواهد کرد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-wheelunit " pixels" .RB ( .wheelUnit ) تعداد پیکسل‌هایی را تعیین می‌کند که با یک حرکت چرخ ماوس، تصویر به بالا، پایین، چپ یا راست جابه‌جا می‌شود. (برای اطلاعات بیشتر در این مورد، کُنش‌های .B wheel و .B hwheel را در زیر ببینید.) اگر روی صفر تنظیم شود، قابلیت چرخ ماوس (اساساً) غیرفعال می‌شود. مقدار پیش‌فرض 80 است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-xoffset " dimen" .RB ( .xOffset ) میزان انحراف افقی خروجی روی صفحه را مشخص می‌کند. ببینید: .BR \-offsets . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BI \-yoffset " dimen" .RB ( .yOffset ) میزان انحراف عمودی خروجی روی صفحه را مشخص می‌کند. ببینید: .BR -offsets . .PP.SH "کلیدها (KEYSTROKES)" .B Xdvi هنگامی که کلیدهای زیر در پنجره‌اش فشرده شوند، آن‌ها را تشخیص می‌دهد. هر کدام می‌توانند به‌طور اختیاری با یک عدد (مثبت یا منفی) همراه شوند؛ یک «آرگومان پیشوند» که تفسیر آن به کلید مربوطه بستگی خواهد داشت. این آرگومان پیشوند را می‌توان با فشردن کلید «Escape» لغو کرد. در صورت وجود، کلیدهای «Help»، «Prior» و «Next» به‌ترتیب مترادف‌هایی برای کلیدهای .RB ` ? '، .RB ` b ' و .RB ` f ' هستند. .PP ترکیب‌های کلیدی فهرست‌شده در اینجا مواردی هستند که .B xdvi به‌طور پیش‌فرض اختصاص می‌دهد. نام‌هایی که در براکت‌ها در ابتدای توضیحات آمده‌اند، نام کنش‌های مرتبط با کلیدها هستند؛ از این نام‌ها می‌توان برای سفارشی‌سازی ترکیب‌های کلیدی استفاده کرد، همان‌طور که در بخش .B CUSTOMIZATION در زیر با جزئیات بیشتر توضیح داده شده است. اگر فقط یک ترکیب با حروف کوچک فهرست شده باشد، هر دو کلید با حروف کوچک و بزرگ برای آن ترکیب کار خواهند کرد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" .\" SPECIAL KEYS / کلیدهای ویژه .\" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR ESC " (کلید)" .RB [ discard-number() ] کلید Escape پیشوند عددی را برای تمام کنش‌ها کنار می‌گذارد (زمانی که عددی را اشتباه تایپ کرده‌اید کاربردی است). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR Return " (کلید)" .RB [ forward-page() ] به صفحهٔ بعدی (یا در صورت ارائهٔ عدد، به .IR n \-اُمین صفحهٔ بعدی) می‌رود. مترادف‌های آن .RB ` n '، .RB ` f ' و Line Feed هستند. .TP .BR Backspace " (کلید)" .RB [ back-page() ] به صفحهٔ قبلی (یا .I n صفحه به عقب) می‌رود. مترادف‌های آن .RB ` p '، .RB ` b ' و .BR Ctrl-h هستند. .TP .BR Delete " (کلید)" .RB [ up-or-previous() ] به اندازهٔ دو سوم ظرفیت پنجره به بالا می‌رود، یا در صورتی که از پیش در بالای صفحه باشد، به بالای صفحهٔ قبلی می‌رود. با یک آرگومان اعشاری، به اندازهٔ کسر متناظر از یک پنجره به بالا حرکت می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR Space " (کلید)" .RB [ unpause-or-next() ] به اندازهٔ دو سوم ظرفیت پنجره به پایین می‌رود، یا اگر از پیش در پایین صفحه باشد، به صفحهٔ بعدی می‌رود. .br هنگامی که گزینهٔ .BI \-pause " special-string" استفاده شده باشد و نمایش در حال حاضر متوقف شده باشد، این کلید در عوض بخش بعدی صفحه را تا رسیدن به .I special-string بعدی یا انتهای صفحه نمایش می‌دهد. برای جزئیات به شرح گزینهٔ .B \-pause مراجعه کنید. کنش .RB [ down-or-next() ] کار مشابهی انجام می‌دهد، اما بدون توقف؛ این کنش به‌طور پیش‌فرض به هیچ کلیدی اختصاص نیافته است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR Ctrl-Home " (Xaw)، " Ctrl-osfBeginLine " (Motif)" .RB [ goto-page(1) ] به اولین صفحهٔ سند می‌رود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR Ctrl-End " (Xaw)، " Ctrl-osfEndLine " (Motif)" .RB [ goto-page() ] به آخرین صفحهٔ سند می‌رود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR Home " (Xaw)، " osfBeginLine " (Motif)" .RB [ home-or-top() ] به موقعیت «home» صفحه می‌رود، یا در صورتی که پرچم .I keep تنظیم شده باشد، به بالای صفحه می‌رود (در این حالت، صفحه به‌صورت افقی پیمایش نمی‌شود). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .BR End " (Xaw)، " osfEndLine " (Motif)" .RB [ end-or-bottom() ] به موقعیت «end» صفحه (گوشهٔ پایین سمت راست) می‌رود، یا اگر پرچم .I keep تنظیم شده باشد، به پایین صفحه می‌رود (در این حالت، صفحه به‌صورت افقی پیمایش نمی‌شود). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" .\" ARROW KEYS / کلیدهای جهت‌نما .\" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B کلید جهت‌نمای پایین (Down arrow) .RB [ down(0.015) ] صفحه را به پایین پیمایش می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B کلید جهت‌نمای بالا (Up arrow) .RB [ up(0.015) ] صفحه را به بالا پیمایش می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B کلید جهت‌نمای راست (Right arrow) .RB [ right(0.015) ] صفحه را به راست پیمایش می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B کلید جهت‌نمای چپ (Left arrow) .RB [ left(0.015) ] صفحه را به چپ پیمایش می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" .\" ORDINARY KEYS. Note that the special symbols ([ ] + - etc.) are not in .\" strict ASCII order (found that more intuitive). Sequence for each letter .\" is: Alt-Ctrl, Ctrl, uppercase, lowercase. .\" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Alt-Ctrl-+ .RB [ change-density(25) ] تیرگی قلم‌ها در پنجرهٔ DVI را با افزودن به مقدار گاما افزایش می‌دهد (همچنین کلید .RB ` S ' را ببینید). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Alt-Ctrl-- .RB [ change-density(-25) ] تیرگی قلم‌ها در پنجرهٔ DVI را با کاستن از مقدار گاما کاهش می‌دهد (همچنین کلید .RB ` S ' را ببینید). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-+ .RB [ set-shrink-factor(+) ] ضریب کوچک‌نمایی را افزایش می‌دهد (همچنین کلید .RB ` s ' را ببینید). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-- .RB [ set-shrink-factor(-) ] ضریب کوچک‌نمایی را کاهش می‌دهد (همچنین کلید .RB ` s ' را ببینید). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctr-[ .RB [ pagehistory-delete-backward() ] مورد فعلی در تاریخچهٔ صفحه را حذف می‌کند و به موردِ تاریخچه پیش از مورد حذف‌شده می‌رود. با یک آرگومان پیشوند .BR n ، تعداد .B n مورد قبلی در تاریخچه را حذف می‌کند. برای جزئیات به .B PAGE HISTORY مراجعه کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B [ .RB [ pagehistory-back() ] در تاریخچهٔ صفحه به عقب بازمی‌گردد (برای جزئیات به .B PAGE HISTORY مراجعه کنید). با یک آرگومان پیشوند .BR n ، به اندازهٔ .B n مورد در تاریخچه به عقب می‌رود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctr-] .RB [ pagehistory-delete-forward() ] مورد فعلی در تاریخچهٔ صفحه را حذف می‌کند و به موردِ تاریخچه پس از مورد حذف‌شده می‌رود. با یک آرگومان پیشوند .BR n ، تعداد .B n مورد بعدی در تاریخچه را حذف می‌کند. برای جزئیات به .B PAGE HISTORY مراجعه کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .B ] .RB [ pagehistory-forward() ] حرکت به جلو در تاریخچه صفحات (برای جزئیات به .B PAGE HISTORY مراجعه کنید). با یک آرگومان پیشوندی .BR n ، به اندازه .B n مورد در تاریخچه به جلو حرکت می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B ^ .RB [ home() ] انتقال به موقعیت «آغازین» (home) صفحه. این موقعیت معمولاً گوشه بالا سمت چپ صفحه است، که بسته به حاشیه‌های شرح‌داده‌شده در گزینه .B \-margins در بالا، تغییر می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B ? .RB [ help() ] مشابه کلید .B h (که توضیح آن در ادامه آمده است). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B B .RB [ htex-back() ] این کلید به لنگرگاه پیوند یکتای قبلی بازمی‌گردد. برای اطلاعات بیشتر در مورد پیمایش پیوندها به بخش .B HYPERLINKS مراجعه کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B b .RB [ back-page() ] رفتن به صفحه قبلی (یا بازگشت به اندازه .I n صفحه). کلیدهای مترادف عبارتند از .RB ` p '، .B Ctrl-h و .BR Backspace . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B C .RB [ set-color() ] این کلید استفاده از دستورات ویژه رنگ (color specials) را تغییر وضعیت می‌دهد. دنباله‌های کلیدی .RB ` 0C ' و .RB ` 1C ' به ترتیب تفسیر دستورات ویژه رنگ را غیرفعال و فعال می‌کنند. همچنین گزینه .B \-nocolor را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B c .RB [ center() ] صفحه را طوری جابه‌جا می‌کند که نقطه زیر مکان‌نمای ماوس به وسط پنجره منتقل شود، و مکان‌نمای ماوس را نیز به همان نقطه منتقل می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B D .RB [ toggle-grid-mode() ] این کلید استفاده از شبکه (grid) را روی صفحه نمایش داده‌شده تغییر وضعیت می‌دهد. اگر هیچ عددی وارد نشود، حالت شبکه روشن یا خاموش می‌شود. با قرار دادن یک عدد از ۱ تا ۳ در ابتدا، می‌توان ۳ سطح شبکه مختلف را تنظیم کرد. واحدهای شبکه بسته به اینکه قالب کاغذ letter (اینچ) باشد یا a4 (سانتی‌متر)، اینچ یا سانتی‌متر خواهند بود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B d .RB [ down() ] صفحه را به اندازه دو سوم یک پنجره کامل به پایین جابه‌جا می‌کند. با یک آرگومان اعشاری برای «down»، به کسر متناظر از یک پنجره کامل به سمت پایین حرکت می‌کند. .\" Therefore, a more .\" ``smooth'' scrolling using the ``Up'' and ``Down'' keys can be .\" achieved by the following setting: .\" .sp .\" xdvi.mainTranslations: #override\e .\" .br .\" Up:up(0.01)\en\e .\" .br .\" Down:down(0.01)\en .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-f .RB [ find() ] پنجره‌ای را برای جستجوی یک رشته در فایل DVI باز می‌کند. برای جزئیات بیشتر به بخش .BR "STRING SEARCH" در زیر مراجعه کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B f .RB [ forward-page() ] رفتن به صفحه بعدی (یا در صورت مشخص شدن عدد، به صفحه .IR n \-اُم بعدی). کلیدهای مترادف عبارتند از .RB ` n '، Return و Line Feed. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B G .RB [ set-greyscaling() ] این کلید استفاده از هموارسازی خاکستری (greyscale anti-aliasing) را برای نمایش بیت‌مپ‌های کوچک‌شده تغییر وضعیت می‌دهد. علاوه بر این، دنباله‌های کلیدی .RB ` 0G ' و .RB ` 1G ' به ترتیب این پرچم را پاک و فعال می‌کنند. همچنین گزینه .B \-nogrey را ببینید. .sp اگر یک آرگومان عددی غیر از 0 یا 1 داده شود، هموارسازی خاکستری فعال می‌شود و منبع گاما (gamma) روی مقدار تقسیم بر ۱۰۰ تنظیم می‌شود. به عنوان مثال،\& .RB ` 150G ' حالت خاکستری را فعال کرده و گاما را روی 1.5 تنظیم می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-g .RB [ find-next() ] یافتن تطابق بعدی رشته در فایل DVI؛ این کلید می‌تواند به جای کلیک بر روی دکمه «Find» در پنجره جستجو استفاده شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B g .RB [ goto-page() ] رفتن به صفحه‌ای با شماره مشخص شده. اگر شماره صفحه‌ای داده نشود، xdvi به آخرین صفحه می‌پرد. .br اگر گزینه/منبع .B useTeXpages فعال باشد، شماره‌ها مطابق با شماره صفحات واقعی در فایل TeX هستند؛ در غیر این صورت، از شماره صفحات مطلق (شروع از ۱) استفاده می‌شود. در حالت دوم، شماره صفحات را می‌توان با کلید .RB ` P ' در زیر تغییر داد. توجه داشته باشید که با گزینه .B useTeXpages ممکن است یک شماره صفحه چندین بار تکرار شود؛ در چنین حالتی، xdvi از اولین شماره صفحه‌ای که مطابقت دارد استفاده خواهد کرد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B h پنجره راهنمایی را با توضیحی کوتاه درباره مهم‌ترین کلیدها و مفاهیم باز می‌کند. .\" .\" Ummh, surely nobody will use the following ... .\" .\" For I18n purposes, the help texts and menu entries are configurable .\" via the following X resources: .\" .BR helpGeneral , .\" #ifhyper .\" .BR helpHypertex , .\" #endif .\" .BR helpOthercommands , .\" .BR helpMarking , .\" .BR helpPagemotion , .\" .BR helpMousebuttons , .\" .BR helpRulermode , .\" .BR helpSearch and .\" .BR helpSourcespecials . .\" The values of this resource should be a text string, the first line of .\" which should contain two fields separated by `\en'. The first field is .\" used as list entry for the list of help topics on the left of the help .\" window, and the second field is used as the heading on the right-hand side. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B k .RB [ set-keep-flag() ] معمولاً زمانی که .B xdvi صفحات را تغییر می‌دهد، به موقعیت آغازین (home) نیز می‌رود. کلید .RB ` k ' پرچم «keep-position» را تغییر وضعیت می‌دهد که در صورت فعال بودن، هنگام جابه‌جایی میان صفحات، موقعیت فعلی را حفظ می‌کند. همچنین .RB ` 0k ' و .RB ` 1k ' به ترتیب این پرچم را پاک و فعال می‌کنند. همچنین گزینه .B \-keep را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-l .RB [ fullscreen(toggle) ] حالت تمام‌صفحه را تغییر وضعیت می‌دهد (برای اطلاعات بیشتر به توضیحات گزینه .B \-fullscreen مراجعه کنید). این قابلیت حتی از استفاده از گزینه خط فرمان نیز ناپایدارتر است: هیچ استاندارد جهان‌شمولی درباره اینکه پنجره چگونه می‌تواند ابعاد یا تزیینات خود را در زمان اجرا تغییر دهد وجود ندارد، بنابراین در اکثر مدیران پنجره یا میزکارها کار نخواهد کرد. به‌طور کلی، بهتر است از کنترل‌های مدیر پنجره برای تغییر اندازه یا تزیینات پنجره xdvi استفاده کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B l .RB [ left() ] صفحه را به اندازه دو سوم یک پنجره کامل به چپ جابه‌جا می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .B M .RB [ set-margins() ] حاشیه‌ها را به‌گونه‌ای تنظیم می‌کند که نقطه فعلی زیر مکان‌نمای ماوس، گوشه بالا سمت چپ متن صفحه را تعیین نماید. توجه داشته باشید که این دستور تصویر را جابه‌جا .I نمی‌کند بلکه فقط حاشیه‌ها را برای دستورهای تعویض صفحه مشخص می‌سازد. برای جزئیات مربوط به نحوه استفاده از حاشیه‌ها، گزینه .B \-margins را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B m .RB [ toggle-mark() ] وضعیت علامت صفحه فعلی را در فهرست صفحات تغییر می‌دهد. هنگامی که صفحه‌ای علامت‌گذاری شود، با یک ستاره کوچک «*» در کنار شماره صفحه نمایش داده می‌شود. سپس صفحات علامت‌گذاری‌شده را می‌توان چاپ کرد یا در یک فایل ذخیره نمود. همچنین می‌توان با کلیک یا کشیدن .B Mouse-2 در فهرست صفحات، یک یا چند صفحه را علامت‌گذاری کرد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-n .RB [ toggle-mark()forward-page() ] وضعیت علامت صفحه فعلی را در فهرست صفحات تغییر می‌دهد و به صفحه بعد می‌رود. این امکان به شما اجازه می‌دهد رشته‌ای از صفحات متوالی را به‌سرعت علامت‌گذاری کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B n .RB [ forward-page() ] به صفحه بعدی (یا در صورت ارائه یک عدد، به .IR n \-امین صفحه بعد) می‌رود. مترادف‌های آن عبارتند از .RB ` f '، Return و Line Feed. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-o .RB [ select-dvi-file() ] یک فایل .I dvi جدید می‌خواند. یک ابزارک انتخاب فایل به‌صورت پنجره پاپ‌آپ باز می‌شود تا فایل DVI را از آن انتخاب کنید. اگر یک آرگومان پیشوندی .I n داده شود، در عوض .IR n \-امین فایل از تاریخچه فایل‌ها باز می‌شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B P .RB [ declare-page-number() ] «این شماره صفحه .IR n است.» از این کلید می‌توان استفاده کرد تا فشردن کلید .RB ` g ' به شماره صفحه‌ای متفاوت از صفحه فیزیکی اشاره کند. (اگر می‌خواهید به‌جای صفحات فیزیکی از شماره صفحات «منطقی» یا \*(Te\& استفاده کنید، در عوض استفاده از گزینه .B \-useTeXpages را در نظر داشته باشید.) آرگومان .I n باید به‌عنوان پیشوند برای این کلید ارائه شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-p .RB [ print() ] یک پنجره پاپ‌آپ برای چاپ فایل DVI یا بخش‌هایی از آن باز می‌کند. برای توضیح گزینه‌های موجود و منابع جهت سفارشی‌سازی رفتار پیش‌فرض، بخش .B PRINT DIALOG را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B p .RB [ back-page() ] به صفحه قبلی می‌رود (یا .I n صفحه به عقب بازمی‌گردد). مترادف‌های آن عبارتند از .RB ` b '، .B Ctrl-h و .BR Backspace . .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B q .RB [ quit() ] از برنامه خارج می‌شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-r .RB [ forward-page(0) ] صفحه فعلی را دوباره نمایش می‌دهد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B R .RB [ reread-dvi-file() ] فایل .I dvi را وادار به بازخوانی می‌کند. این ویژگی به شما امکان می‌دهد نسخه‌های متعددی از یک فایل را در حالی که .B xdvi تنها یک بار اجرا شده است پیش‌نمایش کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B r .RB [ right() ] صفحه را به اندازه دو سوم یک پنجره کامل به راست می‌برد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-s .RB [ save() ] یک پنجره پاپ‌آپ برای ذخیره فایل DVI یا بخش‌هایی از آن باز می‌کند. برای اطلاعات بیشتر در این مورد، بخش SAVE DIALOG را در زیر ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B S .RB [ set-density() ] ضریب تراکم را برای استفاده در هنگام کوچک‌سازی bitmapها تنظیم می‌کند. این مقدار باید عددی بین 0 و 100 باشد؛ اعداد بزرگ‌تر نویسه‌های کم‌رنگ‌تری تولید می‌کنند. اگر حالت طیف خاکستری فعال باشد، این دستور در عوض مقدار گاما را تغییر می‌دهد. مقدار جدید گاما برابر با عدد داده‌شده تقسیم بر 100 است؛ مقادیر منفی نیز مجاز هستند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B s .RB [ set-shrink-factor() ] ضریب کوچک‌سازی را به عدد داده‌شده تغییر می‌دهد. اگر عددی مشخص نشود، کوچک‌ترین ضریبی که باعث شود کل صفحه در پنجره جا بگیرد استفاده خواهد شد. (حاشیه‌ها در این محاسبه نادیده گرفته می‌شوند.) .\" NOTE: following only works in action string, not interactively!!! .\" Two special values are .\" .B + .\" and .\" .B - .\" which zoom in and out respectively, by decrementing/incrementing the .\" shrinkfactor by one step. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B T .RB [ use-tex-pages() ] برای برچسب‌های فهرست صفحات و هنگام پرش به یک صفحه در سند از طریق .BR goto-page() ، به‌جای صفحات فیزیکی از صفحات منطقی \*(Te\& (مقادیر ثبات .IR \ecount0 ) استفاده می‌کند. همچنین گزینه .B \-useTeXpages را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B t .RB [ switch-magnifier-units() ] واحدهای مورد استفاده برای درجه‌بندی‌های ذره‌بین و گزارش فاصله بین اشاره‌گر ماوس و مرکز خط‌کش را در حالت خط‌کش تعویض می‌کند (بخش .B MODES را ببینید). مقدار پیش‌فرض توسط منبع X با نام .B tickUnits (به‌طور پیش‌فرض `mm') تعیین می‌شود. واحدها بین مقادیر زیر جابه‌جا می‌شوند؛ به جز `px'، همگی متناظر با واحدهای \*(Te\& هستند: .I mm (میلی‌متر) .I pt (نقطه‌های \*(Te\&)، .I in (اینچ)، .I sp (نقطه‌های مقیاس‌بندی‌شده، واحدی که به‌طور داخلی در \*(Te\& استفاده می‌شود) .I bp (نقطه‌های بزرگ یا `PostScript points')، .I cc (نقطه‌های cicero)، .I dd (نقطه‌های didot)، .I pc (pica)، و .I px (پیکسل‌های صفحه نمایش). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-u .RB [ back-page()toggle-mark() ] به صفحه قبلی می‌رود و وضعیت علامت آن صفحه را تغییر می‌دهد. این عمل قرینه .BR Ctrl-n است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B u .RB [ up() ] صفحه را به اندازه دو سوم یک پنجره کامل به بالا می‌برد. با ارائه یک آرگومان اعشاری (float) به «up»، به اندازه کسر متناظر از یک پنجره کامل به بالا حرکت می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-v .RB [ show-source-specials() ] کادرهای احاطه‌کننده (bounding boxes) را برای تمام منبع‌های special در صفحه فعلی نشان می‌دهد و رشته‌های موجود در این specialها را در stderr چاپ می‌کند. با پیشوند 1، تمام کادرهای احاطه‌کننده صفحه را نمایش می‌دهد. این قابلیت عمدتاً برای اهداف اشکال‌زدایی است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .B V .RB [ set-gs-alpha() ] این کلید وضعیت صاف‌سازی لبه‌ها (anti-aliasing) را برای دستورهای ویژهٔ PostScript در زمانی که .B Ghostscript به‌عنوان رندرکننده استفاده می‌شود، تغییر می‌دهد. علاوه بر این، دنباله کلیدهای .RB ` 0V ' و .RB ` 1V ' به‌ترتیب این پرچم را پاک و فعال می‌کنند. همچنین گزینهٔ .B \-gsalpha را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B v .RB [ set-ps() ] این کلید رندر دستورهای ویژهٔ PostScript را میان ۳ وضعیت تغییر می‌دهد: .RS 7 .TP 0 .SB - دستورهای ویژه (مانند گرافیک‌های EPS) نمایش داده می‌شوند؛ .TP .SB - دستورهای ویژه همراه با کادر محصورکننده (در صورت وجود) نمایش داده می‌شوند؛ .TP .SB - تنها کادر محصورکننده نمایش داده می‌شود. .PP .sp این وضعیت‌ها را همچنین می‌توان مستقیماً با استفاده از .RB ` 1v '، .RB ` 2v ' و .RB ` 0v ' به‌ترتیب انتخاب کرد. همچنین گزینهٔ .B \-postscript را ببینید. .RE .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Ctrl-x .RB [ source-what-special() ] اطلاعات مربوط به دستور ویژهٔ سورس (source special) در کنار مکان‌نمای موش‌واره را در خط وضعیت نمایش می‌دهد. این همان دستور ویژه‌ای است که توسط .IR source-special() یافت می‌شود، اما بدون فراخوانی ویرایشگر. برای مقاصد اشکال‌زدایی. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B x .RB [ set-expert-mode() ] حالت کارشناس (expert mode) را فعال/غیرفعال می‌کند؛ حالتی که در آن خط وضعیت، نوارهای پیمایش، دکمه‌های منو، نوار ابزار (تنها در Motif) و فهرست صفحات نمایش داده نمی‌شوند. فشردن .RB ` 1x ' نمایش خط وضعیت در پایین پنجره را تغییر می‌دهد. فشردن .RB ` 2x ' نوارهای پیمایش را (در صورت وجود) تغییر می‌دهد. در Xaw، کلید .RB ` 3x ' دکمه‌های منو و فهرست صفحات را تغییر می‌دهد؛ در Motif، فهرست صفحات را تغییر می‌دهد. در Motif، مقیدسازی‌های اضافی .RB ` 4x ' نوار ابزار، و .RB ` 5x ' نوار منو را تغییر می‌دهند. .br بدون آرگومان پیشوندی، همهٔ عناصر واسط گرافیکی یادشده یا روشن می‌شوند (اگر قبلاً پنهان بوده‌اند) یا خاموش. .br تغییر وضعیت نوارهای پیمایش ممکن است در ابزارک‌های Xaw رفتاری نامنظم داشته باشد؛ برای نمونه، ممکن است نوارهای پیمایش پس از تغییر اندازهٔ پنجره دوباره پدیدار شوند، و در اندازه‌های خاصی از پنجره، یکی از نوارهای پیمایش ممکن است پنهان نشود. .br همچنین گزینهٔ .B \-expertmode را ببینید (شماره‌های بالا متناظر با بیت‌های موجود در آرگومانِ .BR \-expertmode هستند). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "کنش‌های موش‌واره در پنجره اصلی (MOUSE ACTIONS IN THE MAIN WINDOW)" کنش‌های موش‌واره را می‌توان با تنظیم منبع X با نام .BR mouseTranslations سفارشی‌سازی کرد. از آنجا که سه حالت مختلف موش‌واره وجود دارد (بخش .B MODES در زیر را ببینید)، کنش ویژه‌ای به نام .B mouse-modes وجود دارد که کنش‌ها را برای هر یک از این سه حالت فهرست می‌کند: \fBmouse-modes("ACTIONS-FOR-MODE1", "ACTIONS-FOR-MODE2", "ACTIONS-FOR-MODE3")\fR. اگر تنها یک آرگومان تعیین شود، این کنش برای تمامی حالت‌ها استفاده خواهد شد. مقیدسازی‌های پیش‌فرض به‌صورت زیر هستند: .RS 5 .nf .ft 3 .sp 1n xdvi.mouseTranslations: \e Shift:mouse-modes("drag(+)")\en\e Shift:mouse-modes("drag(|)")\en\e Shift:mouse-modes("drag(-)")\en\e Ctrl:mouse-modes("source-special()")\en\e : mouse-modes("do-href()magnifier(*2)", "text-selection()", "ruler()")\en\e : mouse-modes("do-href-newwindow()magnifier(*2)", "text-selection()", "ruler()")\en\e : mouse-modes("magnifier(*3)")\en\e : mouse-modes("wheel(-0.2)")\en\e : mouse-modes("wheel(0.2)")\en\e : mouse-modes("hwheel(-0.2)")\en\e : mouse-modes("hwheel(0.2)")\en\e .sp 1n .ft .fi .RE همهٔ این کنش‌ها با جزئیات بیشتر در زیر شرح داده شده‌اند. به استفاده از علامت‌های نقل‌قول در اطراف رشته‌های کنش توجه کنید که برای گروه‌بندی آن‌ها در قالب یک آرگومان ضروری است. دکمه‌های ۴، ۵، ۶ و ۷ به حرکت‌های چرخ موش‌واره (چرخ به بالا/پایین/چپ/راست) در موش‌واره‌های چرخ‌دار اشاره دارند. همهٔ موش‌واره‌ها از پیمایش افقی پشتیبانی نمی‌کنند. .PP توابع X Toolkit که نگاشت‌ها (translations) را پیاده‌سازی می‌کنند، از انواع رویداد .B Btn6Down یا .BR Btn7Down پشتیبانی نمی‌کنند. به همین دلیل، .B xdvi تجزیه‌کنندهٔ خودش را برای نگاشت‌های ارائه‌شده در .BR mouseTranslations پیاده‌سازی می‌کند. این تجزیه‌کننده محدودتر از تجزیه‌کنندهٔ توکار X Toolkit است. رشتهٔ ارائه‌شده در .B mouseTranslations نباید با .RB `` #replace ''، .RB `` #augment ''، یا .RB `` #override '' آغاز شود. تغییردهنده‌هایی به‌شکل .BI @ keysym پشتیبانی نمی‌شوند، و نوع رویداد باید به‌شکل .B BtnDown یا .BI Btn n Down\fR،\fP باشد، که در آن .I n یک عدد صحیح مثبت بدون صفرهای ابتدایی است. همچنین، محدودیت‌هایی بر روی فیلد کنش اعمال می‌شود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B do-href() .TP .B do-href-newwindow() .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" معمولاً اگر یک مقیدسازی بیش از یک کنش را مشخص کند، همهٔ کنش‌ها به‌ترتیب اجرا می‌شوند. مقیدسازی‌های ابرپیوند .B do-href() و .B do-href-newwindow() از این جهت خاص هستند که .I اگر موش‌واره هم‌اکنون روی یک ابرپیوند قرار داشته باشد، به‌عنوان یک .I جایگزین برای سایر کنش‌هایی که ممکن است پس از آن‌ها بیایند استفاده می‌شوند. در این صورت، هیچ‌یک از کنش‌های دیگر اجرا نخواهند شد؛ در غیر این صورت، تنها سایر کنش‌ها اجرا می‌شوند. .br کنش .B do-href() به مقصد پیوند در پنجرهٔ فعلی xdvi می‌پرد (و در نهایت صفحه را تغییر می‌دهد)، و .B do-href-newwindow() نمونهٔ جدیدی از xdvi را برای مقصد پیوند باز می‌کند. در هر دو حالت، موقعیت مقصد با یک پیکان کوچک که به همان رنگ پیوند دیده‌شده در گوشهٔ سمت چپ پنجره ترسیم می‌شود، مشخص می‌گردد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B magnifier(n x m) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B magnifier(*n) این کنش یک «ذره‌بین» را ظاهر می‌کند که تصویر فشرده‌نشدهٔ ناحیهٔ اطراف نشانگر موش‌واره را نشان می‌دهد. با رها کردن دکمهٔ موش‌واره، ذره‌بین ناپدید می‌شود. حرکت دادن مکان‌نمای موش‌واره حین نگه داشتن دکمه، ذره‌بین را جابه‌جا می‌کند. .br دکمه‌های مختلف موش‌واره پنجره‌هایی با اندازه‌های متفاوت ایجاد می‌کنند، همان‌گونه که با آرگومان کنشِ .I magnifier() مشخص می‌شود. آرگومان آن یا رشته‌ای به‌شکل .IR width x height است، مانند گزینهٔ خط فرمان .BI \-mgs n\fR، یا یکی از رشته‌های .B *1 تا .BR *5 است، که به مقدار مشخص‌شده توسط گزینهٔ متناظرِ .BI \-mgs n اشاره دارد. .\" Note that in order to assign magnifier actions to .\" the buttons 4 or 5, you need to use the resource .\" .B wheelTranslations .\" (more about this resource below), e.g.: .\" .sp .\" xdvi.wheelTranslations: : magnifier(*4)\en\e .\" : magnifier(*5)\en .\" .sp .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .B drag(+) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B drag(|) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B drag(-) صفحه را با ماوس می‌کشد. این کنش باید یک پارامتر داشته باشد، نویسهٔ .RB `` | ''، .RB `` - ''، یا .RB `` + ''، که به ترتیب نشان‌دهندهٔ فقط کشیدن عمودی، فقط کشیدن افقی، یا کشیدن در تمام جهت‌ها است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B source-special() این کنش یک «جستجوی معکوس» (reverse search) را آغاز می‌کند، و ویرایشگر را در مکانی از فایل \*(Te\& باز می‌کند که متناظر با مکان اشاره‌گر در فایل DVI است. برای اطلاعات بیشتر در این باره، بخش SOURCE SPECIALS را در ادامه ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B wheel() این کنش می‌تواند برای پیمایش تصویر با چرخ ماوس استفاده شود، جایی که معمولاً به دکمهٔ ۴ ماوس (چرخش به بالا) یا ۵ (چرخش به پایین) مقید شده است. این کنش یک پارامتر می‌گیرد که مسافت پیمایش تصویر را مشخص می‌کند. اگر پارامتر شامل ممیز اعشاری باشد، مسافت بر حسب واحدهای چرخ (wheel units) ارائه می‌شود؛ در غیر این صورت، بر حسب پیکسل است. مقدار منفی به بالا و مقدار مثبت به پایین پیمایش می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B hwheel() این کنش می‌تواند برای پیمایش افقی تصویر با چرخ ماوس به کار رود، جایی که معمولاً به دکمهٔ ۶ ماوس (چرخش به چپ) یا ۷ (چرخش به راست) مقید شده است. این کنش یک پارامتر می‌گیرد که مسافت پیمایش تصویر را مشخص می‌کند. اگر پارامتر شامل ممیز اعشاری باشد، مسافت بر حسب واحدهای چرخ ارائه می‌شود؛ در غیر این صورت، بر حسب پیکسل است. مقدار منفی به چپ و مقدار مثبت به راست پیمایش می‌کند. همهٔ ماوس‌ها از پیمایش افقی پشتیبانی نمی‌کنند؛ این قابلیت بیشتر برای تاچ‌پدها، ترک‌پدها و غیره کاربرد دارد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B text-selection() این کنش به شما امکان می‌دهد یک ناحیهٔ مستطیلی از متن را در فایل DVI مشخص کنید. متن در بافر انتخاب X قرار می‌گیرد و می‌تواند در برنامه‌های دیگر (مانند ویرایشگرهای متن) جای‌گذاری شود. این عملکرد شبیه به گزینهٔ Plain text در گفتگوی .B Save است؛ برای اطلاعات بیشتر دربارهٔ مسائل کدگذاری، توضیحات آن بخش را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B ruler() این کنش یک خط‌کش صلیبی‌شکل ایجاد می‌کند. حرکت دادن ماوس و پایین نگه داشتن کلید، خط‌کش را جابه‌جا کرده و اجازه می‌دهد فاصله‌ها را روی صفحه اندازه بگیرید. برای اطلاعات بیشتر در این مورد، بخش .B Ruler Mode را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "کنش‌های مقیدنشده (UNBOUND ACTIONS)" کنش‌های زیر به‌طور پیش‌فرض به کلیدی مقید نشده‌اند، اما برای سفارشی‌سازی در دسترس هستند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B quit-confirm() یک پنجرهٔ تأیید برای خروج از xdvi نمایش می‌دهد. برای مقید کردن آن به کلید .RB ` q ' به‌جای کنش پیش‌فرض `quit()' عبارت زیر را در فایل .I ~/.Xdefaults خود قرار دهید: .sp xdvi.mainTranslations: #override\e .br q: quit-confirm()\en .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B down-or-next() مشابه .IR unpause-or-next() : به اندازهٔ دو سوم یک پنجرهٔ کامل به پایین حرکت می‌کند، یا اگر در پایین صفحه باشد، به صفحهٔ بعدی می‌رود. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B shrink-to-dpi() این کنش یک آرگومان (الزامی) می‌پذیرد. ضریب کوچک‌نمایی را روی یک عدد صحیح تنظیم می‌کند تا استفاده از قلم‌ها با تعداد نقاط در اینچ متناظر تقریب زده شود. اگر .B xdvi از قلم‌های مقیاس‌بندی‌شده برای .I p نقطه در اینچ استفاده کند، و آرگومان ورودی به .B shrink-to-dpi برابر با .IR n باشد، آنگاه ضریب کوچک‌نمایی متناظر، نسبت .IR p / n خواهد بود که به نزدیک‌ترین عدد صحیح گرد شده است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B user-exec() این کنش یک آرگومان (الزامی) می‌پذیرد. برنامهٔ خارجی مشخص‌شده توسط آرگومان را اجرا می‌کند، که بر اساس فاصله‌ها بخش‌بندی می‌شود. متغیر محیطی .B XDVI_FILE روی مسیر مطلق فایل DVI تنظیم می‌شود تا برنامه بتواند فایل DVI را پیدا کند. به عنوان مثال، برای تخصیص کلید .RB ` m ' به عنوان کلید میانبری که فایل DVI را با `make' بازتولید می‌کند، خطوط زیر را در فایل .I ~/.Xdefaults خود قرار دهید: .sp xdvi.mainTranslations: #override\e .br m: user-exec(xdvi-remake)\en که در آن `xdvi-remake' نام برنامه‌ای در .B PATH شما، مشابه `cd $(dirname $XDVI_FILE) && make $(basename $XDVI_FILE)' است. (همچنین بخش .B SIGNALS را برای روشی جهت وادار کردن .B xdvi به بازخوانی فایل DVI پس از بازتولید آن ببینید.) .PP .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".SH "سفارشی‌سازی (CUSTOMIZATION)" تخصیص‌های کلید و دکمه‌های ماوس را می‌توان با تنظیم منبع .B mainTranslations به رشته‌ای از ترجمه‌ها (translations) آن‌گونه که در مستندات جعبه‌ابزار X تعریف شده است، تغییر داد. عملیات‌ها باید به شکل نام‌های عملیاتی فهرست‌شده در بخش‌های KEYSTROKES و MOUSE ACTIONS باشند. .PP یک استثنا برای این موضوع، کلیدهای Motif شامل .IR osfPageUp " (" PgUp )، .IR osfPageDown " (" PgDown )، .IR osfBeginLine " (" Home ) و .IR osfEndLine " (" End ) هستند که در حال حاضر در نسخهٔ Motif قابل سفارشی‌سازی نیستند. .PP عملیات‌های کلید معمولاً بدون آرگومان هستند؛ اگر به آن‌ها آرگومانی داده شود، بیانگر عدد اختیاری یا «آرگومان پیشوندی» تایپ‌شده پیش از عملیات است. .PP برخی عملیات‌های کلید ممکن است آرگومان‌های ویژه‌ای به شرح زیر بگیرند: آرگومان .B goto-page می‌تواند حرف .RB ` e ' باشد که بیانگر عملیات رفتن به انتهای سند است. آرگومان .B set-shrink-factor می‌تواند حرف .RB ` a ' باشد که نشان می‌دهد ضریب کوچک‌نمایی باید روی کوچک‌ترین مقداری تنظیم شود که در آن صفحه درون پنجره جا بگیرد، یا یکی از علامت‌های .RB ` + ' یا .RB ` - ' باشد که به ترتیب نشان‌دهندهٔ افزایش یا کاهش ضریب کوچک‌نمایی است. در نهایت، عملیات‌هایی که تغییر وضعیت (toggle) انجام می‌دهند، مانند .BR set-keep-flag ، می‌توانند آرگومان .RB ` t ' را دریافت کنند که نشان می‌دهد عملیات باید صرف‌نظر از آرگومان پیشوندی فعلی، وضعیت را تغییر دهد. .PP عملیات‌های ماوس تنها باید به رویدادهای .B ButtonPress اشاره داشته باشند (برای نمونه\& .BR ":magnifier(*1)" ). رویدادهای حرکت و رهاسازی متناظر به صورت درونی مدیریت خواهند شد. یک عملیات کلید می‌تواند به یک رویداد ماوس متصل (bind) شود، اما برعکس آن ممکن نیست. .PP معمولاً رشتهٔ ترجمه‌ها باید با .RB `` #override '' آغاز شود، که نشان می‌دهد تخصیص‌های پیش‌فرض کلید و دکمهٔ ماوس نباید نادیده گرفته شوند. .PP هنگامی که کلیدها یا دکمه‌های ماوسِ شامل کلیدهای تبدیل (مانند Ctrl یا Shift) همراه با معادل‌های بدون تبدیل خود سفارشی‌سازی می‌شوند، کلیدهای تبدیل‌یافته باید ابتدا بیایند، برای مثال: .RS 5 .nf .ft 3 .sp 1n xdvi.mainTranslations: #override \e Shifts: select-dvi-file()\en\e Ctrls: save()\en\e s: find()\en .sp 1n .ft .fi .RE .PP از آنجا که .B xdvi باید رویدادهای حرکت نشانگر را دریافت کند، و به این دلیل که سازوکار ترجمه‌های X Toolkit نمی‌تواند هم‌زمان رویدادهای حرکت و رویدادهای دوبار کلیک را پشتیبانی کند، تعیین عملیات‌های دوبار کلیک در سفارشی‌سازی‌های .B xdvi امکان‌پذیر نیست. برای اطلاعات دربارهٔ این موضوع و دیگر جنبه‌های ترجمه‌ها، مستندات X Toolkit Intrinsics را ببینید. .PP هیچ گزینهٔ خط فرمانی برای تنظیم منبع .B mainTranslations وجود ندارد، چرا که تغییر این منبع در خط فرمان دشوار خواهد بود. برای تنظیم این منبع به منظور آزمایش، از گزینهٔ خط فرمان .B -xrm ارائه‌شده توسط X toolkit استفاده کنید. برای مثال، \fBxdvi \-xrm 'XDvi.mainTranslations: #override "z":quit()' ...\fR یا .B "xdvi \-xrm 'XDvi.mainTranslations: #override z:quit()' ..." باعث می‌شود کلید .RB ` z ' موجب خروج از .BR xdvi شود. .PP برخی منابع برای امکان سفارشی‌سازی هندسهٔ دکمه‌های فرمان Xaw ارائه شده‌اند. مجدداً، این منابع از طریق گزینه‌های خط فرمان، به غیر از گزینهٔ .B \-xrm قابل تغییر نیستند. تمامی این منابع مقادیر عدد صحیح می‌پذیرند. .TP .B buttonSideSpacing تعداد پیکسل‌هایی که در هر دو طرف دکمه‌ها قرار می‌گیرد. مقدار پیش‌فرض ۶ است. .TP .B buttonTopSpacing تعداد پیکسل‌های بین دکمهٔ بالایی و بالای پنجره. مقدار پیش‌فرض ۵۰ است. .TP .B buttonBetweenSpacing تعداد پیکسل‌های بین دکمه‌ها. مقدار پیش‌فرض ۲۰ است. .TP .B buttonBetweenExtra تعداد پیکسل‌های فضای اضافی که درج می‌شود اگر رشتهٔ منبع .B buttonTranslations شامل یک نویسهٔ خط جدید اضافی باشد. مقدار پیش‌فرض ۵۰ است. .TP .B buttonBorderWidth عرض حاشیهٔ پنجره‌های دکمه. مقدار پیش‌فرض ۱ است. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "فهرست صفحات (PAGE LIST)" فهرست طومارپذیر صفحات در سمت راست پنجرهٔ اصلی به شما امکان می‌دهد تا مستقیماً به صفحه‌ای در فایل DVI بپرید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Mouse-1 به صفحه‌ای که ماوس روی آن قرار دارد می‌پرد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B Mouse-2 .RB [ toggle-mark() ] وضعیت نشانه‌گذاری صفحهٔ فعلی را تغییر می‌دهد. این نشانه‌ها توسط پنجره‌های گفت‌وگوی «Print» و «Save to file» استفاده می‌شوند تا تنها صفحات نشانه‌گذاری‌شده از فایل DVI انتخاب شوند. .PP هنگامی که نشانگر ماوس درون فهرست صفحات قرار دارد، چرخ ماوس به صفحهٔ بعدی یا قبلی جابه‌جا می‌شود. .PP .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".SH "نوارهای پیمایش (SCROLLBARS)" نوارهای پیمایش (در صورت وجود) به شیوه استاندارد عمل می‌کنند: فشردن Button 2 در یک نوار پیمایش، لبه بالایی یا چپ نوار پیمایش را به آن نقطه منتقل کرده و در صورت نگه‌داشتن و کشیدن، آن را جابه‌جا می‌کند؛ فشردن Button 1 تصویر را به اندازه فاصله نقطه کلیک تا گوشه بالا-چپ پنجره، به سمت بالا یا راست جابه‌جا می‌کند؛ فشردن Button 3 تصویر را به همان میزان به سمت پایین یا چپ جابه‌جا می‌کند. .PP نوارهای پیمایش را می‌توان از طریق پرچم یا فشردن کلید .I -expertmode حذف کرد (به توضیحات آن مراجعه کنید). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "ذره‌بین (MAGNIFIER)" به‌طور پیش‌فرض، دکمه‌های ۱ تا ۵ موشواره یک «ذره‌بین» را باز می‌کنند که تصویری کوچک‌نشده از صفحه (یعنی تصویری با تفکیک‌پذیری تعیین‌شده توسط گزینه یا منبع اکس .B pixels یا .BR mfmode ) را در اندازه‌های گوناگون نمایش می‌دهد. هنگام جابه‌جایی ذره‌بین، نشانه‌های کوچک خط‌کش‌مانندی در لبه‌های ذره‌بین نمایش داده می‌شوند (مگر اینکه منبع اکس .B delayRulers روی false تنظیم شده باشد، که در این حالت نشانه‌ها همواره نمایش داده خواهند شد). واحد این نشانه‌ها توسط منبع اکس .B tickUnits تعیین می‌شود (به‌طور پیش‌فرض mm). این واحد را می‌توان در زمان اجرا از طریق کنش .BR switch-magnifier-units() ، که به‌طور پیش‌فرض به کلید .RB ` t ' اختصاص یافته است تغییر داد (برای جزئیات بیشتر درباره واحدهای موجود، به توضیحات آن کلید و switch-magnifier-units() مراجعه کنید). .br طول نشانه‌ها را می‌توان از طریق منبع اکس .B tickLength تغییر داد (به‌طور پیش‌فرض ۴). یک مقدار صفر یا منفی، نمایش نشانه‌ها را غیرفعال می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "تاریخچه صفحه (PAGE HISTORY)" برنامه .B Xdvi تاریخچه‌ای از صفحات مشاهده‌شده را نگه می‌دارد، و شما می‌توانید با استفاده از کلیدهای .B [ .RI ( pagehistory-back() ) ، .B ] .RI ( pagehistory-forward() ) ، .B Ctr-[ .RI ( pagehistory-delete-backward() ) و .B Ctr-] .RI ( pagehistory-delete-forward() ) در طول تاریخچه جابه‌جا شده و موارد را حذف کنید. .PP هنگامی که یکی از دستورهای تاریخچه به کار می‌رود، تاریخچه صفحه در خط وضعیت واقع در پایین پنجره نمایش داده می‌شود؛ به این صورت که مورد فعلی فهرست با قلاب‌های `[' و `]' مشخص شده و حداکثر تا ۱۰ مورد از محتوای قبل و بعد آن نشان داده می‌شود. مرزهای فایل با `#' علامت‌گذاری می‌شوند. .PP اندازه تاریخچه را می‌توان از طریق منبع اکس .B pageHistorySize سفارشی‌سازی کرد (اندازه پیش‌فرض ۱۰۰۰ مورد است). اگر مقدار اندازه روی ۰ تنظیم شود، دستورهای تاریخچه غیرفعال می‌گردند. .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "ابرپیوندها (HYPERLINKS)" کنش‌های .B do-href() و .B do-href-newwindow() (که در صورت قرار داشتن اشاره‌گر روی یک ابرپیوند، به‌طور پیش‌فرض به Mouse-1 و Mouse-2 متصل هستند) می‌توانند برای باز کردن مقصد پیوند در همان پنجره .RB ( do-href() ) یا در یک پنجره جدید .RB ( do-href-newwindow() ) استفاده شوند. .PP اگر مقصد پیوند فایلی روی دیسک محلی نباشد، xdvi تلاش می‌کند یک مرورگر وب (به ترتیبی که با گزینه خط فرمان .B -browser ، متغیر محیطی .B BROWSER یا منبع اکس .B wwwBrowser مشخص شده است) را برای دریافت سند اجرا کند. برای مشاهده نمونه تنظیمات، به توضیحات متغیر محیطی .B BROWSER در ادامه مراجعه کنید. .PP اگر فایل محلی باشد، xdvi تلاش می‌کند بررسی کند که آیا یک فایل DVI است یا خیر. در صورت مثبت بودن، xdvi تلاش می‌کند فایل را نمایش دهد؛ در غیر این صورت، نوع MIME فایل و از روی آن برنامه مناسب برای باز کردن فایل را تعیین می‌کند. این کار از طریق بررسی و تجزیه فایل‌های مشخص‌شده توسط متغیر محیطی .B EXTENSIONMAPS برای نگاشت پسوندهای نام فایل به انواع MIME، و فایل‌های تعیین‌شده توسط متغیر محیطی .B MAILCAPS برای نگاشت انواع MIME به برنامه‌های کاربردی انجام می‌گیرد. برای توضیحات دقیق‌تر و مقادیر پیش‌فرض این متغیرها، به توضیحات آن‌ها در بخش .BR ENVIRONMENT در ادامه مراجعه کنید. اگر هیچ فایل مناسبی یافت نشود، از مجموعه‌ای توکار از انواع MIME و برنامه‌های پیش‌فرض استفاده می‌شود. .PP در حال حاضر .B Xdvi به‌جز پسوند نام فایل، از هیچ روش ابتکاری دیگری برای تشخیص نوع MIME یک فایل استفاده نمی‌کند. اگر نام فایل فاقد پسوند باشد، مقدار منبع .B noMimeSuffix استفاده می‌شود (به‌طور پیش‌فرض .IR application/x-unknown ). اگر پسوند فایل با هیچ‌یک از پسوندهای موجود در .BR mime.types تطابق نداشته باشد، مقدار منبع .B unknownMimeSuffix به کار می‌رود (به‌طور پیش‌فرض .IR application/x-unknown ). اگر ورودی‌های .B mailcap نمایشگری برای یک نوع MIME مشخص فهرست نکرده باشند، xdvi یک پنجره بازشوی هشدار نمایش می‌دهد. اگر می‌خواهید از این هشدار جلوگیری کنید، و برای مثال مایلید برای انواع MIME ناشناخته همواره از مرورگر netscape استفاده شود، می‌توانید خط زیر را به فایل ~/.mailcap خود بیفزایید: .RS 4 .nf .ft 3 .sp 1n application/xdvi-unknown; \e netscape -raise -remote 'openURL(%s,new-window)' .sp 1n .ft .fi .RE .\" As an example, consider the following settings, which are the default .\" settings for buttons 1 and 2: .\" .RS 5 .\" .nf .\" .ft 3 .\" .sp 1n .\" xdvi.mainTranslations: #override \e .\" : do-href()magnifier(*1)\en\e .\" : do-href-newwindow()magnifier(*2)\en\e .\" : magnifier(*3)\en .\" .sp 1n .\" .ft .\" .fi .\" .RE .\" .PP .\" If a link points to a file which is not a DVI file (e.g. HTML, or .\" PostScript), the files .\" .B mime.types .\" and .\" .B mailcap .\" are parsed to determine a suitable viewer; if no suitable .\" .B mailcap .\" entry was found, if the .\" .SB WWWBROWSER .\" environment variable is set, or .\" .B \-browser .\" was specified on the command line, the browser is launched to load the file. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".SH "جستجوی رشته (STRING SEARCH)" کلید میانبر .I Ctrl-f یا مدخل منوی .I File > Find ... (یا نماد «دوربین دوچشمی» در نوار ابزار، برای Motif) پنجرهٔ محاوره‌ای را برای جستجوی یک رشتهٔ متنی یا یک عبارت منظم در فایل DVI باز می‌کند. کلید میانبر .I Ctrl-g به تطابق بعدی می‌پرد (مانند فشردن دکمهٔ «Find» در پنجرهٔ جستجو). .PP به‌طور پیش‌فرض، موارد منطبق با رنگ معکوس برجسته می‌شوند. اگر نمایشگر در حالت TrueColor اجرا نشود، یا منبع X با نام .B matchHighlightInverted روی false تنظیم شده باشد یا گزینهٔ خط فرمان .B \-nomatchinverted استفاده شود، xdvi در عوض مستطیلی با رنگ .I highlight (گزینهٔ .B \-hl را ببینید) به دور مورد منطبق رسم می‌کند. .PP اگر یک تطابق از مرز صفحه عبور کند، تنها بخش واقع در صفحهٔ اول برجسته می‌شود. .B Xdvi تا ۲ صفحهٔ مجاور را برای تطبیق رشته‌هایی که از مرزهای صفحه عبور می‌کنند پویش خواهد کرد؛ اما توجه داشته باشید که خطوط سربرگ یا پانویس، یا صفحات شناور میانی به عنوان بخشی از متن پویش‌شده در نظر گرفته می‌شوند. چنین متنی معمولاً باعث شکست در تطابق‌های چندصفحه‌ای خواهد شد. .PP این موضوع بر این واقعیت تأکید دارد که جستجو در متن قالب‌بندی‌شده (خروجی DVI) متفاوت از جستجو در متن منبع عمل می‌کند: جستجو در فایل DVI رد شدن از دستورالعمل‌های قالب‌بندی را آسان‌تر کرده و امکان جستجوی مواردی چون خط‌فاصله‌گذاری (hyphenation) و شماره‌های معادلات را فراهم می‌سازد؛ اما گاهی اوقات نتایج قالب‌بندی نیز می‌توانند مانع شوند، مانند پاورقی‌ها. در این موارد بهتر است در عوض در منبع \*(Te\& جستجو کنید. استفاده از .I source specials جابجایی میان نمایشگر xdvi و ویرایشگر حاوی منبع \*(Te\& را آسان‌تر می‌کند؛ برای اطلاعات بیشتر در این مورد، بخش .B SOURCE SPECIALS را در ادامه ببینید. .PP متن استخراج‌شده از فایل DVI با کدگذاری UTF-8 کدگذاری شده است (می‌توانید آن متن را با ذخیرهٔ فایل در قالب UTF-8 از طریق آیتم منوی .I File > Save as ... مشاهده کنید). اگر xdvi به همراه پشتیبانی از locale، .I nl_langinfo() و .I iconv کامپایل شده باشد، عبارت جستجو از مجموعه نویسه‌های تعیین‌شده توسط locale جاری به UTF-8 تبدیل می‌شود. (خروجی .B locale -a را برای فهرستی از تنظیمات محلی موجود در سیستم خود بررسی کنید). اگر .I nl_langinfo() در دسترس نباشد اما .I iconv موجود باشد، می‌توانید کدگذاری ورودی برای .I iconv را از طریق منبع X با نام .I textEncoding مشخص کنید (خروجی .B iconv -l را برای فهرستی از کدگذاری‌های معتبر بررسی کنید). اگر پشتیبانی از .I iconv در دسترس نباشد، تنها کدگذاری‌های .I ISO-8859-1 و .I UTF-8 پشتیبانی می‌شوند (این نام‌ها به بزرگی و کوچکی حروف حساس نیستند). .PP با نویسه‌های اندیشه‌نگاشت (Ideographic) قلم‌های CJKV به طور ویژه‌ای رفتار می‌شود: تمام فضاهای خالی (فاصله‌ها و خطوط جدید) قبل و بعد از این نویسه‌ها در رشتهٔ جستجو و در فایل DVI نادیده گرفته می‌شوند. .PP برای تطبیق با نویسهٔ خط جدید، از \fI\en\fR در رشتهٔ جستجو استفاده کنید؛ برای تطبیق با رشتهٔ \fI\en\fR، از \fI\e\en\fR استفاده کنید. .PP اگر چک‌باکس .I Regular Expression فعال باشد، با رشته به عنوان یک عبارت منظم با نحو گسترش‌یافتهٔ POSIX رفتار می‌شود که دارای ویژگی‌های زیر است: .RS 2 .TP 2 - عبارت \fIa?\fR با \fIa\fR صفر یا یک بار تطابق می‌یابد. .TP - عبارت \fIa*\fR با \fIa\fR صفر یا چند بار تطابق می‌یابد. .TP - عبارت \fIa+\fR با \fIa\fR یک یا چند بار تطابق می‌یابد. توجه داشته باشید که \fI*\fR و \fI+\fR حریصانه (greedy) هستند، یعنی بلندترین زیررشتهٔ ممکن را تطبیق می‌دهند. .TP - الگوی \fI.\fR با هر نویسه‌ای به جز خط جدید تطابق می‌یابد. برای تطبیق با خط جدید نیز، از «\fI(.|\en)\fR» استفاده کنید. .TP - عبارت \fIa{n}\fR دقیقاً n بار با \fIa\fR تطابق می‌یابد. .TP - عبارت \fIa{n,m}\fR حداقل n و حداکثر m بار با \fIa\fR تطابق می‌یابد. .TP - عبارت \fIa|b\fR با \fIa\fR یا \fIb\fR تطابق می‌یابد. می‌توان از پرانتزها برای گروه‌بندی استفاده کرد، مثلاً: \fI(a|b)|c\fR. .TP - رشتهٔ تطبیق‌یافته توسط گروه nام می‌تواند با \fI\en\fR ارجاع داده شود، مثلاً \fI\e1\fR به اولین تطابق ارجاع دارد. .TP - نویسه‌های \fI^\fR و \fI$\fR به ترتیب با ابتدا و انتهای یک خط تطابق می‌یابند. .TP - عبارت \fI[abc]\fR با هر یک از حروف a، b، c تطابق می‌یابد و \fI[a-z]\fR با تمام نویسه‌های از a تا z تطابق دارد. .TP - هر مورد در عبارت منظم می‌تواند یکی از رده‌های نویسه‌ای (character classes) زیر در POSIX نیز باشد: .br .nf .I [[:alnum:]] [[:alpha:]] [[:blank:]] [[:cntrl:]] [[:digit:]] .I [[:graph:]] [[:lower:]] [[:print:]] [[:space:]] [[:upper:]] .fi این رده‌ها را می‌توان با درج یک نماد \fI^\fR پس از اولین قلاب نفی کرد: .I [^[:alpha:]] برای جزئیات بیشتر دربارهٔ عبارات منظم POSIX، برای نمونه تعریف استاندارد .B IEEE Std 1003.1 را ببینید که به صورت برخط از پیوند زیر در دسترس است: .nf http://www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap09.html .fi .TP - به عنوان یک افزونهٔ غیراستاندارد، اختصارات پرل‌مانند زیر می‌توانند به جای رده‌های POSIX استفاده شوند: .nf .sp 1n .ta 1L +8L +30L Symbol Meaning POSIX Class \fI\ew\fR یک نویسهٔ حرفی‌عددی \fI[[:alnum:]]\fR \fI\eW\fR یک نویسهٔ غیرحرفی‌عددی \fI[^[:alnum:]]\fR \fI\ed\fR یک نویسهٔ رقم \fI[[:digit:]]\fR \fI\eD\fR یک نویسهٔ غیررقم \fI[^[:digit:]]\fR \fI\es\fR یک نویسهٔ فاصلهٔ خالی \fI[[:space:]]\fR \fI\eS\fR یک نویسهٔ غیرفاصلهٔ خالی \fI[^[:space:]]\fR .sp 1n .fi .TP - نویسه‌های زیر نمادهای ویژه هستند؛ برای تطبیق لفظی آن‌ها باید با \fI\e\fR فراردهی شوند: \fI ( ) [ ] . * ? + ^ $ \e\fR. .TP - تطابق‌های با طول صفر بدون هیچ پیامی نادیده گرفته می‌شوند. .RE .PP این پنجرهٔ محاوره‌ای همچنین چک‌باکس‌هایی را برای موارد زیر فراهم می‌کند: .RS 2 .TP 2 - جستجو به سمت عقب؛ .TP - تطابق حساس به بزرگی و کوچکی حروف (حالت پیش‌فرض نادیده گرفتن بزرگی و کوچکی است، یعنی رشتهٔ جستجوی .I Test با هر دو رشتهٔ .I test و .I TEST در فایل DVI تطابق خواهد داشت)؛ .TP - نادیده گرفتن شکست‌های خط و خط‌فاصله‌ها: این کار تمام خط‌فاصله‌های انتهای خطوط و نویسه‌های خط جدید پس از آن‌ها را حذف کرده، و تمام نویسه‌های خط جدید باقی‌مانده را با فاصلهٔ خالی جایگزین می‌کند. بنابراین کلمات خط‌فاصله‌دار در جستجو به عنوان یک کلمه ظاهر می‌شوند، و جستجو برای دو کلمه با یک فاصله در بین آن‌ها، کلماتی را که با یک شکست خط از هم جدا شده باشند نیز تطبیق می‌دهد. .br توجه داشته باشید که حذف خط‌فاصله ممکن است اثرات جانبی ناخواسته‌ای برای کلمات مرکب حاوی خط‌فاصله‌ای که پس از خط‌فاصله شکسته شده‌اند ایجاد کند، و جایگزینی خطوط جدید بر تفسیر عبارات منظم به شکل زیر تأثیر می‌گذارد: الگوی \fI.\fR با خطوط جدید نیز تطابق می‌یابد، و \fI^\fR و \fI$\fR دیگر با ابتدا و انتهای خطوط تطابق نخواهند داشت. (از آنجا که در حال حاضر گزینه‌ای برای خاموش کردن حالت حریصانهٔ \fI*\fR و \fI+\fR وجود ندارد، فعال کردن این گزینه معمولاً منجر به تطابق‌هایی می‌شود که طولانی‌تر از حد مورد نظر هستند.) .RE .PP تنظیمات فعلی چک‌باکس در فایل .I ~/.xdvirc ذخیره می‌شوند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".SH "پنجره چاپ (PRINT DIALOG)" پنجره محاوره‌ای چاپ به شما امکان می‌دهد همه صفحه‌ها، صفحه‌های نشانه‌گذاری‌شده (با کلیک یا کشیدن Mouse-2 در فهرست صفحه‌ها برای نشانه‌گذاری آن‌ها)، یا بازه‌ای از صفحه‌ها را چاپ کنید. توجه داشته باشید که شماره صفحه‌ها همواره به صفحه‌های فیزیکی اشاره دارند؛ بنابراین اگر از گزینه \(lquse TeX pages\(rq استفاده می‌کنید، ممکن است بخواهید آن را غیرفعال کنید تا تعیین شماره صفحه‌های درست آسان‌تر شود (یا با نشانه‌گذاری صفحاتی که باید چاپ شوند، به‌کلی از بروز این مشکل جلوگیری کنید). .PP مقدار فیلد متنی .B Printer از طریق سازوکار .B -o! به‌عنوان یک آرگومان تکی پس از «!» به .B dvips ارسال می‌شود. هرگونه آرگومان واردشده در فیلد .B Dvips options در فاصله‌های خالی (whitespace) تفکیک شده و به‌عنوان آرگومان‌های مجزا به dvips تحویل داده می‌شود. برای نمونه، اگر می‌خواهید فایل را به‌صورت ۲ صفحه در یک برگه (2-up) چاپ کنید، باید رشته زیر را در فیلد .B Printer وارد کنید: .RS 5 .nf .sp 1n \fIpsnup -2 -q | lpr -Plp\fP .sp 1n .fi .RE .PP چندین منبع برای سفارشی‌سازی رفتار و مقادیر پیش‌فرض پنجره چاپ وجود دارد: .TP .B dvipsPrinterString .TP .B dvipsOptionsString این منابع می‌توانند به‌ترتیب برای تعیین مقادیر پیش‌فرض فیلدهای متنی .B Printer و .B Dvips options استفاده شوند. اگر اندازه کاغذ در فایل DVI مشخص نشده باشد (مثلاً از طریق \eusepackage[dvips]{geometry} \- که روش ارجح است)، فیلد ورودی با مقدار فعلی گزینه خط فرمان/منبع اکس .BR paper مقداردهی اولیه می‌شود. به‌عنوان مثال، گزینه .I -paper a4r به گزینه‌های dvips به‌صورت .IR "-t a4 -t landscape" ترجمه می‌شود. توجه داشته باشید که هیچ بررسی انجام نمی‌شود که آیا dvips واقعاً این گزینه‌ها را پشتیبانی می‌کند یا خیر (اگر پشتیبانی نکند، آن‌ها را نادیده می‌گیرد)؛ در حال حاضر تمام گزینه‌هایی که xdvi به کار می‌برد توسط dvips پوشش داده نمی‌شوند. .TP .B dvipsHangTime .TP .B dvipsFailHangTime این منابع مدت‌زمانی (به میلی‌ثانیه) را مشخص می‌کنند که پنجره پیشرفت چاپ پس از پایان فرآیند .B dvips باز خواهد ماند. مقدار .B dvipsHangTime در صورتی اعمال می‌شود که فرآیند با موفقیت پایان یابد؛ .B dvipsFailHangTime نیز هنگامی استفاده می‌شود که فرآیند با خطا متوقف شود. مقادیر پیش‌فرض به‌ترتیب ۱٫۵ و ۵ ثانیه هستند. اگر هر دو مقدار منفی باشند، پنجره تا زمانی که توسط کاربر بسته نشود باز می‌ماند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "پنجره ذخیره (SAVE DIALOG)" این پنجره به شما امکان می‌دهد تمام یا صفحه‌های انتخاب‌شده/نشانه‌گذاری‌شده در فایل DVI جاری را ذخیره کنید. شما می‌توانید در یکی از قالب‌های زیر ذخیره‌سازی را انجام دهید: .RS 2 .TP 2 - قالب PostScript (از .B dvips برای تبدیل فایل DVI به یک فایل PostScript استفاده می‌کند، درست مانند زمان چاپ روی یک فایل PostScript). .TP - قالب PDF (ابتدا از .B dvips برای تبدیل فایل DVI به یک فایل PostScript استفاده کرده، سپس با استفاده از .B ps2pdf فایل PostScript را به PDF تبدیل می‌کند). .TP - متن ساده در کدگذاری ISO-8859-1 یا UTF-8. مورد دوم نویسه‌های خاص بیشتری از LaTeX مانند حالت ریاضی را حفظ می‌کند. با این حال توجه داشته باشید که تنها تعداد اندکی از نمادهای ریاضیاتی LaTeX می‌توانند به‌درستی به‌صورت متن نمایش داده شوند؛ بنابراین این ویژگی برای اسناد متنی ساده بهترین کارایی را دارد. اگر نویسه‌ای در مجموعه نویسه انتخابی قابل نمایش نباشد، با «\e» و به دنبال آن کد شانزده‌شانزدهی (هگزادسیمال) نویسه جایگزین می‌شود. اگر نویسه‌ای اصلاً شناسایی نشود، با «?» جایگزین خواهد شد. .RE .PP برنامه‌های مورد استفاده برای تبدیل به PostScript و PDF می‌توانند به‌ترتیب از طریق گزینه‌های خط فرمان یا منابع اکس .BR -dvipspath / .dvipsPath و .BR -ps2pdfpath / .ps2pdfPath سفارشی‌سازی شوند؛ برای جزئیات بیشتر به شرح این گزینه‌ها در بخش‌های بالاتر مراجعه کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "حالت‌ها (MODES)" فشردن کلید .B Ctrl-m [\fBswitch-mode()\fR] بین سه حالت مختلف نگاشت کلیدهای ماوس جابه‌جا می‌شود، که همچنین می‌توان آن را از طریق منوی .B Modes فعال کرد (در Motif، این یک زیرمنو از منوی .B Options تحت عنوان .BR "Mouse Mode" است). حالت پیش‌فرض در زمان راه‌اندازی می‌تواند از طریق منبع اکس .B mouseMode یا گزینه خط فرمان .BR \-mousemode تنظیم شود. حالت راه‌اندازی پیش‌فرض Magnifier Mode است. .PP .B نکته: این حالت‌ها با تغییر دادن کنش .I magnifier() پیاده‌سازی شده‌اند. در صورتی که .B Mouse-1 برای دنباله‌ای از کنش‌ها سفارشی‌سازی شده باشد که شامل کنش magnifier() نیست، تغییر حالت کار نخواهد کرد. .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B "حالت ذره‌بین (Magnifier Mode)" در این حالت، دکمه‌های ۱ تا ۵ ماوس پنجره شناور «ذره‌بین» را باز می‌کنند که تصویری کوچک‌نشده (در اندازه اصلی) از صفحه را (یعنی تصویری با تفکیک‌پذیری تعیین‌شده توسط گزینه/منبع اکس .B pixels یا .BR mfmode ) در اندازه‌های گوناگون نمایش می‌دهد. هنگامی که ذره‌بین حرکت داده می‌شود، درجه‌بندی‌های کوچک خط‌کش‌مانندی در لبه‌های ذره‌بین نمایش داده می‌شوند (مگر آنکه منبع اکس .B delayRulers روی false تنظیم شده باشد، که در این صورت نشانه‌های درجه‌بندی همواره نمایش می‌یابند). واحد درجه‌بندی‌ها توسط منبع اکس .B tickUnits تعیین می‌شود (پیش‌فرض mm است). این واحد را می‌توان در زمان اجرا از طریق کنش .BR switch-magnifier-units() تغییر داد که به‌طور پیش‌فرض به کلید .RB ` t ' اختصاص داده شده است (برای جزئیات بیشتر درباره واحدهای موجود، شرح آن کلید و کنش switch-magnifier-units() را ببینید). .br طول نشانه‌های درجه‌بندی را می‌توان از طریق منبع اکس .B tickLength تغییر داد (پیش‌فرض ۴ است). مقدار صفر یا منفی نمایش نشانه‌ها را غیرفعال می‌سازد. .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .B "حالت انتخاب متن (Text Selection Mode)" این حالت به شما امکان می‌دهد با نگه داشتن کلید .B Mouse-1 و حرکت دادن ماوس، ناحیه‌ای مستطیلی از متن را در فایل DVI انتخاب کنید. متن در انتخاب اولیه (primary selection) اکس قرار می‌گیرد تا بتوان آن را طبق معمول با .B Mouse-2 در دیگر برنامه‌های X چسباند (paste کرد). .br اگر xdvi به همراه پشتیبانی از locale، .I nl_langinfo() و .I iconv کامپایل شده باشد، متن انتخاب‌شده به مجموعه نویسه locale جاری تبدیل می‌شود (برای مشاهده فهرستی از تنظیمات locale موجود در سیستم خود، خروجی دستور .B locale -a را بررسی کنید). اگر .I nl_langinfo() در دسترس نباشد اما .I iconv موجود باشد، می‌توانید کدگذاری ورودی .I iconv را از طریق منبع اکس .I textEncoding مشخص کنید (برای دیدن فهرست کدگذاری‌های معتبر، خروجی .B iconv -l را ببینید). اگر پشتیبانی از .I iconv موجود نباشد، تنها کدگذاری‌های .I ISO-8859-1 و .I UTF-8 پشتیبانی می‌شوند (این نام‌ها به بزرگ و کوچکی حروف حساس نیستند). .br توجه داشته باشید که UTF-8 تنها کدگذاری‌ای است که می‌تواند تمام نویسه‌های یک فایل DVI (مانند نمادهای ریاضی) را ارائه دهد. در صورت فعال بودن ISO-8859-1، نویسه‌هایی که قابل نمایش نیستند با «\e» و به دنبال آن کد شانزده‌شانزدهی نویسه جایگزین می‌شوند. برای سایر کدگذاری‌ها، چنین نویسه‌هایی ممکن است باعث نمایش پیام‌های خطای iconv شوند. اگر نویسه‌ای اصلاً شناسایی نشود، با «?» جایگزین می‌شود. .br جهت استخراج بخش‌های بزرگ‌تری از متن، می‌توانید به‌جای این کار، صفحات انتخاب‌شده یا کل فایل را در قالب متنی از طریق منوی .B File > Save as ... ذخیره کنید. .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP .B "حالت خط‌کش (Ruler Mode)" این حالت روشی ساده برای اندازه‌گیری فاصله‌ها در صفحه فراهم می‌کند. .br هنگامی که این حالت فعال می‌شود، مکان‌نمای موشواره به یک علامت بعلاوهٔ باریک تبدیل می‌شود، و یک خط‌کش صلیبی‌شکل بزرگ‌تر با رنگ برجسته‌سازی در محل موشواره رسم می‌گردد. این خط‌کش فاقد واحدهای مشخص روی خود است؛ در عوض، فاصلهٔ فعلی بین خط‌کش و مکان‌نمای موشواره به‌طور پیوسته در سطر وضعیت (statusline) چاپ می‌شود. .br هنگام فعال‌سازی حالت خط‌کش، خط‌کش در ابتدا به موشواره متصل است و می‌توان آن را جابه‌جا کرد. سپس می‌توان با کلیک روی .BR Mouse-1 آن را در مکانی ثابت قرار داد. پس از آن، مکان‌نمای موشواره را می‌توان برای اندازه‌گیری فاصلهٔ افقی .RI ( dx )، عمودی .RI ( dy ) و مستقیم (کوتاه‌ترین) .RI ( dr ) بین نقطهٔ مرکزی خط‌کش و موشواره حرکت داد. .br کلیک دوبارهٔ .B Mouse-1 خط‌کش را به موقعیت فعلی موشواره منتقل می‌کند، و پایین نگه‌داشتن .B Mouse-1 خط‌کش را جابه‌جا خواهد کرد. .br در حالت خط‌کش، کلیدهای میانبر ویژهٔ زیر، کلیدهای پیش‌فرض را گسترش داده یا جایگزین آن‌ها می‌شوند: .RS 7 .TP 7 .B o .RB [ ruler-snap-origin() ] خط‌کش را به مختصات مبدأ (0,0) بازمی‌گرداند. .TP .B t \fR[جایگزین \fBswitch-magnifier-units()\fP] جابه‌جایی بین واحدهای مختلف خط‌کش، که می‌توان آن‌ها را با منبع X به نام .B tickUnits مشخص کرد (به‌طور پیش‌فرض `mm'). .TP .B P \fR[جایگزین \fBdeclare-page-number()\fP] چاپ فاصله‌های نمایش‌داده‌شده در سطر وضعیت بر روی خروجی استاندارد. .RE .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "نوار ابزار (TOOLBAR (Motif only))" نوار ابزار Motif را نیز می‌توان سفارشی‌سازی کرد. فایل XPM استفاده‌شده برای شمایل‌های نوار ابزار را می‌توان از طریق منبع .BR toolbarPixmapFile مشخص کرد، که باید شامل نام فایلی باشد که بتوان آن را در یکی از متغیرهای .B XFILESEARCHPATH یا .B XDVIINPUTS یافت (برای اطلاعات بیشتر در مورد این متغیرها، بخش .B FILE SEARCHING در زیر را ببینید). .B Xdvi تلاش خواهد کرد تا این pixmap را به‌صورت افقی به .I n تکه تقسیم کند، که در آن پهنای هر تکه به اندازهٔ ارتفاع pixmap است و به عنوان تصویری در نظر گرفته می‌شود برای دکمهٔ نوار ابزار .IR n . این بدان معناست که هر شمایل باید مربع باشد، و کل pixmap باید دارای پهنای \fIn\fR x \fIh\fR باشد اگر \fIh\fR ارتفاع pixmap باشد. .PP منبع .B toolbarTranslations می‌تواند برای نگاشت شمایل‌ها/دکمه‌ها به کنش‌های مشخص به کار رود. این منبع باید شامل رشته‌ای باشد که با نویسه‌های خط جدید از هم جدا شده‌اند، مشابه منابع .B mainTranslations و .BR menuTranslations . هر خط باید شامل تعریف فاصله‌گذار (spacer) یا تعریف شمایل (icon) باشد: .PP تعریف فاصله‌گذار رشته‌ای به صورت \fBSPACER(\fIn\fB)\fR است، که در آن .I n تعداد پیکسل‌هایی است که به عنوان جداکننده تا دکمهٔ بعدی درج می‌شود. .PP تعریف شمایل فهرستی جداشده با دونقطه (:) است که شامل عناصر زیر می‌باشد: .RS 2 .TP 2 .SB \- نمایهٔ یک شمایل در فایل pixmap (شروع از صفر)؛ .TP .SB \- یک رشتهٔ راهنمای ابزار طولانی، که در ناحیهٔ وضعیت نمایش می‌یابد؛ .TP .SB \- یک رشتهٔ راهنمای ابزار کوتاه، که به صورت بالاپر (popup) نمایش می‌یابد؛ .TP .SB \- دنباله‌ای از کنش‌ها که هنگام فشرده‌شدن دکمهٔ نوار ابزار مربوطه انجام می‌شوند. .RE .PP برای روشن‌تر شدن این موضوع، مقدار پیش‌فرض .B toolbarTranslations به صورت زیر است: .RS 5 .nf .ft 3 .sp 1n xdvi.toolbarTranslations: \e SPACER(5)\en\e 0:Open a new document (Key\e\e: Ctrl-f):\e Open file:select-dvi-file()\en\e SPACER(10)\en\e 1:Reread this document (Key\e\e: R):\e Reread file:reread-dvi-file()\en\e SPACER(10)\en\e 2:Go to the first page of this document (Key\e\e: 1g):\e Go to first page:goto-page(1)\en\e 3:Go to the previous page of this document (Key\e\e: p):\e Go to previous page:back-page(1)\en\e 4:Go to the next page of this document (Key\e\e: n):\e Go to next page:forward-page(1)\en\e 5:Go to the last page of this document (Key\e\e: g):\e Go to last page:goto-page()\en\e SPACER(10)\en\e 6:Enlarge the display (Key\e\e: Ctrl-+):Zoom in:\e set-shrink-factor(+)\en\e 7:Shrink the display (Key\e\e: Ctrl--):Zoom out:\e set-shrink-factor(-)\en\e SPACER(10)\en\e 8:Jump back to the previous hyperlink (Key\e\e: B):\e Back hyperlink:htex-back()\en\e SPACER(10)\en\e 10:Print this document:Print:print()\en\e SPACER(10)\en\e 11:Toggle marks for odd pages (Key\e\e: 1m):\e Toggle odd:toggle-mark(1)\en\e 12:Toggle marks for even pages (Key\e\e: 2m):\e Toggle even:toggle-mark(2)\en\e 13:Toggle mark for current page (Key\e\e: 2m):\e Toggle current:toggle-mark()\en\e 14:Unmark all pages (Key\e\e: 0m):\e Unmark all:toggle-mark(0)\en\e SPACER(10)\en\e 18:Display fonts darker (Key\e\e: Alt-Ctrl-+):\e Fonts darker:change-density(5)\en\e 19:Display fonts lighter (Key\e\e: Alt-Ctrl--):\e Fonts lighter:change-density(-5)\en .sp 1n .ft .fi .RE .PP هنگامی که موشواره برای مدت معینی روی یک دکمهٔ نوار ابزار باقی بماند، پنجرهٔ «راهنمای ابزار» (tooltip) نمایش داده می‌شود، که کارایی دکمه را با استفاده از .I رشتهٔ راهنمای ابزار کوتاه از منبع بالا شرح می‌دهد. هم‌زمان، .I رشتهٔ راهنمای ابزار طولانی در سطر وضعیت نمایش داده می‌شود. ظاهر و رفتار این راهنماهای ابزار را می‌توان از طریق منابع زیر سفارشی‌سازی کرد: .TP .B tipShell.background رنگ پس‌زمینهٔ پنجرهٔ راهنمای ابزار. .TP .B tipShell.fontSet قلم مورد استفاده برای راهنمای ابزار. .TP .B tipShell.waitPeriod مدت زمانی (به میلی‌ثانیه) که نشانگر موشواره باید روی دکمه قرار گیرد تا راهنمای ابزار نمایش داده شود. برای جلوگیری کامل از نمایش راهنماهای ابزار، آن را روی یک مقدار منفی تنظیم کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".SH "طیف خاکستری و نقشه‌های رنگ (GREYSCALING AND COLORMAPS)" قابلیت هموارسازی لبه‌ها با مقیاس خاکستری (greyscale anti-aliasing) در .B xdvi در صورتی که نمایشگر رنگ‌های کافی در دسترس نداشته باشد، به بهترین شکل عمل نخواهد کرد. این مسئله می‌تواند هنگامی رخ دهد که برنامه‌های دیگر بیشتر نقشهٔ رنگ (colormap) را اشغال کرده باشند (حتی اگر آیکون یا کمینه شده باشند). در صورت وقوع این حالت، .B xdvi پیام خطایی چاپ کرده و گزینهٔ .B -copy را فعال می‌کند. این کار منجر به نمایش نادرست نویسه‌های با چاپ مجدد روی یکدیگر (overstrike) خواهد شد؛ همچنین اگر تعداد رنگ‌های موجود بسیار اندک باشد، ممکن است به کیفیت پایین نمایش بیانجامد. .PP معمولاً این مشکل در نمایشگرهایی رخ می‌دهد که هشت بیت از حافظهٔ ویدئویی را به هر پیکسل اختصاص می‌دهند. برای مشاهدهٔ اینکه نمایشگر شما از چند بیت در هر پیکسل استفاده می‌کند، در یک پنجرهٔ .B xterm دستور .B xwininfo را تایپ کنید، و سپس هنگام درخواست، با موشواره روی پنجرهٔ ریشه (root window) کلیک نمایید. مدخل ``Depth:'' مشخص خواهد کرد چه تعداد بیت به هر پیکسل اختصاص یافته است. .PP نمایشگرهایی که از دست‌کم ۱۵ بیت در هر پیکسل استفاده می‌کنند، معمولاً جلوه‌های بصری .B TrueColor هستند که این مشکل را ندارند، چرا که نقشهٔ رنگ آن‌ها به طور دائم اختصاص یافته و در دسترس همهٔ برنامه‌ها است. (کلاس بصری نیز توسط .BR xwininfo نمایش داده می‌شود.) برای اطلاعات بیشتر دربارهٔ کلاس‌های بصری، به مستندات سامانه پنجره X مراجعه کنید. .PP بنابراین برای برطرف کردن این مشکل، می‌توان (الف) سیستم را با بیت‌های بیشتری در هر پیکسل اجرا کرد (این امر ممکن است نیازمند افزایش حافظهٔ ویدئویی یا تعویض کارت گرافیک باشد)، (ب) برنامه‌های دیگری که بخش عمده‌ای از نقشهٔ رنگ را مصرف می‌کنند بست و سپس .BR xdvi را دوباره اجرا کرد، یا (ج) .B xdvi را با گزینهٔ .B \-install اجرا نمود. .PP یکی از برنامه‌هایی که اغلب علت این مشکل است .BR Netscape می‌باشد. در این مورد، دو راهکار دیگر برای چاره‌جویی وضعیت وجود دارد. می‌توان دستور .RB `` "netscape -install" '' را اجرا کرد تا .B Netscape یک نقشهٔ رنگ خصوصی را نصب کند. این کار می‌تواند هنگامی که موشواره به پنجرهٔ دیگری منتقل می‌شود، باعث تغییرات عجیب در رنگ‌ها شود. یا می‌توان دستور .RB `` "netscape -ncols 220" '' را اجرا کرد تا .B Netscape به تعداد رنگ کمتری محدود شود. تعداد کمتر تضمین می‌کند که برنامه‌های دیگر رنگ‌های بیشتری در دسترس داشته باشند، اما کیفیت رنگ را در پنجرهٔ .B Netscape کاهش خواهد داد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "مدیریت اشکال پست‌اسکریپت (HANDLING OF POSTSCRIPT FIGURES)" .B Xdvi می‌تواند فایل‌های Encapsulated PostScript (EPS) گنجانده‌شده در فایل .I dvi را نمایش دهد. این‌گونه فایل‌ها ابتدا در همان پوشه‌ای که فایل .I dvi در آن قرار دارد جستجو می‌شوند، و سپس با استفاده از قوانین عادی .B Kpathsea جستجو می‌گردند. با این وجود، یک استثنا وجود دارد: اگر نام فایل با یک بک‌تیک .RB ( ` ) شروع شود، نویسه‌های باقی‌مانده در نام فایل به عنوان یک دستور شل (اغلب .BR zcat ) در نظر گرفته شده و اجرا می‌شوند؛ سپس خروجی استاندارد آن برای تفسیر به عنوان PostScript ارسال می‌گردد. از آنجا که اجرای دستورات دلخواه شل با مجوزهای کاربر یک ریسک امنیتی بسیار بزرگ است، ارزیابی این دستورات بک‌تیک به صورت پیش‌فرض غیرفعال شده است. فعال‌سازی آن باید از طریق گزینهٔ خط فرمان .B \-allowshell انجام گیرد. .B نکته: هرگز نباید هنگام مشاهدهٔ اسنادی که خودتان کامپایل نکرده‌اید از این گزینه استفاده کنید. نویسه‌های ویژهٔ بک‌تیک برای غیرفشرده‌سازی فایل‌های PostScript فشرده با gzip لازم نیستند، زیرا .B xdvi اگر نام فایل با .I .eps.gz یا .I .eps.Z پایان یابد (و بایت‌های آغازین فایل نشان دهند که فایل واقعاً فشرده شده است)، می‌تواند این کار را بی‌درنگ در هنگام اجرا انجام دهد. این روش نسبت به رویکرد بک‌تیک هم امن‌تر و هم منعطف‌تر است، زیرا قوانین پیش‌فرض جستجوی فایل برای چنین نام‌هایی نیز اعمال خواهند شد. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "قلم‌های TYPE 1 (TYPE 1 FONTS)" با استفاده از FreeType (نسخه ۲)، .B xdvi می‌تواند قلم‌های PostScript Type 1 را مستقیماً، بدون نیاز به عبور از مسیر قلم‌های پیکسلی (pk) متعلق به \*(Te\& رندر کند. مزیت این امر این است که تنها باید یک اندازه از هر قلم روی دیسک ذخیره شود. مگر اینکه از گزینهٔ .B -notype1fonts استفاده شود، .B xdvi تلاش خواهد کرد هر قلمی را با استفاده از FreeType رندر کند. تنها به عنوان جایگزین نهایی (fallback)، برنامه‌ای خارجی (مانند .BR mktexpk که خود ممکن است ابزارهایی مانند .B ps2pk یا .BR gsftopk ) را فراخوانی کند، اجرا خواهد شد تا قلم پیکسلی را از منبع Type 1 تولید نماید. رندر مستقیم قلم‌های .B Computer Modern باید بدون نیاز به تنظیمات اضافی کار کند، در حالی که سایر قلم‌های Type 1 مانند ۳۵ قلم استاندارد PostScript مقیم در چاپگرها ممکن است نیاز به در دسترس قرار گرفتن برای استفاده در .BR xdvi داشته باشند، مگر آنکه مدیر سیستم یا توزیع TeX شما پیشاپیش این کار را انجام داده باشد (که به عنوان نمونه در سیستم‌های کنونی TeX Live چنین است). برای ۳۵ قلم مقیم PostScript، در صورت نیاز .B xdvik با استفاده از .B Fontmap ارائه‌شده به همراه .BR Ghostscript جستجو خواهد کرد. همچنین، توزیع .B xdvik با ابزاری به نام .B t1mapper عرضه می‌شود تا این قلم‌ها را برای xdvi در دسترس قرار دهد؛ برای جزئیات استفاده به صفحهٔ راهنمای t1mapper(1) مراجعه کنید. با این وجود، احتمالاً این برنامه در آینده حذف خواهد شد، زیرا به احتمال قوی دیگر نیازی به آن نیست. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".SH "دستورات ویژه (کلیات) (SPECIALS (GENERALLY))" هر یک از دستورات ویژه (specials) مورد استفاده توسط .B xdvi می‌توانند با نویسه‌های .RB `` xdvi: '' آغاز شوند. انجام این کار رفتار دستور ویژه را تحت .B xdvi تغییر نمی‌دهد، اما به سایر راه‌اندازهای dvi (مانند dvips) اعلام می‌کند که آن دستور ویژه را نادیده بگیرند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "دستورات ویژه مبدأ (SOURCE SPECIALS)" برخی از پیاده‌سازی‌های \*(Te\& یا بسته‌های ماکرو این امکان را فراهم می‌کنند که به‌اصطلاح «دستورات ویژه مبدأ» (source specials) به‌طور خودکار درون یک فایل DVI گنجانده شوند. این دستورات شامل شماره خط، در مواردی شماره ستون، و نام فایل مبدأ .tex هستند. این قابلیت پرش از یک فایل .dvi به مکان متناظر در مبدأ .tex و بالعکس را امکان‌پذیر می‌سازد (که «جستجوی معکوس» نیز نامیده می‌شود \- پرش از فایل DVI به فایل TeX تحت عنوان «جستجوی وارون» (reverse search) و پرش از فایل TeX به فایل DVI با عنوان «جستجوی مستقیم» (forward search) شناخته می‌شود). .P برای قابل استفاده بودن در .BR xdvi ، دستورات ویژه مبدأ در فایل .I dvi باید یکی از قالب‌های زیر را داشته باشند: .RS 5 .nf .sp 1n \fBsrc:\fP\fIline\fP[ ]\fIfilename\fP \fBsrc:\fP\fIline\fP\fB:\fP\fIcol\fP[ ]\fIfilename\fP \fBsrc:\fP\fIline\fP \fBsrc:\fP\fIline\fP\fB:\fP\fIcol\fP \fBsrc::\fP\fIcol\fP .sp 1n .fi .RE اگر .I filename یا .I line حذف شوند، تازه‌ترین مقادیر استفاده می‌شوند. نخستین دستور ویژه مبدأ در هر صفحه باید یکی از دو حالت اول باشد، زیرا مقادیر پیش‌فرض بین صفحات به ارث برده نمی‌شوند. .sp برای درج چنین دستورات ویژه مبدأ در فایل DVI، به یک پیاده‌سازی \*(Te\& نیاز خواهید داشت که سوییچ مناسبی ارائه دهد (مانند .IR \-src ) یا یک بسته ماکرو (مانند .I srcltx.sty یا .IR srctex.sty ، موجود در CTAN:macros/latex/contrib/supported/srcltx/). .sp برای جستجوی وارون، ترکیب کلیدهای .I Ctrl-Mouse 1 باعث می‌شود xdvi یک ویرایشگر (مقدار تعیین‌شده در گزینه خط فرمان .IR \-editor ) را به همراه فایل و شماره خط مبدأ .tex باز کند. برای اطلاعات بیشتر و نمونه تنظیمات، به توضیحات گزینه .I \-editor مراجعه کنید. .P برای جستجوی مستقیم، .B xdvi دارای گزینه .I \-sourceposition است که باعث می‌شود .B xdvi به صفحه متناظر با خط داده‌شده (یا نزدیک‌ترین خط دارای دستور ویژه مبدأ) از فایل مشخص‌شده در فایل DVI بپرد و ناحیه یافت‌شده را برجسته کند. برای جزئیات بیشتر به توضیحات گزینه .I \-sourceposition مراجعه فرمایید. .PP اطلاعات بیشتر درباره پیکربندی ویرایشگرهای گوناگون برای استفاده با دستورات ویژه مبدأ را می‌توانید در نشانی زیر بیابید: .RS 5 .nf .sp 1n http://xdvi.sourceforge.net/inverse-search.html .sp 1n .fi .RE .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "دستورات ویژه اندازه کاغذ (PAPERSIZE SPECIALS)" .B xdvi دستورات ویژه‌ای را جهت تعیین اندازه کاغذ سند می‌پذیرد. این دستورات ویژه باید به شکل زیر باشند: .RS 5 .nf .sp 1n \fBpapersize=\fP[\fB*\fP]\fIwidth\fP,\fIheight\fP .sp 1n .fi .RE .PP که در آن .I width و .I height به‌ترتیب پهنا و ارتفاع کاغذ را مشخص می‌کنند. هر یک از این مقادیر باید به صورت یک عدد اعشاری ظاهر شوند که در پی آن یکی از اختصارات دوحرفی یکاهای پذیرفته‌شده توسط \*(Te\& می‌آید .RB ( pt ، .BR pc ، .BR in ، .BR bp ، .BR cm ، .BR mm ، .BR dd ، .BR cc ، یا .BR sp ). اگر یک علامت ستاره .RB ( * ) درست قبل از پهنا قرار گیرد، اندازه‌گیری‌ها به ابعاد سند ارجاع داده می‌شوند (مثلاً .B pt در مقایسه با .BR truept ). این امر به یک بسته ماکرو امکان می‌دهد تا اندازه صفحه را متناسب با اجزای سند تغییر دهد؛ به عنوان مثال: .RS 5 .ft 3 .nf .sp 1n \especial{xdvi: papersize=*\enumber\ewd\emybox sp, \enumber\eht\emybox sp} .sp 1n .ft .fi .RE .PP به‌جز علامت ستاره، این قالب کاملاً با .B dvips سازگار است. .P آخرین دستور ویژه .B papersize در یک صفحه، اندازه آن صفحه را تعیین می‌کند. اگر چنین دستور ویژه‌ای در صفحه‌ای معین وجود نداشته باشد، تازه‌ترین .B papersize استفاده می‌شود؛ یا اگر در هیچ‌یک از صفحات پیشین نیز دستور ویژه .B papersize وجود نداشته باشد، مقدار منبع .B paper (یا گزینه .B \-paper در خط فرمان) به کار گرفته خواهد شد. بدین ترتیب اندازه کاغذ ممکن است برای صفحات مختلف فایل .I dvi متفاوت باشد. .P اگر مقدار منبع .B paper (یا گزینه خط فرمان .BR \-paper ) با علامت علامت جمع .RB (` + ') آغاز شود، تمام دستورات ویژه .B papersize موجود در فایل .I dvi نادیده گرفته می‌شوند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".SH "دستورهای ویژه رنگ (COLOR SPECIALS)" دستورهای ویژه رنگ (color specials) پشتیبانی‌شده توسط .B xdvi مشابه مواردی است که توسط .BR dvips پشتیبانی می‌شوند، به جز اینکه مشخصات رنگ دائمی PostScript (مانند مثال .B AggiePattern در مستندات .BR dvips ) پشتیبانی نمی‌شود. همچنین محدودیت‌هایی به دلیل نحوه پیاده‌سازی روتین‌های رسم xdvi وجود دارد؛ به عنوان مثال ماکروهای .B \ecolorbox و .B \efcolorbox با .BR xdvi کار نمی‌کنند. برای اطلاعات بیشتر درباره این محدودیت‌ها، بخش «محدودیت‌ها (LIMITATIONS)» در ادامه را ببینید. .B Xdvi از همان فهرست نام‌های رنگی که .B dvips پشتیبانی می‌کند، پشتیبانی می‌نماید، یعنی: .P .BR Apricot , .BR Aquamarine , .BR Bittersweet , .BR Black , .BR Blue , .BR BlueGreen , .BR BlueViolet , .BR BrickRed , .BR Brown , .BR BurntOrange , .BR CadetBlue , .BR CarnationPink , .BR Cerulean , .BR CornflowerBlue , .BR Cyan , .BR Dandelion , .BR DarkOrchid , .BR Emerald , .BR ForestGreen , .BR Fuchsia , .BR Goldenrod , .BR Gray , .BR Green , .BR GreenYellow , .BR JungleGreen , .BR Lavender , .BR LimeGreen , .BR Magenta , .BR Mahogany , .BR Maroon , .BR Melon , .BR MidnightBlue , .BR Mulberry , .BR NavyBlue , .BR OliveGreen , .BR Orange , .BR OrangeRed , .BR Orchid , .BR Peach , .BR Periwinkle , .BR PineGreen , .BR Plum , .BR ProcessBlue , .BR Purple , .BR RawSienna , .BR Red , .BR RedOrange , .BR RedViolet , .BR Rhodamine , .BR RoyalBlue , .BR RoyalPurple , .BR RubineRed , .BR Salmon , .BR SeaGreen , .BR Sepia , .BR SkyBlue , .BR SpringGreen , .BR Tan , .BR TealBlue , .BR Thistle , .BR Turquoise , .BR Violet , .BR VioletRed , .BR White , .BR WildStrawberry , .BR Yellow , .BR YellowGreen , .BR YellowOrange . .P توجه داشته باشید که این نام‌ها به بزرگی و کوچکی حروف حساس هستند. .P مستندات بسته .B color در La\*(Te\& جزئیات بیشتری درباره نحوه استفاده از این دستورهای ویژه با La\*(Te\& ارائه می‌دهد؛ برای شرح تفصیلی نحو و معناشناسی دستورهای ویژه رنگ، مستندات .B dvips را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "سیگنال‌ها (SIGNALS)" هنگامی که .B xdvi یک سیگنال .SB SIGUSR1 دریافت می‌کند، فایل .I dvi را مجدداً بازخوانی می‌کند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "محیط (ENVIRONMENT)" .B Xdvik برای جستجوی فایل‌های قلم از همان متغیرهای محیطی و الگوریتم‌هایی استفاده می‌کند که \*(Te\& و متعلقات آن به کار می‌برند. برای شرح تفصیلی این موارد، مستندات کتابخانه .BR Kpathsea ، یعنی .BR kpathsea.dvi را ببینید. .PP علاوه بر این، .B xdvik متغیرهای زیر را می‌پذیرد: .TP .SB DISPLAY مشخص می‌کند از کدام ترمینال نمایش گرافیکی استفاده شود. .TP .SB KPATHSEA_DEBUG ردیابی جستجوهای .BR Kpathsea ؛ برای ردیابی کامل آن را روی .B -1 (= روشن بودن همه بیت‌ها) تنظیم کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .SB EXTENSIONMAPS فهرستی از فایل‌ها که برای ورودی‌های انواع mime (مانند Acrobat Reader) جستجو می‌شوند. مدخل‌های پیشین در یکی از این فایل‌ها بر مدخل‌های پسین اولویت دارند. اگر این متغیر تنظیم نشده باشد، مسیر پیش‌فرض زیر استفاده می‌شود: .RS 7 .nf .ft 3 .sp 1n $HOME/.mime.types:/etc/mime.types:\e /usr/etc/mime.types:/usr/local/etc/mime.types .sp 1n .ft .fi .RE .TP .SB MAILCAPS فهرستی از فایل‌ها برای جستجوی مدخل‌های mailcap، طبق تعریف RFC 1343. برای شرح تفصیلی قالب فایل mailcap به این RFC یا صفحه راهنمای .BR mailcap (4) مراجعه کنید. در حال حاضر تنها ویژگی‌های mailcap زیر پشتیبانی می‌شوند: .RS 7 .TP 7 .BI test= command این مدخل تنها زمانی استفاده می‌شود که .I command بتواند از طریق فراخوانی .B system() اجرا شود و مقدار بازگشتی فراخوانی system() برابر با 0 (موفقیت) باشد. رشته .I command ممکن است شامل رشته قالب‌بندی .IR %s باشد که با نام فایل جایگزین خواهد شد. .TP .B needsterminal اگر از این پرچم استفاده شود، دستور با افزودن پیشوند .RI `` "xterm -e "'' به رشته دستور، در یک پنجره جدید xterm اجرا خواهد شد. .RE .PP .RS 7 تمام فیلدهای دیگر در مدخل mailcap توسط xdvi نادیده گرفته می‌شوند. مدخل‌های پیشین در یکی از این فایل‌ها بر مدخل‌های پسین اولویت دارند. اگر متغیر تعریف نشده باشد، مسیر پیش‌فرض زیر استفاده می‌شود: .RS 4 .nf .ft 3 .sp 1n $HOME/.mailcap:/etc/mailcap:/usr/etc/mailcap:\e /usr/local/etc/mailcap .sp 1n .ft .fi .RE .br به دلایل امنیتی، برخی از نویسه‌های خاص (مانند ( ) ` \e ;) پیش از ارسال به .BR system() در آرگومان گریز داده می‌شوند (escape می‌شوند). .RE .TP .SB BROWSER مرورگر وب مورد استفاده برای باز کردن پیوندهای خارجی (یعنی تمام نشانی‌های وب که با طرح‌واره .RI ` file: ' شروع نمی‌شوند و پیوندهای نسبی در فایل DVI محلی نیستند)، و برای باز کردن پیوندهایی که هیچ نمایشگری برای آن‌ها در فایل‌های .B mailcap مشخص نشده است را تعیین می‌کند. مقدار این متغیر فهرستی از دستورها است که با دونقطه از هم جدا شده‌اند. Xdvi هر یک از آن‌ها را به ترتیب امتحان می‌کند تا یکی از آن‌ها موفق شود (یعنی بلافاصله با وضعیت 0 بازنگردد). این قابلیت به شما امکان می‌دهد تا مرورگر دلخواه خود را در ابتدا، و مرورگرهای جایگزین را در انتها مشخص کنید. هر بار تکرار .I %s در این رشته با نشانی وب هدف جایگزین می‌شود؛ هر بار تکرار .I %% با یک .IR % تکی جایگزین می‌شود. اگر هیچ .I %s وجود نداشته باشد، رشته نشانی وب به عنوان یک آرگومان اضافی افزوده می‌شود. .br یک نمونه تنظیمات به این صورت است: .RS 7 .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""".TP 7 .SB "netscape -raise -remote 'openURL(%s,new-window)':xterm -e lynx %s:xterm -e wget %s:lynx %s:wget %s" .TP ببینید .TP .SB http://www.catb.org/~esr/BROWSER .PP برای جزئیات بیشتر درباره متغیر محیطی .B BROWSER . .RE .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .SB GS_LIB فهرستی از دایرکتوری‌های جداشده با دونقطه (:) برای جستجوی فایل‌های .B Fontmap و غیره، همان‌طور که برای Ghostscript استفاده می‌شود. این متغیر همان معنایی را دارد که هنگام اجرای Ghostscript دارد. در .BR xdvik ، هنگامی که فایل نگاشت (map file) نام فایلی را برای قلم مشخص نمی‌کند (که این مورد باید بسیار نادر باشد)، برای جستجوی فایل‌های قلم استفاده می‌شود. دستور .B gs \-h مقدار پیش‌فرضی را که Ghostscript استفاده می‌کند فهرست خواهد کرد. همچنین متغیر محیطی .SB XDVI_GS_LIB (در ادامه) را ببینید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .SB XDVI_GS_LIB این متغیر اثر مشابهی با .SB GS_LIB دارد اما تنها بر .BR xdvi تأثیر می‌گذارد. هنگامی از این متغیر استفاده کنید که می‌خواهید در زمان اجرای .BR xdvi ، مقدار متفاوتی را برای .SB GS_LIB به‌کار ببرید، اما هنگام اجرای Ghostscript از مقدار پیش‌فرض کامپایل‌شده یا مقداری دیگر استفاده کنید. اگر هر دو متغیر .SB GS_LIB و .SB XDVI_GS_LIB تنظیم شده باشند، آن‌گاه .B xdvi از .SB XDVI_GS_LIB استفاده می‌کند. برای استفاده از مقدار پیش‌فرض کامپایل‌شده در .B xdvi در عین حفظ توانایی تنظیم .SB GS_LIB برای استفاده با Ghostscript، می‌توانید .SB XDVI_GS_LIB را برابر با یک رشته خالی قرار دهید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .SB TMPDIR دایرکتوری مورد استفاده برای ذخیره فایل‌های موقتی که هنگام خارج کردن فایل‌های PostScript از حالت فشرده ایجاد می‌شوند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .SB XEDITOR دستور ویرایشگری را تعیین می‌کند که برای «جستجوی معکوس» (reverse search) در source special استفاده می‌شود، در صورتی که نه گزینه خط فرمان .I \-editor و نه منبع .I .editor مشخص نشده باشند. برای جزئیات در مورد قالب آن، توضیحات گزینه خط فرمان .I \-editor را ببینید. .TP .SB VISUAL ویرایشگری را برای باز شدن در یک پنجره xterm تعیین می‌کند، در صورتی که هیچ‌یک از .IR -editor ، .IR .editor ، یا .I XEDITOR مشخص نشده باشند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .SB EDITOR ویرایشگری را برای باز شدن در یک پنجره xterm تعیین می‌کند، در صورتی که هیچ‌یک از .IR -editor ، .IR .editor ، .I XEDITOR یا .I VISUAL مشخص نشده باشند. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP .SB WWWBROWSER منسوخ شده است؛ به‌جای آن از .B BROWSER استفاده کنید. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "محدودیت‌ها (LIMITATIONS)" .B xdvi بسیاری از انواع PostScript specials را که توسط .BR dvips پذیرفته می‌شوند قبول می‌کند، اما نه همه آن‌ها را. برای نمونه، بیشتر ویژه‌دستورهای (specials) تولیدشده توسط .B epsf و .BR psfig را می‌پذیرد. با این حال، از .B bop\-hook یا .BR eop\-hook پشتیبانی نمی‌کند، و همچنین اجازه نمی‌دهد دستورات PostScript بر رندر مواردی که PostScript نیستند تأثیر بگذارند (برای نمونه، مثال‌های «NEAT» و «A» چرخانده‌شده در راهنمای .BR dvips ). این محدودیت‌ها ناشی از طراحی .BR xdvi هستند؛ و به احتمال زیاد همواره باقی خواهند ماند. .PP ویژه‌دستورهای (specials) چرخش La\*(Te\&2e در حال حاضر پشتیبانی نمی‌شوند. .PP فایل‌های .B MetaPost حاوی متن گنجانده‌شده پشتیبانی نمی‌شوند. .PP مدیریت رنگ در .B xdvi از ماکروهای .B \ecolorbox و .B \efcolorbox پشتیبانی نمی‌کند؛ احتمال تغییر این موضوع در آینده نزدیک اندک است. این همچنین بدین معناست که برای نمونه، جدول‌های رنگی (مانند آنچه توسط بسته .I colortbl ایجاد می‌شود) ممکن است به نادرستی رندر شوند: متن در رنگ‌هایی متفاوت از رنگ پیش‌فرض پیش‌زمینه ممکن است نمایش داده نشود. هنگامی که صفحه مجدداً بازترسیم می‌شود (مثلاً پس از استفاده از ذره‌بین)، ممکن است رنگ پس‌زمینه سلول‌ها روی متن را بپوشاند..SH "فایل‌ها (FILES)" .TP .SB $HOME/.xdvirc فایلی شامل تمام تنظیماتی که کاربر از طریق کلیدها، منوی \(lqOptions\(rq، منوی \(lqModes\(rq در Xaw و کادرهای محاوره تغییر داده است و به عنوان منابع X نگهداری می‌شوند. این منابع، تنظیمات موجود در .BR $HOME/.Xdefaults را بازنویسی می‌کنند. در صورت استفاده از گزینهٔ .B \-q یا تنظیم منبع X با عنوان .BR noInitFile ، این فایل نادیده گرفته می‌شود. .TP .SB config.xdvi یک فایل پیکربندی اختیاری برای راه‌اندازی قلم‌های Type 1 که فایل‌های نگاشت به سبک .B dvips را به صورت ویژه برای .B xdvik مشخص می‌کند. در صورت استفاده، این فایل باید در دایرکتوری تعیین‌شده توسط متغیر محیطی .B TEXCONFIG وجود داشته باشد. قالب آن شبیه فایل‌های پیکربندی .BR dvips است، با این تفاوت که فقط برای یافتن نام فایل‌های نگاشت (دستورالعمل‌های .B p و .BR p+ ) پیمایش می‌شود. .SH "همچنین ببینید (SEE ALSO)" .BR X (1), .BR dvips (1), .BR mktexpk (1), .BR ps2pk (1), .BR gsftopk (1), .BR t1mapper (1), .BR mailcap (4), مستندات .BR Kpathsea ، .BR https://ctan.org/pkg/xdvi ، و صفحهٔ اصلی Xdvik در .BR http://xdvi.sourceforge.net . .SH "نویسندگان (AUTHORS)" Eric Cooper از CMU نسخه‌ای برای خروجی مستقیم به QVSS ایجاد کرد. توسط Bob Scheifler از MIT Laboratory for Computer Science برای X بازنویسی شد. توسط Mark Eichin از MIT SIPB برای X11 اصلاح شد. بهبودهای افزودهٔ دیگری نیز توسط افراد بسیاری انجام گرفته است. .PP نگه‌دارندهٔ کنونی نسخهٔ اصلی .B xdvi Paul Vojta از دانشگاه U.C. Berkeley است. .PP کد مربوط به گونهٔ xdvik توسط افراد بسیاری مشارکت شده است که نام آن‌ها در سراسر فایل‌های منبع پراکنده است. .PP برای به‌روزترین اطلاعات، لطفاً ببینید: .PP .B http://xdvi.sourceforge.net .PP لطفاً تمام باگ‌ها را به سامانهٔ ردیابی باگ SourceForge گزارش دهید: .PP .nf .B http://sourceforge.net/tracker/?func=add&group_id=23164&atid=377580 .PP