.\" t
.\"
.\" Copyright (c) 2007- Leon Bottou
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual. Otherwise check the web site
.\" of the Free Software Foundation at http://www.fsf.org.
.TH DJVIEW4 1 "10/11/2001" "DjVuLibre" "DjVuLibre"
.de SS
.SH \\0\\0\\0\\$*
..
.SH "نام (NAME)"
djview4 \- نمایشگر مستقل اسناد DjVu

.SH "خلاصه دستور (SYNOPSIS)"
.BI "djview4 [" "options" "] [" "argument" "]"

.SH "توضیحات (DESCRIPTION)"
نمایشگر مستقل برای فایل‌های DjVu.
از قابلیت‌های آن می‌توان به پیمایش اسناد،
بزرگ‌نمایی و حرکت روی تصویر صفحات،
تولید و نمایش بندانگشتی‌ها (thumbnails)،
نمایش ساختار درختی سند (outline)،
جستجوی کلمات خاص در لایه متنی پنهان سند،
رونوشت متن پنهان به حافظه موقت (clipboard)،
ذخیره صفحات و اسناد
به عنوان فایل‌های چندصفحه‌ای یکپارچه (bundled) یا غیرمستقیم (indirect)،
و چاپ صفحات و اسناد اشاره کرد.
این نمایشگر می‌تواند چندین صفحه را به طور هم‌زمان
با چیدمان کنار هم یا پیوسته نمایش دهد.

.SH "شناسه و گزینه‌های خط فرمان (COMMAND LINE ARGUMENT AND OPTIONS)"
این برنامه
می‌تواند به عنوان یک برنامه مستقل یا
به عنوان یک فرایند وابسته برای افزونه مرورگر DjVu یعنی
.BR nsdejavu
اجرا شود.
هنگام اجرا به عنوان یک برنامه مستقل،
شناسه خط فرمان
.I argument
می‌تواند یکی از موارد زیر باشد:
.IP "*" 3
نام فایل یک سند معتبر DjVu.
.IP "*" 3
نشانی
.SM URL
یک سند محلی DjVu به فرمت:
.IP "" 5
.BI "file:///" path "/" name.djvu "[?djvuopts&" keyword = value "&...]"
.IP "" 3
کروشه‌ها بخش‌های اختیاری
.SM URL
را مشخص می‌کنند.
گزینه‌های مختلف را می‌توان با نحوی مشابه شناسه‌های
.SM CGI
تعیین کرد.
مشخص کردن گزینه‌ها به این روش برای افزونه مرورگر بسیار مفید است
زیرا در آنجا شناسه خط فرمان وجود ندارد.
در مورد یک نمایشگر مستقل،
تمام گزینه‌ها را می‌توان به عنوان شناسه‌های خط فرمان مشخص کرد.
.IP "*" 3
نشانی
.SM URL
یک سند راه دور DjVu به فرمت:
.IP "" 5
.BI http:// host / path "/" name.djvu "[?djvuopts&" keyword = value "&...]"
.IP "" 5
.BI https:// host / path "/" name.djvu "[?djvuopts&" keyword = value "&...]"
.IP "" 3
مرور اسناد راه دور DjVu با نمایشگر مستقل
کارایی کمتری نسبت به استفاده از افزونه مرورگر دارد.
نمایشگر مستقل از سازوکارهای ذخیره‌سازی موقت (caching) و تنظیمات پروکسی مرورگر بهره‌مند نمی‌شود.
تنظیمات پروکسی برای نمایشگر مستقل را می‌توان به طور مستقل در کادر تنظیمات پیکربندی کرد.
.PP

فهرست گسترده‌ای از گزینه‌ها شناسایی می‌شوند.
بیشتر گزینه‌ها را می‌توان به عنوان شناسه خط فرمان که با نویسه معمول خط تیره
.BR "" "(" "-" ")"
آغاز می‌شود مشخص کرد،
یا از نحو شناسه‌های
.SM CGI
در
.SM URL
سند استفاده نمود.
با این حال، برخی گزینه‌ها تنها
به عنوان شناسه‌های خط فرمان معنا دارند.
سایر گزینه‌ها تنها هنگام اجرای نسخه
.SM X11
از برنامه
.BR djview4
شناسایی می‌شوند.

.SH "گزینه‌های خط فرمان (COMMAND LINE OPTIONS)"
گزینه‌های زیر تنها هنگامی که در خط فرمان مشخص شوند
معنا دارند.

.TP
.B "-help"
نمایش یک پیام راهنمای کوتاه.

.TP
.B "-verbose"
پیام‌های اطلاعاتی را روی کنسول چاپ می‌کند.
این گزینه بسیار مفید است چرا که پیام‌هایی در مورد ساختارهای ناشناخته
در لایه‌های حاشیه‌نویسی (annotation) و پیوندهای DjVu را نمایش می‌دهد.

.TP
.BI "-fullscreen, -fs "
اجرای
.B djview4 
در حالت تمام‌صفحه.
برای خروج از حالت تمام‌صفحه از کلید
.B ESC
استفاده کنید.

.TP
.BI "-slideshow[=" arg "]
اجرای
.B djview4 
در حالت نمایش اسلاید.
شناسه عددی اختیاری
.I arg
تعداد ثانیه‌ها را پیش از ورق زدن هر صفحه
مشخص می‌کند.
برای خروج از حالت نمایش اسلاید از کلید
.B ESC
استفاده کنید.


.TP
.BI "-style=" "stylename"
تعیین سبک رابط کاربری گرافیکی.
مقادیر قابل قبول برای
.I stylename
به نسخه نصب‌شده ابزار Qt بستگی دارد.
نام‌های سبک متداول عبارتند از
.BR cde ،
.BR motif ،
.BR plastique ،
.BR platinum
و
.BR windows .


.SH "گزینه‌های سامانه گرافیکی X11 (X11 OPTIONS)"
گزینه‌های خط فرمان زیر توسط نسخه
.SM X11
از برنامه
.B djview4
شناسایی می‌شوند.
برخلاف اکثر
.B گزینه‌های djview4،
گزینه‌های X11 که نیاز به یک شناسه دارند
از نویسه مساوی برای معرفی شناسه خود
استفاده نمی‌کنند.
.TP
.BI "-display " "displayname"
مشخص می‌کند که پنجره‌های
.B djview4
باید در نمایشگر X11 به نام
.IR displayname
نمایش یابند.

.TP
.BI "-geometry " W x H + X + Y
تعیین اندازه و موقعیت اولیه نخستین پنجره
با استفاده از نحو مرسوم تعیین مشخصات هندسی در X11.
شناسه‌های عددی
.IR W " و " H
عرض و ارتفاع اولیه پنجره را نشان می‌دهند.
شناسه‌های عددی
.IR X " و " Y
موقعیت پنجره را نسبت به
گوشه بالا سمت چپ صفحه نمایش مشخص می‌کنند.

.TP
.BI "-name " "name"
تنظیم نام برنامه.

.TP
.BI "-title " "title"
تنظیم عنوان نخستین پنجره.

.TP
.BI "-fn " "fontname" ", -font " "fontname"
تعیین نام قلم پیش‌فرض
مورد استفاده برای دکمه‌ها و منوها.
قلم باید با استفاده از
رشته توصیف قلم منطقی X مشخص شود.
.TP
.BI "-bg " "color" ", -background " "color"
تعیین رنگ پس‌زمینه پیش‌فرض برای
عناصر رابط کاربری گرافیکی.
رنگ باید به عنوان یک نام رنگ استاندارد در X11 مشخص شود.

.TP
.BI "-fg " "color" ", -foreground " "color"
تعیین رنگ پیش‌زمینه پیش‌فرض برای
عناصر رابط کاربری گرافیکی.
رنگ باید به عنوان یک نام رنگ استاندارد در X11 مشخص شود.

.TP
.BI "-btn " "color"
تعیین رنگ دکمه پیش‌فرض.
رنگ باید به عنوان یک نام رنگ استاندارد در X11 مشخص شود.

.TP
.BI "-ncols " "count"
محدود کردن تعداد رنگ‌های تخصیص‌یافته در یک نمایشگر ۸ بیتی.
مکعب رنگ پیش‌فرض شامل ۲۱۶ رنگ متمایز است.
.TP
.B "-cmap"
اجبار به تخصیص یک جدول رنگ (colormap) اختصاصی در نمایشگر ۸ بیتی.
این کار ممکن است کیفیت رنگ را افزایش دهد اما هنگام فعال شدن
پنجره نمایشگر باعث چشمک‌زدن صفحه شود.

.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
گزینه‌های زیر را می‌توان به عنوان گزینه‌های خط فرمان مشخص کرد
یا می‌توان آن‌ها را با افزودن به
.SM URL
سند با استفاده از نحوی مشابه شناسه‌های
.SM CGI
منتقل کرد
.IP "" 3
.BI "http://.../file.djvu?djvuopts&" "key=value" "&" "key=value" "&" "..."
.PP
به منظور تفکیک شناسه‌های واقعی
.SM CGI
از این گزینه‌ها، نمایشگر تنها کلیدواژه‌هایی را شناسایی می‌کند
که پس از واژه
.BR djvuopts
قرار می‌گیرند.
کلیدواژه‌های
.I key
با حذف خط تیره‌های ابتدایی
از نام گزینه‌ها مشتق می‌شوند.

.TP
.BI "-page=" "pagename"
نمایش یک صفحه خاص از سند.
نمایشگر ابتدا به دنبال صفحه‌ای می‌گردد
که شناسه آن با
.IR pagename
مطابقت داشته باشد.
در غیر این صورت، اگر
.I pagename
عددی باشد که پیش از آن نویسه
.BR "+" " یا " "-" ","
آمده باشد، نمایشگر یک جابه‌جایی نسبی نسبت به صفحه جاری انجام می‌دهد.
در غیر این صورت، با شروع از صفحه جاری
و بازگشت به ابتدا، به دنبال صفحه‌ای می‌گردد
که عنوان آن با
.IR pagename
مطابقت داشته باشد.
در غیر این صورت، اگر
.I pagename
عددی باشد، به عنوان یک شماره صفحه ترتیبی تفسیر می‌شود.
در غیر این صورت، و در نهایت، نمایشگر به دنبال صفحه‌ای می‌گردد
که نام آن با
.IR pagename
مطابقت داشته باشد.
.TP
.BI "-pageno=" "pagenumber"
الگوریتم جستجوی صفحه برای گزینه
.B "page"
هنگامی که عنوان صفحات قابل تفسیر به عنوان عدد باشند، می‌تواند باعث ابهام شود.
شناسه گزینه
.B "pageno"
همواره به عنوان شماره صفحه ترتیبی تفسیر می‌شود.
این گزینه سازگاری کمتری نسبت به
.B "page"
دارد زیرا در نسخه‌های قدیمی‌تر افزونه djvu شناسایی نمی‌شود.
هنگامی که استفاده از این گزینه ضروری است،
توصیه می‌شود از هر دو گزینه
.B "page"
و
.B "pageno"
استفاده شود.
.TP
.BI "-zoom=" zoomfactor
تعیین ضریب بزرگ‌نمایی اولیه.
مگر در حالتی که نوار ابزار، منوی زمینه و صفحه‌کلید غیرفعال باشند،
کاربر قادر خواهد بود ضریب بزرگ‌نمایی را تغییر دهد.
مقادیر مجاز برای
.I zoomfactor
در زیر نشان داده شده‌اند:
.br
.TS
center,box;
lfI l
lfB l
lfB l
lfB l
lfB l
.
number	ضریب بزرگ‌نمایی در بازه 10% تا 999%.
one2one	انتخاب حالت «یک به یک» (اندازه واقعی).
width	انتخاب حالت «برازش با عرض».
page	انتخاب حالت «برازش با صفحه».
stretch	کشیدن تصویر به اندازه پنجره افزونه.
.TE
.PP

.TP
.BI "-showposition=" px "," py
تعیین نقطه‌ای در صفحه جاری که باید
تا حد امکان به مرکز پنجره نزدیک باشد.
موقعیت‌های افقی و عمودی
.IB  px "," py
در صفحه جاری به عنوان کسری در بازه 0 تا 1 داده می‌شوند.
به عنوان مثال،
.B 0,0
گوشه بالا سمت چپ صفحه را مشخص می‌کند،
.B 0.5,0.5
مرکز صفحه است، و
.B 1,1
گوشه پایین سمت راست است.

.TP
.BI "-mode=" modespec
تعیین حالت نمایش اولیه.
مگر در حالتی که نوار ابزار و منوی بازشو غیرفعال باشند،
کاربر قادر خواهد بود آن را تغییر دهد.
مقادیر مجاز برای
.I modespec
در زیر نشان داده شده‌اند:
.br
.TS
center,box;
lfB l
lfB l
lfB l
lfB l
lfB l
.
color	نمایش تصویر رنگی.
bw	تنها نمایش ماسک پیش‌زمینه.
fore	تنها نمایش پیش‌زمینه.
back	تنها نمایش پس‌زمینه.
text	پوشش دادن متن پنهان روی تصویر رنگی.
.TE
.PP

.TP
.BI "-hor_align=" keyword ", -halign=" keyword
تعیین موقعیت افقی صفحه در پنجره نمایشگر.
(این گزینه تعیین نمی‌کند کدام بخش از صفحه نشان داده شود، بلکه
چگونگی قرارگیری حاشیه‌ها در اطراف صفحه در پنجره افزونه را مشخص می‌کند.)
شناسه
.I keyword
باید
.BR left ،
.BR center
یا
.BR right
باشد.

.TP
.BI "-ver_align=" keyword ", -valign=" keyword
تعیین موقعیت عمودی صفحه در پنجره نمایشگر.
(این گزینه تعیین نمی‌کند کدام بخش از صفحه نشان داده شود، بلکه
چگونگی قرارگیری حاشیه‌ها در اطراف صفحه در پنجره افزونه را مشخص می‌کند.)
شناسه
.I keyword
باید
.BR top ،
.BR center
یا
.BR bottom
باشد.

.TP
.BI "-cache=(yes|no)"
فعال یا غیرفعال کردن ذخیره‌سازی موقت (cache) صفحات کاملاً رمزگشایی‌شده سند.
ذخیره‌سازی موقت به طور پیش‌فرض فعال است.
ذخیره‌سازی موقت اسنادی که
.SM URL
آن‌ها شامل پسوند
.BR .djvu " یا " .djv
نیست به طور پیش‌فرض غیرفعال است.

.TP
.BI "-continuous=(yes|no)"
فعال یا غیرفعال کردن چیدمان پیوسته (continuous)
اسناد چندصفحه‌ای.

.TP
.BI "-sidebyside=(yes|no), -side_by_side=(yes|no)"
فعال یا غیرفعال کردن چیدمان کنار هم (side-by-side)
اسناد چندصفحه‌ای.

.TP
.BI "-coverpage=(yes|no)"
مشخص می‌کند که آیا صفحه جلد در نمایش چیدمان کنار هم اسناد چندصفحه‌ای
باید به تنهایی نمایش یابد یا خیر.

.TP
.BI "-righttoleft=(yes|no)"
مشخص می‌کند که آیا در چیدمان کنار هم اسناد چندصفحه‌ای،
صفحات باید راست به چپ چیده شوند یا خیر.

.TP
.BI "-layout=" keyword "{," keyword "}"
تعیین تنظیمات چیدمان با استفاده از یک فهرست واحد
از کلیدواژه‌های جداشده با کاما.
کلیدواژه‌های زیر شناسایی می‌شوند:
.br
.TS
center,box;
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
.
single	غیرفعال کردن حالت‌های کنار هم و پیوسته.
double	فعال کردن حالت کنار هم.
continuous	فعال کردن حالت پیوسته.
cover,nocover	نحوه نمایش صفحه نخست در حالت کنار هم.
ltor,rtol	جهت چیدمان برای حالت کنار هم.
gap,nogap	مشخص کردن وجود یا عدم وجود فاصله بین صفحات.
.TE

.TP
.BI "-scrollbars=(yes|no)"
فعال یا غیرفعال کردن نوارهای پیمایش هنگامی که اندازه کامل
تصویر از اندازه پنجره افزونه فراتر می‌رود.
مقدار پیش‌فرض yes است.

.TP
.BI "-frame=(yes|no)"
فعال یا غیرفعال کردن نمایش یک قاب باریک
و سایه در اطراف تصاویر DjVu.
قاب‌ها به طور پیش‌فرض فعال هستند.

.TP
.BI "-background=" color
تعیین رنگ کادر پس‌زمینه
نمایش‌داده‌شده در اطراف سند. رنگ
.I color
باید در قالب هگزادسیمال
.SM RRGGBB
یا
.SM #RRGGBB
داده شود.

.TP
.BI "-toolbar=" keyword "{(,|+|-)" keyword "}"
کنترل ظاهر و محتویات نوار ابزار.
شناسه گزینه
.B toolbar
از تعدادی کلیدواژه تشکیل شده که با
نویسه‌های کاما، علامت مثبت یا علامت منفی از یکدیگر جدا شده‌اند.
ظاهر نوار ابزار توسط کلیدواژه‌هایی کنترل می‌شود
که قبل از نخستین وقوع نویسه مثبت یا منفی قرار گرفته‌اند.
کلیدواژه‌های زیر در این زمینه شناسایی می‌شوند:
.br
.TS
center,box;
lfB l
lfB l
lfB l
lfB l
lfB l
.
no	غیرفعال کردن نوار ابزار.
always	همواره نوار ابزار را نمایش می‌دهد.
auto	فعال کردن حالت «پنهان‌سازی خودکار» نوار ابزار (پیاده‌سازی نشده).
top	قرار دادن نوار ابزار در لبه بالایی.
bottom	قرار دادن نوار ابزار در لبه پایینی.
.TE
.IP ""
محتویات نوار ابزار توسط کلیدواژه‌هایی کنترل می‌شود
که پس از نخستین وقوع نویسه مثبت یا منفی قرار می‌گیرند.
هر کلیدواژه یک دکمه یا گروهی از دکمه‌های خاص را به نوار ابزار اضافه می‌کند (پس از علامت مثبت)
یا از آن حذف می‌کند (پس از علامت منفی).
محتوای اولیه نوار ابزار بر اساس نخستین وقوع نویسه مثبت یا منفی تعیین می‌شود.
هنگامی که این نویسه مثبت باشد،
نوار ابزار در ابتدا خالی است.
هنگامی که این نویسه منفی باشد،
نوار ابزار در ابتدا شامل انتخاب پیش‌فرضی از دکمه‌ها خواهد بود.

کلیدواژه‌های زیر شناسایی می‌شوند:
.br
.TS
center,box;
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
.
modecombo	برای ابزار انتخاب حالت نمایش.
zoomcombo	برای ابزار انتخاب بزرگ‌نمایی.
zoom	برای دکمه‌های بزرگ‌نمایی.
select	برای دکمه انتخاب.
rotate	برای دکمه‌های چرخش تصویر.
find	برای دکمه جستجوی متن.
new	برای دکمه پنجره جدید.
open	برای دکمه باز کردن سند جدید.
save	برای دکمه ذخیره‌سازی.
print	برای دکمه چاپ.
layout	برای دکمه‌های چیدمان صفحه.
pagecombo	برای ابزار انتخاب صفحه.
firstlast	برای دکمه‌های صفحه اول و صفحه آخر.
prevnext	برای دکمه‌های صفحه قبلی و بعدی.
backforw	رزرو شده برای دکمه‌های عقب و جلو.
help	برای دکمه راهنمای زمینه‌ای.
.TE
.PP
به منظور سازگاری با گذشته،
کلیدواژه‌های
.BR fore ،
.BR fore_button ،
.BR back ،
.BR back_button ،
.BR bw ،
.BR bw_button ،
.BR color
و
.BR color_button
مشابه کلیدواژه
.BR modecombo
تفسیر می‌شوند؛
کلیدواژه
.BR rescombo
مترادف
.BR zoomcombo
است؛
کلیدواژه‌های
.BR pan ،
.BR zoomsel
و
.BR textsel
مشابه کلیدواژه
.BR select
تفسیر می‌شوند؛
و کلیدواژه
.BR doublepage
مشابه کلیدواژه
.BR layout
تفسیر می‌شود.
تمامی کلیدواژه‌های دیگر نادیده گرفته می‌شوند.
.PP

.TP
.BI "-menubar=(yes|no)"
فعال یا غیرفعال کردن نمایش نوار منو
واقع در بالای پنجره.

.TP
.BI "-statusbar=(yes|no)"
فعال یا غیرفعال کردن نمایش نوار وضعیت
واقع در پایین پنجره.

.TP
.BI "-sidebar=" keyword "{," keyword "}"
کنترل پنل‌های لنگرپذیر (dockable).
شناسه یک فهرست از کلیدواژه‌های جداشده با کاما است.
گروه اول کلیدواژه‌ها انتخاب می‌کند که کدام پنل‌ها تحت تأثیر قرار گیرند.
حذف این کلیدواژه‌ها، همه پنل‌ها را انتخاب می‌کند.
گروه دوم کلیدواژه‌ها سپس وضعیت نمایش و
موقعیت پنل‌های انتخاب‌شده را کنترل می‌کند.
.br
.TS
center,box;
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
.
thumbnails	مشخص کردن پنل بندانگشتی‌ها.
outline,bookmarks	مشخص کردن پنل ساختار درختی / نشانک‌ها.
search,find	مشخص کردن پنل جستجو.
=
yes,true	نمایش پنل‌های مشخص‌شده (پیش‌فرض).
no,false	پنهان کردن پنل‌های مشخص‌شده.
left	لنگر انداختن پنل‌های مشخص‌شده در سمت چپ.
right	لنگر انداختن پنل‌های مشخص‌شده در سمت راست.
top	لنگر انداختن پنل‌های مشخص‌شده در بالا.
bottom	لنگر انداختن پنل‌های مشخص‌شده در پایین.
.TE
.PP
.TP
.BI "-thumbnails=" keyword "{," keyword "}"
نام مستعار سازگاری برای
.BI "-sidebar=" keyword "{," keyword "},thumbnails."
.TP
.BI "-outline=" keyword "{," keyword "}"
نام مستعار سازگاری برای
.BI "-sidebar=" keyword "{," keyword "},outline."
.TP
.BI "-menu=(yes|no)"
فعال یا غیرفعال کردن منوی زمینه (pop-up).

.TP
.BI "-keyboard=(yes|no)"
فعال یا غیرفعال کردن میانبرهای صفحه‌کلید افزونه DjVu.
مقدار پیش‌فرض yes (فعال) است.
توجه داشته باشید که غیرفعال کردن پردازش صفحه‌کلید
میانبرهای مرتبط با منوهای فعال (گزینه‌های
.BR "-menu" " و " "-menubar"
را ببینید)
و نوارهای ابزار و کناری مرئی (گزینه‌های
.BR "-toolbar" " و " "-sidebar"
را ببینید) را غیرفعال نمی‌کند.

.TP
.BI "-mouse=(yes|no)"
فعال یا غیرفعال کردن تعامل ماوس برای پیمایش و انتخاب.
مقدار پیش‌فرض yes (فعال) است.

.TP
.BI "-links=(yes|no)"
فعال یا غیرفعال کردن پیوندها در تصویر DjVu.
پیوندها به طور پیش‌فرض فعال هستند.

.TP
.BI "-highlight=" x "," y "," w "," h "[," color "]"
نمایش یک مستطیل برجسته‌شده در مختصات مشخص‌شده در
صفحه جاری و با رنگ تعیین‌شده. مختصات
.IR x "، " y "، " w " و " h
در دستگاه مختصات تصویر سند (نه مختصات صفحه نمایش) اندازه‌گیری می‌شوند.
مبدأ مختصات در گوشه پایین سمت چپ تصویر قرار دارد. رنگ
.I color
باید در قالب هگزادسیمال
.SM RRGGBB
یا
.SM #RRGGBB
داده شود.
می‌توان چندین ناحیه برجسته را مشخص کرد
و آن‌ها را با چندین گزینه
.BI "-page=" "pagename"
در هم آمیخت.
.TP
.BI "-find=" text
برجسته‌سازی موارد وقوع رشته ارائه‌شده
.IR text .
این گزینه زمانی کار می‌کند که سند دارای یک لایه متنی پنهان باشد.
می‌توان از آن در ترکیب با
.BR "-sidebar=find"
برای نمایش رابط کاربری جستجوی متن استفاده کرد.

رشته
.I text
می‌تواند با اسلش
.BR "" "(" "/" ")"
و به دنبال آن حروفی که گزینه‌های جستجو را مشخص می‌کنند خاتمه یابد.
حروف زیر شناسایی می‌شوند:
.br
.TS
center,box;
lfB l
lfB l
lfB l
lfB l
lfB l
lfB l
.
c	جستجوی حساس به کوچک و بزرگی حروف.
C	جستجوی غیرحساس به حروف بزرگ و کوچک (پیش‌فرض).
w	شروع انطباق‌های جستجو از مرزهای کلمات (پیش‌فرض).
W	نادیده گرفتن مرزهای کلمات.
r	جستجو با عبارات باقاعده (regular expression).
R	جستجوی رشته‌ای ساده (پیش‌فرض).
.TE
.PP

.TP
.BI "-rotate=(0|90|180|270)"
چرخش تصویر djvu با زاویه مشخص‌شده بر حسب
درجه و در جهت خلاف عقربه‌های ساعت.

.TP
.BI "-print=(yes|no)"
فعال یا غیرفعال کردن چاپ سند DjVu.
چاپ به طور پیش‌فرض فعال است.

.TP
.BI "-save=(yes|no)"
فعال یا غیرفعال کردن ذخیره سند DjVu.
ذخیره‌سازی به طور پیش‌فرض فعال است.

.TP
.BI "-passive"
باعث می‌شود تصویر DjVu به شیوه‌ای مشابه
یک تصویر وب معمولی نمایش داده شود.
ضریب بزرگ‌نمایی پیش‌فرض به
.BR page
تغییر می‌کند.
نوار ابزار، نوار وضعیت، نوارهای پیمایش،
منوها و میانبرهای صفحه‌کلید غیرفعال می‌شوند.

.TP
.BI "-passivestretch"
باعث می‌شود تصویر DjVu به شیوه‌ای مشابه
یک تصویر وب معمولی نمایش داده شود.
ضریب بزرگ‌نمایی پیش‌فرض به
.BR stretch
تغییر می‌کند.
نوار ابزار، نوار وضعیت، نوارهای پیمایش،
منوها و میانبرهای صفحه‌کلید غیرفعال می‌شوند.

.TP
.BI "-nomenu, -notoolbar, -noscrollbars"
این گزینه‌ها در برخی از نسخه‌های نمایشگرهای
DjVu شناسایی می‌شدند و صرفاً برای سازگاری
با گذشته پشتیبانی می‌شوند.
هنگام فعال بودن گزینه
.BR -verbose
یک پیام هشدار چاپ می‌شود.

.TP
.BI "-logo, -textsel, -search"
این گزینه‌ها در برخی از نسخه‌های نمایشگرهای
DjVu شناسایی می‌شدند اما در حال حاضر توسط
.BR djview4
پیاده‌سازی نشده‌اند.
هنگام فعال بودن گزینه
.BR -verbose
یک پیام هشدار چاپ می‌شود.


.SH "نحوه استفاده (USAGE)"

اکثر قابلیت‌ها از طریق منوها، نوار ابزار، نوار کناری یا منوی زمینه‌ای که
با کلیک راست روی تصویر DjVu نشان داده می‌شود، قابل دسترسی هستند.
راهنمای تفصیلی را می‌توان با کلیک روی نماد راهنمای زمینه‌ای در نوار ابزار
و سپس کلیک بر روی بخش‌های مختلف رابط کاربری djview مشاهده کرد.

جدول زیر برخی از کلیدهای ترکیبی مفید را که هنگام
فعال بودن سند djvu کار می‌کنند فهرست کرده است:
.PP
.TS
center,box;
lfB lfB
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
.
کلید	عملکرد
=
SHIFT+F1	فعال‌سازی راهنمای زمینه‌ای.
1,2, and 3	تغییر بزرگ‌نمایی به 100%، 200% و 300%.
Up, Down, Left, Right	پیمایش تصویر در جهت مشخص‌شده.
Home	نمایش گوشه بالا سمت چپ تصویر.
End	نمایش گوشه پایین سمت راست تصویر.
Control+Home	رفتن به ابتدای سند.
Control+End	رفتن به انتهای سند.
Space, Return	پیمایش به پایین یا رفتن به صفحه بعد.
Backspace	پیمایش به بالا یا رفتن به صفحه قبل.
Page Down	رفتن به صفحه بعد.
Page Up	رفتن به صفحه قبل.
+, -	بزرگ‌نمایی و کوچک‌نمایی.
[, ]	چرخش تصویر.
W	انتخاب حالت بزرگ‌نمایی «برازش با عرض».
P	انتخاب حالت بزرگ‌نمایی «برازش با صفحه».
CTRL+F, F3	جستجو در لایه متنی پنهان.
CTRL+G	رفتن به یک صفحه خاص بر اساس نام یا شماره.
.TE
.PP
با نگه‌داشتن کلیدهای تبدیل (modifier) می‌توان به جلوه‌های مفیدی دست یافت.
اگرچه این کلیدها از کادر تنظیمات قابل پیکربندی هستند،
اما جدول زیر انتساب‌های پیش‌فرض را فهرست می‌کند:
.PP
.TS
center,box;
lfB lfB
l l
l l
l l
.
کلید	عملکرد
=
CTRL+SHIFT	نگه‌داشتن این کلیدها برای نمایش ذره‌بین بزرگ‌نمایی.
CTRL	نگه‌داشتن این کلید برای انتخاب یک ناحیه با ماوس.
SHIFT	نگه‌داشتن این کلید برای نمایش تمامی پیوندها.
.TE
.PP


.SH "محیط (ENVIRONMENT)"
تنظیم متغیر محیطی
.BR DJVIEW_VERBOSE
روی یک مقدار غیر صفر معادل فراخوانی
.BR djview
با گزینه
.BR -verbose
است.
تنظیم متغیر محیطی
.BR DJVIEW_OPENGL
روی مقادیر 0 یا 1، تنظیمات ترجیحی
مربوط به رندرینگ با OpenGL را لغو می‌کند.

هنگامی که کاربر روی یک پیوند djvu کلیک می‌کند که به یک صفحه وب اشاره دارد، برنامه
ابتدا تلاش می‌کند برنامه‌های مرورگر وبی را اجرا کند که نام آن‌ها در متغیر محیطی
جداشده با دونقطه
.BR BROWSER
فهرست شده است،
سپس پیش‌فرض‌های منطقی وابسته به پلتفرم را امتحان می‌کند.

زبان رابط کاربری ابتدا با جستجوی یک مجموعه کامل از فایل‌های ترجمه برای
زبان مشخص‌شده در کادر تنظیمات تعیین می‌شود، سپس
برای زبان‌های ISO 639 مشخص‌شده در متغیر محیطی جداشده با دونقطه
.BR LANGUAGE ،
و در نهایت زبان مشخص‌شده توسط منطقه محلی سیستم (locale) بررسی می‌شود.
اگر همه این جستجوها ناموفق باشند، زبان رابط کاربری
به پیش‌فرض انگلیسی برمی‌گردد.

.SH "دست‌اندرکاران (CREDITS)"
این برنامه توسط L\('eon Bottou <leonb@users.sf.net> نوشته شده است
و تحت پروانه عمومی همگانی گنو توزیع می‌شود.
این برنامه شامل کدهایی برگرفته از برنامه
.BR tiff2pdf
است که توسط Ross Finlayson نوشته شده و
تحت پروانه BSD منتشر شده است.


.SH "همچنین ببینید (SEE ALSO)"
.BR djvu (1),
.BR ddjvu (1),
.BR nsdejavu (1),
.BR tiff2pdf (1)