.\" -*- 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 "DATATOOL2BIB 1"
.TH DATATOOL2BIB 1 2024-12-21 "perl v5.40.0" datatool2bib
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
datatool2bib \- تبدیل داده‌های بسته LaTeX datatool به فایل BibTeX
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdatatool2bib\fR [\fIگزینه\fR]+ \fIفایل\-ورودی\fR \fIفایل\-bib\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
یک فایل
.I .tex
حاوی پایگاه‌های داده
.I datatool.sty
را به یک فایل
.I .bib
با قالب مورد نیاز برای
.B bib2gls
تبدیل می‌کند. همراه با
.I bib2gls
توزیع می‌شود.
.PP
برای تجزیه ورودی از TeX Parser Library استفاده می‌شود، که ورودی ممکن است یک فایل DTLTEX یا DBTEX یا فایلی باشد که شامل دستورات ساخت پایگاه داده نظیر
\&\f(CW\*(C`\eDTLnewdb\*(C'\fR
یا
\&\f(CW\*(C`\eDTLaction\*(C'\fR
است. در صورت استفاده از گزینه
.BR \-\-read ،
فایل ورودی می‌تواند یک فایل CSV نیز باشد.
.PP
بسته‌های
.B datatool
و
.B datagidx
به‌طور خودکار پیاده‌سازی شده‌اند، بنابراین نیازی نیست فایل ورودی شامل این بسته‌ها از طریق
\&\f(CW\*(C`\eusepackage\*(C'\fR
باشد. به‌طور کلی، بهتر است کل سند وارد نشود و در عوض فایلی داده شود که فقط شامل دستورات ساخت پایگاه داده باشد، زیرا TeX Parser Library تنها مجموعه محدودی از دستورات را شناسایی می‌کند.
.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"
فعال کردن حالت پرگو (نمایش جزئیات کامل).
.IP \fB\-\-no\-verbose\fR 4
.IX Item "--no-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"
می‌تواند به‌جای
.B \-\-debug
در مواردی که به‌خاطرسپاری شماره سطح دشوار است استفاده شود. مقدار آن مانند گزینه
.B \-\-debug\-mode
در
.B bib2gls
است.
.IP \fB\-\-no\-debug\fR 4
.IX Item "--no-debug"
غیرفعال کردن حالت اشکال‌زدایی. معادل با
.BR "\-\-debug 0" .
.IP "\fB\-\-log\-file\fR \fIfilename\fR" 4
.IX Item "--log-file filename"
ثبت پیام‌ها در فایل مشخص‌شده. اساساً برای پیام‌های اشکال‌زدایی در نظر گرفته شده است، بنابراین فعال کردن حالت دیباگ به‌طور خودکار یک فایل گزارش ایجاد می‌کند، اما در غیر این صورت فایلی ایجاد نخواهد شد مگر اینکه از این گزینه استفاده شود.
.SS "گزینه‌های کدگذاری و بومی‌سازی (ENCODING AND LOCALISATION OPTIONS)"
.IX Subsection "ENCODING AND LOCALISATION OPTIONS"
.IP "\fB\-\-texenc\fR \fIname\fR" 4
.IX Item "--texenc name"
تنظیم کدگذاری نویسه‌ها به
.I name
برای فایل‌های ورودی
.BR .tex .
.IP "\fB\-\-bibenc\fR \fIname\fR" 4
.IX Item "--bibenc name"
تنظیم کدگذاری نویسه‌ها به
.I name
برای فایل‌های خروجی
.BR .bib .
.IP "\fB\-\-locale\fR \fIlang tag\fR" 4
.IX Item "--locale lang tag"
استفاده از فایل‌های منابع زبان مرتبط با برچسب زبان داده‌شده
.IR "lang tag" .
اگر فایل مناسبی وجود نداشته باشد، فایل
.B en
(انگلیسی) استفاده خواهد شد.
.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"
نادیده گرفتن تمام فیلدهای موجود در
.I list
جداشده با کاما. هر مورد در لیست باید فیلد را بر اساس کلید ستون حساس به حروف کوچک و بزرگ اصلی مشخص کند.
.Sp
این گزینه انباشتی است.
.IP \fB\-\-no\-ignore\-fields\fR 4
.IX Item "--no-ignore-fields"
لغو اثر گزینه
.BR \-\-ignore\-fields .
.IP \fB\-\-skip\-datagidx\fR 4
.IX Item "--skip-datagidx"
رد کردن پایگاه داده داخلی و ویژه
.BR datagidx .
(پیش‌فرض.)
.IP \fB\-\-no\-skip\-datagidx\fR 4
.IX Item "--no-skip-datagidx"
عدم رد کردن پایگاه داده داخلی ویژه
.BR datagidx .
.SS "گزینه‌های فایل خروجی (OUTPUT FILE OPTIONS)"
.IX Subsection "OUTPUT FILE OPTIONS"
.IP \fB\-\-overwrite\fR 4
.IX Item "--overwrite"
بازنویسی فایل‌های bib موجود.
.IP \fB\-\-no\-overwrite\fR 4
.IX Item "--no-overwrite"
عدم بازنویسی فایل‌های bib موجود.
.IP \fB\-\-split\fR 4
.IX Item "--split"
تقسیم مدخل‌ها به فایل‌های جداگانه بر اساس پایگاه داده.
.IP \fB\-\-no\-split\fR 4
.IX Item "--no-split"
عدم تقسیم مدخل‌ها به فایل‌های جداگانه (پیش‌فرض).
.SS "گزینه‌های تنظیم و تبدیل (ADJUSTMENT OPTIONS)"
.IX Subsection "ADJUSTMENT OPTIONS"
.IP "\fB\-\-space\-sub\fR \fIvalue\fR یا \fB\-s\fR \fIvalue\fR" 4
.IX Item "--space-sub value or -s value"
جایگزینی فاصله‌ها در برچسب‌ها با
.IR value .
.IP "\fB\-\-field\-map\fR \fImappings\fR یا \fB\-m\fR \fImappings\fR" 4
.IX Item "--field-map mappings or -m mappings"
افزودن نگاشت‌های کلید ستون مبدأ به برچسب فیلد مقصد. آرگومان باید لیستی از جفت‌های
\fIcol\-key\fR=\fIbib\-field\fR
جداشده با کاما باشد. این گزینه انباشتی است.
.IP \fB\-\-no\-field\-map\fR 4
.IX Item "--no-field-map"
لغو تمام نگاشت‌های اعمال‌شده با
.BR \-\-field\-map .
.IP "\fB\-\-index\-conversion\fR یا \fB\-i\fR" 4
.IX Item "--index-conversion or -i"
هر مدخلی که به‌طور معمول به
\f(CW@entry\fR
تبدیل می‌شد اما فاقد فیلد
.B description
است، به
\f(CW@index\fR
تبدیل می‌شود.
.IP \fB\-\-no\-index\-conversion\fR 4
.IX Item "--no-index-conversion"
عدم جایگزینی
\f(CW@entry\fR
با
\f(CW@index\fR
در صورت نبود توضیحات (پیش‌فرض).
.IP \fB\-\-detect\-symbols\fR 4
.IX Item "--detect-symbols"
تلاش برای تشخیص مدخل‌هایی که باید بر اساس مقدار فیلد
.B name
به
\f(CW@symbol\fR
یا
\f(CW@number\fR
تبدیل شوند.
.IP \fB\-\-no\-detect\-symbols\fR 4
.IX Item "--no-detect-symbols"
عدم تلاش برای تشخیص نمادها (پیش‌فرض).
.IP "\fB\-\-label\fR \fIcol\-key\fR یا \fB\-L\fR" 4
.IX Item "--label col-key or -L"
استفاده از ستون مشخص‌شده با
.I col\-key
برای برچسب مدخل. کلید ستون پیش‌فرض
.B Label
است، بنابراین اگر پایگاه داده ستونی با این کلید نداشته باشد، باید ستونی را با
.B \-\-label
مشخص کنید یا از
.B \-\-auto\-label
استفاده نمایید. این گزینه همراه با
.B \-\-auto\-label
نادیده گرفته می‌شود.
.IP "\fB\-\-auto\-label\fR یا \fB\-a\fR" 4
.IX Item "--auto-label or -a"
تولید خودکار برچسب‌های مدخل به‌جای استفاده از مقدار یک ستون.
.IP \fB\-\-no\-auto\-label\fR 4
.IX Item "--no-auto-label"
عدم تولید خودکار برچسب‌های مدخل. استفاده از ستون مشخص‌شده توسط
.B \-\-label
برای برچسب مدخل. (پیش‌فرض.)
.IP "\fB\-\-auto\-label\-prefix\fR \fIprefix\fR" 4
.IX Item "--auto-label-prefix prefix"
استفاده از
.I prefix
هنگام تولید خودکار برچسب‌های مدخل. همراه با
.B \-\-no\-auto\-label
نادیده گرفته می‌شود.
.IP \fB\-\-adjust\-gls\fR 4
.IX Item "--adjust-gls"
تنظیم برچسب‌ها در دستوراتی مانند
\&\f(CW\*(C`\egls\*(C'\fR
در مقادیر فیلدها. (پیش‌فرض.) این گزینه همچنین دستورات
.I datagidx.sty
مانند
\&\f(CW\*(C`\eglsnl\*(C'\fR
را با نزدیک‌ترین معادل
.I glossaries.sty
جایگزین می‌کند.
.IP \fB\-\-no\-adjust\-gls\fR 4
.IX Item "--no-adjust-gls"
عدم تنظیم برچسب‌ها در دستوراتی مانند
\&\f(CW\*(C`\egls\*(C'\fR
در مقادیر فیلدها.
.IP "\fB\-\-dependency\-field\fR \fIfield\-name\fR" 4
.IX Item "--dependency-field field-name"
تعیین نام فیلد وابستگی. همراه با
.B \-\-no\-strip\-glsadd
هیچ اثری ندارد. با
.BR \-\-strip\-glsadd ،
برچسب حاصل از آرگومان پیراسته‌شدهٔ
\&\f(CW\*(C`\eglsadd\*(C'\fR
به فیلد مشخص‌شده با
.I field\-name
اضافه خواهد شد. مقدار پیش‌فرض
.B dependency
است که توسط
.B bib2gls
نادیده گرفته می‌شود مگر اینکه دستور دیگری داده شده باشد (از طریق نام مستعار فیلد و غیره).
.IP \fB\-\-no\-dependency\-field\fR 4
.IX Item "--no-dependency-field"
عدم ذخیره برچسب‌ها از نمونه‌های حذف‌شدهٔ
\&\f(CW\*(C`\eglsadd\*(C'\fR.
.IP \fB\-\-strip\fR 4
.IX Item "--strip"
فعال کردن تمام گزینه‌های پیراستن و حذف.
.IP \fB\-\-no\-strip\fR 4
.IX Item "--no-strip"
غیرفعال کردن تمام گزینه‌های پیراستن و حذف.
.IP \fB\-\-strip\-glsadd\fR 4
.IX Item "--strip-glsadd"
حذف
\&\f(CW\*(C`\eglsadd\*(C'\fR
و آرگومان آن از مقادیر فیلدها. (پیش‌فرض.)
.IP \fB\-\-no\-strip\-glsadd\fR 4
.IX Item "--no-strip-glsadd"
عدم حذف
\&\f(CW\*(C`\eglsadd\*(C'\fR
از مقادیر فیلدها.
.IP \fB\-\-strip\-acronym\-font\fR 4
.IX Item "--strip-acronym-font"
حذف
\&\f(CW\*(C`\eacronymfont\*(C'\fR
از مقادیر فیلدها. (پیش‌فرض.)
.IP \fB\-\-no\-strip\-acronym\-font\fR 4
.IX Item "--no-strip-acronym-font"
عدم حذف
\&\f(CW\*(C`\eacronymfont\*(C'\fR
از مقادیر فیلدها.
.IP \fB\-\-strip\-acronym\-text\fR 4
.IX Item "--strip-acronym-text"
حذف فیلد
.B text
برای کوته‌نوشت‌های مشخص‌شده با
\&\f(CW\*(C`\enewacro\*(C'\fR.
(پیش‌فرض.)
.IP \fB\-\-no\-strip\-acronym\-text\fR 4
.IX Item "--no-strip-acronym-text"
عدم حذف فیلد
.B text
برای کوته‌نوشت‌ها.
.IP \fB\-\-strip\-acronym\-name\fR 4
.IX Item "--strip-acronym-name"
حذف فیلد
.B name
برای کوته‌نوشت‌های مشخص‌شده با
\&\f(CW\*(C`\enewacro\*(C'\fR.
(پیش‌فرض.)
.IP \fB\-\-no\-strip\-acronym\-name\fR 4
.IX Item "--no-strip-acronym-name"
عدم حذف فیلد
.B name
برای کوته‌نوشت‌ها.
.IP \fB\-\-strip\-case\-change\fR 4
.IX Item "--strip-case-change"
حذف دستورات شناخته‌شدهٔ تغییر بزرگی و کوچکی حروف (مانند
\&\f(CW\*(C`\emakefirstuc\*(C'\fR
یا
\&\f(CW\*(C`\ecapitalisewords\*(C'\fR)
از مقادیر فیلدها.
.IP \fB\-\-nostrip\-case\-change\fR 4
.IX Item "--nostrip-case-change"
عدم حذف دستورات تغییر بزرگی و کوچکی حروف. (پیش‌فرض.)
.SS "گزینه‌های دیگر (OTHER OPTIONS)"
.IX Subsection "OTHER OPTIONS"
این گزینه‌ها متناظر با قابلیت‌هایی هستند که در نسخه 3.0 بسته
.I datatool.sty
معرفی شدند؛ این نسخه دارای تنظیمی است که هنگام تجزیه داده‌ها، مقدار عددی و نماد یکای پول (در صورت وجود) را ذخیره می‌کند. رشته اصلی (عدد قالب‌بندی‌شده)، مقدار عددی و نماد یکای پول در یک قالب داده‌ای (datum) ویژه ذخیره می‌شوند که به‌طور معمول به متن قالب‌بندی‌شده اصلی خود بسط می‌یابد اما همچنین اجازه می‌دهد اطلاعات تجزیه‌شده قبلی بدون نیاز به تجزیه مجدد داده‌ها به‌سادگی استخراج شوند.
.IP "\fB\-\-setup\fR \fIoptions\fR" 4
.IX Item "--setup options"
اجرای
\&\f(CW\*(C`\eDTLsetup{\*(C'\fR\fIoptions\fR\f(CW\*(C`}\*(C'\fR
در ابتدا. این می‌تواند شامل گزینه‌هایی نظیر
\&\f(CW\*(C`store\-datum\*(C'\fR،
\&\f(CW\*(C`new\-value\-expand\*(C'\fR،
\&\f(CW\*(C`new\-value\-trim\*(C'\fR
و
\&\f(CW\*(C`default\-name\*(C'\fR
باشد.
.IP "\fB\-\-read\fR \fIoptions\fR" 4
.IX Item "--read options"
به‌جای تجزیه ساده فایل ورودی به‌عنوان یک فایل
.I .tex
معمولی، منبع به‌صورت
\&\f(CW\*(C`\eDTLread[\*(C'\fR\fIoptions\fR\f(CW\*(C`]{\*(C'\fR\fIin\-file\fR\f(CW\*(C`}\*(C'\fR
به تجزیه‌گر TeX ارائه می‌شود که در آن گزینه‌ها می‌توانند برای مشخص کردن قالب فایل (برای مثال،
\&\f(CW\*(C`format=tsv\*(C'\fR)
استفاده شوند.
.Sp
اگر لیست
.I options
(پس از حذف فاصله‌های خالی) خالی باشد، معادل با
.B \-\-no\-read
خواهد بود.
.IP \fB\-\-no\-read\fR 4
.IX Item "--no-read"
فایل ورودی مانند یک فایل
.I .tex
معمولی تجزیه می‌شود، که ممکن است سند کامل یا فایلی باشد که می‌تواند در یک سند
\&\f(CW\*(C`\einput\*(C'\fR
شود. (پیش‌فرض.)
.IP "\fB\-\-save\-value\fR \fIsuffix\fR" 4
.IX Item "--save-value suffix"
اگر یک مقدار فیلد تجزیه شده و به‌عنوان عددی شناسایی شود، مقدار عددی قالب‌بندی‌نشده در فیلدی ذخیره می‌شود که نام آن از نام فیلد اصلی به همراه
.I suffix
داده‌شده ساخته می‌شود.
.IP \fB\-\-no\-save\-value\fR 4
.IX Item "--no-save-value"
عدم ذخیره مقدار عددی در یک فیلد جداگانه. (پیش‌فرض.)
.IP "\fB\-\-save\-currency\fR \fIsuffix\fR" 4
.IX Item "--save-currency suffix"
اگر یک مقدار فیلد تجزیه شده و به‌عنوان داده یکای پول شناسایی شود، نماد یکای پول در فیلدی ذخیره می‌شود که نام آن از نام فیلد اصلی به همراه
.I suffix
داده‌شده ساخته می‌شود.
.IP \fB\-\-no\-save\-currency\fR 4
.IX Item "--no-save-currency"
عدم ذخیره نماد یکای پول در فیلد جداگانه. (پیش‌فرض.)
.IP \fB\-\-save\-datum\fR 4
.IX Item "--save-datum"
معادل با:
.Sp
.Vb 1
\&        \-\-save\-value \*(Aq\-value\*(Aq \-\-save\-currency \*(Aq\-currency\*(Aq
.Ve
.IP \fB\-\-no\-save\-datum\fR 4
.IX Item "--no-save-datum"
معادل با
.BR "\-\-no\-save\-value \-\-no\-save\-currency" .
.SH "نیازمندی‌ها (REQUIRES)"
.IX Header "REQUIRES"
جاوا ۸ (Java 8) و یک توزیع TeX.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر
<http://gnu.org/licenses/gpl.html>
این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.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
.PP
دفترچه راهنمای datatool:
.PP
.Vb 1
\&        texdoc datatool
.Ve
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
Nicola L. C. Talbot,
<https://www.dickimaw\-books.com>