.\" Copyright (c) 2001-2003 Leon Bottou, Yann Le Cun, Patrick Haffner,
.\" Copyright (c) 2001 AT&T Corp., and Lizardtech, Inc.
.\"
.\" 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 DJVUDIGITAL 1 "1/31/2004" "DjVuLibre-3.5" "DjVuLibre-3.5"
.SH "نام (NAME)"
djvudigital \- ساخت پرونده‌های DjVu از پرونده‌های PS یا PDF

.SH "خلاصه دستور (SYNOPSIS)"
.BI "djvudigital [" "گزینه‌ها" "] " "پرونده_ورودی" " [" "پرونده_خروجی" "]"

.SH "توضیحات (DESCRIPTION)"
این برنامه یک پرونده DjVu از پرونده‌های PostScript
.BR "" "(" ".ps" ")،"
PostScript فشرده‌شده با GZip
.BR "" "(" ".ps.gz" ")،"
Encapsulated PostScript
.BR "" "(" ".eps" ")،"
یا Portable Document Format
.BR "" "(" ".pdf" ")"
با نام
.I پرونده_ورودی
می‌سازد.
.PP
نام پرونده خروجی یا توسط آرگومان
.I پرونده_خروجی
مشخص می‌شود یا با جایگزینی پسوندهای پرونده ورودی با پسوند DjVu
.BR "" "(" ".djvu" ")"
تولید می‌گردد.

.SH "پیش‌نیازها (PREREQUISITES)"
این برنامه به یک درایور خاص GhostScript وابسته است.
اگر برنامه GhostScript شما این درایور را ارائه نمی‌دهد، لطفاً
.B http://djvu.sourceforge.net/gsdjvu.html
را بررسی کنید.

.SH "گزینه‌ها (OPTIONS)"
.TP
.BR "--verbose" ", " "-v"
نمایش پیام‌های اطلاعاتی بیشتر در هنگام تبدیل پرونده.
.TP
.BR "--quiet" ", " "-q"
عدم نمایش پیام‌های اطلاعاتی در هنگام تبدیل پرونده.
.TP
.BI "--dpi=" "وضوح"
تعیین وضوح (تفکیک‌پذیری) مورد نظر به
.I وضوح
نقطه در اینچ (dpi).
مقدار پیش‌فرض ۳۰۰ نقطه در اینچ است.
.TP
.BI "--psrotate=" "زاویه"
چرخش پرونده PostScript به میزان
.I زاویه
درجه در جهت عقربه‌های ساعت.
فقط مقادیر
.BR 0 "، " 90 "، " 180 " و " 270
پشتیبانی می‌شوند.
این گزینه فقط برای پرونده‌های PostScript اعمال می‌شود.
پرونده‌های PDF همیشه بر اساس جهت‌گیری اصلی خود تبدیل می‌شوند.
.TP
.BI "--epsf=" "آرایش"
تعیین نحوه مدیریت پرونده‌های Encapsulated PostScript.
آرگومان
.I آرایش
می‌تواند مقادیر
.BR crop "، " fit " و " ignore
را بپذیرد.
آرایش پیش‌فرض
.B crop
یک پرونده DjVu می‌سازد که اندازه آن با کادر مرزی (bounding box) پرونده Encapsulated PostScript مطابقت دارد. مقدار
.B fit
ابعاد گرافیک را به اندازه پیش‌فرض صفحه تغییر مقیاس می‌دهد. مقدار
.B ignore
تمام کدهای مختص Encapsulated PostScript را غیرفعال می‌کند.
این گزینه به Ghostscript نسخه ۷.۰۷ یا بالاتر نیاز دارد.
.TP
.BI "--exact-color"
رندرینگ دقیق‌تر رنگ‌ها را فعال می‌کند.
این گزینه به GhostScript نسخه ۶.۵۲ یا بالاتر نیاز دارد.
.TP
.BI "--threshold=" "آستانه"
تعیین حد آستانه برای کد جداسازی پیش‌زمینه/پس‌زمینه.
مقادیر قابل قبول برای
.I آستانه
از ۰ تا ۱۰۰ متغیر است. مقادیر بزرگتر اطلاعات بیشتری را در لایه پیش‌زمینه قرار می‌دهند.
مقدار آستانه پیش‌فرض ۸۰ است.
.TP
.BI "--bg-subsample=" "نمونه‌برداری"
تعیین نسبت زیرنمونه‌برداری پس‌زمینه.
آرگومان
.I نمونه‌برداری
باید یک عدد صحیح بین ۱ و ۶ باشد.
مقدار پیش‌فرض ۳ است.
.TP
.BI "--bg-slices=" "n" "+...+" "n"
تعیین کیفیت کدگذاری لایه پس‌زمینه.
نحو این آرگومان مشابه موارد شرح داده شده برای گزینه
.B -slice
در دستور
.B c44
است.
مقدار پیش‌فرض
.B 72+11+10+10
می‌باشد.
.TP
.BI "--fg-colors=" تعداد_رنگ‌ها
تعیین حداکثر تعداد رنگ‌های مجزا در لایه پیش‌زمینه.
آرگومان
.I تعداد_رنگ‌ها
می‌تواند مقادیر صحیح بین ۱ تا ۴۰۰۰ را بپذیرد.
مقدار پیش‌فرض ۲۵۶ است.
.TP
.BI "--fg-image-colors=" تعداد_رنگ‌ها
تعیین حداکثر تعداد رنگ‌های مجزا در یک تصویر جهت در نظر گرفتن آن برای کدگذاری در لایه پیش‌زمینه.
آرگومان
.I تعداد_رنگ‌ها
می‌تواند مقادیر صحیح بین ۱ تا ۴۰۰۰ را بپذیرد.
مقدار پیش‌فرض ۲۵۶ است.
.TP
.BI "--words"
استخراج متن از کد PostScript و گنجاندن این اطلاعات در پرونده DjVu.
این گزینه مکان دقیق هر کلمه را ثبت می‌کند.
.TP
.BI "--lines"
استخراج متن از کد PostScript و گنجاندن این اطلاعات در پرونده DjVu.
این گزینه با ثبت مکان هر سطر، چند بایت در فضا صرفه‌جویی می‌کند.
.TP
.BI "--gsarg=" arg1 "[," arg2 ",...," argN "]"
درج آرگومان‌های اضافی در خط فرمان GhostScript.
.TP
.BI "--cseparg=" arg1 "[," arg2 ",...," argN "]"
درج آرگومان‌های اضافی در خط فرمان برنامه
.BR csepdjvu " یا " msepdjvu .
.TP
.BI "--poppler=" "کلیدواژه‌ها"
این گزینه موجب می‌شود
.B djvudigital
اطلاعات تکمیلی را با استفاده از ابزار
.B pdftotext
(همراه کتابخانه Poppler) از پرونده‌های PDF استخراج کند.
اطلاعات انتخاب‌شده در مرحله پس‌پردازش به پرونده DjVu اضافه می‌شوند. این گزینه در صورتی که پرونده ورودی PDF نباشد نادیده گرفته می‌شود.
آرگومان
.I کلیدواژه‌ها
فهرستی از کلیدواژه‌ها است که با کاما از هم جدا شده‌اند.
هنگامی که این فهرست حاوی کلیدواژه
.B meta
باشد، متادیتای استخراج‌شده توسط
.B pdftotext
در پرونده DjVu درج می‌شود.
هنگامی که این فهرست حاوی کلیدواژه
.B text
باشد، اطلاعات متنی استخراج‌شده توسط
.B pdftotext
در پرونده DjVu درج می‌گردد، که ممکن است جایگزین اطلاعات جمع‌آوری‌شده با گزینه‌های
.B --words
یا
.B --lines
شود.
این ویژگی مثلاً هنگامی کاربرد دارد که یک پرونده PDF اسکن‌شده دارای لایه متنی مخفی باشد که توسط Ghostscript شناسایی نشده و در نتیجه به بک‌اند djvudigital ارسال نگردیده است.
.TP
.BI "--sepfile"
تولید یک پرونده داده تفکیک‌شده به جای پرونده DjVu. برنامه
.B csepdjvu
می‌تواند این پرونده داده تفکیک‌شده را به یک پرونده DjVu تبدیل کند.
.TP
.BI "--check"
نمایش نام‌های دو برنامه کمکی یافت‌شده توسط
.BR djvudigital ،
یعنی یک مفسر مناسب Ghostscript و یک انکودر بک‌اند مناسب.
برای جزئیات بیشتر به دو بخش بعدی مراجعه کنید.
.TP
.BI "--dryrun"
صرفاً خط فرمان Ghostscript تولید شده توسط
.B djvudigital
را بدون اجرای آن نمایش می‌دهد.
هیچ پرونده خروجی تولید نمی‌شود.
.TP
.BI "--help"
نمایش صفحه راهنمای
.BR djvudigital .
.PP

.SH "مسائل مربوط به GHOSTSCRIPT (GHOSTSCRIPT ISSUES)"
برنامه
.B djvudigital
به طور داخلی به درایور خاصی از Ghostscript به نام
.B djvusep
متکی است. این درایور ساختار منطقی توالی دستورات رندرینگ PostScript را تحلیل کرده و تصمیم می‌گیرد که هر دستور در لایه پیش‌زمینه یا پس‌زمینه اجرا شود. درایور GhostScript یک پرونده داده تفکیک‌شده تولید می‌کند که سپس با استفاده از برنامه
.B csepdjvu
از مجموعه‌ی DjVuLibre فشرده می‌شود.
.PP
پیش از پردازش پرونده ورودی، برنامه
.B djvudigital
به دنبال یک فایل اجرایی Ghostscript می‌گردد که درایور
.B djvusep
را ارائه دهد. این جستجو با پرونده مشخص‌شده در متغیر محیطی
.B GSDJVU
آغاز می‌شود و با فایل‌های اجرایی خط فرمان با نام‌های
.BR gs " و " gsdjvu
ادامه می‌یابد.
.PP
کد منبع DjVuLibre حاوی دستورالعمل‌هایی برای کامپایل چنین فایل اجرایی GhostScript است. اطلاعات بیشتر را می‌توان از
.B http://djvu.sourceforge.net/gsdjvu.html
به دست آورد.

.SH "مسائل مربوط به CSEPDJVU (CSEPDJVU ISSUES)"
خروجی درایور
.B djvusep
در GhostScript باید توسط برنامه
.B csepdjvu
از مجموعه‌ی DjVuLibre پردازش شود. این برنامه همچنین می‌تواند با برنامه اختصاصی Lizardtech به نام
.B msepdjvu
جایگزین گردد.
پیش از پردازش پرونده ورودی، برنامه
.B djvudigital
به دنبال چنین فایل اجرایی می‌گردد. این جستجو با پرونده مشخص‌شده در متغیر محیطی
.B CSEPDJVU
آغاز شده و با فایل‌های اجرایی خط فرمان با نام‌های
.BR msepdjvu " و " csepdjvu
ادامه می‌یابد.

.SH "سایر برنامه‌ها (OTHER PROGRAMS)"
گزینه
.BI "--poppler=" "کلیدواژه‌ها"
به ابزار
.B pdftotext
همراه کتابخانه Poppler و ابزار
.B djvused
همراه djvulibre متکی است.
فقط نسخه‌های جدید
.B pdftotext
که گزینه
.B -bbox
را می‌پذیرند پشتیبانی می‌شوند.
هر دو ابزار ابتدا با بررسی پرونده‌های مشخص‌شده در متغیرهای محیطی
.B PDFTOTEXT
و
.B DJVUSED
جستجو می‌شوند، و سپس در میان فایل‌های اجرایی با نام‌های
.B pdftotext
یا
.B djvused
موجود در مسیر اجرایی شل (PATH) جستجو می‌گردند.

.SH "سازندگان (CREDITS)"
نخستین نسخه این مبدل توسط
L\('eon Bottou <leonb@users.sourceforge.net>
در آزمایشگاه‌های AT&T نوشته شد. نسخه DjVuLibre از کدی برگرفته شده که با سخاوتمندی توسط Lizardtech در ژانویه ۲۰۰۴ منتشر گردید.

.SH "اشکالات (BUGS)"
برنامه
.B djvudigital
تنها می‌تواند پرونده‌های ورودی را پردازش کند که GhostScript قادر به پردازش صحیح آن‌ها باشد.

.SH "همچنین ببینید (SEE ALSO)"
.BR djvu (1),
.BR csepdjvu (1),
.BR c44 (1),
.BR gs (1),
.BR gzip (1)