.\" به‌طور خودکار توسط Pod::Man 4.11 (Pod::Simple 3.35) تولید شده است .\" .\" مقدمه استاندارد: .\" ======================================================================== .de Sp \" فضای عمودی (زمانی که نمی‌توانیم از .PP استفاده کنیم) .if t .sp .5v .if n .sp .. .de Vb \" آغاز متن عین‌عبارت (verbatim) .ft CW .nf .ne \\$1 .. .de Ve \" پایان متن عین‌عبارت (verbatim) .ft R .fi .. .\" راه‌اندازی برخی تبدیل‌های نویسه و رشته‌های از پیش تعریف‌شده. \*(-- یک .\" خط تیره نشکستنی ایجاد می‌کند، \*(PI مقدار pi را می‌دهد، \*(L" علامت نقل‌قول .\" دوتایی چپ، و \*(R" علامت نقل‌قول دوتایی راست را ایجاد می‌کند. \*(C+ یک .\" C++ زیباتر ایجاد خواهد کرد. امگای بزرگ برای ایجاد خط‌های تیره نشکستنی استفاده می‌شود و .\" بنابراین در دسترس نخواهد بود. \*(C` و \*(C' در nroff به `' بسط می‌یابند، .\" و در troff به هیچ، برای استفاده با 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" '' . ds C` . ds C' 'br\} .\" .\" فرار از علامت‌های نقل‌قول تکی در رشته‌های تحت‌اللفظی برای جلوگیری از تبدیل یونیکد groff. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" اگر ثبات F بزرگ‌تر از ۰ باشد، ورودی‌های نمایه را در stderr برای .\" عنوان‌ها (.TH)، سربرگ‌ها (.SH)، زیربخش‌ها (.SS)، آیتم‌ها (.Ip)، و ورودی‌های نمایه .\" علامت‌گذاری‌شده با X<> در POD تولید می‌کنیم. البته باید خودتان خروجی را .\" به شکلی معنادار پردازش کنید. .\" .\" جلوگیری از اخطار groff درباره ثبات تعریف‌نشده 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" تعاریف علامت‌های اکسنت (@(#)ms.acc 1.5 88/02/08 SMI؛ برگرفته از UCB 4.2). .\" بترسید. فرار کنید. خودتان را نجات دهید. هیچ بخش قابل تعمیر توسط کاربر وجود ندارد. . \" ضرایب اصلاحی برای nroff و 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 #] \& .\} . \" اکسنت‌های ساده برای nroff و 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 و nroff (چرخ آفتابگردانی) .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 . \" تصحیحات برای 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' . \" برای دستگاه‌های با تفکیک‌پذیری پایین (crt و 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 "texindy 1" .TH texindy 1 "2020-05-28" "Release 2.5.1" "xindy" .\" برای nroff، تراز کردن متن را خاموش کنید. همیشه فاصله‌گذاری خط تیره را خاموش کنید؛ این کار .\" در اسناد فنی خطاهای بسیار زیادی ایجاد می‌کند. .if n .ad l .nh.SH "نام (NAME)" texindy \- ایجاد نمایه مرتب‌شده و برچسب‌گذاری‌شده از نمایه خام LaTeX .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" .Vb 2 \& texindy [\-V?h] [\-qv] [\-iglr] [\-d magic] [\-o outfile.ind] [\-t log] \e \& [\-L lang] [\-C codepage] [\-M module] [idx0 idx1 ...] .Ve .SS "گزینه‌های طولانی به سبک گنو برای گزینه‌های کوتاه:" .IX Subsection "GNU-Style Long Options for Short Options:" .Vb 10 \& \-V / \-\-version \& \-? / \-h / \-\-help \& \-q / \-\-quiet \& \-v / \-\-verbose \& \-i / \-\-stdin \& \-g / \-\-german \& \-l / \-\-letter\-ordering \& \-r / \-\-no\-ranges \& \-d / \-\-debug (چندین بار) \& \-o / \-\-out\-file \& \-t / \-\-log\-file \& \-L / \-\-language \& \-C / \-\-codepage \& \-M / \-\-module (چندین بار) \& \-I / \-\-input\-markup (پشتیبانی‌شده: latex، xelatex، omega) .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBtexindy\fR نسخهٔ ویژهٔ LaTeX از سامانه‌ی نمایه‌سازی انعطاف‌پذیر xindy است. این دستور یک نمایهٔ خام را به عنوان ورودی دریافت کرده و یک نمایهٔ ادغام‌شده، مرتب‌شده و برچسب‌گذاری‌شده تولید می‌کند. ادغام، مرتب‌سازی و برچسب‌گذاری توسط ماژول‌های xindy کنترل می‌شود که مجموعه‌ای مناسب از آن‌ها از پیش بارگذاری شده است. .PP فایل‌های حاوی نمایهٔ خام به عنوان آرگومان ارسال می‌شوند. اگر هیچ آرگومانی ارسال نشود، نمایهٔ خام از ورودی استاندارد خوانده خواهد شد. .PP توضیحات مقدماتی مناسبی از \fBtexindy\fR در فصل نمایه‌سازی کتاب LaTeX Companion (ویرایش دوم) آمده است. .PP اگر می‌خواهید برای اسناد LaTeX با نشانه‌گذاری‌های خاص نمایه، نمایه‌ای تولید کنید، دستور \fBxindy\fR\|(1) احتمالاً برای شما کاربردی‌تر خواهد بود. .PP \&\fBtexindy\fR رویکردی برای تلفیق پشتیبانی از چارچوب \fImake-rules\fR، ماژول‌های اختصاصی xindy (برای مثال، برای دستورات ویژهٔ LaTeX در نمایه)، و سطحی معقول از سازگاری با MakeIndex است. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .ie n .IP """\-\-version"" / \fB\-V\fR" 4 .el .IP "\f(CW\-\-version\fR / \fB\-V\fR" 4 .IX Item "--version / -V" شماره نسخهٔ تمام مؤلفه‌های مرتبط را نمایش داده و خارج می‌شود. .ie n .IP """\-\-help"" / \fB\-h\fR / \fB\-?\fR" 4 .el .IP "\f(CW\-\-help\fR / \fB\-h\fR / \fB\-?\fR" 4 .IX Item "--help / -h / -?" پیام راهنمای استفاده را به همراه توضیح گزینه‌ها در خروجی نمایش می‌دهد. .ie n .IP """\-\-quiet"" / \fB\-q\fR" 4 .el .IP "\f(CW\-\-quiet\fR / \fB\-q\fR" 4 .IX Item "--quiet / -q" پیام‌های پیشرفت را در خروجی چاپ نمی‌کند. فقط پیام‌های خطا نمایش داده می‌شوند. .ie n .IP """\-\-verbose"" / \fB\-v\fR" 4 .el .IP "\f(CW\-\-verbose\fR / \fB\-v\fR" 4 .IX Item "--verbose / -v" پیام‌های پیشرفت را با جزئیات کامل در خروجی چاپ می‌کند. .ie n .IP """\-\-debug"" \fImagic\fR / \fB\-d\fR \fImagic\fR" 4 .el .IP "\f(CW\-\-debug\fR \fImagic\fR / \fB\-d\fR \fImagic\fR" 4 .IX Item "--debug magic / -d magic" پیام‌های اشکال‌زدایی را در خروجی چاپ می‌کند؛ این گزینه می‌تواند چندین بار مشخص شود. \&\fImagic\fR تعیین می‌کند چه مواردی در خروجی نمایش داده شوند: .Sp .Vb 6 \& magic توضیح \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& script پیام‌های پیشرفت درونی اسکریپت‌های راه‌انداز \& keep_tmpfiles فایل‌های موقت را حذف نکن \& markup ردگیری نشانه‌گذاری خروجی، مطابق توضیحات راهنمای xindy \& level=n سطح ثبت وقایع، n برابر 0 (پیش‌فرض)، 1، 2، یا 3 است .Ve .ie n .IP """\-\-out\-file"" \fIoutfile.ind\fR / \fB\-o\fR \fIoutfile.ind\fR" 4 .el .IP "\f(CW\-\-out\-file\fR \fIoutfile.ind\fR / \fB\-o\fR \fIoutfile.ind\fR" 4 .IX Item "--out-file outfile.ind / -o outfile.ind" نمایه را در فایل \fIoutfile.ind\fR ذخیره می‌کند. اگر این گزینه مشخص نشود، نام فایل خروجی برابر با نام پایهٔ آرگومان اول با پسوند \fIind\fR خواهد بود. اگر نمایهٔ خام از ورودی استاندارد خوانده شود، تعیین این گزینه الزامی است. .ie n .IP """\-\-log\-file"" \fIlog.ilg\fR / \fB\-t\fR \fIlog.ilg\fR" 4 .el .IP "\f(CW\-\-log\-file\fR \fIlog.ilg\fR / \fB\-t\fR \fIlog.ilg\fR" 4 .IX Item "--log-file log.ilg / -t log.ilg" پیام‌های گزارش را در فایل \fIlog.ilg\fR ذخیره می‌کند. این پیام‌های گزارش مستقل از پیام‌های پیشرفتی هستند که می‌توانید با \f(CW\*(C`\-\-debug\*(C'\fR یا \f(CW\*(C`\-\-verbose\*(C'\fR آن‌ها را تغییر دهید. .ie n .IP """\-\-language"" \fIlang\fR / \fB\-L\fR \fIlang\fR" 4 .el .IP "\f(CW\-\-language\fR \fIlang\fR / \fB\-L\fR \fIlang\fR" 4 .IX Item "--language lang / -L lang" نمایه بر اساس قواعد زبان \fIlang\fR مرتب می‌شود. این قواعد در یک ماژول xindy که توسط \fImake-rules\fR ایجاد شده کدگذاری شده‌اند. .Sp اگر هیچ کدگذاری ورودی از طریق \f(CW\*(C`\-\-codepage\*(C'\fR مشخص نشده باشد یا توسط نشانه‌گذاری ورودی تحمیل نشده باشد، ماژول xindy مربوط به آن زبان با کدگذاری‌های latin ،cp ،iso ،ascii یا utf8 (به همین ترتیب) جستجو می‌شود. .ie n .IP """\-\-codepage"" \fIenc\fR / \fB\-C\fR \fIenc\fR" 4 .el .IP "\f(CW\-\-codepage\fR \fIenc\fR / \fB\-C\fR \fIenc\fR" 4 .IX Item "--codepage enc / -C enc" برای این گزینه دو موقعیت و مورد کاربرد متفاوت وجود دارد: .RS 4 .IP "1." 4 نشانه‌گذاری ورودی \f(CW\*(C`latex\*(C'\fR باشد (پیش‌فرض). .Sp در این حالت، ورودی خام \fBtexindy\fR به عنوان کدگذاری‌شده در «نمایش درونی نویسه‌های LaTeX» (\s-1LICR\s0) فرض می‌شود؛ یعنی نویسه‌های غیر ASCII به صورت توالی‌های دستور کدگذاری می‌شوند. این گزینه به xindy می‌گوید که از چه کدگذاری برای سربرگ‌های گروه‌های حرفی استفاده کند. (علاوه بر این، کدگذاری مورداستفاده در درون برنامه برای مرتب‌سازی را نیز مشخص می‌کند \*(-- اما این تأثیری در نتیجهٔ نهایی ندارد.) .Sp تنها کدگذاری‌های \s-1LICR\s0 برای الفباهای خط لاتین پشتیبانی می‌شوند؛ به‌طور دقیق‌تر نویسه‌هایی که در کدگذاری‌های \s-1LICR\s0 بسته‌های latin1، latin2 و latin3 در LaTeX قرار دارند. .Sp حتی اگر \f(CW\*(C`utf8\*(C'\fR را به عنوان codepage مشخص کنید، تنها همین نویسه‌ها شناخته خواهند شد. اما اگر از الفباهای غیرلاتین استفاده می‌کنید، احتمالاً از XeLaTeX یا LuaLaTeX استفاده می‌کنید (یا باید استفاده کنید) و بنابراین نشانه‌گذاری ورودی متفاوتی خواهید داشت. .IP "2." 4 نشانه‌گذاری ورودی \f(CW\*(C`xelatex\*(C'\fR یا \f(CW\*(C`omega\*(C'\fR باشد. .Sp در این صورت، این گزینه نادیده گرفته شده و codepage پیش‌فرض \f(CW\*(C`utf8\*(C'\fR تحمیل می‌شود. .Sp ورودی خام \&\fBtexindy\fR به صورت کدگذاری‌شده با \s-1UTF\-8\s0 فرض می‌شود و از \s-1LICR\s0 استفاده نمی‌شود. .RE .RS 4 .RE .ie n .IP """\-\-module"" \fImodule\fR / \fB\-M\fR \fImodule\fR" 4 .el .IP "\f(CW\-\-module\fR \fImodule\fR / \fB\-M\fR \fImodule\fR" 4 .IX Item "--module module / -M module" ماژول xindy به نام \fImodule.xdy\fR را بارگذاری می‌کند. این گزینه می‌تواند چندین بار مشخص شود. ماژول‌ها در مسیر جستجوی xindy جستجو می‌شوند که می‌توان آن را با متغیر محیطی \f(CW\*(C`XINDY_SEARCHPATH\*(C'\fR تغییر داد. .ie n .IP """\-\-input\-markup"" \fIinput\fR / \fB\-I\fR \fIinput\fR" 4 .el .IP "\f(CW\-\-input\-markup\fR \fIinput\fR / \fB\-I\fR \fIinput\fR" 4 .IX Item "--input-markup input / -I input" نشانه‌گذاری ورودی نمایهٔ خام را مشخص می‌کند. مقادیر پشتیبانی‌شده برای \fIinput\fR عبارتند از \f(CW\*(C`latex\*(C'\fR، \f(CW\*(C`xelatex\*(C'\fR و \f(CW\*(C`omega\*(C'\fR. .Sp نشانه‌گذاری ورودی \&\f(CW\*(C`latex\*(C'\fR همان نشانه‌گذاری است که به طور پیش‌فرض توسط هستهٔ LaTeX یا توسط بستهٔ ماکروی \f(CW\*(C`index\*(C'\fR اثر David Jones هنگام استفاده با LaTeX استاندارد یا pdfLaTeX تولید می‌شود. نمادگذاری ^^ برای نویسه‌های تک‌بایتی پشتیبانی می‌شود. همچنین استفاده از بستهٔ \fIinputenc\fR در LaTeX مفروض است، یعنی ورودی خام با \s-1LICR\s0 کدگذاری شده است. .Sp نشانه‌گذاری ورودی \&\f(CW\*(C`xelatex\*(C'\fR شبیه به \f(CW\*(C`latex\*(C'\fR است، اما بدون استفاده از \fIinputenc\fR. ورودی خام با \s-1UTF\-8\s0 کدگذاری می‌شود. LuaLaTeX نیز نشانه‌گذاری ورودی یکسانی دارد و مقدار گزینهٔ مجزایی برای آن وجود ندارد. .Sp نشانه‌گذاری ورودی \&\f(CW\*(C`omega\*(C'\fR مشابه نشانه‌گذاری ورودی \f(CW\*(C`latex\*(C'\fR است، اما از نمادگذاری ^^ متعلق به Omega به عنوان کدگذاری برای نویسه‌های غیر ASCII استفاده می‌کند. در این صورت از کدگذاری \s-1LICR\s0 استفاده نمی‌شود و \f(CW\*(C`utf8\*(C'\fR به عنوان codepage اجباری برای مرتب‌سازی و خروجی سربرگ‌های گروه‌های حرفی اعمال خواهد شد..SH "زبان‌ها / کدپیج‌های پشتیبانی‌شده (SUPPORTED LANGUAGES / CODEPAGES)" .IX Header "SUPPORTED LANGUAGES / CODEPAGES" زبان‌های زیر پشتیبانی می‌شوند: .SS "خط‌های لاتین (Latin scripts)" .IX Subsection "Latin scripts" .Vb 10 \& albanian gypsy portuguese \& croatian hausa romanian \& czech hungarian russian\-iso \& danish icelandic slovak\-small \& english italian slovak\-large \& esperanto kurdish\-bedirxan slovenian \& estonian kurdish\-turkish spanish\-modern \& finnish latin spanish\-traditional \& french latvian swedish \& general lithuanian turkish \& german\-din lower\-sorbian upper\-sorbian \& german\-duden norwegian vietnamese \& greek\-iso polish .Ve .PP زبان آلمانی دو طرح مرتب‌سازی متفاوت را برای مدیریت اوملاوت‌ها به رسمیت می‌شناسد: به‌طور معمول، \f(CW\*(C`a\*:\*(C'\fR مانند \f(CW\*(C`ae\*(C'\fR مرتب می‌شود، اما در دفترچه‌های تلفن یا لغت‌نامه‌ها، مانند \f(CW\*(C`a\*(C'\fR مرتب می‌شود. طرح نخست به عنوان \&\fIترتیب \s-1DIN\s0\fR و طرح دوم به عنوان \fIترتیب Duden\fR شناخته می‌شود. .PP نام‌های زبان \&\f(CW\*(C`*\-iso\*(C'\fR فرض می‌کنند که مدخل‌های خام نمایه با کدگذاری \s-1ISO 8859\-9\s0 هستند. .PP \&\f(CW\*(C`gypsy\*(C'\fR یکی از گویش‌های شمالی زبان روسی است. .SS "خط‌های سیریلیک (Cyrillic scripts)" .IX Subsection "Cyrillic scripts" .Vb 3 \& belarusian mongolian serbian \& bulgarian russian ukrainian \& macedonian .Ve .SS "سایر خط‌ها (Other scripts)" .IX Subsection "Other scripts" .Vb 1 \& greek klingon .Ve .SS "کدپیج‌های موجود (Available Codepages)" .IX Subsection "Available Codepages" این بخش هنوز نوشته نشده است. می‌توانید آن‌ها را در توزیع xindy خود، در دایرکتوری \fImodules/lang/language/\fR (که در آن \&\fIlanguage\fR زبان شما است) بیابید. آن‌ها به‌صورت \&\fIvariant\-codepage\-lang.xdy\fR نام‌گذاری شده‌اند، که در آن اغلب \fIvariant\-\fR خالی است (برای آلمانی، \f(CW\*(C`din5007\*(C'\fR و \f(CW\*(C`duden\*(C'\fR؛ برای اسپانیایی، \f(CW\*(C`modern\*(C'\fR و \f(CW\*(C`traditional\*(C'\fR، و غیره). .PP .Vb 1 \& < شرح کدپیج‌های در دسترس برای هر زبان > \& \& < شرح ارتباط کدپیج‌ها (به‌عنوان نمایش درونی) برای \& LaTeX inputenc > .Ve .SH "ماژول‌های استاندارد TEXINDY (TEXINDY STANDARD MODULES)" .IX Header "TEXINDY STANDARD MODULES" مجموعه‌ای از ماژول‌های استاندارد \fBtexindy\fR وجود دارند که به پردازش فایل‌های نمایه LaTeX کمک می‌کنند. برخی از آن‌ها به‌طور خودکار بارگذاری می‌شوند. برخی از آن‌ها به‌طور پیش‌فرض بارگذاری می‌شوند که می‌توان این رفتار را با یک گزینه \fBtexindy\fR غیرفعال کرد. سایر ماژول‌ها را می‌توان به‌عنوان آرگومان \f(CW\*(C`\-\-module\*(C'\fR برای رسیدن به نتیجه‌ای خاص مشخص کرد. .PP .Vb 1 \& ماژول xindy دسته‌بندی توضیحات .Ve .SS "مرتب‌سازی (Sorting)" .IX Subsection "Sorting" .Vb 10 \& word\-order پیش‌فرض یک فاصله پیش از هر حرفی در الفبا قرار می‌گیرد: \& \`\`index style\*(Aq\*(Aq پیش از \`\`indexing\*(Aq\*(Aq فهرست \& می‌شود. با گزینه \-l غیرفعالش کنید. \& letter\-order افزودنی فاصله‌ها نادیده گرفته می‌شوند: \`\`index style\*(Aq\*(Aq \& پس از \`\`indexing\*(Aq\*(Aq مرتب می‌شود. \& keep\-blanks افزودنی فاصله‌های خالی ابتدایی و انتهایی (فاصله‌ها \& و تب‌ها) نادیده گرفته نمی‌شوند؛ فاصله خالی \& میانی تغییری نمی‌کند. \& ignore\-hyphen افزودنی خط‌های پیوند نادیده گرفته می‌شوند: \& \`\`ad\-hoc\*(Aq\*(Aq به‌صورت \`\`adhoc\*(Aq\*(Aq مرتب می‌شود. \& ignore\-punctuation افزودنی انواع نویسه‌های نشانه‌گذاری نادیده گرفته می‌شوند: \& خط پیوند، نقطه، ویرگول، اسلش، \& پرانتز و غیره. \& numeric\-sort خودکار اعداد به‌صورت عددی مرتب می‌شوند، نه مانند \& نویسه‌ها: \`\`V64\*(Aq\*(Aq پیش از \`\`V128\*(Aq\*(Aq می‌آید. .Ve.SS "شماره‌های صفحه (Page Numbers)" .IX Subsection "Page Numbers" .Vb 10 \& page\-ranges پیش‌فرض موارد تکرار در بیش از دو صفحهٔ متوالی به‌صورت \& یک بازه فهرست می‌شوند: \`\`1\-\-4\*(Aq\*(Aq. \& آن را با گزینهٔ \-r غیرفعال کنید. \& ff\-ranges افزودنی از نمادگذاری ضمنی \`\`ff\*(Aq\*(Aq برای بازه‌های \& سه صفحه‌ای، و پس از آن از بازه‌های صریح \& استفاده می‌کند: 2f, 2ff, 2\-\-6. \& ff\-ranges\-only افزودنی تنها از بازه‌های ضمنی استفاده می‌کند: 2f, 2ff. \& book\-order افزودنی شماره‌های صفحه را با طرح شماره‌گذاری معمول کتاب \& به‌درستی مرتب می‌کند \-\- ابتدا اعداد رومی، سپس \& اعداد عربی، سپس دیگر موارد: i, 1, A. .Ve .SS "نشانه‌گذاری و چیدمان (Markup and Layout)" .IX Subsection "Markup and Layout" .Vb 10 \& tex خودکار قواعد پایه‌ای TeX را مدیریت می‌کند. \& latex\-loc\-fmts خودکار دستورهای قالب‌بندی LaTeX را برای کپسوله‌سازی \& شمارهٔ صفحه ارائه می‌دهد. \& latex خودکار قواعد LaTeX را هم در مدخل‌های خام نمایه و هم در \& نشانه‌گذاری خروجی مدیریت می‌کند؛ شامل tex نیز هست. \& makeindex خودکار نحو ورودی پیش‌فرض MakeIndex و رفتار نقل‌قول \& آن را شبیه‌سازی می‌کند. \& latin\-lettergroups خودکار چیدمان شامل یک حرف لاتین منفرد در بالای هر \& گروه از کلماتی است که با همان حرف آغاز می‌شوند. \& german\-sty افزودنی نشانه‌گذاری اوملاوت گزینه‌های german و ngerman \& در babel را مدیریت می‌کند. .Ve .SH "سازگاری با MAKEINDEX (COMPATIBILITY TO MAKEINDEX)" .IX Header "COMPATIBILITY TO MAKEINDEX" \&\fBxindy\fR ادعای سازگاری کامل با MakeIndex را ندارد؛ چرا که این امر مانع از برخی بهبودهای آن می‌شد. با این وجود، ما تلاش می‌کنیم تا بیشترین سازگاری ممکن را ارائه دهیم. مهم‌ترین ناسازگاری‌ها عبارتند از: .IP "\(bu" 4 برای مدخل‌های خام نمایه در نحو LaTeX، عبارت \f(CW\*(C`\eindex{aaa|bbb}\*(C'\fR به گونهٔ متفاوتی تفسیر می‌شود. برای MakeIndex، مقدار \f(CW\*(C`bbb\*(C'\fR نشانه‌گذاری‌ای است که به عنوان یک برچسب LaTeX برای این شمارهٔ صفحه در خروجی درج می‌شود. برای \fBxindy\fR، این یک صفت مکان (location attribute) است؛ یک شناسهٔ انتزاعی که بعداً با نشانه‌گذاری‌ای که باید برای آن صفت در خروجی ظاهر شود، مرتبط خواهد شد. .Sp برای استفاده‌های ساده، هنگامی که \f(CW\*(C`bbb\*(C'\fR برابر با \f(CW\*(C`textbf\*(C'\fR یا مانند آن باشد، ما تعاریف صفت مکانی را ارائه می‌دهیم که رفتار MakeIndex را شبیه‌سازی می‌کند. .Sp برای استفاده‌های پیچیده‌تر، هنگامی که \f(CW\*(C`bbb\*(C'\fR یک شناسه نباشد، چنین تعاریف سازگاری‌ای وجود ندارد و ممکن است در نسخهٔ کنونی \fBxindy\fR نیز امکان ایجاد آن‌ها وجود نداشته باشد. گزارش شده است که چنین وضعیتی برای کلاس LaTeX با نام \&\f(CW\*(C`memoir\*(C'\fR رخ می‌دهد. .Sp برنامه‌نویسانی که Common Lisp و Lex را می‌دانند و می‌خواهند روی یک راهکار کار کنند، لطفاً با نویسنده تماس بگیرند. .IP "\(bu" 4 اگر یک بازهٔ نمایه و یک صفت مکان دارید، برای نمونه اگر \&\f(CW\*(C`\eindex{key\e(attr}\*(C'\fR بازه را آغاز کند، کاربر باید (۱) آن صفت را در مدخل بستن بازه نیز مشخص کند (یعنی به‌صورت \&\f(CW\*(C`\eindex{key\e)attr}\*(C'\fR) و (۲) صفت نمایه را در یک فایل سبک \&\fBxindy\fR تعریف کند. .Sp ابزار MakeIndex برای چنین ساختاری، نشانه‌گذاری \f(CW\*(C`\eattr{page1\-\-page2}\*(C'\fR را در خروجی تولید می‌کند. دستیابی به این ساختار در \fBxindy\fR امکان‌پذیر نیست؛ خروجی به‌صورت \f(CW\*(C`\eattrMarkup{page1}\-\-\eattrMarkup{page2}\*(C'\fR خواهد بود. (این مورد در واقع یک باگ محسوب می‌شود، اما از اولویت بالایی برخوردار نیست.) .Sp تفاوت بین برچسب‌های شمارهٔ صفحه در MakeIndex و صفت‌های مکان در \&\fBxindy\fR پیش‌تر در مورد قبلی توضیح داده شد. .IP "\(bu" 4 تعاریف سازگاری MakeIndex تنها از نحو پیش‌فرض نمایهٔ خام و تعریف نشانه‌گذاری پشتیبانی می‌کنند. امکان پیکربندی تجزیهٔ نمایهٔ خام یا استفاده از یک فایل سبک MakeIndex برای توصیف نشانه‌گذاری خروجی وجود ندارد. .SH "محیط (ENVIRONMENT)" .IX Header "ENVIRONMENT" .ie n .IP """TEXINDY_AUTO_MODULE""" 4 .el .IP "\f(CWTEXINDY_AUTO_MODULE\fR" 4 .IX Item "TEXINDY_AUTO_MODULE" این نام ماژول xindy است که تمام ماژول‌های بارگیری‌شونده به‌صورت خودکار را بارگذاری می‌کند. مقدار پیش‌فرض \f(CW\*(C`texindy\*(C'\fR است..SH "نویسنده (AUTHOR)" .IX Header "AUTHOR" Joachim Schrod .SH "شرایط حقوقی (LEGALESE)" .IX Header "LEGALESE" کپی‌رایت (c) 2004\-2014 متعلق به Joachim Schrod. .PP \&\fBtexindy\fR یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی \s-1GNU\s0 که توسط Free Software Foundation منتشر شده است؛ چه نسخهٔ ۲ مجوز یا (به انتخاب خودتان) هر نسخهٔ بالاتر دیگری، بازتوزیع کرده و/یا تغییر دهید. .PP این برنامه با این امید که مفید باشد توزیع شده است، اما \s-1بدون هیچ‌گونه ضمانت\s0؛ حتی بدون ضمانت ضمنی \&\s-1قابلیت فروش\s0 یا \s-1تناسب برای یک هدف خاص\s0. برای جزئیات بیشتر به \&\s-1GNU\s0 General Public License مراجعه کنید.