.TH PBIBTEX 1 "12 January 2026" "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
.\"=====================================================================
.SH "نام (NAME)"
pbibtex, upbibtex \- ساخت کتاب‌نامه (ژاپنی) برای (La)TeX
.SH "خلاصه دستور (SYNOPSIS)"
.B pbibtex
.RI [ options ]
.IR auxname [ \fB.aux\fP ]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
برنامه p\*(BX (\fBpbibtex\fR)
نسخهٔ تغییریافته‌ای از
.BR bibtex (1)
برای مدیریت کتاب‌نامه‌های ژاپنی است. این ابزار مدخل‌ها را بر اساس نقطه‌کدها در EUC-JP مرتب‌سازی می‌کند، و توابع توکار جدید و اصلاح‌شده‌ای را که در ادامه شرح داده شده‌اند، ارائه می‌دهد.
.PP
برنامه up\*(BX (\fBupbibtex\fR) نسخهٔ اصلاح‌شده‌ای از p\*(BX است که مدخل‌ها را بر اساس نقطه‌کدها در Unicode مرتب می‌سازد.
.PP
.B افزونه‌های توابع سبک کتاب‌نامه (bst)
.PP
یک تابع توکار جدید در دسترس است، و برخی توابع دیگر برای ساده‌سازی کار با زبان ژاپنی اصلاح شده‌اند.
.PP
.TP 5
.B is.kanji.str$
[تابع توکار جدید]
بالاترین مقدار ثابت (رشته) را از پشته برمی‌دارد تا بررسی کند آیا شامل نویسهٔ غیر ASCII هست یا خیر. اگر حداقل شامل یک نویسه باشد 1، و در غیر این صورت 0 را در پشته قرار می‌دهد.
.PP
.TP 5
.B substring$
به‌منظور جلوگیری از شکستن رشتهٔ نویسه‌ای در میانهٔ یک نویسهٔ چندبایتی اصلاح شده است.
.PP
.TP 5
.B text.prefix$
اصلاح مشابهی همانند
.BR substring$
روی آن انجام گرفته است.
.PP
.TP 5
.B add.period$
اصلاح شده است تا از الحاق "." پس از علائم نگارشی ژاپنی متناظر با "!"، "?" و "."
(یعنی U+FF01، U+FF1F، U+3002 و U+FF0E) جلوگیری کند.
.PP
.TP 5
.B format.name$
اصلاح شده است تا فاصلهٔ اندیشه‌نگار \fIzenkaku\fR ژاپنی
(U+3000) را برای نام‌های نمایش‌یافته در زبان ژاپنی بپذیرد.
همچنین اصلاح شده تا کاماهای ژاپنی (U+3001 و U+FF0C) را مشابه "and" میان نام‌ها تشخیص دهد.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
برای جزئیات تجزیهٔ خط فرمان به
.BR tex (1)
و برای گزینه‌های رایج به
.BR bibtex (1)
مراجعه کنید: \fB-min-crossrefs\fP، \fB-terse\fP، \fB-help\fP،
\fB-version\fP.
.TP
.B [-no]-guess-input-enc
غیرفعال/فعال‌سازی تشخیص خودکار کدگذاری فایل ورودی.
.TP
.BI -kanji= string
تنظیم کدگذاری ژاپنی؛ که در آن \fIstring\fP یکی از مقادیر
\fIeuc\fP، \fIjis\fP، \fIsjis\fP، \fIutf8\fP یا \fIuptex\fP است.
.TP
.BI -kanji-internal= string
تنظیم کدگذاری داخلی ژاپنی؛ که در آن \fIstring\fP یکی از مقادیر \fIeuc\fP
یا \fIuptex\fP است.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR bibtex (1),
.BR ptex (1).
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
\*(BX توسط Oren Patashnik در دانشگاه استنفورد نوشته شد.
.PP
نسخهٔ ژاپنی \*(BX در ابتدا توسط Shouichi Matsui در قالب J\*(BX تا سال ۱۹۹۱ توسعه یافت.
این برنامه به‌گونه‌ای توسعه یافته بود تا در مدیریت کدگذاری‌های قدیمی ژاپنی، رفتاری سازگار با NTT J\*(TX داشته باشد.
فایل‌های مستندات قدیمی jbibtex.pdf، jbtxdoc.tex و jbtxhak.tex
(همگی در \*(TX Live در دسترس هستند)
قابلیت کار با زبان ژاپنی و برخی نکات تکمیلی J\*(BX را شرح می‌دهند.
.PP
نسخهٔ کنونی (u)p\*(BX یک انشعاب از J\*(BX است،
و روال تبدیل کدگذاری را با روالی که با ویرایش جامعهٔ (u)p\*(TX با استفاده از کتابخانهٔ ptexenc سازگار است جایگزین کرده است.
توضیحات مربوط به کدگذاری‌ها در فایل‌های مستندات قدیمی
j*.pdf (به‌ویژه بخش 3.3 از jbibtex.pdf، مانند BIBTERMCODE
و BIBFILECODE) دیگر صحیح نیستند.
.PP
این صفحهٔ راهنما توسط Hironobu Yamashita نوشته شده است.
.PP
گزارش‌های اشکال را به issue@texjp.org ایمیل کنید.