.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "tex2xindy 1"
.TH tex2xindy 1 "2010-05-10" "Version 1.24" "xindy"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
tex2xindy \- پیش‌پردازنده‌ای برای پردازشگر نمایه xindy
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& tex2xindy [\-o] [attr_file]
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \fBtex2xindy\fR یک فایل نمایه LaTeX با پسوند \f(CW\*(C`.idx\*(C'\fR (یا یک فایل \f(CW\*(C`.aux\*(C'\fR) را به یک فایل نمایه خام \fBxindy\fR تبدیل می‌کند.
.PP
این برنامه یک پالایه است که فایلی را در قالب ورودیِ فایل نمایه خام LaTeX، یعنی دارای برچسب‌های \f(CW\*(C`\eindexentry\*(C'\fR، از \fIstdin\fR می‌خواند و در \fIstdout\fR یک فایل نمایه خام \fBxindy\fR، یعنی دارای عبارت‌های \f(CW\*(C`indexentry\*(C'\fR، را به عنوان خروجی ارائه می‌دهد.
.PP
اگر گزینه \fB\-o\fR مشخص نشده باشد، \fBtex2xindy\fR نشانه‌گذاری ^^\- در TeX را پردازش کرده و هشت‌بیت (بایت) معادل آن را در خروجی می‌آورد: عبارت \f(CW\*(C`^^ab\*(C'\fR در ورودی، به صورت بایت 0xab در خروجی نوشته می‌شود. اگر عبارت‌های \f(CW\*(C`^^^^abcd\*(C'\fR یا \f(CW\*(C`^^^^^^^^abcdefab\*(C'\fR تشخیص داده شوند، بدون تغییر در خروجی قرار می‌گیرند.
.PP
اگر گزینه \fB\-o\fR مشخص شده باشد، \fBtex2xindy\fR در \fIحالت Omega\fR عمل کرده و نشانه‌گذاری ^^\- آن را پردازش می‌کند: در این حالت، عبارت‌های \f(CW\*(C`^^ab\*(C'\fR، \f(CW\*(C`^^^^abcd\*(C'\fR و \f(CW\*(C`^^^^^^^^abcdefab\*(C'\fR به ترتیب نویسه‌های یونیکد با نقاط کد 0xab، 0xabcd و 0xabcdefab را نشان می‌دهند. این مقادیر با کدگذاری \s-1UTF\-8\s0 در خروجی نوشته می‌شوند.
.PP
اگر آرگومان اختیاری \fIattr_file\fR مشخص شده باشد، \fBtex2xindy\fR تمامی مشخصه‌های کلید نمایه را در این فایل ذخیره می‌کند.
.SH "کاستی‌ها (DEFICITS)"
.IX Header "DEFICITS"
این برنامه به این دلیل نوشته شد که استخراج تجزیه‌کننده از سامانه قدیمی makeindex به سادگی ممکن نبود. بنابراین، این ابزار بر خلاف نسخه \fImakeindex\fR\|(1) قادر به پیدا کردن تمام خطاهای ورودی نیست.
.PP
به علاوه، این ابزار تنها از مشخص‌کننده‌های ورودی پیش‌فرض \fImakeindex\fR\|(1) استفاده می‌کند. در صورتی که مشخص‌کننده‌های ورودی دیگری مورد نیاز باشد (ر.ک. صفحه راهنمای \fImakeindex\fR\|(1))، مشخص‌کننده‌های ورودی (که با الگوی \f(CW\*(C`KEYWORD\*(C'\fR آغاز می‌شوند؛ در ادامه آمده است) باید تغییر یابند و برنامه دوباره کامپایل شود.
.PP
مهم‌ترین قابلیت پیاده‌نشده، امکان پیکربندی نویسه‌های نقل‌قول (quote) و نویسه‌های واقعی (actual) است؛ همچنین شاید نویسه‌های گریز (escape)، زیرمورد (سطح) و پوشش‌دهنده (encap). به نظر می‌رسد جداکننده‌های آرگومان و دامنه مشکل کمتری ایجاد کنند.
.PP
در واقع، مدیریت نشانه‌گذاری ورودی (و در نتیجه \fBtex2xindy\fR) باید در هسته \fBxindy\fR ادغام شود تا امکان تعیین پیکربندی در فایل‌های شیوه‌نامه xindy فراهم گردد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fItexindy\fR\|(1),
\&\fIxindy\fR\|(1),
\&\fImakeindex\fR\|(1)
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Roger Kehr, Institut fuer Theoretische Informatik, \s-1TU\s0 Darmstadt
.SH "کپی‌رایت و مجوز (COPYRIGHT AND LICENSE)"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (c) 1996,1997 Roger Kehr.
.br
Copyright (c) 2006 Joachim Schrod.
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (\s-1GNU\s0 General Public License) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی دیگری، بازتوزیع کرده یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که مفید واقع شود، اما \s-1بدون\s0 \s-1هرگونه\s0 \s-1ضمانت\s0؛ حتی بدون ضمانت ضمنی \s-1قابلیت\s0 \s-1فروش\s0 یا \s-1تناسب\s0 \s-1برای\s0 \s-1یک\s0 \s-1هدف\s0 \s-1خاص\s0. برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را ببینید.
.PP
شما باید به همراه این برنامه یک نسخه از «مجوز عمومی همگانی گنو» (\s-1GNU\s0 General Public License) دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر بنویسید:
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, \s-1MA\s0 02139, \s-1USA\s0.