.\" -*- 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 "CONVERTGLS2BIB 1" .TH CONVERTGLS2BIB 1 2024-12-21 "perl v5.40.0" convertgls2bib .\" 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" \&\fBconvertgls2bib\fR [\fIoption\fR]+ \fItexfile\fR \fIbibfile\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" یک فایل \fB.tex\fR حاوی تعاریف واژه‌نامه با استفاده از دستورهایی نظیر \f(CW\*(C`\enewglossaryentry\*(C'\fR و \f(CW\*(C`\enewacronym\*(C'\fR را به یک فایل \fB.bib\fR با قالب موردنیاز برای \fBbib2gls\fR تبدیل می‌کند. به‌همراه \fIbib2gls\fR توزیع شده است. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .SS "گزینه‌های عمومی (GENERAL OPTIONS)" .IX Subsection "GENERAL OPTIONS" .IP "\fB\-\-help\fR یا \fB\-h\fR" 4 .IX Item "--help or -h" نمایش پیام راهنما و خروج. .IP "\fB\-\-version\fR یا \fB\-v\fR" 4 .IX Item "--version or -v" نمایش اطلاعات نسخه و خروج. .IP "\fB\-\-silent\fR یا \fB\-\-quiet\fR یا \fB\-q\fR" 4 .IX Item "--silent or --quiet or -q" فرونشاندن تمامی پیام‌ها به‌جز خطاها. .IP \fB\-\-verbose\fR 4 .IX Item "--verbose" فعال‌کردن حالت پرگو (verbose). .IP \fB\-\-no\-verbose\fR 4 .IX Item "--no-verbose" غیرفعال‌کردن حالت پرگو (verbose). .IP "\fB\-\-debug\fR [\fIn\fR]" 4 .IX Item "--debug [n]" نمایش پیام‌های اشکال‌زدایی. .IP "\fB\-\-debug\-mode\fR \fIsetting\fR" 4 .IX Item "--debug-mode setting" می‌تواند به‌جای \fB\-\-debug\fR در مواردی که به‌خاطرسپاری شماره سطح دشوار است استفاده شود. مقدار آن مشابه گزینهٔ \fB\-\-debug\-mode\fR در \fBbib2gls\fR است. .IP \fB\-\-no\-debug\fR 4 .IX Item "--no-debug" غیرفعال‌کردن حالت اشکال‌زدایی. معادل \fB\-\-debug\fR \fB0\fR. .IP "\fB\-\-log\-file\fR \fIfilename\fR" 4 .IX Item "--log-file filename" ثبت پیام‌ها در فایل داده‌شده. اساساً برای پیام‌های اشکال‌زدایی در نظر گرفته شده است، بنابراین فعال‌سازی حالت اشکال‌زدایی به‌طور خودکار یک فایل گزارش ایجاد می‌کند، اما در غیر این صورت فایلی ایجاد نخواهد شد مگر اینکه از این گزینه استفاده شود. .SS "گزینه‌های کدگذاری و محلی‌سازی (ENCODING AND LOCALISATION OPTIONS)" .IX Subsection "ENCOSING AND LOCALISATION OPTIONS" .IP "\fB\-\-texenc\fR \fIname\fR" 4 .IX Item "--texenc name" تنظیم کدگذاری نویسه‌ها روی \fIname\fR برای فایل‌های ورودی \fB.tex\fR. .IP "\fB\-\-bibenc\fR \fIname\fR" 4 .IX Item "--bibenc name" تنظیم کدگذاری نویسه‌ها روی \fIname\fR برای فایل‌های خروجی \fB.bib\fR. .IP "\fB\-\-locale\fR \fIlang tag\fR" 4 .IX Item "--locale lang tag" استفاده از فایل‌های منبع زبان مرتبط با برچسب زبانِ داده‌شده \fIlang tag\fR. اگر فایل مناسبی وجود نداشته باشد، فایل \fBen\fR (انگلیسی) استفاده خواهد شد. .SS "گزینه‌های فیلترکردن (FILTERING OPTIONS)" .IX Subsection "FILTERING OPTIONS" .IP "\fB\-\-preamble\-only\fR یا \fB\-p\fR" 4 .IX Item "--preamble-only or -p" تنها دیباچه (preamble) سند را تجزیه می‌کند. بدین معنا که در صورت مواجهه با \f(CW\*(C`\ebegin{document}\*(C'\fR، تجزیه متوقف می‌شود. .IP \fB\-\-no\-preamble\-only\fR 4 .IX Item "--no-preamble-only" تجزیهٔ تمام سند (پیش‌فرض). .IP "\fB\-\-ignore\-fields\fR \fIlist\fR یا \fB\-f\fR \fIlist\fR" 4 .IX Item "--ignore-fields list or -f list" نادیده‌گرفتن تمام فیلدهای موجود در \fIlist\fR که با کاما از هم جدا شده‌اند. اگر فهرست شامل \fBsort\fR، \fBtype\fR یا \fBcategory\fR باشد، به‌طور خودکار گزینهٔ متناظر \fB\-\-ignore\-sort\fR، \fB\-\-ignore\-type\fR یا \fB\-\-ignore\-category\fR را اعمال می‌کند. هر مورد در فهرست باید فیلد را با کلید اصلی حساس به کوچک و بزرگی حروف مشخص کند. .Sp این گزینه تجمعی است. .IP \fB\-\-no\-ignore\-fields\fR 4 .IX Item "--no-ignore-fields" تأثیر \fB\-\-ignore\-fields\fR را لغو می‌کند. .IP \fB\-\-ignore\-category\fR 4 .IX Item "--ignore-category" فیلد \fBcategory\fR را حذف می‌کند. در صورت استفاده از \fB\-\-split\-on\-category\fR پیش‌فرض است. .IP \fB\-\-no\-ignore\-category\fR 4 .IX Item "--no-ignore-category" فیلد \fBcategory\fR را حذف نمی‌کند. پیش‌فرض است، مگر اینکه از \fB\-\-split\-on\-category\fR استفاده شود. .IP \fB\-\-ignore\-type\fR 4 .IX Item "--ignore-type" فیلد \fBtype\fR را حذف می‌کند. در صورت استفاده از \fB\-\-split\-on\-type\fR پیش‌فرض است. .IP \fB\-\-no\-ignore\-type\fR 4 .IX Item "--no-ignore-type" فیلد \fBtype\fR را حذف نمی‌کند. پیش‌فرض است، مگر اینکه از \fB\-\-split\-on\-type\fR استفاده شود. .IP \fB\-\-ignore\-sort\fR 4 .IX Item "--ignore-sort" نادیده‌گرفتن فیلد \fBsort\fR (پیش‌فرض). .IP \fB\-\-no\-ignore\-sort\fR 4 .IX Item "--no-ignore-sort" فیلد \fBsort\fR را نادیده نمی‌گیرد. .SS "گزینه‌های فایل خروجی (OUTPUT FILE OPTIONS)" .IX Subsection "OUTPUT FILE OPTIONS" .IP \fB\-\-overwrite\fR 4 .IX Item "--overwrite" بازنویسی روی فایل‌های .bib موجود. پیش‌فرض است، مگر اینکه از \fB\-\-split\-on\-type\fR استفاده شده باشد. .IP \fB\-\-no\-overwrite\fR 4 .IX Item "--no-overwrite" فایل‌های .bib موجود را بازنویسی نمی‌کند. در صورت استفاده از \fB\-\-split\-on\-type\fR پیش‌فرض است. .IP "\fB\-\-split\-on\-type\fR یا \fB\-t\fR" 4 .IX Item "--split-on-type or -t" مدخل‌ها را با توجه به فیلد \fBtype\fR به فایل‌های جداگانه تقسیم می‌کند. این گزینه به‌طور خودکار \fB\-\-ignore\-type\fR و \fB\-\-no\-overwrite\fR را اعمال می‌کند. .IP \fB\-\-no\-split\-on\-type\fR 4 .IX Item "--no-split-on-type" مدخل‌ها را با توجه به فیلد \fBtype\fR به فایل‌های جداگانه تقسیم نمی‌کند (پیش‌فرض). .IP "\fB\-\-split\-on\-category\fR یا \fB\-c\fR" 4 .IX Item "--split-on-category or -c" مدخل‌ها را با توجه به فیلد \fBcategory\fR به فایل‌های جداگانه تقسیم می‌کند. این گزینه به‌طور خودکار \fB\-\-ignore\-category\fR و \fB\-\-no\-overwrite\fR را اعمال می‌کند. .IP \fB\-\-no\-split\-on\-category\fR 4 .IX Item "--no-split-on-category" مدخل‌ها را با توجه به فیلد \fBcategory\fR به فایل‌های جداگانه تقسیم نمی‌کند (پیش‌فرض). .SS "گزینه‌های تطبیق (ADJUSTMENT OPTIONS)" .IX Subsection "ADJUSTMENT OPTIONS" .IP \fB\-\-absorb\-see\fR 4 .IX Item "--absorb-see" ادغام \f(CW\*(C`\eglssee\*(C'\fR و \f(CW\*(C`\eglsxtrindexseealso\*(C'\fR در داده‌ها (پیش‌فرض). .IP \fB\-\-no\-absorb\-see\fR 4 .IX Item "--no-absorb-see" \f(CW\*(C`\eglssee\*(C'\fR و \f(CW\*(C`\eglsxtrindexseealso\*(C'\fR را در داده‌ها ادغام نمی‌کند. .IP "\fB\-\-index\-conversion\fR یا \fB\-i\fR" 4 .IX Item "--index-conversion or -i" هر مدخلی که معمولاً به \f(CW@entry\fR تبدیل می‌شد اما فاقد شرح باشد یا شرح آن صرفاً روی \f(CW\*(C`\enopostdesc\*(C'\fR یا \f(CW\*(C`\eglsxtrnopostpunc\*(C'\fR تنظیم شده باشد، به \f(CW@index\fR تبدیل شده و فیلد \fBdescription\fR حذف خواهد شد. .IP \fB\-\-no\-index\-conversion\fR 4 .IX Item "--no-index-conversion" عدم استفاده از \f(CW@index\fR به‌جای \f(CW@entry\fR در صورتی که شرح خالی باشد یا صرفاً شامل \f(CW\*(C`\enopostdesc\*(C'\fR یا \f(CW\*(C`\eglsxtrnopostpunc\*(C'\fR باشد (پیش‌فرض). .IP "\fB\-\-space\-sub\fR \fIvalue\fR یا \fB\-s\fR \fIvalue\fR" 4 .IX Item "--space-sub value or -s value" جایگزین‌کردن فاصله‌ها در برچسب‌ها با \fIvalue\fR. .IP "\fB\-\-field\-map\fR \fImappings\fR یا \fB\-m\fR \fImappings\fR" 4 .IX Item "--field-map mappings or -m mappings" افزودن نگاشت کلید مبدأ به برچسب فیلد مقصد. این آرگومان باید فهرستی جداشده با کاما از جفت‌های \fIsrc\-field\fR=\fIdest\-field\fR باشد. این گزینه تجمعی است. .Sp گزینهٔ منسوخ‌شدهٔ \fB\-\-key\-map\fR مترادفی برای \fB\-\-field\-map\fR است. .IP \fB\-\-no\-field\-map\fR 4 .IX Item "--no-field-map" تمام نگاشت‌های اعمال‌شده با \fB\-\-field\-map\fR را لغو می‌کند. گزینهٔ منسوخ‌شدهٔ \fB\-\-no\-key\-map\fR مترادفی برای \fB\-\-field\-map\fR است. .IP "\fB\-\-internal\-field\-map\fR \fImappings\fR" 4 .IX Item "--internal-field-map mappings" نگاشت‌های داده‌شده را به مجموعهٔ پیش‌فرض نگاشت‌های فیلد داخلی به کلید اضافه می‌کند. (برای نمونه، \fBdesc\fR برچسب فیلد داخلی برای کلید \fBdescription\fR است.) این گزینه تجمعی است. .Sp این گزینه تنها زمانی نیاز است که برچسب فیلد داخلی در آرگومان دستوری مانند \f(CW\*(C`\eglssetnoexpandfield\*(C'\fR ارائه شده باشد. .SH "نیازمندی‌ها (REQUIRES)" .IX Header "REQUIRES" جاوا ۸ (Java 8) و یک توزیع 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,