DATATOOL2BIB(1) datatool2bib DATATOOL2BIB(1) نام (NAME) datatool2bib - تبدیل داده‌های بسته LaTeX datatool به فایل BibTeX خلاصه دستور (SYNOPSIS) datatool2bib [گزینه]+ فایل-ورودی فایل-bib توضیحات (DESCRIPTION) یک فایل .tex حاوی پایگاه‌های داده datatool.sty را به یک فایل .bib با قالب مورد نیاز برای bib2gls تبدیل می‌کند. همراه با bib2gls توزیع می‌شود. برای تجزیه ورودی از TeX Parser Library استفاده می‌شود، که ورودی ممکن است یک فایل DTLTEX یا DBTEX یا فایلی باشد که شامل دستورات ساخت پایگاه داده نظیر "\DTLnewdb" یا "\DTLaction" است. در صورت استفاده از گزینه --read، فایل ورودی می‌تواند یک فایل CSV نیز باشد. بسته‌های datatool و datagidx به‌طور خودکار پیاده‌سازی شده‌اند، بنابراین نیازی نیست فایل ورودی شامل این بسته‌ها از طریق "\usepackage" باشد. به‌طور کلی، بهتر است کل سند وارد نشود و در عوض فایلی داده شود که فقط شامل دستورات ساخت پایگاه داده باشد، زیرا TeX Parser Library تنها مجموعه محدودی از دستورات را شناسایی می‌کند. گزینه‌ها (OPTIONS) گزینه‌های عمومی (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. نیازمندی‌ها (REQUIRES) جاوا ۸ (Java 8) و یک توزیع TeX. مجوز (LICENSE) مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد. مطالعه پیشنهادی (RECOMMENDED READING) دفترچه راهنمای bib2gls: texdoc bib2gls دفترچه راهنمای glossaries-extra: texdoc glossaries-extra دفترچه راهنمای glossaries: texdoc glossaries دفترچه راهنمای datatool: texdoc datatool نویسنده (AUTHOR) Nicola L. C. Talbot, perl v5.40.0 2024-12-21 DATATOOL2BIB(1)