نام (NAME)

makeglossaries - فراخوانی makeindex/xindy برای اسناد LaTeX با استفاده از بسته glossaries

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

makeglossaries [-o file] [-q] [-Q] [-k] [-n] [-s file] [-t file] [-L language] [-c] [-g] [-l] [-p num] [-r] [-d aux dir] [-m file] [-x file] [-e] [--version] [--help] filename

توضیحات (DESCRIPTION)

دستور makeglossaries برای استفاده همراه با اسناد LaTeX طراحی شده است که از بسته glossaries استفاده می‌کنند.

آرگومان اجباری filename باید نام فایل aux باشد. پسوند .aux می‌تواند حذف شود، اما بهتر است در مواردی که نام فایل شامل نقطه‌های اضافی است برای جلوگیری از ابهام ذکر شود.

همچنین، در صورتی که فقط یک واژه‌نامه (glossary) باید پردازش شود (برای نمونه، هنگام کار روی پیش‌نویس سند)، filename می‌تواند نام یک فایل واژه‌نامه خاص باشد. در این حالت، همچنان انتظار می‌رود فایل aux وجود داشته باشد و از نام پایه (basename) مربوط به filename استنتاج می‌شود.

دستور makeglossaries فایل کمکی (auxiliary) را می‌خواند تا مشخص کند که آیا makeindex باید فراخوانی شود یا xindy. تمامی اطلاعات موردنیاز برای ارسال به برنامه نمایه‌سازی مربوطه نیز باید در فایل کمکی موجود باشد، اما می‌توان آن‌ها را با آرگومان‌های گزینه‌های makeglossaries لغو (override) کرد.

گزینه‌ها (OPTIONS)

-e: تلاشی برای ترمیم چندباره encaps یا شماره صفحه‌های نامعتبر انجام ندهد (فقط makeindex).
-c: فشرده‌سازی فاصله‌های خالی میانی (فقط makeindex).
-d aux dir: دایرکتوری محل قرارگیری فایل‌های .aux، .glo و غیره را مشخص می‌کند. پیش‌فرض، دایرکتوری والد فایل پایه filename است.
-g: به‌کارگیری ترتیب واژگان آلمانی (فقط makeindex).
-k: تلاشی برای انشعاب (forking) با تغییر مسیر لوله‌ای انجام ندهد. (اثر -q را کاهش می‌دهد)
-l: ترتیب حرف به حرف (Letter ordering).
-L language: این گزینه تنها زمانی اثر دارد که xindy فراخوانی شود. زبان را تنظیم می‌کند. برای جزئیات بیشتر به مستندات xindy مراجعه کنید.
-m file: مسیر کامل به file را برای makeindex مشخص می‌کند، در صورتی که makeindex در متغیر path سیستم‌عامل موجود نباشد.
-n: دستورهایی را که معمولاً اجرا می‌شوند چاپ می‌کند اما آن‌ها را اجرا نمی‌کند.
-o file: از file به عنوان فایل خروجی استفاده می‌کند. (تنها برای اسنادی مناسب است که شامل یک واژه‌نامه هستند، در غیر این صورت هر واژه‌نامه بازنویسی خواهد شد.)
-p num: شماره صفحه آغازین را روی num تنظیم می‌کند (فقط makeindex).
-q: حالت بی‌صدا. پیام‌های ارسالی به خروجی استاندارد را کاهش می‌دهد.
-Q: هشدار مربوط به ناتوانی در ایجاد انشعاب (fork) را خاموش می‌کند.
-r
-s file: استفاده از file به عنوان فایل شیوه‌نامه (style file). توجه داشته باشید اگر از این گزینه استفاده می‌کنید، باید بدانید که آیا makeindex یا xindy فراخوانی خواهد شد، چرا که آن‌ها فایل‌های شیوه‌نامه متفاوتی دارند.
-t file: استفاده از file به عنوان فایل رونوشت (transcript file).
تشکیل ضمنی محدوده صفحات را غیرفعال می‌کند (فقط makeindex).
-x file: مسیر کامل به file را برای xindy مشخص می‌کند، در صورتی که xindy در متغیر path سیستم‌عامل موجود نباشد.
--version: شماره نسخه را چاپ کرده و خارج می‌شود.
--help: پیام راهنما را چاپ کرده و خارج می‌شود.

پیش‌نیازها (REQUIRES)

ابزارهای Perl، Getopt::Std و makeindex یا xindy (بسته به گزینه‌های بسته glossaries).

مجوز (LICENSE)

این یک نرم‌افزار آزاد است که تحت «مجوز عمومی پروژه لایتک» (LaTeX Project Public License) توزیع می‌شود. هیچ ضمانتی وجود ندارد (NO WARRANTY). برای جزئیات به http://www.latex-project.org/lppl.txt مراجعه کنید.

نویسنده (AUTHOR)

Nicola L. C. Talbot, http://www.dickimaw-books.com

مطالعه پیشنهادی (RECOMMENDED READING)

راهنمای بسته glossaries:

texdoc glossaries