.TH MENDEX 1 \"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX .\" LX definition must follow TX so LX can use TX .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX .if n .ds LX LaTeX \"===================================================================== .SH "نام (NAME)" mendex \- پردازشگر نمایه ژاپنی .SH "خلاصه دستور (SYNOPSIS)" \fBmendex\fR [-ilqrcgfEJSU] [\fB-s\fI sty\fR] [\fB-d\fI dic\fR] [\fB-o\fI ind\fR] [\fB-t\fI log\fR] [\fB-p\fI no\fR] [\fB-I\fI enc\fR] [\fB--help\fR] [\fB--\fR] [\fI idx0 idx1 idx2 ...\fR] .SH "توضیحات (DESCRIPTION)" .PP برنامهٔ \fImendex\fR یک تولیدکنندهٔ نمایهٔ سلسله‌مراتبی با اهداف عمومی است؛ این برنامه یک یا چند فایل ورودی (\fI.idx\fR؛ که اغلب توسط یک قالب‌بندی‌کنندهٔ متن مانند \*(LX تولید می‌شوند) را می‌پذیرد، مدخل‌ها را مرتب می‌کند و یک فایل خروجی تولید می‌نماید که قابل قالب‌بندی است. این برنامه تقریباً با \fImakeindex\fR سازگار است و قابلیت اضافی برای مدیریت خوانش واژه‌های کانجی (kanji) نیز در دسترس است. .RE قالب‌های فایل‌های ورودی و خروجی در یک فایل شیوه‌نامه (style file) مشخص می‌شوند. خوانش واژه‌های کانجی را می‌توان در یک فایل واژه‌نامه (dictionary file) مشخص کرد. .RE نمایه می‌تواند تا سه سطح (۰، ۱ و ۲) از تورفتگی زیرمدخل‌ها را داشته باشد. .SH "گزینه‌ها (OPTIONS)" .PP .TP 10 \fB-i\fR دریافت ورودی از stdin، حتی زمانی که فایل‌های نمایه مشخص شده باشند. .TP 10 \fB-l\fR تنظیم بر روی «مرتب‌سازی بر اساس ترتیب نویسه‌ها». به‌طور پیش‌فرض از «مرتب‌سازی بر اساس ترتیب واژه‌ها» استفاده می‌شود. جزئیات در ادامه شرح داده شده است. .TP 10 \fB-q\fR حالت بی‌صدا؛ هیچ پیامی به \fIstderr\fR ارسال نمی‌شود، به جز پیام‌های خطا و هشدارها. .TP 10 \fB-r\fR غیرفعال کردن تشکیل خودکار بازهٔ صفحات. به‌طور پیش‌فرض، سه یا چند صفحهٔ متوالی به‌طور خودکار به صورت یک بازه خلاصه می‌شوند (مانند 1\(en5). .TP 10 \fB-c\fR فشرده‌سازی توالی فاصله‌های خالی میانی (فاصله(ها) و/یا تب(ها)) به یک فاصله و نادیده گرفتن فاصله‌های خالی ابتدا و انتها. به‌طور پیش‌فرض، فاصله‌های خالی در کلید نمایه حفظ می‌شوند. .TP 10 \fB-g\fR تنظیم سرنمایهٔ ژاپنی به ردیف-\fIA\fR (\fIA, Ka, Sa, ...\fR؛ ۱۰ نویسه) از جدول \fIgojuon\fR (هجابندی ژاپنی). به‌طور پیش‌فرض، از تمام ۴۸ نویسه در جدول \fIgojuon\fR استفاده می‌شود. .TP 10 \fB-f\fR اجبار به چاپ نویسه‌های کانجی در خروجی، حتی اگر در واژه‌نامه‌ها موجود نباشند. .TP 10 \fB-s\fI sty\fR استفاده از \fIsty\fR به عنوان فایل شیوه‌نامه (style file). .TP 10 \fB-d\fI dic\fR استفاده از \fIdic\fR به عنوان فایل واژه‌نامه (dictionary file). فایل واژه‌نامه از فهرستی از <\fIindex_word\fR\ \fIreading\fR> تشکیل شده است. .TP 10 \fB-o\fI ind\fR استفاده از \fIind\fR به عنوان فایل نمایهٔ خروجی. به‌طور پیش‌فرض، نام فایل با افزودن پسوند \fIind\fR به نام پایهٔ نخستین فایل ورودی ایجاد می‌شود. .TP 10 \fB-t\fI log\fR استفاده از \fIlog\fR به عنوان فایل گزارش (transcript file). به‌طور پیش‌فرض، نام فایل با افزودن پسوند \fIilg\fR به نام پایهٔ نخستین فایل ورودی ایجاد می‌شود. .TP 10 \fB-p\fI no\fR تنظیم شماره صفحهٔ آغازین فهرست نمایهٔ خروجی روی \fIno\fR. آرگومان \fIno\fR می‌تواند عددی یا یکی از موارد زیر باشد: \fIany\fR (صفحهٔ بعدی تا انتهای محتوا)، \fIodd\fR (صفحهٔ فرد بعدی تا انتهای محتوا)، \fIeven\fR (صفحهٔ زوج بعدی تا انتهای محتوا). .TP 10 \fB-E\fR تنظیم کدگذاری نویسه‌های ورودی/خروجی روی EUC-JP. .TP 10 \fB-J\fR تنظیم کدگذاری نویسه‌های ورودی/خروجی روی JIS (ISO-2022-JP). .TP 10 \fB-S\fR تنظیم کدگذاری نویسه‌های ورودی/خروجی روی Shift_JIS. .TP 10 \fB-U\fR تنظیم کدگذاری نویسه‌های ورودی/خروجی روی UTF-8. .TP 10 \fB-I\fI enc\fR تنظیم کدگذاری نویسه‌های داخلی روی \fIenc\fR. آرگومان \fIenc\fR می‌تواند \fIeuc\fR (EUC-JP) یا \fIutf8\fR (UTF-8) باشد. پیش‌فرض روی \fIutf8\fR تنظیم شده است. .TP 10 \fB--help\fR نمایش خلاصه‌ای از گزینه‌ها. .TP 10 \fB--\fR آرگومان‌های پس از \fB--\fR به عنوان گزینه در نظر گرفته نمی‌شوند. این قابلیت زمانی مفید است که نام فایل ورودی با '-' آغاز شود. .SH "فایل شیوه‌نامه (STYLE FILE)" فایل شیوه‌نامه به \fImendex\fR دربارهٔ قالب فایل‌های ورودی \fIidx\fR و قالب مورد نظر برای فایل خروجی نهایی اطلاع می‌دهد. این قالب با قالب مورد استفاده در \fImakeindex\fR سازگاری رو به بالا دارد. فایل شیوه‌نامه شامل فهرستی از جفت‌های <\fIspecifier\fR\ \fIattribute\fR> است. دو نوع مشخص‌کننده وجود دارد: ورودی و خروجی. جفت‌ها نیازی ندارند که به ترتیب خاصی قرار بگیرند. خطی که با \'%\' آغاز شود یک یادداشت (comment) است. .PP \fBپارامترهای شیوهٔ فایل ورودی\fR .TP 30 \fBkeyword\fR "\\\\indexentry" .RS دستوری همراه با یک آرگومان از مدخل نمایه که قرار است پردازش شود. .RE .TP 30 \fBarg_open\fR \'{\' .RS جداکنندهٔ بازکننده که آغاز مدخل نمایه را نشان می‌دهد. .RE .TP 30 \fBarg_close\fR \'}\' .RS جداکنندهٔ پایان‌دهنده که انتهای مدخل نمایه را نشان می‌دهد. .RE .TP 30 \fBrange_open\fR \'(\' .RS جداکنندهٔ بازکننده که آغاز بازهٔ صفحات را نشان می‌دهد. .RE .TP 30 \fBrange_close\fR \')\' .RS جداکنندهٔ پایان‌دهنده که انتهای بازهٔ صفحات را نشان می‌دهد. .RE .TP 30 \fBlevel\fR \'!\' .RS جداکننده‌ای که سطح پایین‌تر را نشان می‌دهد. .RE .TP 30 \fBactual\fR \'@\' .RS نمادی که نشان می‌دهد توالی بعدی باید به عنوان رشته‌های نمایه در فایل خروجی ظاهر شود. .RE .TP 30 \fBencap\fR \'|\' .RS نمادی که نشان می‌دهد توالی بعدی باید به عنوان نام دستور ضمیمه‌شده به شماره صفحه استفاده شود. .RE .TP 30 \fBpage_compositor\fR "-" .RS جداکنندهٔ میان سطوح صفحه برای شیوه‌ای با سطوح چندگانه از شماره صفحات. .RE .TP 30 \fBpage_precedence\fR "rnaRA" .RS اولویت ترتیب نمایش برای شماره صفحه. \'R\' و \'r\' متناظر با اعداد رومی هستند. \'n\' متناظر با ارقام عربی است. \'A\' و \'a\' متناظر با الفبای لاتین هستند. .RE .TP 30 \fBquote\fR \'"\' .RS نویسهٔ گریز (escape) برای پارامترهای \fImendex\fR. .RE .TP 30 \fBescape\fR \'\\\\\' .RS نویسهٔ گریز (escape) برای اسکریپت‌های عمومی. .RE \fBپارامترهای شیوهٔ فایل خروجی\fR .TP 30 \fBpreamble\fR "\\\\begin{theindex}\\n" .RS دیباچهٔ (preamble) فایل خروجی. .RE .TP 30 \fBpostamble\fR "\\n\\n\\\\end{theindex}\\n" .RS مؤخرهٔ (postamble) فایل خروجی. .RE.TP 30 \fBsetpage_prefix\fR "\\n \\\\setcounter{page}{" .RS پیشوند شمارهٔ صفحه در صورتی که صفحهٔ آغازین تعیین شده باشد. .RE .TP 30 \fBsetpage_suffix\fR "}\\n" .RS پسوند شمارهٔ صفحه در صورتی که صفحهٔ آغازین تعیین شده باشد. .RE .TP 30 \fBgroup_skip\fR "\\n\\n \\\\indexspace\\n" .RS رشته‌ای برای درج فاصلهٔ عمودی پیش از بخش جدید نمایه. .RE .TP 30 \fBlethead_prefix\fR "" .RS پیشوند عنوان برای حرف سربرگ جدید. .RE .TP 30 \fBheading_prefix\fR "" .RS مشابه \fBlethead_prefix\fR (سازگار با makeindex). .RE .TP 30 \fBlethead_suffix\fR "" .RS پسوند عنوان برای حرف سربرگ جدید. .RE .TP 30 \fBheading_suffix\fR "" .RS مشابه \fBlethead_suffix\fR (سازگار با makeindex). .RE .TP 30 \fBlethead_flag\fR 0 .RS پرچمی برای کنترل خروجی حروف سربرگ. مقادیر \(aq0\(aq، \(aq1\(aq و \(aq\-1\(aq به‌ترتیب نشان‌دهندهٔ بدون خروجی، حروف بزرگ و حروف کوچک هستند. .RE .TP 30 \fBheading_flag\fR 0 .RS مشابه \fBlethead_flag\fR (نکته: makeindex از نام متفاوت \fBheadings_flag\fR استفاده می‌کند). .RE .TP 30 \fBitem_0\fR "\\n \\\\item " .RS دنبالهٔ دستوری که میان مدخل‌های سطح اصلی درج می‌شود. .RE .TP 30 \fBitem_1\fR "\\n \\\\subitem " .RS دنبالهٔ دستوری که میان مدخل‌های سطح فرعی درج می‌شود. .RE .TP 30 \fBitem_2\fR "\\n \\\\subsubitem " .RS دنبالهٔ دستوری که میان مدخل‌های سطح زیرفرعی درج می‌شود. .RE .TP 30 \fBitem_01\fR "\\n \\\\subitem " .RS دنبالهٔ دستوری که میان مدخل‌های سطح اصلی و فرعی درج می‌شود. .RE .TP 30 \fBitem_x1\fR "\\n \\\\subitem " .RS دنبالهٔ دستوری که میان مدخل‌های سطح اصلی و فرعی درج می‌شود، زمانی که مدخل اصلی فاقد شمارهٔ صفحه باشد. .RE .TP 30 \fBitem_12\fR "\\n \\\\subsubitem " .RS دنبالهٔ دستوری که میان مدخل‌های سطح فرعی و زیرفرعی درج می‌شود. .RE .TP 30 \fBitem_x2\fR "\\n \\\\subsubitem " .RS دنبالهٔ دستوری که میان مدخل‌های سطح فرعی و زیرفرعی درج می‌شود، زمانی که مدخل سطح فرعی فاقد شمارهٔ صفحه باشد. .RE .TP 30 \fBdelim_0\fR ", " .RS رشتهٔ جداکننده میان مدخل سطح اصلی و نخستین شمارهٔ صفحه. .RE .TP 30 \fBdelim_1\fR ", " .RS رشتهٔ جداکننده میان مدخل سطح فرعی و نخستین شمارهٔ صفحه. .RE .TP 30 \fBdelim_2\fR ", " .RS رشتهٔ جداکننده میان مدخل سطح زیرفرعی و نخستین شمارهٔ صفحه. .RE .TP 30 \fBdelim_n\fR ", " .RS رشتهٔ جداکننده میان شماره‌های صفحه که به‌طور مشترک برای هر سطحی از مدخل‌ها استفاده می‌شود. .RE .TP 30 \fBdelim_r\fR "--" .RS رشتهٔ جداکننده میان شماره‌های صفحه برای نمایش بازهٔ صفحات. .RE .TP 30 \fBdelim_t\fR "" .RS رشتهٔ جداکننده‌ای که در پایان فهرست شماره‌های صفحه درج می‌شود. .RE .TP 30 \fBsuffix_2p\fR "" .RS رشته‌ای که در صورت متوالی بودن دو صفحه، به‌جای \fBdelim_n\fR و شمارهٔ صفحهٔ بعدی درج می‌شود. .RE تنها زمانی کار می‌کند که این پارامتر تعریف شده باشد. .RE .TP 30 \fBsuffix_3p\fR "" .RS رشته‌ای که در صورت متوالی بودن سه صفحه، به‌جای \fBdelim_r\fR و شمارهٔ صفحهٔ سوم درج می‌شود. این پارامتر نسبت به \fBsuffix_mp\fR تقدم دارد. .RE تنها زمانی کار می‌کند که این پارامتر تعریف شده باشد. .RE .TP 30 \fBsuffix_mp\fR "" .RS رشته‌ای که در صورت متوالی بودن سه یا چند صفحه، به‌جای \fBdelim_r\fR و شمارهٔ آخرین صفحه درج می‌شود. .RE تنها زمانی کار می‌کند که این پارامتر تعریف شده باشد. .RE .TP 30 \fBencap_prefix\fR "\\\\" .RS پیشوند برای دستور دربرگیرنده هنگامی که این دستور به شمارهٔ صفحه افزوده می‌شود. .RE .TP 30 \fBencap_infix\fR "{" .RS پیشوند درست پیش از شمارهٔ صفحه هنگامی که دستور دربرگیرنده به شمارهٔ صفحه افزوده می‌شود. .RE .TP 30 \fBencap_suffix\fR "}". .RS پسوند پس از شمارهٔ صفحه هنگامی که دستور دربرگیرنده به شمارهٔ صفحه افزوده می‌شود. .RE .TP 30 \fBline_max\fR 72 .RS حداکثر طول یک خط. در صورت فراتر رفتن از این مقدار، خط‌ها شکسته می‌شوند. .RE .TP 30 \fBindent_space\fR "\t\t" .RS فاصله برای تورفتگی که در ابتدای خط شکسته درج می‌شود. .RE .TP 30 \fBindent_length\fR 16 .RS طول فاصله برای تورفتگی که در ابتدای خط شکسته درج می‌شود. .RE.TP 30 \fBsymhead_positive\fR "Symbols" .RS رشته‌ای برای نمایش به‌عنوان حرف سربرگ برای اعداد و نمادها، هنگامی که lethead_flag یا heading_flag یک عدد مثبت باشد. .RE .TP 30 \fBsymhead_negative\fR "symbols" .RS رشته‌ای برای نمایش به‌عنوان حرف سربرگ برای اعداد و نمادها، هنگامی که lethead_flag یا heading_flag یک عدد منفی باشد. .RE .TP 30 \fBsymbol\fR "" .RS رشته‌ای برای نمایش به‌عنوان حرف سربرگ برای اعداد و نمادها، هنگامی که symbol_flag غیر صفر باشد. .RE در صورت تعیین، این گزینه نسبت به symhead_positive و symhead_negative اولویت دارد. (توسعه‌یافته توسط mendex) .RE .TP 30 \fBsymbol_flag\fR 1 .RS پرچم برای نمایش نمادها. اگر \'0\' باشد، چاپ نمی‌شوند. (توسعه‌یافته توسط mendex) .RE .TP 30 \fBletter_head\fR 1 .RS پرچم حرف سربرگ برای کانای ژاپنی. اگر \'1\' و \'2\' باشد، به ترتیب از کاتاکانا و هیراگانا استفاده می‌شود. (توسعه‌یافته توسط mendex) .RE .TP 30 \fBpriority\fR 0 .RS پرچم روش مرتب‌سازی برای کلمات نمایه متشکل از خط ژاپنی و غیرژاپنی (مانند خط لاتین). اگر غیر صفر باشد، در طول فرایند مرتب‌سازی یک فاصله (U+20) میان توالی ژاپنی و توالی غیرژاپنی درج می‌شود. (توسعه‌یافته توسط mendex) .RE .TP 30 \fBcharacter_order\fR "SNEJ" .RS ترتیب خط‌ها و نمادها. \'S\'، \'N\'، \'E\' و \'J\' به ترتیب نشان‌دهنده نماد، اعداد، انگلیسی و ژاپنی هستند. (توسعه‌یافته توسط mendex) لطفاً اطمینان حاصل کنید که \'S\' و \'N\' در کنار یکدیگر قرار دارند، زیرا \fBmendex\fR اعداد را بخشی از نمادها در نظر می‌گیرد. .RE .PP .SH "درباره پردازش زبان ژاپنی (ABOUT JAPANESE PROCESSING)" .PP \fImendex\fR در مقایسه با \fImakeindex\fR، از قابلیتی اضافی برای ساده‌سازی فرایند مدیریت نمایه‌های ژاپنی برخوردار است. بدین ترتیب کاربران می‌توانند از زحمت تعیین دستی خوانش (reading) برای هر کلمه کانجی بی‌نیاز شوند. .RE کلمات کانجی ژاپنی معمولاً بر اساس هجاهای خوانش آن‌ها (\fI\'Yomi\'\fR) مرتب می‌شوند که می‌توان آن‌ها را با خط‌های کانا (هیراگانا، کاتاکانا) نمایش داد. \fImendex\fR کلمات نمایه را که مستقیماً به شکل عبارت کانا در یک فایل ورودی مشخص شده‌اند می‌پذیرد، و همچنین تبدیل کلمات نمایه به خط‌های کانا را با ارجاع به فرهنگ‌لغت‌های ژاپنی پشتیبانی می‌کند. .RE .LP نمونه‌هایی از ساده‌سازی داخلی هجاها در زیر نشان داده شده است. .PP .RS .br かぶしきがいしゃ かふしきかいしや .br マッキントッシュ まつきんとつしゆ .br ワープロ わあふろ .RE .LP فایل فرهنگ‌لغت شامل فهرستی با ساختار <\'index_word\' \'reading\'> است. کلمه نمایه می‌تواند با هر خطی (کانجی، کانا و غیره) نوشته شود، و خوانش باید با خط‌های هیراگانا یا کاتاکانا باشد. جداکننده بین کلمه نمایه و خوانش آن، یک یا چند برگه (tab) یا فاصله (space) است. .RE نمونه‌ای از یک فرهنگ‌لغت ژاپنی در زیر آورده شده است. .PP .RS .br 漢字 かんじ .br 読み よみ .br 環境 かんきょう .br α アルファ .RE .LP در اینجا، هر کلمه نمایه تنها مجاز به داشتن یک یومی (Yomi) است. اگرچه برخی از کلمات کانجی (برای مثال 「表」) ممکن است بیش از یک یومی داشته باشند (مانند 「ひょう」 و 「おもて」)، اما تنها یکی از آن‌ها می‌تواند در فرهنگ‌لغت ثبت شود. هنگامی که به یومی‌های متفاوتی نیاز باشد، باید به صراحت در قالب عبارت کانا (مانند \\index{ひょう@表} یا \\index{おもて@表}) در فایل ورودی مشخص شوند. .RE علاوه بر این، با تعیین نام فایل در متغیر محیطی \fIINDEXDEFAULTDICTIONARY\fR، یک فایل فرهنگ‌لغت به‌طور خودکار مورد ارجاع قرار می‌گیرد. فرهنگ‌لغت تعیین‌شده توسط متغیر محیطی می‌تواند در کنار فایل(های) مشخص‌شده با گزینه \fI-d\fR استفاده شود. .PP .SH "درباره فرایند مرتب‌سازی (ABOUT SORTING PROCEDURE)" .PP \fImendex\fR به‌طور پیش‌فرض نمایه‌ها را همان‌گونه که هستند مرتب می‌کند (\'مرتب‌سازی بر اساس ترتیب کلمه\' یا \'sort by word order\'). با تنظیم گزینه \fI-l\fR، فاصله‌های میان کلمات در یک نمایه پیش از فرایند مرتب‌سازی حذف می‌شوند (\'مرتب‌سازی بر اساس ترتیب نویسه\' یا \'sort by character order\'). .RE حتی در صورت مرتب‌سازی بر اساس ترتیب نویسه‌ها، نمایه در خروجی به شکل توالی اصلی خود و بدون حذف فاصله‌ها باقی می‌ماند. .RE در ادامه یک نمونه آورده شده است. .PP .RS \fIsort by word order sort by character order\fR .br X Window Xlib .br Xlib XView .br XView X Window .RE .LP علاوه بر این، دو روش مرتب‌سازی را می‌توان برای نمایه‌هایی اعمال کرد که شامل هر دو خط کانا ژاپنی و سایر خط‌ها (مانند خط لاتین) هستند. با تنظیم \fIpriority\fR روی 0 (پیش‌فرض) و 1 در یک فایل سبک (style file)، پیش از فرایند مرتب‌سازی، یک فاصله به ترتیب میان کانای ژاپنی و سایر خط‌ها درج می‌شود یا درج نمی‌شود. .RE در ادامه یک نمونه آورده شده است. .PP .RS \fIpriority=0 priority=1\fR .br index sort indファイル .br indファイル index sort .RE .PP.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" دستور \fImendex\fR به متغیرهای محیطی زیر ارجاع می‌دهد: .PP .TP 10 \fIINDEXSTYLE\fR دایرکتوری‌ای که فایل‌های سبک نمایه در آن قرار دارند. .TP 10 \fIINDEXDEFAULTSTYLE\fR فایل سبک نمایه که به عنوان پیش‌فرض به آن ارجاع داده می‌شود. .TP 10 \fIINDEXDICTIONARY\fR دایرکتوری‌ای که فایل‌های واژه‌نامه در آن قرار دارند. .TP 10 \fIINDEXDEFAULTDICTIONARY\fR فایل واژه‌نامه‌ای که به طور خودکار خوانده می‌شود. .PP .SH "جزئیات (DETAIL)" مشخصات تفصیلی با \fImakeindex\fR سازگار است. .PP .SH "مشکلات شناخته‌شده (KNOWN ISSUES)" هنگامی که از عبارات چندگانهٔ شماره صفحه استفاده می‌شود، فایل‌های \fI.idx\fR باید همگام با ترتیب شماره‌های صفحه مشخص شوند. در غیر این صورت، ممکن است شماره‌های صفحهٔ نادرستی در خروجی ظاهر شوند. .PP .SH "همچنین ببینید (SEE ALSO)" tex(1), latex(1), makeindex(1) .SH "نویسنده (AUTHOR)" این صفحهٔ راهنما توسط Japanese \*(TX Development Community نوشته شده است.