| UPMENDEX(1) | General Commands Manual | UPMENDEX(1) |
نام (NAME)
upmendex - پردازشگر نمایه چندزبانه
خلاصه دستور (SYNOPSIS)
upmendex [-ilqrcgf] [-s sty] [-d
dic] [-o ind] [-t log] [-p no]
[--] [ idx0 idx1 idx2 ...]
upmendex --help
upmendex --version
توضیحات (DESCRIPTION)
برنامه upmendex
یک
تولیدکننده
نمایه
سلسلهمراتبی
چندزبانه
با کاربرد
عمومی است
که با upLaTeX، XeLaTeX و LuaLaTeX
کار
میکند؛
این برنامه
یک یا چند
فایل ورودی
(.idx؛
معمولاً
تولیدشده
توسط
قالببندیکنندههای
متنی مانند
خانواده LaTeX)
را
میپذیرد،
مدخلها را
مرتب
میکند و یک
فایل خروجی
تولید
میکند که
قابل
قالببندی
است. این
ابزار از
خطهای
لاتین (شامل
زبانهای
غیرانگلیسی)،
یونانی،
سیریلیک،
هانگول
کرهای و
هان
(اندیشهنگاشتهای
هانزی) و
همچنین
کانای
ژاپنی
پشتیبانی
میکند.
همچنین
بهصورت
آزمایشی از
خطهای
برهمایی
(بنگالی،
دیواناگری،
گورموکی،
گجراتی،
کانادا،
لائو،
مالایالام،
اوریا،
سینهالی،
تامیلی،
تلوگو و
تایلندی)،
عربی و عبری
پشتیبانی
میکند. این
برنامه تا
حد زیادی با
makeindex و mendex
سازگار
است، و
قابلیت
اضافی برای
مدیریت
خوانش
کلمات
کانجی (kanji) نیز
در دسترس
است.
قالبهای
فایلهای
ورودی و
خروجی در یک
فایل
شیوهنامه
(style file) مشخص
میشوند.
خوانش
کلمات
کانجی را
میتوان در
یک فایل
فرهنگلغت
مشخص کرد.
نمایه
میتواند
تا پنج سطح
(۰، ۱، ۲، ۳ و
۴)
زیرمجموعه
تو در تو
داشته
باشد.
گزینهها (OPTIONS)
- -i
- دریافت ورودی از stdin، حتی در صورتی که فایلهای نمایه مشخص شده باشند.
- -l
- تنظیم بر روی «مرتبسازی بر اساس ترتیب نویسهها». بهطور پیشفرض، از «مرتبسازی بر اساس ترتیب کلمات» استفاده میشود. جزئیات در ادامه شرح داده شده است.
- -q
- حالت بیصدا؛ هیچ پیامی به stderr ارسال نمیشود، مگر پیامهای خطا و هشدارها.
- -r
- غیرفعالسازی تشکیل ضمنی بازه صفحات. بهطور پیشفرض، سه یا چند صفحه متوالی بهطور خودکار بهصورت یک بازه خلاصه میشوند (مانند 1–5).
- -c
- فشردهسازی توالی فاصلههای میانی (فاصله(ها) و/یا تب(ها)) به یک فاصله و نادیده گرفتن فاصلههای خالی ابتدا و انتها. بهطور پیشفرض، فاصلههای خالی در کلید نمایه حفظ میشوند.
- -g
- تنظیم سربرگ نمایه ژاپنی بر روی سطر A (A, Ka, Sa, ...؛ ۱۰ نویسه) از جدول gojuon (هجانگار ژاپنی). بهطور پیشفرض، تمام ۴۸ نویسه موجود در جدول gojuon استفاده میشوند.
- -f
- اجبار به چاپ نویسهها در خروجی، حتی اگر خطهای نوشتاری مربوطه توسط upmendex پشتیبانی نشوند.
- -s sty
- بهکارگیری sty به عنوان فایل شیوهنامه (style file).
- -d dic
- بهکارگیری dic به عنوان فایل فرهنگلغت. فایل فرهنگلغت از فهرستی از <index_word reading> تشکیل شده است.
- -o ind
- بهکارگیری ind به عنوان فایل نمایه خروجی. بهطور پیشفرض، نام فایل با افزودن پسوند ind به نام پایه نخستین فایل ورودی ایجاد میشود.
- -t log
- بهکارگیری log به عنوان فایل گزارش (transcript file). بهطور پیشفرض، نام فایل با افزودن پسوند ilg به نام پایه نخستین فایل ورودی ایجاد میشود.
- -p no
- تنظیم شماره صفحه آغازین فهرست نمایه خروجی بر روی no. آرگومان no میتواند عددی باشد یا یکی از مقادیر زیر: any (صفحه بعد از پایان محتوا)، odd (صفحه فرد بعد از پایان محتوا)، even (صفحه زوج بعد از پایان محتوا).
- --help
- نمایش خلاصه گزینهها و خروج.
- --version
- نمایش اطلاعات نسخه و خروج.
- --
- آرگومانهای پس از -- به عنوان گزینه در نظر گرفته نمیشوند. این قابلیت زمانی مفید است که نام فایل ورودی با '-' شروع شود..SH "فایل شیوهنامه (STYLE FILE)" فایل شیوهنامه به upmendex دربارهٔ قالب فایلهای ورودی idx و قالب مد نظر برای فایل خروجی نهایی اطلاعات میدهد. این قالب با قالب برنامههای makeindex و mendex سازگاری رو به بالا دارد. فایل شیوهنامه شامل فهرستی از جفتهای <specifier attribute> است. دو نوع مشخصکننده وجود دارد: ورودی و خروجی. نیازی نیست جفتها با ترتیب خاصی قرار بگیرند. خطی که با ´%´ آغاز شود یک یادداشت (کامنت) است.
پارامتر سبک فایل ورودی
- keyword <string>
- "\\indexentry"
- arg_open <char>
- ´{´
- arg_close <char>
- ´}´
- level <char>
- ´!´
- actual <char>
- ´@´
- encap <char>
- ´|´
- page_precedence <string>
- "rnaRA"
- quote <char>
- ´"´
- escape <char>
- ´\\´
پارامتر سبک فایل خروجی
- preamble <string>
- "\\begin{theindex}\n"
- postamble <string>
- "\n\n\\end{theindex}\n"
- setpage_prefix <string>
- "\n \\setcounter{page}{"
- setpage_suffix <string>
- "}\n"
- group_skip <string>
- "\n\n \\indexspace\n"
- script_head <string 1> <string 2>
- "(standard heading characters)"
- devanagari_head <string>
- "ऄअआइईउऊऋऌऍऎएऐऑऒओऔकखगघङचछजझञटठडढणतथदधनपफबभमयरलळवशषसह"
- thai_head <string>
- "กขฃคฅฆงจฉชซฌญฎฏฐฑฒณดตถทธนบปผฝพฟภมยรฤลฦวศษสหฬอฮ"
- item_0 <string>
- "\n \\item "
- item_1 <string>
- "\n \\subitem "
- item_2 <string>
- "\n \\subsubitem "
- item_3 <string>
- "\n \\subsubsubitem "
- item_4 <string>
- "\n \\subsubsubsubitem "
- item_01 <string>
- "\n \\subitem "
- item_12 <string>
- "\n \\subsubitem "
- item_23 <string>
- "\n \\subsubsubitem "
- item_34 <string>
- "\n \\subsubsubsubitem "
- item_x1 <string>
- "\n \\subitem "
- item_x2 <string>
- "\n \\subsubitem "
- item_x3 <string>
- "\n \\subsubsubitem "
- item_x4 <string>
- "\n \\subsubsubsubitem "
- delim_0 <string>
- ", "
- delim_1 <string>
- ", "
- delim_2 <string>
- ", "
- delim_3 <string>
- ", "
- delim_4 <string>
- ", "
- delim_n <string>
- ", "
- delim_r <string>
- "--"
- symhead_negative <string>
- "symbols"
- numhead_positive <string>
- "Numbers"
- numhead_negative <string>
- "numbers"
- character_order <string>
- "SNLGCJKHDbpgotukmsTlah"
upmendex در
مقایسه با
makeindex، از یک
ویژگی
اضافی برای
سادهسازی
فرآیند
مدیریت
نمایههای
ژاپنی
برخوردار
است.
کاربران
میتوانند
از زحمت
تعیین دستی
خوانش (تلفظ)
برای هر
کلمهٔ
کانجی (kanji)
صرفنظر
کنند.
کلمات
کانجی
ژاپنی
معمولاً بر
اساس
هجاهای
خوانش
آنها (´Yomi´)
مرتب
میشوند که
میتوان
آنها را با
خطهای
کانا
(هیراگانا،
کاتاکانا)
نشان داد. upmendex
کلمات
نمایهای
را که
مستقیماً
در فایل
ورودی به
صورت عبارت
کانا مشخص
شدهاند
میپذیرد،
و همچنین
تبدیل
کلمات
نمایه از
کانجی یا
نمادها به
خطهای
آوانگار را
با ارجاع به
فرهنگلغتهای
ژاپنی
انجام
میدهد.
نمونههایی از سادهسازی درونی هجاها در زیر نشان داده شده است.
かぶしきがいしゃ かふしきかいしや
マッキントッシュ まつきんとつしゆ
ワープロ わあふろ
فایل
فرهنگلغت
شامل
فهرستی با
ساختار
<´index_word´ ´reading´>
است. کلمهٔ
نمایه را
میتوان به
هر خطی
(کانجی،
کانا و غیره)
نوشت، و
خوانش
میتواند
به هر خط
آوانگاری
مانند
خطهای
هیراگانا
یا
کاتاکانا
باشد.
جداکنندهٔ
بین کلمهٔ
نمایه و
خوانش آن،
یک یا چند
نویسهٔ تب (tab)
یا فاصله (space)
است.
نمونهای
از یک
فرهنگلغت
ژاپنی در
زیر نشان
داده شده
است.
漢字 かんじ
読み よみ
環境 かんきょう
$ ドル
در اینجا،
هر کلمهٔ
نمایه مجاز
است تنها یک
Yomi داشته
باشد. اگرچه
برخی از
کلمات
کانجی
(مانند «表»)
ممکن است
بیش از یک Yomi
داشته
باشند
(مانند
«ひょう» و
«おもて»)،
تنها یکی از
آنها
میتواند
در
فرهنگلغت
ثبت شود.
هنگامی که
به Yomiهای
متفاوتی
نیاز باشد،
باید
بهطور
صریح با
عبارت کانا
(مانند
\index{ひょう@表} یا
\index{おもて@表}) در
فایل ورودی
مشخص شوند.
علاوه بر
این، با
تعیین نام
فایل در
متغیر
محیطی
INDEXDEFAULTDICTIONARY، به یک
فایل
فرهنگلغت
بهطور
خودکار
ارجاع داده
میشود.
فرهنگلغت
تعیینشده
توسط این
متغیر
محیطی
میتواند
همراه با
فایل(های)
مشخصشده
توسط
گزینهٔ -d
استفاده
شود.
درباره روال مرتبسازی (ABOUT SORTING PROCEDURE)
upmendex بهطور
پیشفرض
نمایهها
را
همانگونه
که هستند
مرتب
میکند (´sort by word
order´). با تنظیم
گزینهٔ -l،
فاصلههای
میان کلمات
در یک نمایه
پیش از
اجرای روال
مرتبسازی
حذف
میشوند (´sort by
character order´).
حتی هنگام
مرتبسازی
بر اساس
ترتیب
نویسهها،
نمایه در
خروجی با
توالی اصلی
و بدون حذف
فاصلهها
باقی
میماند.
در ادامه یک
نمونه نشان
داده شده
است.
X Window Xlib
Xlib XView
XView X Window
علاوه بر
این، دو روش
مرتبسازی
را میتوان
برای
نمایههایی
اعمال کرد
که شامل هر
دو خط کانای
ژاپنی و
سایر خطها
(مانند خط
لاتین)
هستند. با
تنظیم priority به 0
(پیشفرض) و 1
در یک فایل
سبک (style file)، به
ترتیب یک
فاصله میان
کانای
ژاپنی و
سایر خطها
پیش از شروع
روال
مرتبسازی
درج میشود
یا درج
نمیشود.
در ادامه یک
نمونه نشان
داده شده
است.
index sort indファイル
indファイル index sort
- INDEXSTYLE
- دایرکتوری محل قرارگیری فایلهای شیوهنامه نمایه (index style).
- INDEXDEFAULTSTYLE
- فایل شیوهنامه نمایه که به عنوان پیشفرض به آن ارجاع داده میشود.
- INDEXDICTIONARY
- دایرکتوری محل قرارگیری فایلهای واژهنامه (dictionary).
- INDEXDEFAULTDICTIONARY
- فایل واژهنامهای که به طور خودکار خوانده میشود.
جزئیات (DETAIL)
مشخصات دقیق با makeindex سازگار است.
مشکلات شناختهشده (KNOWN ISSUES)
هنگامی که عبارت شماره صفحه جمع استفاده میشود، فایلهای .idx باید همراه با ترتیب شماره صفحات مشخص شوند. در غیر این صورت، ممکن است شمارههای صفحه نادرستی در خروجی ظاهر شوند.
همچنین ببینید (SEE ALSO)
tex(1), latex(1), makeindex(1),
mendex(1).
مولفههای
بینالمللی
برای
یونیکد (ICU):
http://icu.unicode.org,
https://unicode-org.github.io/icu
نویسندگان (AUTHORS)
این صفحه راهنما توسط Takuji Tanaka بر اساس صفحه راهنمای mendex نوشتهشده توسط Japanese TeX Development Community به نگارش درآمده است.