MENDEX(1) General Commands Manual MENDEX(1)

mendex - پردازشگر نمایه ژاپنی

mendex [-ilqrcgfEJSU] [-s sty] [-d dic] [-o ind] [-t log] [-p no] [-I enc] [--help] [--] [ idx0 idx1 idx2 ...]

برنامهٔ mendex یک تولیدکنندهٔ نمایهٔ سلسله‌مراتبی با اهداف عمومی است؛ این برنامه یک یا چند فایل ورودی (.idx؛ که اغلب توسط یک قالب‌بندی‌کنندهٔ متن مانند LaTeX تولید می‌شوند) را می‌پذیرد، مدخل‌ها را مرتب می‌کند و یک فایل خروجی تولید می‌نماید که قابل قالب‌بندی است. این برنامه تقریباً با makeindex سازگار است و قابلیت اضافی برای مدیریت خوانش واژه‌های کانجی (kanji) نیز در دسترس است.
قالب‌های فایل‌های ورودی و خروجی در یک فایل شیوه‌نامه (style file) مشخص می‌شوند. خوانش واژه‌های کانجی را می‌توان در یک فایل واژه‌نامه (dictionary file) مشخص کرد.
نمایه می‌تواند تا سه سطح (۰، ۱ و ۲) از تورفتگی زیرمدخل‌ها را داشته باشد.

دریافت ورودی از stdin، حتی زمانی که فایل‌های نمایه مشخص شده باشند.
تنظیم بر روی «مرتب‌سازی بر اساس ترتیب نویسه‌ها». به‌طور پیش‌فرض از «مرتب‌سازی بر اساس ترتیب واژه‌ها» استفاده می‌شود. جزئیات در ادامه شرح داده شده است.
حالت بی‌صدا؛ هیچ پیامی به stderr ارسال نمی‌شود، به جز پیام‌های خطا و هشدارها.
غیرفعال کردن تشکیل خودکار بازهٔ صفحات. به‌طور پیش‌فرض، سه یا چند صفحهٔ متوالی به‌طور خودکار به صورت یک بازه خلاصه می‌شوند (مانند 1–5).
فشرده‌سازی توالی فاصله‌های خالی میانی (فاصله(ها) و/یا تب(ها)) به یک فاصله و نادیده گرفتن فاصله‌های خالی ابتدا و انتها. به‌طور پیش‌فرض، فاصله‌های خالی در کلید نمایه حفظ می‌شوند.
تنظیم سرنمایهٔ ژاپنی به ردیف-A (A, Ka, Sa, ...؛ ۱۰ نویسه) از جدول gojuon (هجابندی ژاپنی). به‌طور پیش‌فرض، از تمام ۴۸ نویسه در جدول gojuon استفاده می‌شود.
اجبار به چاپ نویسه‌های کانجی در خروجی، حتی اگر در واژه‌نامه‌ها موجود نباشند.
استفاده از sty به عنوان فایل شیوه‌نامه (style file).
استفاده از dic به عنوان فایل واژه‌نامه (dictionary file). فایل واژه‌نامه از فهرستی از <index_word reading> تشکیل شده است.
استفاده از ind به عنوان فایل نمایهٔ خروجی. به‌طور پیش‌فرض، نام فایل با افزودن پسوند ind به نام پایهٔ نخستین فایل ورودی ایجاد می‌شود.
استفاده از log به عنوان فایل گزارش (transcript file). به‌طور پیش‌فرض، نام فایل با افزودن پسوند ilg به نام پایهٔ نخستین فایل ورودی ایجاد می‌شود.
تنظیم شماره صفحهٔ آغازین فهرست نمایهٔ خروجی روی no. آرگومان no می‌تواند عددی یا یکی از موارد زیر باشد: any (صفحهٔ بعدی تا انتهای محتوا)، odd (صفحهٔ فرد بعدی تا انتهای محتوا)، even (صفحهٔ زوج بعدی تا انتهای محتوا).
تنظیم کدگذاری نویسه‌های ورودی/خروجی روی EUC-JP.
تنظیم کدگذاری نویسه‌های ورودی/خروجی روی JIS (ISO-2022-JP).
تنظیم کدگذاری نویسه‌های ورودی/خروجی روی Shift_JIS.
تنظیم کدگذاری نویسه‌های ورودی/خروجی روی UTF-8.
تنظیم کدگذاری نویسه‌های داخلی روی enc. آرگومان enc می‌تواند euc (EUC-JP) یا utf8 (UTF-8) باشد. پیش‌فرض روی utf8 تنظیم شده است.
نمایش خلاصه‌ای از گزینه‌ها.
--
آرگومان‌های پس از -- به عنوان گزینه در نظر گرفته نمی‌شوند. این قابلیت زمانی مفید است که نام فایل ورودی با '-' آغاز شود.

فایل شیوه‌نامه به mendex دربارهٔ قالب فایل‌های ورودی idx و قالب مورد نظر برای فایل خروجی نهایی اطلاع می‌دهد. این قالب با قالب مورد استفاده در makeindex سازگاری رو به بالا دارد. فایل شیوه‌نامه شامل فهرستی از جفت‌های <specifier attribute> است. دو نوع مشخص‌کننده وجود دارد: ورودی و خروجی. جفت‌ها نیازی ندارند که به ترتیب خاصی قرار بگیرند. خطی که با ´%´ آغاز شود یک یادداشت (comment) است.

پارامترهای شیوهٔ فایل ورودی

"\\indexentry"
دستوری همراه با یک آرگومان از مدخل نمایه که قرار است پردازش شود.
´{´
جداکنندهٔ بازکننده که آغاز مدخل نمایه را نشان می‌دهد.
´}´
جداکنندهٔ پایان‌دهنده که انتهای مدخل نمایه را نشان می‌دهد.
´(´
جداکنندهٔ بازکننده که آغاز بازهٔ صفحات را نشان می‌دهد.
´)´
جداکنندهٔ پایان‌دهنده که انتهای بازهٔ صفحات را نشان می‌دهد.
´!´
جداکننده‌ای که سطح پایین‌تر را نشان می‌دهد.
´@´
نمادی که نشان می‌دهد توالی بعدی باید به عنوان رشته‌های نمایه در فایل خروجی ظاهر شود.
´|´
نمادی که نشان می‌دهد توالی بعدی باید به عنوان نام دستور ضمیمه‌شده به شماره صفحه استفاده شود.
"-"
جداکنندهٔ میان سطوح صفحه برای شیوه‌ای با سطوح چندگانه از شماره صفحات.
"rnaRA"
اولویت ترتیب نمایش برای شماره صفحه. ´R´ و ´r´ متناظر با اعداد رومی هستند. ´n´ متناظر با ارقام عربی است. ´A´ و ´a´ متناظر با الفبای لاتین هستند.
´"´
نویسهٔ گریز (escape) برای پارامترهای mendex.
´\\´
نویسهٔ گریز (escape) برای اسکریپت‌های عمومی.

پارامترهای شیوهٔ فایل خروجی

"\\begin{theindex}\n"
دیباچهٔ (preamble) فایل خروجی.
"\n\n\\end{theindex}\n"
مؤخرهٔ (postamble) فایل خروجی. setpage_prefix <string> "\n \\setcounter{page}{"
پیشوند شمارهٔ صفحه در صورتی که صفحهٔ آغازین تعیین شده باشد.
"}\n"
پسوند شمارهٔ صفحه در صورتی که صفحهٔ آغازین تعیین شده باشد.
"\n\n \\indexspace\n"
رشته‌ای برای درج فاصلهٔ عمودی پیش از بخش جدید نمایه.
""
پیشوند عنوان برای حرف سربرگ جدید.
""
مشابه lethead_prefix (سازگار با makeindex).
""
پسوند عنوان برای حرف سربرگ جدید.
""
مشابه lethead_suffix (سازگار با makeindex).
0
پرچمی برای کنترل خروجی حروف سربرگ. مقادیر '0'، '1' و '-1' به‌ترتیب نشان‌دهندهٔ بدون خروجی، حروف بزرگ و حروف کوچک هستند.
0
مشابه lethead_flag (نکته: makeindex از نام متفاوت headings_flag استفاده می‌کند).
"\n \\item "
دنبالهٔ دستوری که میان مدخل‌های سطح اصلی درج می‌شود.
"\n \\subitem "
دنبالهٔ دستوری که میان مدخل‌های سطح فرعی درج می‌شود.
"\n \\subsubitem "
دنبالهٔ دستوری که میان مدخل‌های سطح زیرفرعی درج می‌شود.
"\n \\subitem "
دنبالهٔ دستوری که میان مدخل‌های سطح اصلی و فرعی درج می‌شود.
"\n \\subitem "
دنبالهٔ دستوری که میان مدخل‌های سطح اصلی و فرعی درج می‌شود، زمانی که مدخل اصلی فاقد شمارهٔ صفحه باشد.
"\n \\subsubitem "
دنبالهٔ دستوری که میان مدخل‌های سطح فرعی و زیرفرعی درج می‌شود.
"\n \\subsubitem "
دنبالهٔ دستوری که میان مدخل‌های سطح فرعی و زیرفرعی درج می‌شود، زمانی که مدخل سطح فرعی فاقد شمارهٔ صفحه باشد.
", "
رشتهٔ جداکننده میان مدخل سطح اصلی و نخستین شمارهٔ صفحه.
", "
رشتهٔ جداکننده میان مدخل سطح فرعی و نخستین شمارهٔ صفحه.
", "
رشتهٔ جداکننده میان مدخل سطح زیرفرعی و نخستین شمارهٔ صفحه.
", "
رشتهٔ جداکننده میان شماره‌های صفحه که به‌طور مشترک برای هر سطحی از مدخل‌ها استفاده می‌شود.
"--"
رشتهٔ جداکننده میان شماره‌های صفحه برای نمایش بازهٔ صفحات.
""
رشتهٔ جداکننده‌ای که در پایان فهرست شماره‌های صفحه درج می‌شود.
""
رشته‌ای که در صورت متوالی بودن دو صفحه، به‌جای delim_n و شمارهٔ صفحهٔ بعدی درج می‌شود.
تنها زمانی کار می‌کند که این پارامتر تعریف شده باشد.
""
رشته‌ای که در صورت متوالی بودن سه صفحه، به‌جای delim_r و شمارهٔ صفحهٔ سوم درج می‌شود. این پارامتر نسبت به suffix_mp تقدم دارد.
تنها زمانی کار می‌کند که این پارامتر تعریف شده باشد.
""
رشته‌ای که در صورت متوالی بودن سه یا چند صفحه، به‌جای delim_r و شمارهٔ آخرین صفحه درج می‌شود.
تنها زمانی کار می‌کند که این پارامتر تعریف شده باشد.
"\\"
پیشوند برای دستور دربرگیرنده هنگامی که این دستور به شمارهٔ صفحه افزوده می‌شود.
"{"
پیشوند درست پیش از شمارهٔ صفحه هنگامی که دستور دربرگیرنده به شمارهٔ صفحه افزوده می‌شود.
"}".
پسوند پس از شمارهٔ صفحه هنگامی که دستور دربرگیرنده به شمارهٔ صفحه افزوده می‌شود.
72
حداکثر طول یک خط. در صورت فراتر رفتن از این مقدار، خط‌ها شکسته می‌شوند.
""
فاصله برای تورفتگی که در ابتدای خط شکسته درج می‌شود.
16
طول فاصله برای تورفتگی که در ابتدای خط شکسته درج می‌شود. symhead_positive <string> "Symbols"
رشته‌ای برای نمایش به‌عنوان حرف سربرگ برای اعداد و نمادها، هنگامی که lethead_flag یا heading_flag یک عدد مثبت باشد.
"symbols"
رشته‌ای برای نمایش به‌عنوان حرف سربرگ برای اعداد و نمادها، هنگامی که lethead_flag یا heading_flag یک عدد منفی باشد.
""
رشته‌ای برای نمایش به‌عنوان حرف سربرگ برای اعداد و نمادها، هنگامی که symbol_flag غیر صفر باشد.
در صورت تعیین، این گزینه نسبت به symhead_positive و symhead_negative اولویت دارد. (توسعه‌یافته توسط mendex)
1
پرچم برای نمایش نمادها. اگر ´0´ باشد، چاپ نمی‌شوند. (توسعه‌یافته توسط mendex)
1
پرچم حرف سربرگ برای کانای ژاپنی. اگر ´1´ و ´2´ باشد، به ترتیب از کاتاکانا و هیراگانا استفاده می‌شود. (توسعه‌یافته توسط mendex)
0
پرچم روش مرتب‌سازی برای کلمات نمایه متشکل از خط ژاپنی و غیرژاپنی (مانند خط لاتین). اگر غیر صفر باشد، در طول فرایند مرتب‌سازی یک فاصله (U+20) میان توالی ژاپنی و توالی غیرژاپنی درج می‌شود. (توسعه‌یافته توسط mendex)
"SNEJ"
ترتیب خط‌ها و نمادها. ´S´، ´N´، ´E´ و ´J´ به ترتیب نشان‌دهنده نماد، اعداد، انگلیسی و ژاپنی هستند. (توسعه‌یافته توسط mendex) لطفاً اطمینان حاصل کنید که ´S´ و ´N´ در کنار یکدیگر قرار دارند، زیرا mendex اعداد را بخشی از نمادها در نظر می‌گیرد.

mendex در مقایسه با makeindex، از قابلیتی اضافی برای ساده‌سازی فرایند مدیریت نمایه‌های ژاپنی برخوردار است. بدین ترتیب کاربران می‌توانند از زحمت تعیین دستی خوانش (reading) برای هر کلمه کانجی بی‌نیاز شوند.
کلمات کانجی ژاپنی معمولاً بر اساس هجاهای خوانش آن‌ها (´Yomi´) مرتب می‌شوند که می‌توان آن‌ها را با خط‌های کانا (هیراگانا، کاتاکانا) نمایش داد. mendex کلمات نمایه را که مستقیماً به شکل عبارت کانا در یک فایل ورودی مشخص شده‌اند می‌پذیرد، و همچنین تبدیل کلمات نمایه به خط‌های کانا را با ارجاع به فرهنگ‌لغت‌های ژاپنی پشتیبانی می‌کند.

نمونه‌هایی از ساده‌سازی داخلی هجاها در زیر نشان داده شده است.


かぶしきがいしゃ かふしきかいしや
マッキントッシュ まつきんとつしゆ
ワープロ わあふろ

فایل فرهنگ‌لغت شامل فهرستی با ساختار <´index_word´ ´reading´> است. کلمه نمایه می‌تواند با هر خطی (کانجی، کانا و غیره) نوشته شود، و خوانش باید با خط‌های هیراگانا یا کاتاکانا باشد. جداکننده بین کلمه نمایه و خوانش آن، یک یا چند برگه (tab) یا فاصله (space) است.
نمونه‌ای از یک فرهنگ‌لغت ژاپنی در زیر آورده شده است.


漢字 かんじ
読み よみ
環境 かんきょう
α アルファ

در اینجا، هر کلمه نمایه تنها مجاز به داشتن یک یومی (Yomi) است. اگرچه برخی از کلمات کانجی (برای مثال 「表」) ممکن است بیش از یک یومی داشته باشند (مانند 「ひょう」 و 「おもて」)، اما تنها یکی از آن‌ها می‌تواند در فرهنگ‌لغت ثبت شود. هنگامی که به یومی‌های متفاوتی نیاز باشد، باید به صراحت در قالب عبارت کانا (مانند \index{ひょう@表} یا \index{おもて@表}) در فایل ورودی مشخص شوند.
علاوه بر این، با تعیین نام فایل در متغیر محیطی INDEXDEFAULTDICTIONARY، یک فایل فرهنگ‌لغت به‌طور خودکار مورد ارجاع قرار می‌گیرد. فرهنگ‌لغت تعیین‌شده توسط متغیر محیطی می‌تواند در کنار فایل(های) مشخص‌شده با گزینه -d استفاده شود.

mendex به‌طور پیش‌فرض نمایه‌ها را همان‌گونه که هستند مرتب می‌کند (´مرتب‌سازی بر اساس ترتیب کلمه´ یا ´sort by word order´). با تنظیم گزینه -l، فاصله‌های میان کلمات در یک نمایه پیش از فرایند مرتب‌سازی حذف می‌شوند (´مرتب‌سازی بر اساس ترتیب نویسه´ یا ´sort by character order´).
حتی در صورت مرتب‌سازی بر اساس ترتیب نویسه‌ها، نمایه در خروجی به شکل توالی اصلی خود و بدون حذف فاصله‌ها باقی می‌ماند.
در ادامه یک نمونه آورده شده است.

sort by word order sort by character order
X Window Xlib
Xlib XView
XView X Window

علاوه بر این، دو روش مرتب‌سازی را می‌توان برای نمایه‌هایی اعمال کرد که شامل هر دو خط کانا ژاپنی و سایر خط‌ها (مانند خط لاتین) هستند. با تنظیم priority روی 0 (پیش‌فرض) و 1 در یک فایل سبک (style file)، پیش از فرایند مرتب‌سازی، یک فاصله به ترتیب میان کانای ژاپنی و سایر خط‌ها درج می‌شود یا درج نمی‌شود.
در ادامه یک نمونه آورده شده است.

priority=0 priority=1
index sort indファイル
indファイル index sort
دستور mendex به متغیرهای محیطی زیر ارجاع می‌دهد:
دایرکتوری‌ای که فایل‌های سبک نمایه در آن قرار دارند.
فایل سبک نمایه که به عنوان پیش‌فرض به آن ارجاع داده می‌شود.
دایرکتوری‌ای که فایل‌های واژه‌نامه در آن قرار دارند.
فایل واژه‌نامه‌ای که به طور خودکار خوانده می‌شود.

مشخصات تفصیلی با makeindex سازگار است.

هنگامی که از عبارات چندگانهٔ شماره صفحه استفاده می‌شود، فایل‌های .idx باید همگام با ترتیب شماره‌های صفحه مشخص شوند. در غیر این صورت، ممکن است شماره‌های صفحهٔ نادرستی در خروجی ظاهر شوند.

tex(1), latex(1), makeindex(1)

این صفحهٔ راهنما توسط Japanese TeX Development Community نوشته شده است.