| UNRTF(1) | General Commands Manual | UNRTF(1) |
نام (NAME)
UnRTF - تبدیل اسناد با قالب RTF به دیگر قالب‌ها
خلاصه دستور (SYNOPSIS)
unrtf [options] [file...]
گزینه‌ها: [--nopict] [--noremap] [-P config_search_path] [--html] [--text] [--vt] [--rtf] [--latex] [--help] [--verbose] [--quiet] [--version] [-t tags_file]
توضیحات (DESCRIPTION)
برنامهٔ unrtf یک مبدل برای تبدیل «قالب متن غنی‌شده» (RTF) به شمار فزاینده‌ای از قالب‌های اسناد است. در حال حاضر این برنامه از «زبان نشانه‌گذاری ابرمتن» (HTML)، متن ساده، متن حاوی کدهای VT100، LaTeX و خودِ RTF پشتیبانی می‌کند. همچنین امکان تولید پرونده‌های troff همراه با فراخوانی ماکروها وجود دارد؛ یک پیکربندی نمونه برای troff و بستهٔ ماکروی mm ارائه شده است. تمامی قالب‌های خروجی به جز HTML در مرحلهٔ «آلفا» هستند، به این معنی که محدود بوده و توسعهٔ آن‌ها به تازگی آغاز شده است. با این حال، در خروجی HTML برنامه از جدول‌ها، قلم‌ها، ابرپیوندها و تراز کردن بندها پشتیبانی می‌کند. پشتیبانی از قلم شامل تغییر نوع قلم و اندازه، و همچنین ویژگی‌های معمول مانند مورب (italic)، توپر (bold)، زیرخط‌دار (underlining)، خط‌خورده (strikethrough)، حروف کوچک کاپیتال (smallcaps)، تمام‌بزرگ (allcaps)، کشیده (expand)، فشرده (compress) و رنگ‌های پیش‌زمینه و پس‌زمینه است. تصاویر همواره در پرونده‌هایی جداگانه در دایرکتوری جاری ذخیره می‌شوند، یا می‌توان مشخص کرد که نادیده گرفته شوند.
از نسخهٔ 0.21.0 به بعد، تمام کنترل خروجی unrtf از طریق پرونده‌های پیکربندی زمان اجرا انجام می‌گیرد. این امر تنظیم دقیق خروجی و/یا تعریف قالب‌های خروجی جدید را برای کاربران آسان می‌سازد. پرونده‌های پیکربندی را می‌توان از موارد توزیع‌شده همراه برنامه خواند، یا از پرونده‌های کاربری که در config_search_path جستجو می‌شوند استفاده نمود. توجه داشته باشید که ترتیب آرگومان -P و آرگومان‌های خروجی مهم است. اگر پروندهٔ پیکربندی در مکان استاندارد نباشد، مسیر جستجو باید پیش از هر آرگومانی که آن پرونده را بارگذاری می‌کند، تنظیم شود.
تبدیل کدپیج (صفحه کد) با استفاده از بستهٔ iconv(3) انجام می‌شود.
گزینه‌ها (OPTIONS)
- --nopict
- ذخیره‌سازی خودکار تصاویر تعبیه‌شده در دایرکتوری جاری را غیرفعال می‌کند.
- --noremap
- تبدیل مجموعه نویسه‌ها (charset) را غیرفعال می‌کند (در حال حاضر تنها برای مجموعه‌نویسه‌های ۸ بیتی عمل می‌کند).
- --html
- خروجی HTML را انتخاب می‌کند (پیش‌فرض).
- --rtf
- خروجی RTF را انتخاب می‌کند. خروجی حاصل اغلب بسیار کوچک‌تر از ورودی خواهد بود.
- --text
- خروجی متنی سادهٔ ASCII را انتخاب می‌کند.
- --vt
- خروجی متنی حاوی کدهای گریز VT100 را انتخاب می‌کند.
- --latex
- خروجی سند به زبان LaTeX را انتخاب می‌کند.
- --verbose
- اطلاعات تکمیلی و دقیق‌تری را چاپ می‌کند.
- --quiet
- از چاپ توضیحات (کامنت‌های) ابتدایی در خروجی جلوگیری می‌کند.
- --version
- نسخهٔ برنامه را نمایش می‌دهد.
- -t tags_file
- پروندهٔ پیکربندی برچسب‌های خروجیِ مورد استفاده را مشخص می‌کند. دستور "unrtf -t html"; از نظر عملکرد کاملاً یکسان با "unrtf --html" است. پرونده‌های پیکربندی ساختار ساده‌ای دارند. برای تغییر رفتار unrtf، می‌توان یک رونوشت محلی از پروندهٔ پیکربندی سیستمی تهیه کرده و آن را ویرایش نمود. کامل‌ترین پروندهٔ پیکربندی و در نتیجه بهترین نقطه برای شروع، /usr/share/unrtf/html.conf است.
- -P config_search_path
- دایرکتوری‌هایی را مشخص می‌کند که پروندهٔ پیکربندی برای قالب مشخص‌شده در آن‌ها جستجو می‌شود. این مسیر را می‌توان به صورت یک دایرکتوری واحد یا فهرستی از دایرکتوری‌ها که با دونقطه (colon) از هم جدا شده‌اند، ارائه داد. مقدار پیش‌فرض /usr/share/unrtf است، یعنی جایی که پرونده‌های پیکربندی توزیع‌شده نصب شده‌اند.
فایل‌ها (FILES)
- /usr/share/unrtf/*.conf
- – پرونده‌های پیکربندی خروجی زمان اجرا.
- /usr/share/unrtf/SYMBOL.charmap
- – کدگذاری UTF برای قلم SYMBOL که در بسیاری از پرونده‌های RTF به کار می‌رود. متأسفانه بستهٔ iconv شامل کدگذاری‌های مربوط به قلم‌ها نمی‌شود. قالب این فایل با پرونده‌های صفحه کد iconv همسان است.
وب‌گاه (WEBSITE)
نکات (NOTES)
گزارش باگ‌های برنامه را به http://savannah.gnu.org/projects/unrtf ارسال کنید.
| GNU UnRTF 0.21.9 |