.\" Copyright (C) 2000,2001,2004 by Zachary Smith
.\"
.\" Permission is granted to redistribute this file with UnRTF.
.\"
.TH UNRTF 1 "GNU UnRTF 0.21.9"
.SH "نام (NAME)"
UnRTF \- تبدیل اسناد با قالب RTF به دیگر قالب‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.BI "unrtf [" options "] [" file... ]
.br
.sp
گزینه‌ها:
.BI [\-\-nopict]
.BI [\-\-noremap]
.BI [\-P\ \%config_search_path]
.BI [\-\-html]
.BI [\-\-text]
.BI [\-\-vt]
.BI [\-\-rtf]
.BI [\-\-latex]
.BI [\-\-help]
.BI [\-\-verbose]
.BI [\-\-quiet]
.BI [\-\-version]
.BI [\-t\ tags_file]
.br
.SH "توضیحات (DESCRIPTION)"
برنامهٔ
.B unrtf
یک مبدل برای تبدیل «قالب متن غنی‌شده» (RTF) به شمار فزاینده‌ای از قالب‌های اسناد است. در حال حاضر این برنامه از «زبان نشانه‌گذاری ابرمتن» (HTML)، متن ساده، متن حاوی کدهای VT100، LaTeX و خودِ RTF پشتیبانی می‌کند.
همچنین امکان تولید پرونده‌های troff همراه با فراخوانی ماکروها وجود دارد؛ یک پیکربندی نمونه برای troff و بستهٔ ماکروی mm ارائه شده است.
تمامی قالب‌های خروجی به جز HTML در مرحلهٔ «آلفا» هستند، به این معنی که محدود بوده و توسعهٔ آن‌ها به تازگی آغاز شده است.
با این حال، در خروجی HTML برنامه از جدول‌ها، قلم‌ها، ابرپیوندها و تراز کردن بندها پشتیبانی می‌کند. پشتیبانی از قلم شامل تغییر نوع قلم و اندازه، و همچنین ویژگی‌های معمول مانند مورب (italic)، توپر (bold)، زیرخط‌دار (underlining)، خط‌خورده (strikethrough)، حروف کوچک کاپیتال (smallcaps)، تمام‌بزرگ (allcaps)، کشیده (expand)، فشرده (compress) و رنگ‌های پیش‌زمینه و پس‌زمینه است.
تصاویر همواره در پرونده‌هایی جداگانه در دایرکتوری جاری ذخیره می‌شوند، یا می‌توان مشخص کرد که نادیده گرفته شوند.
.P
از نسخهٔ 0.21.0 به بعد، تمام کنترل خروجی unrtf از طریق پرونده‌های پیکربندی زمان اجرا انجام می‌گیرد. این امر تنظیم دقیق خروجی و/یا تعریف قالب‌های خروجی جدید را برای کاربران آسان می‌سازد. پرونده‌های پیکربندی را می‌توان از موارد توزیع‌شده همراه برنامه خواند، یا از پرونده‌های کاربری که در
.I config_search_path
جستجو می‌شوند استفاده نمود.
توجه داشته باشید که ترتیب آرگومان \-P و آرگومان‌های خروجی مهم است. اگر پروندهٔ پیکربندی در مکان استاندارد نباشد، مسیر جستجو باید پیش از هر آرگومانی که آن پرونده را بارگذاری می‌کند، تنظیم شود.
.P
تبدیل کدپیج (صفحه کد) با استفاده از بستهٔ iconv(3) انجام می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-\-nopict
ذخیره‌سازی خودکار تصاویر تعبیه‌شده در دایرکتوری جاری را غیرفعال می‌کند.
.TP
\-\-noremap
تبدیل مجموعه نویسه‌ها (charset) را غیرفعال می‌کند (در حال حاضر تنها برای مجموعه‌نویسه‌های ۸ بیتی عمل می‌کند).
.TP
\-\-html
خروجی HTML را انتخاب می‌کند (پیش‌فرض).
.TP
\-\-rtf
خروجی RTF را انتخاب می‌کند. خروجی حاصل اغلب بسیار کوچک‌تر از ورودی خواهد بود.
.TP
\-\-text
خروجی متنی سادهٔ ASCII را انتخاب می‌کند.
.TP
\-\-vt
خروجی متنی حاوی کدهای گریز VT100 را انتخاب می‌کند.
.TP
\-\-latex
خروجی سند به زبان LaTeX را انتخاب می‌کند.
.TP
\-\-verbose
اطلاعات تکمیلی و دقیق‌تری را چاپ می‌کند.
.TP
\-\-quiet
از چاپ توضیحات (کامنت‌های) ابتدایی در خروجی جلوگیری می‌کند.
.TP
\-\-version
نسخهٔ برنامه را نمایش می‌دهد.
.TP
\-t tags_file
پروندهٔ پیکربندی برچسب‌های خروجیِ مورد استفاده را مشخص می‌کند. دستور
"unrtf \-t html"
از نظر عملکرد کاملاً یکسان با
"unrtf \-\-html"
است. پرونده‌های پیکربندی ساختار ساده‌ای دارند. برای تغییر رفتار unrtf، می‌توان یک رونوشت محلی از پروندهٔ پیکربندی سیستمی تهیه کرده و آن را ویرایش نمود. کامل‌ترین پروندهٔ پیکربندی و در نتیجه بهترین نقطه برای شروع، /usr/share/unrtf/html.conf است.
.TP
\-P config_search_path
دایرکتوری‌هایی را مشخص می‌کند که پروندهٔ پیکربندی برای قالب مشخص‌شده در آن‌ها جستجو می‌شود. این مسیر را می‌توان به صورت یک دایرکتوری واحد یا فهرستی از دایرکتوری‌ها که با دونقطه (colon) از هم جدا شده‌اند، ارائه داد.
مقدار پیش‌فرض /usr/share/unrtf است، یعنی جایی که پرونده‌های پیکربندی توزیع‌شده نصب شده‌اند.
.SH "فایل‌ها (FILES)"
.TP
/usr/share/unrtf/*.conf
\[en] پرونده‌های پیکربندی خروجی زمان اجرا.
.TP
/usr/share/unrtf/SYMBOL.charmap
\[en] کدگذاری UTF برای قلم SYMBOL که در بسیاری از پرونده‌های RTF به کار می‌رود. متأسفانه بستهٔ iconv شامل کدگذاری‌های مربوط به قلم‌ها نمی‌شود. قالب این فایل با پرونده‌های صفحه کد iconv همسان است.
.SH "وب‌گاه (WEBSITE)"
.UR http://\:www.gnu.org/\:software/\:unrtf/\:unrtf.html
.UE
.SH "نکات (NOTES)"
گزارش باگ‌های برنامه را به http://savannah.gnu.org/projects/unrtf ارسال کنید.