نام (NAME)

tex2xindy - پیش‌پردازنده‌ای برای پردازشگر نمایه xindy

خلاصه دستور (SYNOPSIS)

tex2xindy [-o] [attr_file]

توضیحات (DESCRIPTION)

دستور tex2xindy یک فایل نمایه LaTeX با پسوند ".idx" (یا یک فایل ".aux") را به یک فایل نمایه خام xindy تبدیل می‌کند.

این برنامه یک پالایه است که فایلی را در قالب ورودیِ فایل نمایه خام LaTeX، یعنی دارای برچسب‌های "\indexentry"، از stdin می‌خواند و در stdout یک فایل نمایه خام xindy، یعنی دارای عبارت‌های "indexentry"، را به عنوان خروجی ارائه می‌دهد.

اگر گزینه -o مشخص نشده باشد، tex2xindy نشانه‌گذاری ^^- در TeX را پردازش کرده و هشت‌بیت (بایت) معادل آن را در خروجی می‌آورد: عبارت "^^ab" در ورودی، به صورت بایت 0xab در خروجی نوشته می‌شود. اگر عبارت‌های "^^^^abcd" یا "^^^^^^^^abcdefab" تشخیص داده شوند، بدون تغییر در خروجی قرار می‌گیرند.

اگر گزینه -o مشخص شده باشد، tex2xindy در حالت Omega عمل کرده و نشانه‌گذاری ^^- آن را پردازش می‌کند: در این حالت، عبارت‌های "^^ab"، "^^^^abcd" و "^^^^^^^^abcdefab" به ترتیب نویسه‌های یونیکد با نقاط کد 0xab، 0xabcd و 0xabcdefab را نشان می‌دهند. این مقادیر با کدگذاری UTF-8 در خروجی نوشته می‌شوند.

اگر آرگومان اختیاری attr_file مشخص شده باشد، tex2xindy تمامی مشخصه‌های کلید نمایه را در این فایل ذخیره می‌کند.

کاستی‌ها (DEFICITS)

این برنامه به این دلیل نوشته شد که استخراج تجزیه‌کننده از سامانه قدیمی makeindex به سادگی ممکن نبود. بنابراین، این ابزار بر خلاف نسخه makeindex(1) قادر به پیدا کردن تمام خطاهای ورودی نیست.

به علاوه، این ابزار تنها از مشخص‌کننده‌های ورودی پیش‌فرض makeindex(1) استفاده می‌کند. در صورتی که مشخص‌کننده‌های ورودی دیگری مورد نیاز باشد (ر.ک. صفحه راهنمای makeindex(1))، مشخص‌کننده‌های ورودی (که با الگوی "KEYWORD" آغاز می‌شوند؛ در ادامه آمده است) باید تغییر یابند و برنامه دوباره کامپایل شود.

مهم‌ترین قابلیت پیاده‌نشده، امکان پیکربندی نویسه‌های نقل‌قول (quote) و نویسه‌های واقعی (actual) است؛ همچنین شاید نویسه‌های گریز (escape)، زیرمورد (سطح) و پوشش‌دهنده (encap). به نظر می‌رسد جداکننده‌های آرگومان و دامنه مشکل کمتری ایجاد کنند.

در واقع، مدیریت نشانه‌گذاری ورودی (و در نتیجه tex2xindy) باید در هسته xindy ادغام شود تا امکان تعیین پیکربندی در فایل‌های شیوه‌نامه xindy فراهم گردد.

همچنین ببینید (SEE ALSO)

texindy(1), xindy(1), makeindex(1)

نویسندگان (AUTHORS)

Roger Kehr, Institut fuer Theoretische Informatik, TU Darmstadt

کپی‌رایت و مجوز (COPYRIGHT AND LICENSE)

Copyright (c) 1996,1997 Roger Kehr.
Copyright (c) 2006 Joachim Schrod.

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی دیگری، بازتوزیع کرده یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا تناسب برای یک هدف خاص. برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را ببینید.

شما باید به همراه این برنامه یک نسخه از «مجوز عمومی همگانی گنو» (GNU General Public License) دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر بنویسید: Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.