.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "DOCBOOK2TEXI-SPEC.PL" "1" "05 December 2025" "" ""

.SH "نام (NAME)"
docbook2texi-spec.pl \- تبدیل کتاب‌های DocBook به اسناد Texinfo
.SH "خلاصه دستور (SYNOPSIS)"

\fBsgmlspl\fR \fBdocbook2man-spec.pl\fR


\fBnsgmls\fR [ \fB\fIsgml document\fB\fR ]\fB| sgmlspl\fR \fBdocbook2texi-spec.pl\fR [ \fB\fIbasename\fB\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
برنامه \fBdocbook2texi\fR یک فایل مشخصات sgmlspl است که از اسناد DocBook،
اسناد GNU Texinfo تولید می‌کند.
.PP
این برنامه خروجی ESIS تولیدشده توسط nsgmls (یا سایر تجزیه‌کننده‌های SGML) را از
ورودی استاندارد می‌خواند. در حال حاضر عنصر سند باید Book باشد،
در غیر این صورت نتایج نامشخص خواهد بود.
.PP
خروجی آن، یعنی سند تبدیل‌شده Texinfo، در خروجی استاندارد نوشته می‌شود.
.PP
فایل \fIbasename.refs\fR نیز ایجاد خواهد شد که شامل تمام گره‌های موجود در سند و گره‌های «فرزند» بی‌واسطه آن‌ها است. از آنجا که پردازش گره‌ها همواره نیازمند ارجاع‌های رو به جلو است،
\fBdocbook2texi\fR باید برای هر سند دو بار اجرا شود: بار اول برای ساخت ارجاع‌ها، و بار دوم برای تولید یک سند معتبر واقعی.
.SH "پیش‌نیازها (REQUIREMENTS)"

بسته SGMLSpm از CPAN. این بسته شامل اسکریپت sgmlspl نیز هست که به آن نیاز است.
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
آزمودن \fBdocbook2man\fR بر روی اسناد غیر DocBook یا SGML ناسازگار منجر به رفتاری تعریف‌نشده می‌شود. :-)
.PP
این برنامه یک اسکریپت پرل (Perl) کند و ناپایدار است.
.PP
این برنامه حتی نزدیک به پشتیبانی از تمام نشانه‌گذاری‌های ممکن در DocBook نیست، و ممکن است در برخی موارد با نشانه‌گذاری‌های پشتیبانی‌شده نیز خروجی نادرست تولید کند.
.SH "کارهای آینده (TO DO)"
.TP 0.2i
\(bu
چگونه در Texinfo می‌توان یک بک‌اسلش (\\) را نمایش داد!!@؟
من \\\\ را امتحان کرده‌ام اما TeX از آن ایراد می‌گیرد.
.TP 0.2i
\(bu
رفع خرابی‌های یافت‌شده در اسناد آزمایشی.
.TP 0.2i
\(bu
افزودن مدیریت عناصر جدید و رفع ایرادات مدیریت عناصر موجود.
باید پایدار باشد.
.TP 0.2i
\(bu
افزایش سرعت. فکر می‌کنم بیشتر مشکلات سرعت تا کنون مربوط به تجزیه
ESIS باشد. بازنویسی \fISGMLS.pm\fR با C و/یا دریافت مستقیم ورودی
از \fBSP\fR\&.
.TP 0.2i
\(bu
وابستگی‌هایی به حضور برخی عناصر وجود دارد، در حالی که آن‌ها در واقع اختیاری هستند (بر اساس DTD). باید این مورد را برطرف کنیم (ترجیحاً) یا نیازمندی‌ها را به طور مشخص اعلام کنیم.
.TP 0.2i
\(bu
پشتیبانی از سایر عناصر متداول‌تر سند.
.TP 0.2i
\(bu
جداسازی ارجاع به گره‌ها در یک اسکریپت جداگانه. این کار نه‌تنها نگهداری را به دلیل تفکیک از کد اصلی سریع‌تر/آسان‌تر می‌کند، بلکه مایلم آن را به یک تولیدکننده خودکار فهرست مطالب (ToC) برای DocBook تبدیل کنم.
.SH "حق نشر (COPYRIGHT)"
.PP
حق نشر (C) 1998-1999 متعلق به Steve Cheng <steve@ggi-project.org> است.
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد، چه نسخه ۲ پروانه یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید.
.PP
شما باید یک نسخه از پروانه عمومی همگانی گنو را به همراه این برنامه دریافت کرده باشید؛ فایل \fICOPYING\fR را ببینید. در غیر این صورت، لطفاً به آدرس زیر بنویسید:
Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.