.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
.\" ========================================================================
.\"
.IX Title "bibdoiadd 1"
.TH bibdoiadd 1 2024-09-02 "" "LATEX CROSSREFWARE"
.\" 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)"
bibdoiadd \- افزودن خودکار شناسه‌های DOI به ورودی‌های BibTeX
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
bibdoiadd [\fB\-c\fR \fIconfig_file\fR] [\fB\-C\fR 1|0] [\fB\-e\fR 1|0] [\fB\-f\fR] [\fB\-o\fR \fIoutput\fR] \fIbib_file\fR
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-c\fR \fIconfig_file\fR" 4
.IX Item "-c config_file"
فایل پیکربندی. اگر این فایل وجود نداشته باشد، مقادیر پیش‌فرض استفاده می‌شوند.
برای قالب آن به بخش زیر مراجعه کنید.
.IP "\fB\-C\fR 1|0" 4
.IX Item "-C 1|0"
آیا نام‌ها در خروجی استانداردسازی (canonicalize) شوند (1) یا خیر (0). پیش‌فرض: 1.
.IP \fB\-e\fR 4
.IX Item "-e"
اگر 1 باشد (پیش‌فرض)، در صورت پیدا نشدن شناسه doi، یک فیلد doi خالی اضافه می‌کند. این کار در صورت افزودن ورودی‌های جدید به فایل، از جستجوهای تکراری برای همان ورودی‌ها جلوگیری می‌کند. اجرای \f(CW\*(C`\-e 0\*(C'\fR این رفتار را غیرفعال می‌کند.
.IP \fB\-f\fR 4
.IX Item "-f"
بررسی اجباری شناسه doi حتی اگر از قبل وجود داشته باشد.
.IP "\fB\-o\fR \fIoutput\fR" 4
.IX Item "-o output"
فایل خروجی. اگر از این گزینه استفاده نشود، نام فایل خروجی با افزودن \f(CW\*(C`_doi\*(C'\fR به فایل ورودی ساخته می‌شود.
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این اسکریپت یک فایل BibTeX را می‌خواند. بررسی می‌کند که آیا ورودی‌ها دارای شناسه DOI هستند یا خیر. در غیر این صورت، تلاش می‌کند با http://www.crossref.org ارتباط برقرار کند تا DOI مربوطه را دریافت نماید. نتیجه یک فایل BibTeX است که فیلدهای
\&\f(CW\*(C`doi=...\*(C'\fR
به آن افزوده شده‌اند.
.PP
نام فایل خروجی یا با گزینه
.B \-o
تعیین می‌شود یا با افزودن پسوند \f(CW\*(C`_doi\*(C'\fR به نام فایل ورودی مشتق می‌گردد.
.PP
هر رکورد BibTeX در ورودی با استفاده از BibTeX::Parser پردازش می‌شود، اما فقط رکوردهایی که فیلد \f(CW\*(C`doi\*(C'\fR (یا \f(CW\*(C`mrnumber\*(C'\fR یا
\&\f(CW\*(C`zblnumber\*(C'\fR
برای اسکریپت‌های مشابه) را ندارند پردازش می‌گردند. این ورودی‌های فاقد فیلد درخواستی، همان‌طور که در BibTeX::Parser::Entry توضیح داده شده، بازنویسی می‌شوند.
.PP
رکوردهای bib که پردازش نمی‌شوند (زیرا از قبل فیلد درخواستی را دارند) بدون هیچ‌گونه قالب‌بندی مجدد، همان‌طور که هستند بازنویسی می‌شوند.
.PP
دو حالت برای انجام پرس‌وجوها در Crossref وجود دارد (یا داشت؟): حساب کاربری رایگان و عضویت پولی. در حالت اول شما همچنان باید در Crossref ثبت‌نام کنید و به تعداد کمی از پرس‌وجوها محدود هستید؛ توافق‌نامه را در
\&\f(CW\*(C`http://www.crossref.org/01company/free_services_agreement.html\*(C'\fR
مشاهده کنید. در حالت دوم شما نام کاربری و گذرواژه دارید و می‌توانید از آن‌ها برای پرس‌وجوهای خودکار استفاده نمایید. مشخص نیست که آیا استفاده از این اسکریپت برای دارندگان حساب رایگان مجاز است یا خیر. در هر صورت، اگر می‌خواهید DOIها را به تعداد زیادی از ورودی‌ها اضافه کنید، باید به عنوان عضو پولی ثبت‌نام نمایید.
.SH "فایل پیکربندی (CONFIGURATION FILE)"
.IX Header "CONFIGURATION FILE"
فایل پیکربندی مربوط به پرس‌وجوهای Crossref است و تا حد زیادی واضح است: شامل توضیحاتی است که با \f(CW\*(C`#\*(C'\fR شروع می‌شوند و انتساب‌هایی به شکل
.PP
.Vb 1
\&   $field = value ;
.Ve
.PP
پارامترهای مهم عبارتند از \f(CW$mode\fR (\f(CW\*(Aqfree\*(Aq\fR یا \f(CW\*(Aqpaid\*(Aq\fR)،
\&\f(CW$email\fR (برای کاربران رایگان) و \f(CW$username\fR و \f(CW$password\fR برای اعضای پولی.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
.Vb 2
\&   bibdoiadd \-c bibdoiadd.cfg \-o \- citations.bib > result.bib
\&   bibdoiadd \-c bibdoiadd.cfg \-o result.bib citations.bib
.Ve
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
Boris Veytsman
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
.IX Header "COPYRIGHT AND LICENSE"
حق نشر (C) 2014\-2024 Boris Veytsman
.PP
این نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط مجوز عمومی همگانی گنو
<http://www.gnu.org/licenses/gpl.html>
بازنشر دهید. هیچ ضمانتی تا حد مجاز طبق قانون وجود ندارد.