BIBTEX(1) Web2C 2026 BIBTEX(1)

bibtex - ایجاد کتاب‌نامه برای (La)TeX

bibtex [-min-crossrefs=number] [-terse] auxname[.aux]

برنامه BibTeX فایل کمکی سطح بالای (.aux) با نام auxname را که (معمولاً) در حین اجرای latex(1) یا tex(1) تولید شده است می‌خواند، و یک فایل کتاب‌نامه (.bbl) ایجاد می‌کند که در اجراهای بعدی LaTeX یا TeX در سند گنجانده خواهد شد.

BibTeX در فایل‌های پایگاه دادهٔ کتاب‌شناختی (.bib) که توسط دستور \bibliography مشخص شده‌اند، به دنبال مدخل‌های مشخص‌شده توسط دستورهای \cite و \nocite در فایل منبع LaTeX یا TeX می‌گردد. این برنامه اطلاعات آن مدخل‌ها را طبق دستورالعمل‌های موجود در یک فایل شیوه‌نامهٔ کتاب‌نامه (.bst) (مشخص‌شده توسط دستور \bibliographystyle) قالب‌بندی می‌کند و نتایج را در فایل .bbl خروجی می‌دهد.

کتابچهٔ راهنمای LaTeX توضیح می‌دهد که یک فایل منبع LaTeX برای کار با BibTeX باید شامل چه مواردی باشد. پیوست B آن راهنما، ساختار فایل‌های .bib را شرح می‌دهد.

سند کوتاه “BibTeXing” (“btxdoc”) افزونه‌ها و جزئیات این قالب را شرح می‌دهد و نکات مفید دیگری را برای استفاده از BibTeX ارائه می‌کند.

همچنین می‌توان از BibTeX همراه با plain TeX، از طریق \input btxmac استفاده کرد؛ رابط کاربری آن اساساً مشابه LaTeX است. این پشتیبانی در eplain(1) گنجانده شده است و راهنمای Eplain کاربرد آن را توضیح می‌دهد که اساساً مشابه LaTeX است: https://tug.org/eplain/doc/eplain.html#Citations

برای جزئیات تجزیه خط فرمان به tex(1) مراجعه کنید.

گزینهٔ -min-crossrefs حداقل تعداد crossref مورد نیاز برای گنجاندن خودکار مدخل پایهٔ ارجاع‌متقابل در فهرست ارجاعات را مشخص می‌کند؛ مقدار پیش‌فرض ۲ است. برای جلوگیری کامل از این گنجاندن‌های خودکار، به این گزینه یک عدد به‌اندازهٔ کافی بزرگ بدهید و مطمئن شوید که هرگونه فایل قبلی .aux و .bbl را حذف کرده‌اید. در غیر این صورت ممکن است به نظر برسد این گزینه هیچ اثری ندارد، زیرا BibTeX ارجاع مربوط به مدخل پایه را به فایل .aux اضافه کرده است و چیزی آن را حذف نخواهد کرد.

با گزینهٔ -terse ، BibTeX در حالت بی‌صدا عمل می‌کند. بدون آن، یک اعلان ابتدایی و گزارش‌های پیشرفت روی خروجی استاندارد (stdout) چاپ می‌شوند.

گزینه‌های استاندارد -help و -version نیز پشتیبانی می‌شوند.

BibTeX دایرکتوری‌های موجود در مسیر تعریف‌شده توسط متغیر محیطی BSTINPUTS را برای فایل‌های .bst جستجو می‌کند. اگر BSTINPUTS تنظیم نشده باشد، از پیش‌فرض سیستم استفاده می‌کند. برای فایل‌های .bib ، در صورت تنظیم بودن متغیر محیطی BIBINPUTS از آن و در غیر این صورت از مقدار پیش‌فرض بهره می‌برد. برای جزئیات نحوهٔ جستجو به tex(1) مراجعه کنید.

اگر متغیر محیطی TEXMFOUTPUT تنظیم شده باشد، در صورتی که فایل‌های خروجی نتوانند در دایرکتوری جاری قرار گیرند، BibTeX تلاش می‌کند آن‌ها را در آن قرار دهد. باز هم به tex(1) مراجعه کنید. هیچ جستجوی خاصی برای فایل .aux انجام نمی‌شود.

*.bst
فایل‌های شیوه‌نامهٔ کتاب‌نامه.
“BibTeXing” - مستندات برای کاربران BibTeX
“Designing BibTeX Styles” - مستندات برای نویسندگان .bst
فایل پایگاه داده برای آن دو سند
فایل پایگاه داده شامل نمونه‌هایی از تمام انواع مدخل‌های استاندارد
فایل الگو و مستندات برای شیوه‌نامه‌های استاندارد
BibTeX برای plain TeX

تمام این فایل‌ها باید در جایی روی سیستم شما موجود باشند. اجرای texdoc btxdoc (یا btxhak) ممکن است اسناد فوق را نمایش دهد.

latex(1), eplain(1), tex(1).

صفحهٔ خانگی BibTeX: https://tug.org/bibtex
موضوعات مرتبط با Bib در CTAN: https://ctan.org/topic/:B
صفحهٔ بستهٔ BibTeX در CTAN: https://ctan.org/pkg/bibtex
(که شامل پیوندهایی به اسناد بالا و موارد دیگر است).

Leslie Lamport, LaTeX: A Document Preparation System, Addison-Wesley.

پشتیبانی از کتاب‌نامه در plain TeX: https://tug.org/eplain/doc/eplain.html#Citations

فصل BibTeX در راهنمای Web2c: https://tug.org/texinfohtml/web2c.html#BibTeX

کد منبع حروف‌چینی‌شده برای BibTeX: https://ctan.org/pkg/knuth-pdf

با تشکر از Nelson Beebe، دانشگاه یوتا مجموعهٔ گسترده‌ای از فایل‌های .bib را فراهم کرده است، از جمله مدخل‌هایی برای تمام کتاب‌های استاندارد TeX و یک کتاب‌نامهٔ کامل برای TUGboat. همچنین Nelson این صفحهٔ اطلاعاتی را دربارهٔ BibTeX ارائه می‌دهد:
https://ftp.math.utah.edu/pub/bibnet/bibtex-info.html
و مجموعهٔ بزرگی از ابزارهای مرتبط با BibTeX:
https://www.math.utah.edu/~beebe/software/bibtex-bibliography-tools.html

Oren Patashnik، دانشگاه استنفورد. این صفحهٔ راهنما نسخهٔ Web2c (TeX Live) از BibTeX را توصیف می‌کند. سایر پورت‌های BibTeX پیاده‌سازی جستجوی مسیر یکسان یا گزینه‌های خط فرمان مشابهی ندارند.

فهرست گفتگوی عمومی و گزارش باگ‌ها: https://lists.tug.org/biblio

15 January 2026 bibtex 0.99e