نام (NAME)

xtotroff - تبدیل فونتهای X11 و BDF به فرمت فونت groff

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

xtotroff [-d destination-directory] [-r resolution] [-s type-size] font-map

xtotroff --help

xtotroff -v

xtotroff --version

توضیحات (DESCRIPTION)

دستور xtotroff از font-map برای ایجاد فایل‌های توصیف قلم groff(1) از قلم‌های X11 استفاده می‌کند. هر خط در font-map یک نام قلم groff را با یک نام قلم X به عنوان یک الگوی توصیف منطقی قلم X (XLFD) جفت می‌کند. اجزای هر جفت با فاصله یا نویسه‌های Tab از یکدیگر جدا می‌شوند. به عنوان مثال، یک فایل ورودی font-map متشکل از خط

TB -adobe-times-bold-r-normal--*-*-*-*-p-*-iso8859-1

الگوی XLFD سمت راست را به نام قلم groff TB، که به طور سنتی “Times bold” است، نگاشت می‌کند.

دستور xtotroff یک اتصال به کارساز X در حال اجرا باز می‌کند تا کاتالوگ قلم آن را بررسی کند، و اگر نتواند متوقف می‌شود. در صورت لزوم، نویسه‌های عام (wildcard) در الگوهای XLFD با آرگومان‌های گزینه‌های -r و -s پر می‌شوند. اگر نام یک قلم همچنان مبهم باشد، xtotroff متوقف می‌شود. به ازای هر نگاشت موفق، xtotroff یک فایل توصیف قلم groff در دایرکتوری کاری فعلی (یا دایرکتوری مشخص‌شده توسط گزینه -d) به نام هر قلم groff ایجاد می‌کند و نگاشت را به جریان خروجی استاندارد گزارش می‌دهد.

گزینه‌ها (OPTIONS)

گزینه --help پیام راهنمای استفاده را نمایش می‌دهد، در حالی که -v و --version اطلاعات نگارش را نمایش می‌دهند؛ پس از آن همگی خارج می‌شوند.

-d destination-directory: نوشتن توصیف‌های قلم در destination-directory به جای دایرکتوری کاری فعلی.
-r resolution: تنظیم تفکیک‌پذیری (resolution) برای تمامی الگوهای قلم در font-map. این مقدار برای هر دو اندازه حرکت افقی و عمودی (motion quanta) استفاده می‌شود. در صورت عدم تعیین، تفکیک‌پذیری 75dpi فرض می‌شود.
-s type-size: تنظیم اندازه قلم بر حسب پوینت برای تمامی الگوهای قلم در font-map. در صورت عدم تعیین، اندازه ۱۰ پوینت فرض می‌شود.

وضعیت خروج (EXIT STATUS)

دستور xtotroff در صورت اجرای موفقیت‌آمیز با وضعیت 0، اگر برنامه نتواند آرگومان‌های خط فرمان خود را تفسیر کند با وضعیت 2، و در صورت مواجهه با خطا در حین اجرا با وضعیت 1 خارج می‌شود.

فایل‌ها (FILES)

/usr/share/groff/1.24.1/font/FontMap-X11: فایل نگاشت قلم مورد استفاده برای تولید فایل‌های توصیف قلم از‌پیش‌تولیدشده است که همراه با groff ارائه می‌شوند، مربوط به قلم‌های اصلی X11 متناظر با ۱۳ قلم پایه Type 1 برای PostScript سطح ۱.

اشکالات (BUGS)

تنها کدگذاری‌های قلم پشتیبانی‌شده “iso8859-1” و “adobe-fontspecific” هستند.

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

“X Logical Font Description Conventions”, اثر Jim Flowers و Stephen Gildea.

X(7), groff(1), gxditview(1), troff(1), groff_font(5)