.TH RUBBER 1 .SH "نام (NAME)" rubber \- یک سامانه ساخت برای اسناد LaTeX . .SH "خلاصه دستور (SYNOPSIS)" .B rubber .RI [ گزینه‌ها ] .I sources ... .br .B rubber\-pipe .RI [ گزینه‌ها ] . .SH "توضیحات (DESCRIPTION)" برنامهٔ Rubber یک پوشش (wrapper) برای LaTeX و برنامه‌های جانبی آن است. هدف آن، پردازش یک منبع LaTeX و کامپایل کردن آن به تعداد دفعات کافی برای حل تمام ارجاعات است، که احتمالاً شامل اجرای برنامه‌های اقماری مانند BibTeX، makeindex، Metapost و غیره برای تولید فایل‌های دادهٔ مناسب نیز می‌شود. .PP دستور .B rubber اسناد مشخص‌شده را به طور کامل می‌سازد. فایل‌های منبع می‌توانند منابع LaTeX باشند (که در این صورت پسوند .tex می‌تواند حذف شود) یا اسنادی با قالبی باشند که Rubber نحوهٔ تبدیل آن به LaTeX را می‌داند. اگر یکی از کامپایل‌ها با شکست مواجه شود، کل فرایند متوقف می‌شود، از جمله کامپایل اسناد بعدی موجود در خط فرمان، و .B rubber یک کد خروج غیرصفر برمی‌گرداند. .PP دستور .B rubber\-pipe همین کار را برای یک سند انجام می‌دهد، اما منبع LaTeX را از ورودی استاندارد می‌خواند و سند کامپایل‌شده را در خروجی استاندارد می‌ریزد. .P برخی از اطلاعات را نمی‌توان از منابع LaTeX استخراج کرد. به عنوان مثال، مسیرهای جست‌وجو (که می‌توانند در متغیرهای محیطی مانند TEXINPUTS مشخص شوند)، یا شیوه‌نامه‌ای که باید با Makeindex استفاده شود، از این جمله‌اند. برای رفع این مشکل، می‌توان اطلاعات مورد نظر Rubber را در توضیحات (کامنت‌های) منابع LaTeX قرار داد؛ به بخش .B DIRECTIVES مراجعه کنید. . .SH "گزینه‌ها (OPTIONS)" گزینه‌ها برای انتخاب عملیاتی که باید انجام شود یا برای پیکربندی فرایند ساخت به کار می‌روند. این گزینه‌ها عمدتاً در .B rubber و .B rubber\-pipe مشابه هستند. گزینه‌ها با استفاده از قراردادهای GNU Getopt تجزیه می‌شوند. .TP .B \-b, \-\-bzip2 سند نهایی را فشرده می‌کند (در قالب .IR bzip2 ). این گزینه معادل قید کردن .I \-o bzip2 پس از تمام گزینه‌های دیگر است. .TP .B \-\-clean به جای ساخت سند، تمام فایل‌های تولیدشده توسط کامپایل را حذف می‌کند. این گزینه فقط در \fBrubber\fR وجود دارد. این کار بر اساس کامپایلی اعمال می‌شود که با گزینه‌های خط فرمان مشخص شده است؛ یعنی اجرای "rubber \-\-clean foo" فایل foo.ps را حذف نخواهد کرد، در حالی که اجرای "rubber \-\-ps \-\-clean foo" آن را حذف می‌کند. .TP .BI \-c,\ \-\-command \ دستور (یا رهنمود) مشخص‌شده را .I پیش از تجزیهٔ فایل‌های ورودی اجرا می‌کند. برای جزئیات بیشتر به بخش .B DIRECTIVES مراجعه کنید. .TP .BI \-e,\ \-\-epilogue \ دستور (یا رهنمود) مشخص‌شده را .I پس از تجزیهٔ فایل‌های ورودی اجرا می‌کند. برای جزئیات بیشتر به بخش .B DIRECTIVES مراجعه کنید. .TP .B \-f, \-\-force اجرای حداقل یک بار کامپایل منبع را اجباری می‌کند. این گزینه زمانی مفید است که برای نمونه، وابستگی نامعمولی تغییر کرده باشد (مانند بسته‌ای در یک دایرکتوری سیستمی). این گزینه در .B rubber\-pipe کاربردی ندارد. .TP .B \-z, \-\-gzip سند نهایی را فشرده می‌کند (در قالب .IR gzip ). این معادل قید کردن .I \-o gz پس از تمام گزینه‌های دیگر است. .TP .B \-h, \-\-help فهرست تمام گزینه‌های موجود را نمایش داده و خارج می‌شود. .TP .B \-\-inplace پیش از کامپایل به دایرکتوری فایل‌های منبع می‌رود، تا نتایج کامپایل در همان محل منابع قرار گیرند. .TP .BI \-\-into \ پیش از کامپایل به دایرکتوری مشخص‌شده می‌رود، تا تمام فایل‌ها در آنجا تولید شوند و نه در دایرکتوری جاری. .TP .BI \-\-jobname \ نام کاری (job name) متفاوتی نسبت به نام پایهٔ فایل تعیین می‌کند. این گزینه نام فایل‌های خروجی را تغییر می‌دهد و تنها بر روی اولین هدف اعمال می‌شود. .TP .B \-k, \-\-keep این گزینه تنها در .B rubber\-pipe استفاده می‌شود. با این گزینه، فایل‌های موقت پس از کامپایل سند و ریختن نتایج در خروجی استاندارد حذف نخواهند شد. سند موقت rubtmpX.tex نام‌گذاری می‌شود، که در آن X عددی است به گونه‌ای که در ابتدا هیچ فایلی با این نام وجود نداشته باشد. .TP .BI \-n,\ \-\-maxerr \ حداکثر تعداد خطاهای نمایشی را تعیین می‌کند. به طور پیش‌فرض، تا ۱۰ خطا گزارش می‌شود؛ تعیین .I \-n \-1 تمام خطاها را نمایش می‌دهد. .TP .BI \-m,\ \-\-module \ [: ] علاوه بر بسته‌های سند، از ماژول مشخص‌شده استفاده می‌کند. می‌توان آرگومان‌ها را با افزودن پس از دو‌نقطه (:) به بسته فرستاد؛ این مقادیر با گزینه‌های بسته در LaTeX مطابقت دارند. ماژول .I پیش از تجزیهٔ منابع سند بارگذاری می‌شود. .TP .BI \-\-only \ سند را به صورت جزئی کامپایل می‌کند، به‌طوری‌که تنها منابع مشخص‌شده لحاظ می‌شوند. این کار با درج فراخوانی \\includeonly در خط فرمان عمل می‌کند. آرگومان ورودی فهرستی از نام‌های فایل است که با کاما از هم جدا شده‌اند. .TP .BR \-o,\ \-\-post \ [: ] از ماژول مشخص‌شده به عنوان پس‌پردازشگر (post-processor) استفاده می‌کند. این مورد مشابه گزینهٔ .I \-m است با این تفاوت که ماژول .I پس از تجزیهٔ سند بارگذاری می‌شود. .TP .B \-d, \-\-pdf خروجی PDF تولید می‌کند. هنگامی که این گزینه پس از .I \-\-ps بیاید (مثلاً به شکل .IR \-pd )، مترادفی برای .IR \-o\ ps2pdf است، در غیر این صورت مانند .IR \-m\ pdftex عمل می‌کند تا از pdfLaTeX به جای LaTeX استفاده شود. .TP .B \-p, \-\-ps فایل DVI تولیدشده توسط فرایند را از طریق .BR dvips (1) پردازش می‌کند تا یک سند PostScript تولید شود. این گزینه مترادفی برای .IR \-o\ dvips است و نمی‌تواند پس از .I \-\-pdf بیاید. .TP .B \-q, \-\-quiet میزان پرگویی (verbosity) را کاهش می‌دهد. این گزینه معکوس .I \-v است. .TP .BI \-r,\ \-\-read \ رهنمودهای اضافی را از فایل مشخص‌شده می‌خواند (همچنین به رهنمود "read" مراجعه کنید). .TP .B \-S, \-\-src\-specials در صورت پشتیبانی کامپایلر، تولید source specials را فعال می‌کند. این معادل تنظیم متغیر .I src-specials روی .IR yes است. .TP .B \-s, \-\-short پیام‌های خطای LaTeX را به شکل فشرده نمایش می‌دهد (یک خطا در هر خط). .TP .BI \-I,\ \-\-texpath \ دایرکتوری مشخص‌شده را به مسیر جست‌وجوی TeX اضافه می‌کند. .TP .BI \-\-synctex پشتیبانی از SyncTeX را در اجرای LaTeX فعال می‌کند. .TP .BI \-\-unsafe به سند اجازه می‌دهد برنامه‌های خارجی دلخواه را فراخوانی کند. این کار بالقوه خطرناک است؛ تنها برای اسنادی که از یک منبع قابل اعتماد می‌آیند از این گزینه استفاده کنید..TP .B \-v, \-\-verbose افزایش سطح پرگویی (verbosity). سطوح بین 0 و 4 وجود دارند؛ سطح پیش‌فرض برای .B rubber برابر 1 و برای .BR rubber\-pipe برابر 0 است. توجه داشته باشید که استفاده از .I \-vvv باعث خروجی بسیار مفصل Rubber می‌شود. .TP .B \-\-version چاپ شماره نسخه و خروج موفقیت‌آمیز. .TP .BI \-W,\ \-\-warn \ گزارش اطلاعات مربوط به نوع مشخص‌شده در صورتی که در حین کامپایل خطایی رخ نداده باشد. انواع موجود عبارتند از: .B boxes (جعبه‌های overfull و underfull)، .B refs (ارجاعات تعریف‌نشده یا چندبار تعریف‌شده)، .B misc (سایر هشدارها) و .B all برای گزارش تمام هشدارها. .PP . .SH "پیمانه‌ها (MODULES)" عملکرد Rubber تحت تأثیر پیمانه‌ها قرار دارد. پیمانه‌ها به ویژگی‌های خاص بسته‌ها و برنامه‌های خارجی رسیدگی می‌کنند. . .SS "بسته‌ها (Packages)" به ازای هر بسته‌ای که یک سند استفاده می‌کند، Rubber به دنبال پیمانه‌ای با همان نام می‌گردد تا کارهایی را که ممکن است این بسته جدا از کامپایل توسط LaTeX نیاز داشته باشد، انجام دهد. می‌توان پیمانه‌هایی را به موارد ارائه‌شده به‌طور پیش‌فرض افزود تا قابلیت‌های جدید اضافه شوند (هدف سامانه پیمانه‌ای نیز همین است). پیمانه‌های استاندارد عبارتند از: .TP .B asymptote پردازش فایل‌های .asy تولیدشده توسط بسته LaTeX، و سپس اجرای کامپایل مجدد. .TP .B beamer این پیمانه با فایل‌های اضافی Beamer همانند سایر فهرست‌های مطالب رفتار می‌کند. .TP .B bibtex, biblatex رسیدگی به پردازش کتاب‌شناسی سند با BibTeX در صورت نیاز. این پیمانه در صورتی که سند شامل ماکروی \\bibliography باشد به‌طور خودکار بارگذاری می‌شود (همچنین برای گزینه‌ها به .B DIRECTIVES مراجعه کنید). .TP .B combine بسته combine برای گردآوری چندین سند LaTeX در یک سند واحد استفاده می‌شود، و این پیمانه وابستگی‌ها را در این حالت مدیریت می‌کند. .TP .B epsfig این پیمانه درج تصاویر را برای اسنادی که از ماکروی سبک قدیمی \\psfig استفاده می‌کنند مدیریت می‌کند. این پیمانه در واقع یک رابط برای پیمانه graphics است؛ برای جزئیات به آن مراجعه کنید. .TP .B glossaries اجرای makeglossaries و کامپایل مجدد هنگام تغییر فایل .glo. .TP .B graphics, graphicx این پیمانه‌ها تصاویر گنجانده‌شده در سند را شناسایی کرده و آن‌ها را به عنوان وابستگی‌های کامپایل در نظر می‌گیرند. آن‌ها همچنین از قوانین استاندارد برای ساخت این فایل‌ها با برنامه‌های خارجی استفاده می‌کنند. برای جزئیات به مستندات info مراجعه کنید. .TP .B hyperref مدیریت فایل‌های اضافی که این بسته در برخی موارد تولید می‌کند. .TP .B index, makeidx, nomencl پردازش نمایه‌ها و فهرست واژگان سند با .BR makeindex (1) در صورت نیاز (برای گزینه‌ها به بخش .B DIRECTIVES مراجعه کنید). .TP .BR ltxtable افزودن وابستگی‌ها برای فایل‌های واردشده از طریق بسته LaTeX به نام ltxtable. .TP .B minitoc, minitoc-hyper در هنگام پاک‌سازی، حذف فایل‌های اضافی که برای ساخت فهرست‌های مطالب جزئی تولید شده‌اند. .TP .B moreverb, verbatim افزودن فایل‌های واردشده با \\verbatiminput و ماکروهای مشابه به فهرست وابستگی‌ها. .TP .B multibib مدیریت کتاب‌شناسی‌های اضافی که این بسته ایجاد می‌کند، و حذف فایل‌های اضافی در هنگام پاک‌سازی. .TP .B xr افزودن فایل‌های .aux اضافی استفاده‌شده برای ارجاعات خارجی به فهرست وابستگی‌ها، تا کامپایل مجدد هنگام تغییر اسناد ارجاع‌شده به‌صورت خودکار انجام شود. .PP . .SS "پیش‌پردازش (Pre\-processing)" پیمانه‌های زیر برای استفاده از برنامه‌هایی ارائه شده‌اند که یک منبع LaTeX را از قالب فایلی متفاوت تولید می‌کنند: .TP .B cweb هدف این پیمانه، اجرای .BR cweave (1) در صورت نیاز قبل از فرآیند کامپایل به منظور تولید منبع LaTeX است. این پیمانه در صورتی که فایل مشخص‌شده در خط فرمان پسوند .B .w داشته باشد، به‌صورت خودکار بارگذاری می‌شود. .TP .B lhs2TeX این پیمانه از پیش‌پردازنده .B lhs2TeX برای تولید منبع LaTeX از یک برنامه Literate Haskell استفاده می‌کند. در صورتی که نام فایل ورودی به .BR .lhs ختم شود، به‌صورت خودکار فعال می‌شود. .PP ..SS "پس‌پردازش (Post\-processing)" ماژول‌های زیر برای پشتیبانی از انواع مختلف پس‌پردازش ارائه شده‌اند. توجه داشته باشید که هنگام استفاده از این ماژول‌ها ترتیب اهمیت دارد: اگر می‌خواهید از یک زنجیره پردازش مانند زیر استفاده کنید: .RS foo.tex \-> foo.dvi \-> foo.ps \-> foo.pdf \-> foo.pdf.gz .RE باید ماژول‌های .BR dvips ، .B ps2pdf و .B gz را به همین ترتیب بارگذاری کنید؛ برای نمونه با استفاده از خط فرمان زیر: .RS rubber \-p \-o ps2pdf \-z foo.tex .RE .TP .B bzip2 نسخه‌ای از فایل نهایی فشرده‌شده با .BR bzip2 (1) را تولید می‌کند. .TP .B dvipdfm در پایان کامپایل، .BR dvipdfm (1) را برای تولید یک سند PDF اجرا می‌کند. .TP .B dvips در پایان کامپایل، .BR dvips (1) را برای تولید یک سند PostScript اجرا می‌کند. این ماژول همچنین با گزینه خط فرمان .IR \-\-ps بارگذاری می‌شود. .TP .B expand با جایگزینی ماکروهای \einput با فایل‌های ضمیمه‌شده، ماکروهای کتاب‌شناسی با کتاب‌شناسی تولیدشده توسط .BR bibtex (1)، و کلاس‌ها و بسته‌های محلی با سورس آن‌ها، یک سورس گسترش‌یافته LaTeX تولید می‌کند. اگر فایل اصلی .I foo.tex باشد، فایل گسترش‌یافته .IR foo\-final.tex نامیده خواهد شد. برای جزئیات به مستندات info مراجعه کنید. .TP .B gz نسخه‌ای از فایل نهایی فشرده‌شده با .BR gzip (1) را تولید می‌کند. .TP .B ps2pdf با این فرض که کامپایل یک سند PostScript تولید می‌کند (برای نمونه با استفاده از ماژول .BR dvips )، این سند را با استفاده از .BR ps2pdf (1) به PDF تبدیل می‌کند. .PP . .SS "انتخاب کامپایلر (Compiler choice)" ماژول‌های زیر برای تغییر کامپایلر LaTeX استفاده می‌شوند: .TP .B aleph استفاده از کامپایلر Aleph به جای TeX، یعنی کامپایل سند با استفاده از .BR lamed (1) به جای .BR latex . .TP .B omega استفاده از کامپایلر Omega به جای TeX، یعنی کامپایل سند با استفاده از .BR lambda (1) به جای .BR latex . اگر ماژول .B dvips نیز استفاده شود، از .BR odvips (1) برای تبدیل فایل DVI استفاده خواهد کرد. توجه داشته باشید که این ماژول هنگامی که سند از بسته .BR omega استفاده کند، به‌طور خودکار فراخوانی می‌شود. .TP .B pdftex به Rubber دستور می‌دهد که برای کامپایل سند به جای .BR latex (1) از .BR pdflatex (1) استفاده کند. به‌طور پیش‌فرض، این کار به جای DVI یک فایل PDF تولید می‌کند، اما هنگام بارگذاری ماژول با گزینه .B dvi (برای نمونه با ذکر .IR \-m\ pdftex:dvi ) سند با استفاده از .BR pdflatex به DVI کامپایل می‌شود. این ماژول همچنین با گزینه خط فرمان .IR \-\-pdf بارگذاری می‌شود. .TP .B vtex به Rubber دستور می‌دهد از کامپایلر VTeX استفاده کند. به‌طور پیش‌فرض این ماژول از .B vlatex به عنوان کامپایلر برای تولید خروجی PDF استفاده می‌کند. با گزینه .B ps (برای نمونه با ذکر \(lqrubber \-m vtex:ps foo.tex\(rq) کامپایلر مورد استفاده .B vlatexp بوده و نتیجه یک فایل PostScript خواهد بود. .TP .B xelatex به Rubber دستور می‌دهد که به جای .BR latex از .BR xelatex (1) استفاده کند. .PP . .SH "دستورالعمل‌ها (DIRECTIVES)" رفتار خودکار Rubber بر پایه جستجوی ماکروها در سورس‌های LaTeX است. هنگامی که این کافی نباشد، می‌توان دستورالعمل‌هایی را در کامنت‌های سورس اضافه کرد. یک دستورالعمل خطی مانند زیر است: .RS % rubber: cmd args .RE این خط باید با یک «%» آغاز شود، سپس هر توالی از علامت‌های «%» و فاصله‌ها، سپس عبارت «rubber:» و به دنبال آن فاصله‌ها و یک نام دستور، و احتمالاً در ادامه فاصله‌ها و آرگومان‌ها قرار می‌گیرند. ..SS "دستورالعمل‌های عمومی (General directives)" .TP .BI alias \ \ چنین فرض می‌کند که ماکروی LaTeX به نام .I name1 معادل .IR name2 است. این کار هنگام تعریف پوشش‌ها (wrappers) پیرامون ماکروهای پشتیبانی‌شده می‌تواند مفید باشد. .TP .BI clean \ مشخص می‌کند که فایل تعیین‌شده باید هنگام پاک‌سازی با استفاده از .IR \-\-clean حذف شود. .TP .BI depend \ فایل مشخص‌شده را به عنوان یک وابستگی در نظر می‌گیرد تا زمان آخرین تغییرات آن بررسی شود. .TP .BI make \ \ [ ] اعلام می‌کند که فایل مشخص‌شده باید تولید شود. گزینه‌ها می‌توانند نحوهٔ تولید آن را مشخص کنند؛ گزینه‌های موجود عبارتند از .BI from \ برای تعیین منبع و .BI with \ برای تعیین قاعدهٔ تبدیل. برای مثال، عبارت «make foo.pdf from foo.eps» نشان می‌دهد که .I foo.pdf باید از .IR foo.eps ، با هر قاعدهٔ تبدیلی که قادر به انجام آن باشد تولید شود. برای جزئیات دربارهٔ تبدیل فایل، مستندات info را ببینید. .TP .BI module \ \ [ ] ماژول مشخص‌شده را احتمالاً به همراه گزینه‌ها بارگذاری می‌کند. این معادل گزینهٔ خط فرمان .IR \-\-module است. .TP .BI onchange \ \ اگر محتویات فایل مشخص‌شده پس از کامپایل تغییر کرده باشد، دستور پوستهٔ تعیین‌شده را اجرا می‌کند. نام فایل با اولین فاصله خاتمه می‌یابد. .TP .BI path \ دایرکتوری مشخص‌شده را به مسیر جستجوی TeX (و Rubber) اضافه می‌کند. نام دایرکتوری، تمام چیزی است که پس از فاصله‌های بعد از «path» می‌آید. .TP .BI produce \ اعلام می‌کند که اجرای LaTeX، فایل(های) مشخص‌شده را ایجاد یا به‌روزرسانی خواهد کرد. .TP .BI read \ فایل مشخص‌شدهٔ حاوی دستورالعمل‌ها را می‌خواند. فایل باید در هر خط شامل یک دستورالعمل باشد. خطوط خالی و خطوطی که با «%» شروع می‌شوند نادیده گرفته می‌شوند. .TP .BI rules \ قواعد تبدیل اضافی را از فایل مشخص‌شده می‌خواند. قالب این فایل مشابه قالب .IR rules.ini است؛ برای جزئیات مستندات info را ببینید. .TP .BI set \ \ مقدار یک متغیر را به صورت یک رشته تنظیم می‌کند. برای جزئیات دربارهٔ متغیرهای موجود و معانی آن‌ها، مستندات info را ببینید. .TP .BI setlist \ \ مقدار یک متغیر را به صورت فهرستی از رشته‌ها (که با فاصله از هم جدا شده‌اند) تنظیم می‌کند. برای جزئیات دربارهٔ متغیرهای موجود و معانی آن‌ها، مستندات info را ببینید. .TP .BI shell_escape سند را به عنوان سندی که به برنامه‌های خارجی (shell\-escape یا write18) نیاز دارد مشخص می‌کند. Rubber در عمل این مورد را فعال نمی‌کند مگر اینکه با گزینهٔ \-\-unsafe فراخوانی شود. .TP .BI synctex پشتیبانی از SyncTeX را در اجرای LaTeX فعال می‌کند. .TP .BI watch \ فایل مشخص‌شده را برای تغییرات زیر نظر می‌گیرد. اگر محتویات این فایل پس از یک کامپایل تغییر کرده باشد، کامپایل دیگری راه‌اندازی می‌شود. این مورد برای مثال در رابطه با فهرست مطالب مفید است. .PP . .SS "دستورالعمل‌های مختص ماژول (Module-specific directives)" اگر دستوری به فرم .IR foo.bar باشد، به عنوان دستور .I bar برای ماژول .IR foo در نظر گرفته می‌شود. اگر این ماژول هنگام یافتن دستورالعمل ثبت نشده باشد، دستور بدون هشدار یا اعلان نادیده گرفته می‌شود. برای ماژول‌های استاندارد، دستورالعمل‌ها به شرح زیر هستند: .TP .BI biblatex.path \ دایرکتوری مشخص‌شده را به مسیر جستجو برای پایگاه‌های دادهٔ BibTeX (فایل‌های .bib) اضافه می‌کند. .TP .BI bibtex.crossrefs \ حداقل تعداد .I crossref لازم برای گنجاندن خودکار مدخل ارجاع‌شده در فهرست مراجع را تعیین می‌کند. این دستورالعمل، گزینهٔ .I -min-crossrefs را هنگام فراخوانی .BR bibtex (1) تنظیم می‌کند. .TP .BI bibtex.path \ دایرکتوری مشخص‌شده را به مسیر جستجو برای پایگاه‌های دادهٔ BibTeX (فایل‌های .bib) اضافه می‌کند. .TP .BI bibtex.stylepath \ دایرکتوری مشخص‌شده را به مسیر جستجو برای شیوه‌نامه‌های BibTeX (فایل‌های .bst) اضافه می‌کند. .TP .BI bibtex.tool \ استفاده از یک ابزار کتاب‌شناسی دیگر به جای BibTeX. .TP .BI dvipdfm.options \ سوئیچ‌های خط فرمان مشخص‌شده را به .BR dvipdfm ارسال می‌کند. .TP .BI dvips.options \ سوئیچ‌های خط فرمان مشخص‌شده را به .BR dvips ارسال می‌کند. .TP .BI index.tool \ (index)\ مشخص می‌کند که چه ابزاری برای پردازش نمایه باید استفاده شود. ابزارهای پشتیبانی‌شدهٔ کنونی عبارتند از .BR makeindex (1) (انتخاب پیش‌فرض) و .BR xindy (1). آرگومان .I index اختیاری است؛ می‌توان از آن برای تعیین فهرستی از نمایه‌ها که دستور بر آن‌ها اعمال می‌شود استفاده کرد. در صورت وجود، باید درون پرانتز قرار گیرد؛ فهرست با کاما جدا می‌شود. هنگامی که این آرگومان ارائه نشود، دستور بر تمام نمایه‌ها اعمال می‌گردد. .TP .BI index.language \ (index)\ زبان مورد استفاده برای مرتب‌سازی نمایه را انتخاب می‌کند. این دستورالعمل تنها زمانی اعمال می‌شود که از .BR xindy (1) به عنوان ابزار نمایه‌سازی استفاده شود. آرگومان اختیاری دارای همان معنا و مفهوم ذکرشده در بالاست. .TP .BI index.modules \ (index)\ ... مشخص می‌کند هنگام پردازش نمایه با .BR xindy (1) از کدام ماژول‌ها استفاده شود. آرگومان اختیاری دارای همان معنا و مفهوم ذکرشده در بالاست. .TP .BI index.order \ (index)\ گزینه‌های مرتب‌سازی نمایه‌ها را تغییر می‌دهد. آرگومان‌ها کلماتی (جداشده با فاصله) از میان .IR standard ، .I german و .IR letter هستند. این مورد تنها هنگام استفاده از .BR makeindex (1) اعمال می‌شود. آرگومان اختیاری دارای همان معنا و مفهوم ذکرشده در بالاست. .TP .BI index.path \ (index)\ دایرکتوری مشخص‌شده را به مسیر جستجو برای شیوه‌نامه‌های نمایه (فایل‌های .ist) اضافه می‌کند. آرگومان اختیاری دارای همان معنا و مفهوم ذکرشده در بالاست. .TP .BI index.style \ (index)\