.TH BIBTEXU "1" "30 August 2022" "bibtexu 4.00" "User Commands"
.SH "نام (NAME)"
bibtexu \- نسخه بزرگ BibTeX با پشتیبانی از UTF-8
.SH "خلاصه دستور (SYNOPSIS)"
.B bibtexu
[\fIoptions\fR] \fIaux-file\fR
.SH "توضیحات (DESCRIPTION)"
.PP
برنامهٔ
.B BibTeXu
نسخهٔ سازگار با یونیکد (Unicode) از BibTeX است.
این برنامه تا حد زیادی بر پایهٔ BibTeX8 متعلق به نیل کمپسون (Niel Kempson) توسعه یافته است و با ادغام کتابخانهٔ ICU، پشتیبانی بهتری را از UTF-8 ارائه می‌دهد. بنابراین،
.B BibTeXu
دیگر نیازی به فایل‌های جدول کدبندی و ترتیب مرتب‌سازی ("CS") ندارد؛ در عوض، روش مرتب‌سازی و تغییر بزرگی و کوچکی حروف را می‌توان از طریق گزینه‌های خط فرمان کنترل کرد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-?\fR  \fB\-\-help\fR
نمایش یک متن راهنمای کوتاه.
.TP
\fB\-d\fR  \fB\-\-debug\fR TYPE
گزارش اطلاعات اشکال‌زدایی. TYPE شامل یک یا چند مورد از all، csf، io، mem، misc یا search است.
.TP
\fB\-s\fR  \fB\-\-statistics\fR
گزارش آمارهای داخلی.
.TP
\fB\-t\fR  \fB\-\-trace\fR
گزارش ردگیری اجرای دستور.
.TP
\fB\-v\fR  \fB\-\-version\fR
گزارش نسخهٔ BibTeX.
.TP
\fB\-l\fR  \fB\-\-language\fR LANG
استفاده از زبان LANG برای تبدیل رشته‌ها به حروف کوچک.
این آرگومان به کتابخانهٔ ICU ارسال می‌شود.
.TP
\fB\-o\fR  \fB\-\-location\fR LANG
استفاده از زبان LANG برای مرتب‌سازی.
این آرگومان به کتابخانهٔ ICU ارسال می‌شود.
.TP
\fB\-B\fR  \fB\-\-big\fR
تنظیم ظرفیت BibTeX بر روی حالت بزرگ (big).
.TP
\fB\-H\fR  \fB\-\-huge\fR
تنظیم ظرفیت BibTeX بر روی حالت بسیار بزرگ (huge).
.TP
\fB\-W\fR  \fB\-\-wolfgang\fR
تنظیم ظرفیت واقعاً عظیم BibTeX برای Wolfgang.
.TP
\fB\-M\fR  \fB\-\-min_crossrefs\fR ##
تنظیم مقدار min_crossrefs روی ##.
.TP
\fB\-\-mstrings\fR ##
اجازه دادن به ## رشتهٔ یکتا (unique).
.SH "پشتیبانی از یونیکد (UNICODE SUPPORT)"
.PP
.B BibTeXu
از قابلیت‌های گسترش‌یافته برای مدیریت نویسه‌های یونیکد پشتیبانی می‌کند.
چندین تابع توکار در شیوه‌نامه‌های کتاب‌شناسی به شرح زیر ارتقا یافته‌اند:
.TP
\fB&\fR
دو لیترال بالایی (از نوع عدد صحیح) را از پشته برمی‌دارد و حاصل AND بیتی آن‌ها را در پشته قرار می‌دهد.
.TP
\fB|\fR
دو لیترال بالایی (از نوع عدد صحیح) را از پشته برمی‌دارد و حاصل OR بیتی آن‌ها را در پشته قرار می‌دهد.
.TP
\fBadd.period$\fR
لیترال بالایی (از نوع رشته) را از پشته برمی‌دارد؛ در صورتی که آخرین نویسهٔ غیر از \(oq}\(cq، یکی از نویسه‌های \(oq.\(cq، \(oq?\(cq، \(oq!\(cq یا یک نشانه‌گذاری یونیکد نباشد، یک \(oq.\(cq به آن می‌افزاید و رشته حاصل را در پشته قرار می‌دهد.
این نشانه می‌تواند U+203C، U+203D، U+2047، U+2048، U+2049، U+3002، U+FF01، U+FF0E یا U+FF1F باشد.
.TP
\fBchr.to.int$\fR
لیترال بالایی (از نوع رشته) را از پشته برمی‌دارد، اطمینان حاصل می‌کند که یک رشتهٔ چندبایتی از یک نقطه کد (code point) یونیکد منفرد است، آن را به مقدار اسکالر متناظر یونیکد (عدد صحیح) تبدیل می‌کند و این عدد صحیح را در پشته قرار می‌دهد.
.TP
\fBint.to.chr$\fR
لیترال بالایی (از نوع عدد صحیح) را از پشته برمی‌دارد، آن را به عنوان مقدار اسکالر یونیکد یک نقطه کد منفرد تفسیر می‌کند، آن را به رشتهٔ چندبایتی تک‌نویسه‌ای متناظر تبدیل کرده و این رشته را در پشته قرار می‌دهد.
.TP
\fBnum.names$\fR, \fBformat.name$\fR
عملکرد این تابع مشابه با BibTeX اصلی است، اما ویرگول نگارنگاشتی/تمام‌عرض (U+3001، U+FF0C) علاوه بر رشتهٔ " and " به عنوان جداکننده میان اشخاص پذیرفته می‌شود و فاصلهٔ نگارنگاشتی (U+3000) نیز علاوه بر فاصلهٔ معمولی " " به عنوان جداکننده میان نام خانوادگی و نام کوچک پذیرفته می‌شود.
.TP
\fBsubstring$\fR, \fBtext.length$\fR, \fBtext.prefix$\fR
عملکرد این تابع مشابه با BibTeX اصلی است، اما واحد مقادیر عملوندها نقطه کد (code point) یونیکد است.
.TP
\fBchange.case$\fR
عملکرد این تابع مشابه با BibTeX اصلی است، اما از حروف لاتین غیرانگلیسی، یونانی و سیریلیک نیز پشتیبانی می‌شود.
.TP
\fBwidth$\fR
عملکرد این تابع مشابه با BibTeX اصلی است، اما از حروف Latin-1 و Latin Extended-A و نویسه‌های CJK نیز پشتیبانی می‌شود.
.TP
\fBis.cjk.str$\fR
لیترال بالایی (از نوع رشته) را از پشته برمی‌دارد؛ در صورت یافت شدن نویسه‌های CJK در رشته، بیت‌های پرچم را در قالب یک عدد صحیح تنظیم کرده و عدد صحیح حاصل را در پشته قرار می‌دهد، در غیر این صورت 0 را در پشته می‌گذارد.
پرچم‌های 0x001، 0x002، 0x004، 0x008 و 0x800 به ترتیب متناظر با نویسه‌های Hanzi (شامل Kanji و Hanja)، نویسه‌های Kana، نویسه‌های Hangul، نویسه‌های Bopomofo و سایر نویسه‌های CJK هستند.
برای مثال، اگر در لیترال رشتهٔ برداشته‌شده نویسه‌های Hanzi و Kana پیدا شوند، عدد صحیح 0x003 در پشته قرار خواهد گرفت.
.TP
\fBis.kanji.str$\fR
مشابه با \fBis.cjk.str$\fR جهت سازگاری با (u)pBibTeX.
.SH "همچنین ببینید (SEE ALSO)"
توضیحات دقیق‌تر دربارهٔ
.B BibTeXu
در مسیر $TEXMFDIST/doc/bibtexu/README در دسترس است.
.SH "نویسندگان (AUTHORS)"
.B BibTeXu
توسط Yannis Haralambous و دانشجویان او نوشته شده است.
این ابزار به عنوان بخشی از TeX Live نگهداری می‌شود.
.PP
این صفحهٔ راهنما برای TeX Live نوشته شده است.