.TH BIBTEX 1 "15 January 2026" "bibtex 0.99e" "Web2C 2026"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
.if n .ds TX TeX
.ie t .ds OX \fIT\h'-0.17m'\v'+0.21m'E\v'-0.21m'\h'-0.04m'X\fP
.el .ds OX TeX
.\" BX definition must follow TX so BX can use TX
.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
.if n .ds BX BibTeX
.\" LX definition must follow TX so LX can use TX
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
.\" OX for oblique LaTeX
.if t .ds OL \fIL\\h'-0.19m'\\v'-0.15v'\s-2A\s0\\h'-0.09m'\\v'0.15v'\fP\*(OX
.if n .ds OL LaTeX
.\"=====================================================================
.SH "نام (NAME)"
bibtex \- ایجاد کتاب‌نامه برای (La)TeX
.SH "خلاصه دستور (SYNOPSIS)"
.B bibtex
.RB [ -min-crossrefs=\fInumber\fP ]
.RB [ -terse ]
.IR auxname [ \fB.aux\fP ]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
برنامه \*(BX فایل کمکی سطح بالای
.RB ( .aux )
با نام
.I auxname
را که (معمولاً) در حین اجرای
.BR latex (1)
یا
.BR tex (1)
تولید شده است می‌خواند، و یک فایل کتاب‌نامه
.RB ( .bbl )
ایجاد می‌کند که در اجراهای بعدی \*(LX یا \*(TX در سند گنجانده خواهد شد.
.PP
\*(BX در فایل‌های پایگاه دادهٔ کتاب‌شناختی
.RB ( .bib )
که توسط دستور \ebibliography مشخص شده‌اند، به دنبال مدخل‌های مشخص‌شده توسط دستورهای \ecite و \enocite در فایل منبع \*(LX یا \*(TX می‌گردد.
این برنامه اطلاعات آن مدخل‌ها را طبق دستورالعمل‌های موجود در یک فایل شیوه‌نامهٔ کتاب‌نامه
.RB ( .bst )
(مشخص‌شده توسط دستور \ebibliographystyle) قالب‌بندی می‌کند و نتایج را در فایل
.B .bbl
خروجی می‌دهد.
.PP
کتابچهٔ راهنمای \*(LX توضیح می‌دهد که یک فایل منبع \*(LX برای کار با \*(BX باید شامل چه مواردی باشد.
پیوست B آن راهنما، ساختار فایل‌های
.B .bib
را شرح می‌دهد.
.PP
سند کوتاه \(lq\*(BXing\(rq (\(lqbtxdoc\(rq) افزونه‌ها و جزئیات این قالب را شرح می‌دهد و نکات مفید دیگری را برای استفاده از \*(BX ارائه می‌کند.
.PP
همچنین می‌توان از \*(BX همراه با plain TeX، از طریق \\input btxmac استفاده کرد؛ رابط کاربری آن اساساً مشابه \*(LX است. این پشتیبانی در
.BR eplain (1)
گنجانده شده است و راهنمای Eplain کاربرد آن را توضیح می‌دهد که اساساً مشابه \*(LX است: https://tug.org/eplain/doc/eplain.html#Citations
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
برای جزئیات تجزیه خط فرمان به
.BR tex (1)
مراجعه کنید.
.PP
گزینهٔ
.B -min-crossrefs
حداقل تعداد
.B crossref
مورد نیاز برای گنجاندن خودکار مدخل پایهٔ ارجاع‌متقابل در فهرست ارجاعات را مشخص می‌کند؛ مقدار پیش‌فرض ۲ است.
برای جلوگیری کامل از این گنجاندن‌های خودکار، به این گزینه یک عدد به‌اندازهٔ کافی بزرگ بدهید و مطمئن شوید که هرگونه فایل قبلی
.B .aux
و
.B .bbl
را حذف کرده‌اید. در غیر این صورت ممکن است به نظر برسد این گزینه هیچ اثری ندارد، زیرا \*(BX ارجاع مربوط به مدخل پایه را به فایل
.B .aux
اضافه کرده است و چیزی آن را حذف نخواهد کرد.
.PP
با گزینهٔ
.B -terse
، \*(BX در حالت بی‌صدا عمل می‌کند. بدون آن، یک اعلان ابتدایی و گزارش‌های پیشرفت روی خروجی استاندارد (stdout) چاپ می‌شوند.
.PP
گزینه‌های استاندارد
.B -help
و
.B -version
نیز پشتیبانی می‌شوند.
.\"=====================================================================
.SH "محیط (ENVIRONMENT)"
\*(BX دایرکتوری‌های موجود در مسیر تعریف‌شده توسط متغیر محیطی BSTINPUTS را برای فایل‌های
.B .bst
جستجو می‌کند.
اگر BSTINPUTS تنظیم نشده باشد، از پیش‌فرض سیستم استفاده می‌کند.
برای فایل‌های
.B .bib
، در صورت تنظیم بودن متغیر محیطی BIBINPUTS از آن و در غیر این صورت از مقدار پیش‌فرض بهره می‌برد.
برای جزئیات نحوهٔ جستجو به
.BR tex (1)
مراجعه کنید.
.PP
اگر متغیر محیطی TEXMFOUTPUT تنظیم شده باشد، در صورتی که فایل‌های خروجی نتوانند در دایرکتوری جاری قرار گیرند، \*(BX تلاش می‌کند آن‌ها را در آن قرار دهد. باز هم به
.BR tex (1)
مراجعه کنید.
هیچ جستجوی خاصی برای فایل
.B .aux
انجام نمی‌شود.
.\"=====================================================================
.SH "فایل‌ها (FILES)"
.TP 10n
.I *.bst
فایل‌های شیوه‌نامهٔ کتاب‌نامه.
.TP
.I btxdoc.tex
\(lq\*(BXing\(rq \- مستندات برای کاربران \*(BX
.TP
.I btxhak.tex
\(lqDesigning \*(BX Styles\(rq \- مستندات برای نویسندگان .bst
.TP
.I btxdoc.bib
فایل پایگاه داده برای آن دو سند
.TP
.I xampl.bib
فایل پایگاه داده شامل نمونه‌هایی از تمام انواع مدخل‌های استاندارد
.TP
.I btxbst.doc
فایل الگو و مستندات برای شیوه‌نامه‌های استاندارد
.TP
.I btxmac.tex
\*(BX برای plain TeX
.PP
تمام این فایل‌ها باید در جایی روی سیستم شما موجود باشند. اجرای
.I texdoc btxdoc
(یا \fIbtxhak\fR) ممکن است اسناد فوق را نمایش دهد.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR latex (1),
.BR eplain (1),
.BR tex (1).
.PP
صفحهٔ خانگی \*(BX: https://tug.org/bibtex
.br
موضوعات مرتبط با Bib در CTAN: https://ctan.org/topic/:B
.br
صفحهٔ بستهٔ \*(BX در CTAN: https://ctan.org/pkg/bibtex
.br
(که شامل پیوندهایی به اسناد بالا و موارد دیگر است).
.PP
Leslie Lamport,
.IR "\*(OL: A Document Preparation System" ,
Addison-Wesley.
.PP
پشتیبانی از کتاب‌نامه در plain TeX:
https://tug.org/eplain/doc/eplain.html#Citations
.PP
فصل \*(BX در راهنمای Web2c:
https://tug.org/texinfohtml/web2c.html#BibTeX
.PP
کد منبع حروف‌چینی‌شده برای \*(BX:
https://ctan.org/pkg/knuth-pdf
.PP
با تشکر از Nelson Beebe، دانشگاه یوتا مجموعهٔ گسترده‌ای از فایل‌های
.I .bib
را فراهم کرده است، از جمله مدخل‌هایی برای تمام کتاب‌های استاندارد \*(TX و یک کتاب‌نامهٔ کامل برای \fITUGboat\fP. همچنین Nelson این صفحهٔ اطلاعاتی را دربارهٔ \*(BX ارائه می‌دهد:
.br
https://ftp.math.utah.edu/pub/bibnet/bibtex-info.html
.br
و مجموعهٔ بزرگی از ابزارهای مرتبط با \*(BX:
.br
https://www.math.utah.edu/~beebe/software/bibtex-bibliography-tools.html
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
Oren Patashnik، دانشگاه استنفورد. این صفحهٔ راهنما نسخهٔ Web2c (\*(TX Live) از \*(BX را توصیف می‌کند. سایر پورت‌های \*(BX پیاده‌سازی جستجوی مسیر یکسان یا گزینه‌های خط فرمان مشابهی ندارند.
.PP
فهرست گفتگوی عمومی و گزارش باگ‌ها: https://lists.tug.org/biblio