نام (NAME)

rtf2rtf - برنامه‌ای برای پس‌پردازش RTF خام تولیدشده توسط فایل‌های نگاشت

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

rtf2rtf [گزینه‌ها] ..

توضیحات (DESCRIPTION)

این صفحه راهنما به‌طور خلاصه دستورات rtf2rtf را شرح می‌دهد. این صفحه راهنما برای توزیع Debian GNU/Linux نوشته شده است؛ زیرا برنامه اصلی فاقد صفحه راهنما برای rtf2rtf است.

rtf2rtf برنامه‌ای برای پس‌پردازش RTF خام تولیدشده توسط فایل‌های نگاشت است.

این برنامه توسط سایر برنامه‌های sgml-tools (v1) استفاده می‌شود و معمولاً کاربران عادی نیازی به اجرای مستقیم آن ندارند.

متن زیر برگرفته از فایل README در درخت سورس‌کد است:

(شروع نقل‌قول)

من به این کد افتخار نمی‌کنم. وصله‌پینه‌ای است سوار بر وصله‌پینه‌ای دیگر، پیچیده‌شده درون یکی دو وصله‌پینه دیگر. این برنامه تا حدودی برای اهداف من (تولید فایل‌های RTF. مربوط به WinHelp برای اسنادم) به‌اندازه کافی خوب کار می‌کند، اما قطعاً به یک بازطراحی/بازنویسی نیاز دارد. به‌عنوان یک تغییر ساده روی فیلتر html2html آغاز شد، اما خیلی سریع بدترکیب و آشفته شد...

من بی‌شرمانه قالب RTF را مقصر اصلی بیشتر این وصله‌پینه‌کاری‌ها می‌دانم -- RTF برخلاف LaTeX یا ROFF یک «زبان» نیست -- صرفاً یک قالب فایل است. بنابراین، نمی‌توانیم به RTF برای انجام کارهای ساده‌ای مثل «شکست بند (paragraph break) را تنها در صورتی در اینجا درج کن که نشانه قبلی یک شکست بند نبوده باشد» تکیه کنیم. از آنجا که فرانت‌اند SGML فاقد قابلیت‌های پردازش شرطی است، خطوط خالی متعدد در SGML به چندین شکست بند متوالی در RTF ترجمه می‌شوند. به همین دلیل است که ما از یک فیلتر "lex" (به‌نام rtf2rtf) برای پس‌پردازش RTF خام تولیدشده توسط فایل‌های نگاشت استفاده می‌کنیم.

مجدداً تأکید می‌کنم: این را با این امید به جامعه Linuxdoc ارائه می‌دهم که برای دیگران مفید باشد و فرد دیگری بتواند در تکمیل بخش‌های ناقص کمک کند. چی؟ بخش‌های ناقص؟ بله، به یاد بیاورید که گفتم این برنامه «برای اهداف من به‌اندازه کافی خوب» کار می‌کند. فایل‌های جایگزین (عمومی، نگاشت) در ابتدا شبیه فایل‌های جایگزین latex آغاز شدند. بخش عمده‌ای از آن‌ها هنوز هم *همان* فایل‌های جایگزین latex هستند. من تنها بخش‌هایی را تبدیل کرده‌ام که عملاً توسط اسناد خودم استفاده می‌شدند. اسناد شما ممکن است نیازمند ترجمه بخش‌های بیشتری از این فایل‌ها به RTF باشند.

از آنجا که من از این نگاشت‌ها برای مستندسازی واقعی استفاده می‌کنم، قصد دارم این بک‌اند را نگهداری کنم؛ بنابراین لطفاً هرگونه بهبودی را برای من ارسال کنید -- من با Greg هماهنگ خواهم کرد تا مطمئن شوم آن‌ها به انتشار رسمی بعدی راه می‌یابند.

(پایان نقل‌قول)

گزینه‌ها (OPTIONS)

این برنامه از گزینه‌های معمولی خط فرمان پشتیبانی نمی‌کند.

همچنین ببینید (SEE ALSO)

برای توضیحات کامل، فایل README موجود در آرشیو سورس‌کد را ببینید.

نویسندگان (AUTHORS)

rtf2rtf توسط Steve Tynor (tynor@atlanta.twr.com) در دسامبر ۱۹۹۵ نوشته شد. این صفحه راهنما توسط Taketoshi Sano <sano@debian.org> برای سیستم Debian GNU/Linux نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود). در حال حاضر توسط Agustin Martin <agustin6martin AT gmail com> نگهداری می‌شود.