.\" Copyright (c) 1987-2012 UMD-CS, released under the X11 license;
.\" see README and source files.
.TH DVISELECT 1
.SH "نام (NAME)"
dviselect \- استخراج صفحات از فایل‌های DVI
.SH "خلاصه دستور (SYNOPSIS)"
.B dviselect
[
.B \-s
] [
.B \-i
.I infile
] [
.B \-o
.I outfile
]
.I "list of pages"
[
.I infile
[
.I outfile
] ]
.SH "توضیحات (DESCRIPTION)"
دستور
.I Dviselect
صفحاتی را از یک فایل DVI تولیدشده توسط TeX انتخاب می‌کند
و یک فایل DVI جدید می‌سازد که
توسط هر یک از برنامه‌های تبدیل TeX،
یا حتی توسط خود
.I dviselect
قابل استفاده است.
.PP
یک
.I بازه
رشته‌ای به شکل
.IR even ،
.IR odd ،
یا
.I first:last
است که در آن هر دو مقدار
.I first
و
.I last
رشته‌های عددی اختیاری هستند، و اعداد منفی با یک نویسه زیرخط پیشین «_» مشخص می‌شوند. اگر هر دو مقدار
.I first
و
.I last
حذف شوند، دونقطه نیز ممکن است حذف شود، یا با یک ستاره «*» جایگزین گردد. یک
.I بازه صفحه
فهرستی از بازه‌ها است که با نقطه از هم جدا شده‌اند. یک
.I "فهرست صفحات"
توسط مجموعه‌ای از بازه‌های صفحه توصیف می‌شود که با کاما و/یا نویسه فاصله جدا شده‌اند.
.PP
دستور
.I Dviselect
در واقع به ده متغیر
.I count
که TeX می‌نویسد نگاه می‌کند؛ اولین متغیر از این‌ها (\ecount0)
شماره صفحه است، و \ecount1 تا \ecount9 بسته به این‌که چه بسته‌های ماکرویی در حال استفاده هستند،
کاربردهای متفاوتی دارند. (معمولاً \ecount1 ممکن است شماره فصل یا بخش باشد.) یک صفحه در خروجی
.I dviselect
قرار می‌گیرد اگر تمام مقادیر \ecount آن با هر یک از بازه‌های ذکرشده در خط فرمان مطابقت داشته باشد.
برای مثال، دستور «dviselect *.1,35:» ممکن است همه چیز در فصل ۱ و همچنین صفحات ۳۵ به بعد را انتخاب کند.
دستور «dviselect 10:30» صفحات ۱۰ تا ۳۰ (شامل خود آن‌ها) را انتخاب خواهد کرد.
«:43» یعنی همه‌چیز تا صفحه ۴۳ و شامل خود آن (از جمله صفحات با شماره منفی).
برای دریافت تمام صفحات با شماره زوج، از «even» استفاده کنید؛
برای دریافت تمام صفحات با شماره فرد، از «odd» استفاده کنید.
اگر یک فهرست مطالب دارای شماره صفحات منفی باشد، «:_1» آن را انتخاب خواهد کرد.
توجه داشته باشید که «*» باید در پوسته نقل‌قول (quote) شود؛
استفاده از رشته خالی راحت‌تر است، اگرچه خواندن آن دشوارتر است.
.PP
به‌جای مقادیر \ecount، دستور
.I dviselect
همچنین می‌تواند بر اساس «شماره صفحه مطلق» انتخاب کند، که در آن اولین صفحه،
صفحه ۱، دومین صفحه، صفحه ۲ و به همین ترتیب است. شماره‌های صفحه مطلق
با یک علامت مساوی پیشین «=» مشخص می‌شوند. بازه‌هایی از صفحات مطلق
نیز مجاز هستند: «dviselect =3:7» صفحات سوم تا هفتم را استخراج خواهد کرد.
جداکننده‌های نقطه در بازه‌های مطلق مجاز نیستند و هیچ شماره صفحه مطلق منفی وجود ندارد.
با این حال، مشخص‌کننده‌های زوج/فرد مجاز هستند؛
«dviselect =even» صفحات را یکی‌درمیان، با شروع از صفحه دوم انتخاب می‌کند.
.PP
به‌طور دقیق‌تر، یک ستاره یا یک رشته خالی به معنای بدون محدودیت است؛
علامت مساوی به معنای شماره صفحه مطلق به‌جای \ecountها است؛
دونقطه در ابتدا به معنای همه‌چیز تا صفحه داده‌شده و شامل خود آن است؛
دونقطه در انتها به معنای همه‌چیز از صفحه داده‌شده به بعد است؛
کلمه «even» به این معنا است که تنها مقادیر زوج پذیرفته می‌شوند؛
کلمه «odd» به این معنا است که تنها مقادیر فرد پذیرفته می‌شوند؛ و
نقطه نشان می‌دهد که \ecount بعدی باید بررسی شود.
اگر کمتر از ۱۰ بازه مشخص شود، باقی‌مانده \ecountها بدون محدودیت رها می‌شوند (یعنی «1:5» و «1:5.*» معادل یکدیگرند).
با یک تک‌شماره \fIn\fP به گونه‌ای رفتار می‌شود که گویی بازه \fIn:n\fP است.
می‌توان تعداد دلخواهی از انتخاب‌کننده‌های صفحه را مشخص کرد که با کاما یا فاصله خالی جدا می‌شوند؛
یک صفحه در صورتی انتخاب می‌شود که هر یک از انتخاب‌کننده‌ها با مقادیر \ecount یا شماره صفحه مطلق آن مطابقت داشته باشد.
.PP
دستور Dviselect معمولاً شماره صفحاتِ انتخاب‌شده را چاپ می‌کند؛ گزینه
.I \-s
از این کار جلوگیری می‌کند.
.SH "نویسندگان (AUTHORS)"
Chris Torek, University of Maryland
.SH "همچنین ببینید (SEE ALSO)"
dviconcat(1), latex(1), tex(1)
.br
.I "MC-TeX User's Guide"
.br
.I "The TeXbook"
.SH "گزارش باگ‌ها (BUGS)"
یک علامت «-» پیشین باید برای اعداد منفی مجاز می‌بود، اما در حال حاضر برای سازگاری با گذشته، به عنوان مترادفی برای «:» استفاده می‌شود.
.PP
انتخاب بر اساس بخش (section) یا زیربخش (subsection) گاهی با شکست مواجه می‌شود، زیرا فایل DVI تنها مقادیر \ecount فعال در زمان پایان صفحه را فهرست می‌کند. بسته‌های ماکروی هوشمند می‌توانند با استفاده از دیگر ثبات‌های «آزاد» \ecount این مشکل را کاهش دهند. فصل‌ها معمولاً در صفحات جدید آغاز می‌شوند و دچار این مشکل خاص نمی‌شوند.
.PP
روش اکتشافی (heuristic) که تعیین می‌کند کدام آرگومان‌ها انتخاب‌کننده صفحه و کدام نام فایل هستند اغلب اشتباه می‌کند. استفاده از بازهدایت پوسته یا گزینه‌های \-i و \-o امن‌ترین روش است.
.PP
دستور
.I Dviselect
پارامترها را در پی‌نوشت (postamble) تنظیم نمی‌کند؛ با این حال، از آن‌جا که این مقادیر معمولاً تنها برای تعیین اندازه برخی ساختارها در برنامه‌های تبدیل خروجی استفاده می‌شوند، و نیازی به افزایش این پارامترها نیست، این موضوع تاکنون مشکلی ایجاد نکرده است.