نام (NAME)

bibdoiadd - افزودن خودکار شناسه‌های DOI به ورودی‌های BibTeX

خلاصه دستور (SYNOPSIS)

bibdoiadd [-c config_file] [-C 1|0] [-e 1|0] [-f] [-o output] bib_file

گزینه‌ها (OPTIONS)

-c config_file: فایل پیکربندی. اگر این فایل وجود نداشته باشد، مقادیر پیش‌فرض استفاده می‌شوند. برای قالب آن به بخش زیر مراجعه کنید.
-C 1|0: آیا نام‌ها در خروجی استانداردسازی (canonicalize) شوند (1) یا خیر (0). پیش‌فرض: 1.
-e: اگر 1 باشد (پیش‌فرض)، در صورت پیدا نشدن شناسه doi، یک فیلد doi خالی اضافه می‌کند. این کار در صورت افزودن ورودی‌های جدید به فایل، از جستجوهای تکراری برای همان ورودی‌ها جلوگیری می‌کند. اجرای "-e 0"; این رفتار را غیرفعال می‌کند.
-f: بررسی اجباری شناسه doi حتی اگر از قبل وجود داشته باشد.
-o output: فایل خروجی. اگر از این گزینه استفاده نشود، نام فایل خروجی با افزودن "_doi" به فایل ورودی ساخته می‌شود.

توضیحات (DESCRIPTION)

این اسکریپت یک فایل BibTeX را می‌خواند. بررسی می‌کند که آیا ورودی‌ها دارای شناسه DOI هستند یا خیر. در غیر این صورت، تلاش می‌کند با http://www.crossref.org ارتباط برقرار کند تا DOI مربوطه را دریافت نماید. نتیجه یک فایل BibTeX است که فیلدهای "doi=..." به آن افزوده شده‌اند.

نام فایل خروجی یا با گزینه -o تعیین می‌شود یا با افزودن پسوند "_doi" به نام فایل ورودی مشتق می‌گردد.

هر رکورد BibTeX در ورودی با استفاده از BibTeX::Parser پردازش می‌شود، اما فقط رکوردهایی که فیلد "doi" (یا "mrnumber" یا "zblnumber" برای اسکریپت‌های مشابه) را ندارند پردازش می‌گردند. این ورودی‌های فاقد فیلد درخواستی، همان‌طور که در BibTeX::Parser::Entry توضیح داده شده، بازنویسی می‌شوند.

رکوردهای bib که پردازش نمی‌شوند (زیرا از قبل فیلد درخواستی را دارند) بدون هیچ‌گونه قالب‌بندی مجدد، همان‌طور که هستند بازنویسی می‌شوند.

دو حالت برای انجام پرس‌وجوها در Crossref وجود دارد (یا داشت؟): حساب کاربری رایگان و عضویت پولی. در حالت اول شما همچنان باید در Crossref ثبت‌نام کنید و به تعداد کمی از پرس‌وجوها محدود هستید؛ توافق‌نامه را در "http://www.crossref.org/01company/free_services_agreement.html" مشاهده کنید. در حالت دوم شما نام کاربری و گذرواژه دارید و می‌توانید از آن‌ها برای پرس‌وجوهای خودکار استفاده نمایید. مشخص نیست که آیا استفاده از این اسکریپت برای دارندگان حساب رایگان مجاز است یا خیر. در هر صورت، اگر می‌خواهید DOIها را به تعداد زیادی از ورودی‌ها اضافه کنید، باید به عنوان عضو پولی ثبت‌نام نمایید.

فایل پیکربندی (CONFIGURATION FILE)

فایل پیکربندی مربوط به پرس‌وجوهای Crossref است و تا حد زیادی واضح است: شامل توضیحاتی است که با "#" شروع می‌شوند و انتساب‌هایی به شکل

$field = value ;

پارامترهای مهم عبارتند از $mode ('free' یا 'paid')، $email (برای کاربران رایگان) و $username و $password برای اعضای پولی.

مثال‌ها (EXAMPLES)

bibdoiadd -c bibdoiadd.cfg -o - citations.bib > result.bib
bibdoiadd -c bibdoiadd.cfg -o result.bib citations.bib

نویسنده (AUTHOR)

Boris Veytsman

حق نشر و مجوز (COPYRIGHT AND LICENSE)

این نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط مجوز عمومی همگانی گنو http://www.gnu.org/licenses/gpl.html بازنشر دهید. هیچ ضمانتی تا حد مجاز طبق قانون وجود ندارد.