.\" 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 DJVUTXT 1 "10/11/2001" "DjVuLibre-3.5" "DjVuLibre-3.5"
.de SS
.SH \\0\\0\\0\\$*
..
.SH "نام (NAME)"
djvutxt \- استخراج متن پنهان از اسناد DjVu

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

.SH "توضیحات (DESCRIPTION)"
برنامهٔ 
.B djvutxt
لایهٔ متنی پنهان یک سند DjVu با نام 
.I inputdjvufile
را رمزگشایی کرده و آن را در فایل 
.I outputtxtfile
یا در خروجی استاندارد چاپ می‌کند.
لایهٔ متنی پنهان معمولاً با کمک یک نرم‌افزار تشخیص نوری نویسه‌ها (OCR) تولید می‌شود.

بدون گزینه‌های 
.BR -detail
و
.BR -escape ،
این برنامه صرفاً متن با کدگذاری UTF-8 را خروجی می‌دهد.
گزینهٔ 
.BR -detail
باعث خروجی عبارت‌های ساختاریافته (S-expressions) توصیف‌کنندهٔ متن و موقعیت مکانی آن می‌شود.
گزینهٔ 
.BR -escape
از توالی‌های گریز به سبک زبان C برای نمایش نویسه‌های غیرقابل‌چاپ غیر ASCII استفاده می‌کند.



.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--page=" "pagespec"
مشخص می‌کند کدام صفحات باید پردازش شوند.
هنگامی که این گزینه مشخص نشود،
متن تمام صفحات سند به یکدیگر پیوسته
و در فایل خروجی نوشته می‌شود.
مشخصات صفحهٔ 
.I pagespec 
شامل یک یا چند بازه از صفحات است که با کاما از یکدیگر جدا شده‌اند.
بازهٔ صفحه یا یک شماره صفحهٔ تنها است،
یا دو شماره صفحه که با خط تیره از هم جدا شده‌اند.
برای نمونه، مشخصهٔ 
.BR "1-10" 
صفحات ۱ تا ۱۰ را خروجی می‌دهد، و مشخصهٔ 
.BR "1,3,99999-4"
صفحات ۱ و ۳ و به دنبال آن تمام صفحات سند را
به ترتیب معکوس تا صفحهٔ ۴ در خروجی می‌آورد.
.TP
.BI "--detail=" "keyword"
این گزینه باعث می‌شود 
.B djvutxt
عبارت‌های S-expression را خروجی دهد
که موقعیت متن در صفحه را تعیین می‌کنند.
صفحهٔ راهنمای 
.BR djvused (1)
را برای شرح قالب خروجی ببینید.
آرگومان 
.I keyword
حداکثر سطح جزئیاتی را که موقعیت مکانی متن برای آن گزارش می‌شود، مشخص می‌کند.
مقدارهای شناخته‌شده عبارتند از:
.BR page "، " column "، " region "، " para "، "
.BR line "، " word " و " char "."
تمام مقدارهای دیگر به عنوان 
.BR char
تفسیر می‌شوند.
.TP
.BI "--escape"
توالی‌های گریز را به شکل 
.BI \ "ooo"
برای تمام نویسه‌های غیر ASCII یا غیرقابل‌چاپ UTF-8 و همچنین نویسهٔ بک‌اسلش خروجی می‌دهد.




.SH "نکات (REMARKS)"
برای کنترل بیشتر روی لایهٔ متنی، از برنامهٔ 
.BR djvused (1)
استفاده کنید.

.SH "دست‌اندرکاران (CREDITS)"
این برنامه در ابتدا توسط 
Andrei Erofeev <andrew_erofeev@yahoo.com> نوشته شد و
سپس به دست Bill Riemers <docbill@sourceforge.net> 
و افراد بسیار دیگری بهبود یافت. سپس توسط 
Leon Bottou <leonb@sourceforge.net> بازنویسی شد تا از 
ddjvuapi استفاده کند.

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