نام (NAME)

docbook2texi-spec.pl - تبدیل کتاب‌های DocBook به اسناد Texinfo

خلاصه دستور (SYNOPSIS)

sgmlspl docbook2man-spec.pl

nsgmls [ sgml document ]| sgmlspl docbook2texi-spec.pl [ basename ]

توضیحات (DESCRIPTION)

برنامه docbook2texi یک فایل مشخصات sgmlspl است که از اسناد DocBook، اسناد GNU Texinfo تولید می‌کند.

این برنامه خروجی ESIS تولیدشده توسط nsgmls (یا سایر تجزیه‌کننده‌های SGML) را از ورودی استاندارد می‌خواند. در حال حاضر عنصر سند باید Book باشد، در غیر این صورت نتایج نامشخص خواهد بود.

خروجی آن، یعنی سند تبدیل‌شده Texinfo، در خروجی استاندارد نوشته می‌شود.

فایل basename.refs نیز ایجاد خواهد شد که شامل تمام گره‌های موجود در سند و گره‌های «فرزند» بی‌واسطه آن‌ها است. از آنجا که پردازش گره‌ها همواره نیازمند ارجاع‌های رو به جلو است، docbook2texi باید برای هر سند دو بار اجرا شود: بار اول برای ساخت ارجاع‌ها، و بار دوم برای تولید یک سند معتبر واقعی.

پیش‌نیازها (REQUIREMENTS)

بسته SGMLSpm از CPAN. این بسته شامل اسکریپت sgmlspl نیز هست که به آن نیاز است.

محدودیت‌ها (LIMITATIONS)

آزمودن docbook2man بر روی اسناد غیر DocBook یا SGML ناسازگار منجر به رفتاری تعریف‌نشده می‌شود. :-)

این برنامه یک اسکریپت پرل (Perl) کند و ناپایدار است.

این برنامه حتی نزدیک به پشتیبانی از تمام نشانه‌گذاری‌های ممکن در DocBook نیست، و ممکن است در برخی موارد با نشانه‌گذاری‌های پشتیبانی‌شده نیز خروجی نادرست تولید کند.

کارهای آینده (TO DO)

•

چگونه در Texinfo می‌توان یک بک‌اسلش (\) را نمایش داد!!@؟ من \\ را امتحان کرده‌ام اما TeX از آن ایراد می‌گیرد.

•

رفع خرابی‌های یافت‌شده در اسناد آزمایشی.

•

افزودن مدیریت عناصر جدید و رفع ایرادات مدیریت عناصر موجود. باید پایدار باشد.

•

افزایش سرعت. فکر می‌کنم بیشتر مشکلات سرعت تا کنون مربوط به تجزیه ESIS باشد. بازنویسی SGMLS.pm با C و/یا دریافت مستقیم ورودی از SP.

•

وابستگی‌هایی به حضور برخی عناصر وجود دارد، در حالی که آن‌ها در واقع اختیاری هستند (بر اساس DTD). باید این مورد را برطرف کنیم (ترجیحاً) یا نیازمندی‌ها را به طور مشخص اعلام کنیم.

•

پشتیبانی از سایر عناصر متداول‌تر سند.

•

جداسازی ارجاع به گره‌ها در یک اسکریپت جداگانه. این کار نه‌تنها نگهداری را به دلیل تفکیک از کد اصلی سریع‌تر/آسان‌تر می‌کند، بلکه مایلم آن را به یک تولیدکننده خودکار فهرست مطالب (ToC) برای DocBook تبدیل کنم.

حق نشر (COPYRIGHT)

حق نشر (C) 1998-1999 متعلق به Steve Cheng <steve@ggi-project.org> است.

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد، چه نسخه ۲ پروانه یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید.

شما باید یک نسخه از پروانه عمومی همگانی گنو را به همراه این برنامه دریافت کرده باشید؛ فایل COPYING را ببینید. در غیر این صورت، لطفاً به آدرس زیر بنویسید: Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.