.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "BIB2GLS 1" .TH BIB2GLS 1 2025-11-13 "perl v5.40.3" bib2gls .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBbib2gls\fR [\fIگزینه\fR]+ \fIauxfile\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" \&\fBbib2gls\fR برای کار با بستهٔ LaTeX به نام \fBglossaries\-extra\fR طراحی شده است. (گزینهٔ بسته‌ای \fBrecord\fR الزامی است.) این برنامه دو کارکرد را در قالب یک ابزار ارائه می‌دهد: (۱) انتخاب مدخل‌ها از فایل‌های .bib بر اساس اطلاعات موجود در \fIauxfile\fR (مشابه \&\fBbibtex\fR)؛ (۲) مرتب‌سازی سلسله‌مراتبی مدخل‌ها و تلفیق فهرست‌های مکان (مشابه \fBmakeindex\fR و \fBxindy\fR). پسوند .aux را می‌توان از \fIauxfile\fR حذف کرد. .PP فایل \fIauxfile\fR (و فایل .log متناظر با آن) باید در دایرکتوری جاری یا در دایرکتوری مشخص‌شده توسط \fB\-\-dir\fR قرار داشته باشد. فایل‌های bib می‌توانند نسبت به دایرکتوری‌ای که \fIauxfile\fR در آن قرار دارد مشخص شوند یا در مکانی باشند که توسط kpsewhich قابل یافتن باشد..SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-\-aux\-input\-action\fR \fIsetting\fR" 4 .IX Item "--aux-input-action setting" مشخص می‌کند هنگامی که \fBbib2gls\fR در فایل \fIaux\fR به \f(CW\*(C`\e@input\*(C'\fR برخورد می‌کند چه کاری انجام دهد. مقدار \fIsetting\fR می‌تواند یکی از موارد زیر باشد: .RS 4 .IP \fBfollow\fR 4 .IX Item "follow" دنبال کردن ارجاع (یعنی وارد کردن فایل طبق روال معمول). .IP "\fBskip\-after\-bibglsaux\fR (یا \fBskip after bibglsaux\fR)" 4 .IX Item "skip-after-bibglsaux (or skip after bibglsaux)" دنبال کردن ارجاع برای هر \f(CW\*(C`\e@input\*(C'\fR تا زمانی که به \f(CW\*(C`\e@bibgls@input\*(C'\fR برخورد شود، و پس از آن نادیده گرفتن تمام موارد باقی‌ماندهٔ \f(CW\*(C`\e@input\*(C'\fR (پیش‌فرض). .IP \fBskip\fR 4 .IX Item "skip" نادیده گرفتن تمام موارد \f(CW\*(C`\e@input\*(C'\fR (به‌جز \f(CW\*(C`\e@bibgls@input\*(C'\fR که همواره دنبال می‌شود). .RE .RS 4 .Sp دستور \f(CW\*(C`\e@bibgls@input\*(C'\fR در صورت استفاده از گزینهٔ بستهٔ \f(CW\*(C`bibglsaux\*(C'\fR در فایل \fIaux\fR موجود خواهد بود. .RE .IP \fB\-\-break\-space\fR 4 .IX Item "--break-space" تفسیر نویسهٔ \f(CW\*(C`~\*(C'\fR (تیلدا) و \f(CW\*(C`\enobreakspace\*(C'\fR به عنوان یک فاصلهٔ معمولی. .IP \fB\-\-cite\-as\-record\fR 4 .IX Item "--cite-as-record" در نظر گرفتن \f(CW\*(C`\ecitation\*(C'\fR به عنوان یک رکورد نادیده‌گرفته‌شده. .IP \fB\-\-collapse\-same\-location\-range\fR 4 .IX Item "--collapse-same-location-range" فشرده‌سازی یک بازهٔ صریح که مکان آغاز و پایان یکسان دارد به یک رکورد معمولی (پیش‌فرض). .IP "\fB\-\-custom\-packages\fR \fIlist\fR" 4 .IX Item "--custom-packages list" دستور دادن به کتابخانهٔ تجزیه‌گر TeX برای تلاش جهت تجزیهٔ بسته‌های فهرست‌شده در \fIlist\fR. این گزینه برای بسته‌های سفارشی ساده‌ای در نظر گرفته شده است که حاوی کدهای پیچیده نیستند. .IP \fB\-\-datatool\-sort\-markers\fR 4 .IX Item "--datatool-sort-markers" مفسر از دستورهای نشانه‌گذار \fIdatatool\-base.sty\fR برای تطبیق تعاریف محلی‌شدهٔ آن‌ها در \f(CW\*(C`\eDTLsortwordlist\*(C'\fR (\fIdatatool\fR نسخه ۳.۰+) استفاده خواهد کرد. شما به یک روش مرتب‌سازی نیاز خواهید داشت که نویسه‌های کنترلی استفاده‌شده توسط این دستورها را نادیده نگیرد. .IP "\fB\-\-date\-in\-header\fR (یا \fB\-D\fR)" 4 .IX Item "--date-in-header (or -D)" توضیح سرآیند در ابتدای فایل \fI.glstex\fR شامل تاریخ تغییر فایل خواهد بود. .IP "\fB\-\-debug\fR [\fIn\fR]" 4 .IX Item "--debug [n]" روشن کردن حالت اشکال‌زدایی با تنظیم داده‌شدهٔ \fIn\fR، که باید یک عدد صحیح غیرمنفی باشد. اگر \fIn\fR برابر با \fB0\fR باشد، حالت اشکال‌زدایی خاموش می‌شود. در صورت حذف، مقدار \fIn\fR برابر با 1 تعیین می‌شود که معادل \fB\-\-debug\-mode\fR \fBio\fR است. هر عدد مثبت تمام پیام‌های اشکال‌زدایی \fBbib2gls\fR را فعال خواهد کرد. میزان پیام‌های اشکال‌زدایی کتابخانهٔ تجزیه‌گر TeX به عملیات بیتی روی \fIn\fR بستگی دارد. .IP "\fB\-\-debug\-mode\fR \fIsetting\fR" 4 .IX Item "--debug-mode setting" می‌تواند به جای \fB\-\-debug\fR در مواردی که به‌خاطرسپاری شمارهٔ سطح دشوار است استفاده شود. مقدار \fIsetting\fR می‌تواند فهرستی جداشده با کاما از هر یک از کلیدواژه‌های زیر باشد: .RS 4 .IP \fBall\fR 4 .IX Item "all" بالاترین سطح (احتمالاً منجر به یک فایل رونوشت بزرگ می‌شود). معادل روشن کردن تمام تنظیمات است. .IP \fBcatcode\fR 4 .IX Item "catcode" تغییرات کدهای ردهٔ تجزیه‌گر TeX. .IP \fBcs\fR 4 .IX Item "cs" تعاریف دستور تجزیه‌گر TeX. .IP \fBdecl\fR 4 .IX Item "decl" اعلان‌های تجزیه‌گر TeX. .IP \fBexpansion\fR 4 .IX Item "expansion" بسط‌های تجزیه‌گر TeX (ممکن است منجر به یک فایل رونوشت بزرگ شود). .IP \fBexpansion\-list\fR 4 .IX Item "expansion-list" بسط‌های پشتهٔ تجزیه‌گر TeX (ممکن است منجر به یک فایل رونوشت بزرگ شود). .IP \fBexpansion\-once\fR 4 .IX Item "expansion-once" بسط‌های یک‌سطحی تجزیه‌گر TeX. .IP \fBexpansion\-once\-list\fR 4 .IX Item "expansion-once-list" بسط‌های فهرست یک‌سطحی تجزیه‌گر TeX. .IP \fBio\fR 4 .IX Item "io" عملیات ورودی/خروجی تجزیه‌گر TeX (باز کردن، بستن و واکشی نشانه). .IP \fBpopped\fR 4 .IX Item "popped" بیرون کشیدن از پشتهٔ تجزیه‌گر TeX. .IP \fBprocess\fR 4 .IX Item "process" پردازش ماکروی تجزیه‌گر TeX (ممکن است منجر به یک فایل رونوشت بزرگ شود). .IP \fBprocess\-generic\-cs\fR 4 .IX Item "process-generic-cs" پردازش دستور عمومی تجزیه‌گر TeX. .IP \fBprocess\-stack\fR 4 .IX Item "process-stack" پردازش پشتهٔ تجزیه‌گر TeX (ممکن است منجر به یک فایل رونوشت بزرگ شود). .IP \fBprocess\-stack\-list\fR 4 .IX Item "process-stack-list" پردازش تفصیلی پشتهٔ تجزیه‌گر TeX (ممکن است منجر به یک فایل رونوشت بزرگ شود). .IP \fBread\fR 4 .IX Item "read" خواندن کدپوینت از فایل توسط تجزیه‌گر TeX (احتمالاً منجر به یک فایل رونوشت بزرگ می‌شود). .IP \fBsty\-data\fR 4 .IX Item "sty-data" داده‌های تجزیه‌گر TeX (معمولاً مربوط به اشیای درونی است که ماکروی TeX مشابهی ندارند). این شامل داده‌های جمع‌آوری‌شده از فایل aux می‌شود. .RE .RS 4 .Sp برای مثال: \f(CW\*(C`bib2gls \-\-debug\-mode io,catcode,sty\-data mydoc\*(C'\fR .RE .IP "\fB\-\-default\-encoding\fR \fIname\fR" 4 .IX Item "--default-encoding name" تنظیم کدگذاری نویسهٔ پیش‌فرض برای فایل‌های ورودی و خروجی. در صورت حذف، کدگذاری پیش‌فرض JVM فرض می‌شود. .IP "\fB\-\-dir\fR \fIdirectory\fR (یا \fB\-d\fR )" 4 .IX Item "--dir directory (or -d )" فایل‌ها نسبت به \fIdirectory\fR سنجیده می‌شوند. (این گزینه دایرکتوری کاری فعلی را تغییر نمی‌دهد.) .IP \fB\-\-expand\-fields\fR 4 .IX Item "--expand-fields" عدم نوشتن \f(CW\*(C`\eglsnoexpandfields\*(C'\fR در فایل \fI.glstex\fR. .IP "\fB\-\-force\-cross\-resource\-refs\fR یا \fB\-x\fR" 4 .IX Item "--force-cross-resource-refs or -x" اجبار به روشن بودن حالت ارجاع بین‌منبعی. .IP "\fB\-\-group\fR یا \fB\-g\fR" 4 .IX Item "--group or -g" افزودن فیلد \fBgroup\fR به مدخل‌ها. .IP "\fB\-\-help\fR یا \fB\-h\fR" 4 .IX Item "--help or -h" نمایش پیام راهنما و خروج. .IP "\fB\-\-ignore\-packages\fR \fIlist\fR (یا \fB\-k\fR \fIlist\fR)" 4 .IX Item "--ignore-packages list (or -k list)" عدم تجزیهٔ فایل لاگ برای بسته‌های فهرست‌شده در \fIlist\fR. توجه داشته باشید که \fB\-\-packages\fR این گزینه را لغو می‌کند؛ بنابراین اگر یک بسته هم در \fB\-\-ignore\-packages\fR و هم در \fB\-\-packages\fR فهرست شده باشد، مفسر پشتیبانی شدن آن را بررسی خواهد کرد. این گزینه عملکردی تجمعی دارد. تنها بسته‌های شناخته‌شده را می‌توان در \fIlist\fR گنجاند. .IP \fB\-\-interpret\fR 4 .IX Item "--interpret" استفاده از کتابخانهٔ تجزیه‌گر TeX برای تفسیر دستورهای شناخته‌شدهٔ (La)TeX (پیش‌فرض). .IP \fB\-\-list\-known\-packages\fR 4 .IX Item "--list-known-packages" فهرست کردن تمام بسته‌های شناخته‌شده برای کتابخانهٔ تجزیه‌گر TeX و سپس خروج (با کد خروج 0). هر یک از بسته‌های فهرست‌شده را می‌توان در \fB\-\-packages\fR یا \fB\-\-ignore\-packages\fR استفاده کرد. .IP "\fB\-\-locale\fR \fIlang\fR (یا \fB\-l\fR \fIlang\fR)" 4 .IX Item "--locale lang (or -l lang)" استفاده از فایل منبع زبان برای \fIlang\fR (که باید یک برچسب محلی IETF باشد). .IP "\fB\-\-log\-encoding\fR \fIname\fR" 4 .IX Item "--log-encoding name" تنظیم کدگذاری نویسه برای فایل‌های \fIlog\fR (که ممکن است با کدگذاری فایل‌های LaTeX سند یکسان نباشد). .IP "\fB\-\-log\-file\fR \fIfile\fR (یا \fB\-t\fR )" 4 .IX Item "--log-file file (or -t )" تنظیم فایل رونوشت. .IP "\fB\-\-merge\-nameref\-on\fR \fIrule\fR" 4 .IX Item "--merge-nameref-on rule" قاعده برای ادغام مکان‌های ایجادشده با گزینهٔ بستهٔ \fBrecord=nameref\fR (نیازمند \fIglossaries\-extra.sty\fR نسخه 1.37+). مقدار \fIrule\fR می‌تواند یکی از موارد زیر باشد: \fBhcounter\fR، \fBhref\fR، \fBtitle\fR یا \fBlocation\fR. .IP \fB\-\-merge\-wrglossary\-records\fR 4 .IX Item "--merge-wrglossary-records" ادغام رکوردهای \fBwrglossary\fR یک مدخل برای مکان‌های صفحهٔ یکسان. (جهت استفاده به همراه گزینهٔ بستهٔ \fBindexcounter\fR.) .IP \fB\-\-mfirstuc\-math\-protection\fR 4 .IX Item "--mfirstuc-math-protection" فعال کردن درج خودکار یک گروه خالی برای تغییر حالت ریاضی (\f(CW\*(C`$\*(C'\fR). .Sp اگر \fImfirstuc\fR نسخه 2.08+، \fIglossaries\fR نسخه 4.50+ و \fIglossaries\-extra\fR نسخه 1.49+ شناسایی شوند، حالت پیش‌فرض \fB\-\-no\-mfirstuc\-math\-protection\fR خواهد بود، زیرا دیگر نیازی به این محافظت نخواهد بود..IP "\fB\-\-mfirstuc\-protection\fR \fIfields\fR|\fBall\fR (یا \fB\-u\fR \fIfields\fR|\fBall\fR)" 4 .IX Item "--mfirstuc-protection fields|all (or -u fields|all)" درج یک گروه خالی در صورتی که فیلدها با دستورهای مشکل‌ساز خاصی شروع شوند، جهت محافظت در برابر دستورهای تغییر وضعیت حروف مانند \f(CW\*(C`\eGls\*(C'\fR. .Sp حالت پیش‌فرض اعمال این عمل برای تمام فیلدها است. برای انجام آن تنها روی زیرمجموعه‌ای از فیلدها، مقدار \fIfields\fR را با فهرستی از فیلدهای جداشده با ویرگول مشخص کنید (مانند \fBname,short,long\fR). کلیدواژه \fBall\fR بیانگر همه فیلدها است. .Sp اگر \fImfirstuc\fR نسخه 2.08+، \fIglossaries\fR نسخه 4.50+ و \fIglossaries\-extra\fR نسخه 1.49+ شناسایی شوند، حالت پیش‌فرض \fB\-\-no\-mfirstuc\-protection\fR خواهد بود، زیرا دیگر نیازی به این محافظت نخواهد بود. .IP "\fB\-\-nested\-link\-check\fR \fIlist\fR|\fBnone\fR" 4 .IX Item "--nested-link-check list|none" بررسی هر فیلد مشخص‌شده در \fIlist\fR برای یافتن متن‌های پیوند تودرتو که ممکن است مشکل‌ساز باشند. (فهرست پیش‌فرض: name، text، plural، first، firstplural، short، shortplural، long، longplural، symbol). .Sp اگر \fBnone\fR باشد، بررسی را غیرفعال می‌کند. .IP \fB\-\-no\-break\-space\fR 4 .IX Item "--no-break-space" تفسیر \f(CW\*(C`~\*(C'\fR (تیلدا) و \f(CW\*(C`\enobreakspace\*(C'\fR به عنوان فاصله نشکن (پیش‌فرض). .IP \fB\-\-no\-cite\-as\-record\fR 4 .IX Item "--no-cite-as-record" عدم بررسی موارد رخداد \f(CW\*(C`\ecitation\*(C'\fR در فایل \fI.aux\fR (پیش‌فرض). .IP \fB\-\-no\-collapse\-same\-location\-range\fR 4 .IX Item "--no-collapse-same-location-range" عدم فروپاشی بازه صریحی که مکان شروع و پایان یکسان دارد به یک رکورد عادی. .IP \fB\-\-no\-datatool\-sort\-markers\fR 4 .IX Item "--no-datatool-sort-markers" مفسر از تعریف عادی دستورهای نشانه‌گذار مرتب‌سازی \&\fIdatatool\-base.sty\fR استفاده خواهد کرد. .IP \fB\-\-no\-date\-in\-header\fR 4 .IX Item "--no-date-in-header" توضیح سرآیند در ابتدای فایل \fI.glstex\fR شامل تاریخ ویرایش فایل نخواهد بود (پیش‌فرض). .IP "\fB\-\-no\-debug\fR (یا \fB\-\-nodebug\fR)" 4 .IX Item "--no-debug (or --nodebug)" غیرفعال کردن حالت اشکال‌زدایی. (معادل \fB\-\-debug\fR \fB0\fR) .IP \fB\-\-no\-expand\-fields\fR 4 .IX Item "--no-expand-fields" نوشتن \f(CW\*(C`\eglsnoexpandfields\*(C'\fR در فایل \fI.glstex\fR (پیش‌فرض). .IP \fB\-\-no\-force\-cross\-resource\-refs\fR 4 .IX Item "--no-force-cross-resource-refs" عدم تحمیل فعال‌سازی حالت ارجاع متقابل بین‌منبعی (پیش‌فرض). .IP \fB\-\-no\-group\fR 4 .IX Item "--no-group" عدم افزودن فیلد \fBgroup\fR به مدخل‌ها (پیش‌فرض). .IP \fB\-\-no\-interpret\fR 4 .IX Item "--no-interpret" عدم تلاش برای تفسیر دستورهای (La)TeX. کتابخانه TeX Parser Library همچنان برای تجزیه فایل‌های \fIaux\fR و \fIbib\fR استفاده خواهد شد. .IP \fB\-\-no\-merge\-wrglossary\-records\fR 4 .IX Item "--no-merge-wrglossary-records" عدم ادغام رکوردهای \fBwrglossary\fR یک مدخل. .IP \fB\-\-no\-mfirstuc\-math\-protection\fR 4 .IX Item "--no-mfirstuc-math-protection" غیرفعال کردن درج خودکار گروه خالی برای تغییر حالت ریاضی (\f(CW\*(C`$\*(C'\fR). .IP \fB\-\-no\-mfirstuc\-protection\fR 4 .IX Item "--no-mfirstuc-protection" غیرفعال کردن درج خودکار گروه خالی برای تمامی فیلدها. .IP \fB\-\-no\-nested\-link\-check\fR 4 .IX Item "--no-nested-link-check" عدم بررسی متن‌های پیوند تودرتو که ممکن است مشکل‌ساز باشند. (معادل \fB\-\-nested\-link\-check\fR \fBnone\fR) .IP \fB\-\-no\-obey\-aux\-catcode\fR 4 .IX Item "--no-obey-aux-catcode" نادیده گرفتن دستورهای تغییر کد دسته (catcode) مشاهده‌شده در فایل aux. .IP \fB\-\-no\-provide\-glossaries\fR 4 .IX Item "--no-provide-glossaries" عدم نوشتن \f(CW\*(C`\eprovideignoredglossary*\*(C'\fR در فایل \fI.glstex\fR برای معرفی واژه‌نامه‌های ناشناخته به جز در موارد مستندشده (گزینه‌های منبع \fBmaster\fR، \fBsecondary\fR و \fBtrigger\-type\fR). این تنظیم پیش‌فرض است. .IP \fB\-\-no\-record\-count\fR 4 .IX Item "--no-record-count" عدم افزودن فیلد شمارش رکوردها به مدخل‌ها (پیش‌فرض). این گزینه به‌طور خودکار \fB\-\-no\-record\-count\-unit\fR را نیز اعمال می‌کند. .IP \fB\-\-no\-record\-count\-unit\fR 4 .IX Item "--no-record-count-unit" عدم افزودن فیلد شمارش واحد رکوردها به مدخل‌ها (پیش‌فرض). .IP \fB\-\-no\-replace\-quotes\fR 4 .IX Item "--no-replace-quotes" عدم جایگزینی نویسه‌های علامت نقل‌قول (پیش‌فرض). .IP \fB\-\-no\-retain\-formats\fR 4 .IX Item "--no-retain-formats" قوانین عادی ادغام مکان اعمال می‌شوند (پیش‌فرض). .IP \fB\-\-no\-shift\-zero\-sections\fR 4 .IX Item "--no-shift-zero-sections" عدم بررسی مکان‌های پایان‌یافته با ".0" (پیش‌فرض). .IP \fB\-\-no\-support\-unicode\-script\fR 4 .IX Item "--no-support-unicode-script" بالانویس‌های متنی (\f(CW\*(C`\etextsuperscript\*(C'\fR) یا زیرنویس‌ها (\f(CW\*(C`\etextsubscript\*(C'\fR) به نویسه‌های بالانویس/زیرنویس یونیکد تبدیل نخواهند شد. به عنوان مثال، \f(CW\*(C`\etextsuperscript{2}\*(C'\fR به \f(CW\*(C`2\*(C'\fR تبدیل شده و نشانه‌گذاری آن حذف می‌شود و فقط نویسه 2 باقی می‌ماند. .IP \fB\-\-no\-trim\-fields\fR 4 .IX Item "--no-trim-fields" فاصله‌های خالی ابتدا و انتهای فیلدها را حذف نکن (پیش‌فرض). این گزینه \fB\-\-trim\-only\-fields\fR و \fB\-\-trim\-fields\fR را لغو می‌کند. .IP "\fB\-\-no\-verbose\fR (یا \fB\-\-noverbose\fR)" 4 .IX Item "--no-verbose (or --noverbose)" غیرفعال کردن حالت پرگو (verbose). (برخی از پیام‌ها همچنان در خروجی استاندارد STDOUT نوشته خواهند شد.) .IP \fB\-\-no\-warn\-non\-bib\-fields\fR 4 .IX Item "--no-warn-non-bib-fields" عدم صدور هشدار در صورت یافت شدن فیلدهای داخلی غیر-bib در فایل \fI.bib\fR. استفاده از این فیلدهای داخلی ممکن است نتایج غیرمنتظره‌ای به همراه داشته باشد، بنابراین تنها در صورتی از این گزینه استفاده کنید که تمهیدات لازم را اندیشیده باشید. .IP \fB\-\-no\-warn\-unknown\-entry\-types\fR 4 .IX Item "--no-warn-unknown-entry-types" عدم صدور هشدار در صورت یافت شدن انواع مدخل‌های ناشناخته در فایل \fI.bib\fR. .IP \fB\-\-obey\-aux\-catcode\fR 4 .IX Item "--obey-aux-catcode" پیروی از دستورهای شناخته‌شده تغییر کد دسته (catcode) مشاهده‌شده در فایل aux. .IP "\fB\-\-packages\fR \fIlist\fR (یا \fB\-p\fR \fIlist\fR)" 4 .IX Item "--packages list (or -p list)" به کتابخانه تحلیل‌گر TeX دستور می‌دهد فرض کند بسته‌های مشخص‌شده در \fIlist\fR توسط سند استفاده شده‌اند. توجه داشته باشید که تنها تعداد محدودی از بسته‌ها توسط کتابخانه تحلیل‌گر TeX پشتیبانی می‌شوند. این گزینه اثر تجمعی دارد، بنابراین \fB\-\-packages wasysym,pifont\fR با \fB\-\-packages wasysym \-\-packages pifont\fR یکسان است. .Sp می‌توانید فهرست بسته‌های پشتیبانی‌شده را با \&\fB\-\-list\-known\-packages\fR مشاهده کنید. .IP \fB\-\-provide\-glossaries\fR 4 .IX Item "--provide-glossaries" نوشتن \f(CW\*(C`\eprovideignoredglossary*\*(C'\fR در فایل \fI.glstex\fR برای معرفی واژه‌نامه‌های ناشناخته. .IP "\fB\-\-quiet\fR (یا \fB\-q\fR)" 4 .IX Item "--quiet (or -q)" تنها نمایش پیام‌های خطا. تمام پیام‌های دیگر صرفاً در فایل رونوشت (transcript) نوشته می‌شوند. .IP "\fB\-\-record\-count\fR یا \fB\-c\fR" 4 .IX Item "--record-count or -c" افزودن فیلدهای شمارش رکورد به مدخل‌ها. .IP "\fB\-\-record\-count\-rule\fR \fIrule\fR یا \fB\-r\fR \fIrule\fR" 4 .IX Item "--record-count-rule rule or -r rule" قاعده مورد استفاده توسط \fB\-\-record\-count\fR و \fB\-\-record\-count\-unit\fR را تعیین می‌کند. این گزینه به‌طور خودکار \fB\-\-record\-count\fR را اعمال می‌کند. .Sp مقدار \fIrule\fR می‌تواند این موارد باشد: \f(CW\*(C`all\*(C'\fR یا \f(CW\*(C`a\*(C'\fR (شمارش تمام رکوردها)، \&\f(CW\*(C`non\-ignored\*(C'\fR یا \f(CW\*(C`n\*(C'\fR (شمارش تمام رکوردهای نادیده‌گرفته‌نشده)، \&\f(CW\*(C`f/\*(C'\fR\fIregex\fR\f(CW\*(C`/\*(C'\fR (تنها شمارش رکوردهایی که قالب آن‌ها با عبارت باقاعده \fIregex\fR مطابقت دارد)، \&\f(CW\*(C`c/\*(C'\fR\fIregex\fR\f(CW\*(C`/\*(C'\fR (تنها شمارش رکوردهایی که نام شمارنده آن‌ها با عبارت باقاعده \fIregex\fR مطابقت دارد)، یا \f(CW\*(C`f/\*(C'\fR\fIregex1\fR\f(CW\*(C`/c/\*(C'\fR\fIregex2\fR\f(CW\*(C`/\*(C'\fR\fIop\fR (تنها شمارش رکوردهایی که قالب آن‌ها با عبارت باقاعده \fIregex1\fR و/یا نام شمارنده آن‌ها با عبارت باقاعده \fIregex2\fR مطابقت دارد). بخش \fIop\fR اختیاری است. در صورت مشخص شدن می‌تواند یکی از این موارد باشد: \f(CW\*(C`and\*(C'\fR (قالب و شمارنده هر دو باید مطابقت داشته باشند)، \f(CW\*(C`or\*(C'\fR (قالب یا شمارنده باید مطابقت داشته باشند). اگر \fIop\fR حذف شود، AND در نظر گرفته می‌شود. .IP "\fB\-\-record\-count\-unit\fR یا \fB\-n\fR" 4 .IX Item "--record-count-unit or -n" افزودن فیلدهای شمارش واحد رکورد به مدخل‌ها. این گزینه به‌طور خودکار \fB\-\-record\-count\fR را اعمال می‌کند. .IP \fB\-\-replace\-quotes\fR 4 .IX Item "--replace-quotes" جایگزینی نویسه‌های نقل‌قول تکی و دوگانه (\f(CW\*(C`\*(Aq\*(C'\fR و \f(CW\*(C`"\*(C'\fR) با \&\f(CW\*(C`\ebibglsaposchar\*(C'\fR و \f(CW\*(C`\ebibglsdoublequotechar\*(C'\fR در مقادیر فیلدها و اطلاعات گروه نوشته‌شده در فایل \fI.glstex\fR. .IP "\fB\-\-retain\-formats\fR \fIlist\fR" 4 .IX Item "--retain-formats list" مشخص می‌کند کدام قالب‌های مکان باید همواره حفظ شوند، حتی اگر سبب ایجاد مورد تکراری جزئی شوند. تنها موارد کاملاً تکراری ادغام خواهند شد. .IP \fB\-\-shift\-zero\-sections\fR 4 .IX Item "--shift-zero-sections" انتقال به سطح بالاتر برای مکان‌های بخشی که به ".0" ختم می‌شوند (برای بخش‌های عمیق‌تر از فصل یا chapter). این عمل به‌صورت بازگشتی اعمال می‌شود. .Sp به عنوان مثال، اگر یک رکورد دارای شمارنده \f(CW\*(C`subsection\*(C'\fR و مکان \&\f(CW2.0.0\fR باشد، این مقدار ابتدا با شمارنده \f(CW\*(C`section\*(C'\fR و مکان \f(CW2.0\fR جایگزین می‌شود، اما چون این مقدار هنوز دارای مکان بخشی منتهی به ".0" است، تابع مجدداً اعمال شده و شمارنده به \f(CW\*(C`chapter\*(C'\fR و مکان به \&\f(CW2\fR تغییر می‌یابد (بنابراین مکان subsection 2.0.0 در نهایت به عنوان chapter 2 ثبت می‌شود). فایل لاگ (و حالت پرگو) شامل یک خط به ازای هر تغییر در این بازگشت خواهد بود..IP "\fB\-\-shortcuts\fR \fIoption\fR" 4 .IX Item "--shortcuts option" هنگام جستجوی وابستگی‌ها، دستورهای میانبر بررسی شوند. مقادیر مجاز \fIoption\fR عبارتند از: \fBacronyms\fR (یا \fBacro\fR)، \fBac\fR، \&\fBabbreviations\fR (یا \fBabbr\fR)، \fBall\fR (یا \fBtrue\fR)، \fBnone\fR (یا \&\fBfalse\fR). این گزینه تنظیم مشخص‌شده در \fIauxfile\fR را نادیده می‌گیرد. .IP "\fB\-\-map\-format\fR \fIkey\fR\fB:\fR\fIvalue\fR[\fB,\fR\fIkey\fR\fB:\fR\fIvalue\fR]* (یا \fB\-m\fR \fIkey\fR\fB:\fR\fIvalue\fR[\fB,\fR\fIkey\fR\fB:\fR\fIvalue\fR]*)" 4 .IX Item "--map-format key:value[,key:value]* (or -m key:value[,key:value]*)" تنظیم نگاشت‌های قالب مکان. .IP \fB\-\-silent\fR 4 .IX Item "--silent" تنها پیام‌های خطا نمایش داده شوند. تمامی پیام‌های دیگر فقط در فایل رونوشت (transcript) نوشته می‌شوند. (مترادف \fB\-\-quiet\fR.) .IP \fB\-\-support\-unicode\-script\fR 4 .IX Item "--support-unicode-script" بالانویس متن (\f(CW\*(C`\etextsuperscript\*(C'\fR) یا زیرنویس متن (\f(CW\*(C`\etextsubscript\*(C'\fR) در صورت موجود بودن از نویسه‌های بالانویس/زیرنویس یونیکد استفاده خواهند کرد. برای نمونه، \f(CW\*(C`\etextsuperscript{2}\*(C'\fR به U+00B2 (دو بالانویس) تبدیل خواهد شد. .IP "\fB\-\-tex\-encoding\fR \fIname\fR" 4 .IX Item "--tex-encoding name" تنظیم رمزگذاری نویسه‌ها برای فایل‌های \fIglstex\fR. این گزینه تنظیم مشخص‌شده در \fIauxfile\fR را نادیده می‌گیرد. .IP "\fB\-\-trim\-except\-fields\fR \fIlist\fR" 4 .IX Item "--trim-except-fields list" حذف فاصله‌های خالی ابتدا و انتهای تمام فیلدها به‌جز موارد فهرست‌شده. این گزینه انباشتی است اما توسط \fB\-\-trim\-fields\fR و \fB\-\-no\-trim\-fields\fR لغو می‌شود. این گزینه نباید همراه با \&\fB\-\-trim\-only\-fields\fR استفاده شود. .IP \fB\-\-trim\-fields\fR 4 .IX Item "--trim-fields" حذف فاصله‌های خالی ابتدا و انتهای تمام فیلدها. این گزینه \fB\-\-trim\-only\-fields\fR و \fB\-\-no\-trim\-fields\fR را لغو می‌کند. .IP "\fB\-\-trim\-only\-fields\fR \fIlist\fR" 4 .IX Item "--trim-only-fields list" حذف فاصله‌های خالی ابتدا و انتها تنها از فیلدهای فهرست‌شده. این گزینه انباشتی است اما توسط \fB\-\-trim\-fields\fR و \fB\-\-no\-trim\-fields\fR لغو می‌شود. این گزینه نباید همراه با \&\fB\-\-trim\-except\-fields\fR استفاده شود. .IP \fB\-\-verbose\fR 4 .IX Item "--verbose" فعال کردن حالت پرگو (verbose). .IP "\fB\-\-version\fR یا \fB\-v\fR" 4 .IX Item "--version or -v" نمایش اطلاعات نگارش و خروج. .IP \fB\-\-warn\-non\-bib\-fields\fR 4 .IX Item "--warn-non-bib-fields" هشدار در صورت یافت شدن فیلدهای درونی غیر-bib در فایل \fI.bib\fR. .IP \fB\-\-warn\-unknown\-entry\-types\fR 4 .IX Item "--warn-unknown-entry-types" هشدار در صورت یافت شدن هرگونه نوع مدخل ناشناخته در فایل \fI.bib\fR. .SH "نیازمندی‌ها (REQUIRES)" .IX Header "REQUIRES" جاوا ۸ یا بالاتر و یک توزیع TeX. .SH "مجوز (LICENSE)" .IX Header "LICENSE" مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر این یک نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند. .SH "مطالعه پیشنهادی (RECOMMENDED READING)" .IX Header "RECOMMENDED READING" راهنمای bib2gls: .PP .Vb 1 \& texdoc bib2gls .Ve .PP راهنمای glossaries\-extra: .PP .Vb 1 \& texdoc glossaries\-extra .Ve .PP راهنمای glossaries: .PP .Vb 1 \& texdoc glossaries .Ve .SH "نویسنده (AUTHOR)" .IX Header "AUTHOR" Nicola L. C. Talbot,