گزینه‌های عمومی (GENERAL OPTIONS)

--help یا -h

نمایش پیام راهنما و خروج.

--version یا -v

نمایش اطلاعات نسخه و خروج.

--silent یا --quiet یا -q

بی‌صدا کردن تمام پیام‌ها به جز خطاها.

--verbose

فعال کردن حالت پرگو (نمایش جزئیات کامل).

--no-verbose

غیرفعال کردن حالت پرگو.

--debug [n]

نمایش پیام‌های اشکال‌زدایی.

--debug-mode setting

می‌تواند به‌جای --debug در مواردی که به‌خاطرسپاری شماره سطح دشوار است استفاده شود. مقدار آن مانند گزینه --debug-mode در bib2gls است.

--no-debug

غیرفعال کردن حالت اشکال‌زدایی. معادل با --debug 0.

--log-file filename

ثبت پیام‌ها در فایل مشخص‌شده. اساساً برای پیام‌های اشکال‌زدایی در نظر گرفته شده است، بنابراین فعال کردن حالت دیباگ به‌طور خودکار یک فایل گزارش ایجاد می‌کند، اما در غیر این صورت فایلی ایجاد نخواهد شد مگر اینکه از این گزینه استفاده شود.

گزینه‌های کدگذاری و بومی‌سازی (ENCODING AND LOCALISATION OPTIONS)

--texenc name

تنظیم کدگذاری نویسه‌ها به name برای فایل‌های ورودی .tex.

--bibenc name

تنظیم کدگذاری نویسه‌ها به name برای فایل‌های خروجی .bib.

--locale lang tag

استفاده از فایل‌های منابع زبان مرتبط با برچسب زبان داده‌شده lang tag. اگر فایل مناسبی وجود نداشته باشد، فایل en (انگلیسی) استفاده خواهد شد.

گزینه‌های فیلترسازی (FILTERING OPTIONS)

--preamble-only یا -p

فقط تجزیه مقدمه (preamble) سند. یعنی اگر به "\begin{document}" برخورد کند، تجزیه متوقف می‌شود.

--no-preamble-only

تجزیه کل سند (پیش‌فرض).

--ignore-fields list یا -f list

نادیده گرفتن تمام فیلدهای موجود در list جداشده با کاما. هر مورد در لیست باید فیلد را بر اساس کلید ستون حساس به حروف کوچک و بزرگ اصلی مشخص کند.

این گزینه انباشتی است.

--no-ignore-fields

لغو اثر گزینه --ignore-fields.

--skip-datagidx

رد کردن پایگاه داده داخلی و ویژه datagidx. (پیش‌فرض.)

--no-skip-datagidx

عدم رد کردن پایگاه داده داخلی ویژه datagidx.

گزینه‌های فایل خروجی (OUTPUT FILE OPTIONS)

--overwrite

بازنویسی فایل‌های bib موجود.

--no-overwrite

عدم بازنویسی فایل‌های bib موجود.

--split

تقسیم مدخل‌ها به فایل‌های جداگانه بر اساس پایگاه داده.

--no-split

عدم تقسیم مدخل‌ها به فایل‌های جداگانه (پیش‌فرض).

گزینه‌های تنظیم و تبدیل (ADJUSTMENT OPTIONS)

--space-sub value یا -s value

جایگزینی فاصله‌ها در برچسب‌ها با value.

--field-map mappings یا -m mappings

افزودن نگاشت‌های کلید ستون مبدأ به برچسب فیلد مقصد. آرگومان باید لیستی از جفت‌های col-key=bib-field جداشده با کاما باشد. این گزینه انباشتی است.

--no-field-map

لغو تمام نگاشت‌های اعمال‌شده با --field-map.

--index-conversion یا -i

هر مدخلی که به‌طور معمول به @entry تبدیل می‌شد اما فاقد فیلد description است، به @index تبدیل می‌شود.

--no-index-conversion

عدم جایگزینی @entry با @index در صورت نبود توضیحات (پیش‌فرض).

--detect-symbols

تلاش برای تشخیص مدخل‌هایی که باید بر اساس مقدار فیلد name به @symbol یا @number تبدیل شوند.

--no-detect-symbols

عدم تلاش برای تشخیص نمادها (پیش‌فرض).

--label col-key یا -L

استفاده از ستون مشخص‌شده با col-key برای برچسب مدخل. کلید ستون پیش‌فرض Label است، بنابراین اگر پایگاه داده ستونی با این کلید نداشته باشد، باید ستونی را با --label مشخص کنید یا از --auto-label استفاده نمایید. این گزینه همراه با --auto-label نادیده گرفته می‌شود.

--auto-label یا -a

تولید خودکار برچسب‌های مدخل به‌جای استفاده از مقدار یک ستون.

--no-auto-label

عدم تولید خودکار برچسب‌های مدخل. استفاده از ستون مشخص‌شده توسط --label برای برچسب مدخل. (پیش‌فرض.)

--auto-label-prefix prefix

استفاده از prefix هنگام تولید خودکار برچسب‌های مدخل. همراه با --no-auto-label نادیده گرفته می‌شود.

--adjust-gls

تنظیم برچسب‌ها در دستوراتی مانند "\gls" در مقادیر فیلدها. (پیش‌فرض.) این گزینه همچنین دستورات datagidx.sty مانند "\glsnl" را با نزدیک‌ترین معادل glossaries.sty جایگزین می‌کند.

--no-adjust-gls

عدم تنظیم برچسب‌ها در دستوراتی مانند "\gls" در مقادیر فیلدها.

--dependency-field field-name

تعیین نام فیلد وابستگی. همراه با --no-strip-glsadd هیچ اثری ندارد. با --strip-glsadd، برچسب حاصل از آرگومان پیراسته‌شدهٔ "\glsadd" به فیلد مشخص‌شده با field-name اضافه خواهد شد. مقدار پیش‌فرض dependency است که توسط bib2gls نادیده گرفته می‌شود مگر اینکه دستور دیگری داده شده باشد (از طریق نام مستعار فیلد و غیره).

--no-dependency-field

عدم ذخیره برچسب‌ها از نمونه‌های حذف‌شدهٔ "\glsadd".

--strip

فعال کردن تمام گزینه‌های پیراستن و حذف.

--no-strip

غیرفعال کردن تمام گزینه‌های پیراستن و حذف.

--strip-glsadd

حذف "\glsadd" و آرگومان آن از مقادیر فیلدها. (پیش‌فرض.)

--no-strip-glsadd

عدم حذف "\glsadd" از مقادیر فیلدها.

--strip-acronym-font

حذف "\acronymfont" از مقادیر فیلدها. (پیش‌فرض.)

--no-strip-acronym-font

عدم حذف "\acronymfont" از مقادیر فیلدها.

--strip-acronym-text

حذف فیلد text برای کوته‌نوشت‌های مشخص‌شده با "\newacro". (پیش‌فرض.)

--no-strip-acronym-text

عدم حذف فیلد text برای کوته‌نوشت‌ها.

--strip-acronym-name

حذف فیلد name برای کوته‌نوشت‌های مشخص‌شده با "\newacro". (پیش‌فرض.)

--no-strip-acronym-name

عدم حذف فیلد name برای کوته‌نوشت‌ها.

--strip-case-change

حذف دستورات شناخته‌شدهٔ تغییر بزرگی و کوچکی حروف (مانند "\makefirstuc" یا "\capitalisewords") از مقادیر فیلدها.

--nostrip-case-change

عدم حذف دستورات تغییر بزرگی و کوچکی حروف. (پیش‌فرض.)

گزینه‌های دیگر (OTHER OPTIONS)

این گزینه‌ها متناظر با قابلیت‌هایی هستند که در نسخه 3.0 بسته datatool.sty معرفی شدند؛ این نسخه دارای تنظیمی است که هنگام تجزیه داده‌ها، مقدار عددی و نماد یکای پول (در صورت وجود) را ذخیره می‌کند. رشته اصلی (عدد قالب‌بندی‌شده)، مقدار عددی و نماد یکای پول در یک قالب داده‌ای (datum) ویژه ذخیره می‌شوند که به‌طور معمول به متن قالب‌بندی‌شده اصلی خود بسط می‌یابد اما همچنین اجازه می‌دهد اطلاعات تجزیه‌شده قبلی بدون نیاز به تجزیه مجدد داده‌ها به‌سادگی استخراج شوند.

--setup options

اجرای "\DTLsetup{"options"}" در ابتدا. این می‌تواند شامل گزینه‌هایی نظیر "store-datum"، "new-value-expand"، "new-value-trim" و "default-name" باشد.

--read options

به‌جای تجزیه ساده فایل ورودی به‌عنوان یک فایل .tex معمولی، منبع به‌صورت "\DTLread["options"]{"in-file"}" به تجزیه‌گر TeX ارائه می‌شود که در آن گزینه‌ها می‌توانند برای مشخص کردن قالب فایل (برای مثال، "format=tsv") استفاده شوند.

اگر لیست options (پس از حذف فاصله‌های خالی) خالی باشد، معادل با --no-read خواهد بود.

--no-read

فایل ورودی مانند یک فایل .tex معمولی تجزیه می‌شود، که ممکن است سند کامل یا فایلی باشد که می‌تواند در یک سند "\input" شود. (پیش‌فرض.)

--save-value suffix

اگر یک مقدار فیلد تجزیه شده و به‌عنوان عددی شناسایی شود، مقدار عددی قالب‌بندی‌نشده در فیلدی ذخیره می‌شود که نام آن از نام فیلد اصلی به همراه suffix داده‌شده ساخته می‌شود.

--no-save-value

عدم ذخیره مقدار عددی در یک فیلد جداگانه. (پیش‌فرض.)

--save-currency suffix

اگر یک مقدار فیلد تجزیه شده و به‌عنوان داده یکای پول شناسایی شود، نماد یکای پول در فیلدی ذخیره می‌شود که نام آن از نام فیلد اصلی به همراه suffix داده‌شده ساخته می‌شود.

--no-save-currency

عدم ذخیره نماد یکای پول در فیلد جداگانه. (پیش‌فرض.)

--save-datum

معادل با:

--save-value '-value' --save-currency '-currency'

--no-save-datum

معادل با --no-save-value --no-save-currency.