نام (NAME)

grodvi - راه‌انداز خروجی groff برای قالب TeX DVI

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

grodvi [-dl] [-F dir] [-p paper-format] [-w n] [file ...]

grodvi --help

grodvi -v

grodvi --version

توضیحات (DESCRIPTION)

راه‌انداز خروجی DVI در GNU roff خروجی troff(1) را به قالب DVI در TeX ترجمه می‌کند. به‌طور معمول، grodvi توسط groff(1) فراخوانی می‌شود، هنگامی که گزینه “-T dvi” به آن داده شده باشد. (در این نصب، ps دستگاه خروجی پیش‌فرض است.) برای ارسال هر یک از گزینه‌های بالا به grodvi، از گزینه -P در groff استفاده کنید. اگر هیچ آرگومان file (پرونده) داده نشود، یا اگر file برابر با “-” باشد، grodvi ورودی استاندارد را می‌خواند. این برنامه در خروجی استاندارد می‌نویسد.

فایل DVI تولیدشده توسط grodvi توسط هر راه‌انداز DVI که به‌درستی نوشته شده باشد قابل تفسیر است. دستورات پایه‌ای رسم در troff با استفاده از دستورات ویژه نسخه 2 در tpic پیاده‌سازی شده‌اند. اگر راه‌انداز از این موارد پشتیبانی نکند، توالی‌های گریز \D هیچ خروجی‌ای تولید نخواهند کرد.

فایل‌های پست‌اسکریپت کپسوله‌شده (EPS) را می‌توان به‌آسانی درج کرد؛ از ماکروی PSPIC استفاده کنید. فایل pspic.tmac به‌طور خودکار توسط dvi.tmac بارگذاری می‌شود. groff_tmac(5) را ببینید.

رنگ پیش‌فرض استفاده‌شده توسط توالی‌های گریز \m و \M سیاه است. در حال حاضر، رنگ خط برای توالی‌های گریز رسم \D سیاه است؛ مقادیر رنگ پر کردن به خاکستری تبدیل می‌شوند.

در groff، همانند troff مربوط به AT&T، توالی گریز \N می‌تواند برای دسترسی به هر گلیف در قلم جاری از طریق موقعیت آن در فایل TFM متناظر استفاده شود.

بر اساس طراحی، فرمت DVI اهمیتی به ابعاد فیزیکی رسانه خروجی نمی‌دهد. زیربخش “دستورات افزونه دستگاه” در زیر را ببینید.

سبک‌های قلم (Typefaces)

grodvi از چهار سبک استاندارد پشتیبانی می‌کند: R (رومی / roman)، I (مورب / italic)، B (توپر / bold)، و BI (توپر مورب / bold-italic). قلم‌ها به دو خانواده T و H گروه‌بندی شده‌اند که دارای اعضایی در هر سبک هستند. عبارت “CM” مخفف “Computer Modern” است.

TR: CM Roman (cmr10)
TI: CM Text Italic (cmti10)
TB: CM Bold Extended Roman (cmbx10)
TBI: CM Bold Extended Text Italic (cmbxti10)
HR: CM Sans Serif (cmss10)
HI: CM Slanted Sans Serif (cmssi10)
HB: CM Sans Serif Bold Extended (cmssbx10)
HBI: CM Slanted Sans Serif Bold Extended (cmssbxo10)

قلم‌های زیر عضو هیچ خانواده‌ای نیستند:

CW: CM Typewriter Text (cmtt10)
CWI: CM Italic Typewriter Text (cmitt10)

قلم‌های ویژه شامل MI (cmmi10)، S (cmsy10)، EX (cmex10)، SC (cmtex10، فقط برای CW)، و شاید در کمال تعجب، TR، TI و CW است، چرا که TeX برخی گلیف‌ها را در قلم‌های متنی قرار می‌دهد که troff معمولاً چنین کاری نمی‌کند. برای قلم‌های مورب، CWI به‌جای CW استفاده می‌شود.

در نهایت، قلم‌های نماد انجمن ریاضی آمریکا (AMS) به‌عنوان قلم‌های ویژه SA (msam10) و SB (msbm10) در دسترس هستند. این قلم‌ها به‌طور پیش‌فرض سوار (mount) نشده‌اند.

شما می‌توانید فایل ماکروی ec.tmac را بارگذاری کنید تا به‌جای قلم‌های CM از قلم‌های EC و TC استفاده نمایید که به آن‌ها شباهت دارند. آن‌ها همچنین گلیف‌های یورو \[Eu] و در هزار \[%0] را فراهم می‌کنند. این کار را پیش از بارگذاری فایل‌های ماکروی بومی‌سازی انجام دهید، زیرا ec.tmac کدهای خط‌فاصله‌گذاری خودکار را تنظیم نمی‌کند.

دستورات افزونه دستگاه (Device extension commands)

grodvi معادل دستور \special{papersize=width,length} در TeX را در صفحه نخست ارسال می‌کند؛ سپس dvips (یا یک راه‌انداز DVI دیگر) اندازه صفحه را بر همان اساس تنظیم می‌کند. اگر پهنا یا طول صفحه مثبت نباشد، هیچ دستور ویژه papersize خروجی داده نمی‌شود.

grodvi از یک افزونه دستگاه پشتیبانی می‌کند که با استفاده از درخواست device در groff یا توالی گریز \X در roff قابل دسترسی است.

\X'papersize=width,length': ابعاد صفحه را بر حسب سانتی‌متر روی width (پهنا) در length (طول) تنظیم می‌کند. اگر گزینه -l مشخص شده باشد، این ابعاد جابه‌جا می‌شوند. تغییرات در ابعاد کاغذ باید پیش از صفحه نخست یا در حین خروج صفحه قبل از شروع صفحه بعدی رخ دهد.

: احتیاط: ترتیب ابعاد با آنچه توسط papersize.tmac و گزینه “-d paper” در troff(1) استفاده می‌شود متفاوت است.

پارامتر(های) داده‌شده به device و \X به همان دستورالعمل‌های فایل DVI ترجمه می‌شوند که توسط \special{anything} در TeX تولید می‌شدند؛ anything نمی‌تواند شامل خط جدید (newline) باشد.

فایل‌های توصیف قلم (Font description files)

از tfmtodit(1) برای ایجاد فایل‌های توصیف قلم groff از روی فایل‌های TFM (سنجه‌های قلم TeX) استفاده کنید. فایل توصیف قلم باید شامل دستورالعمل‌های اضافی زیر باشد که tfmtodit به‌طور خودکار آن‌ها را تولید می‌کند.

internalname name: نام فایل TFM (بدون پسوند .tfm) برابر با name است.
checksum n: مجموع مقابله‌ای (checksum) در فایل TFM برابر با n است.
designsize n: اندازه طراحی در فایل TFM برابر با n است.

دستورات رسم (Drawing commands)

grodvi از یک دستور رسم اضافی پشتیبانی می‌کند.

\D'R dh dv': یک خط‌کش یا مستطیل توپر (مستطیل سیاه توپر) رسم می‌کند که یک گوشه آن در موقعیت رسم فعلی، و گوشه قطری مقابل آن در موقعیت رسم +(dh,dv) قرار دارد که پس از آن به موقعیت رسم جدید تبدیل می‌شود. این دستور یک خط‌کش (rule) در فایل DVI تولید می‌کند و بنابراین بر خلاف سایر دستورات \D، حتی با راه‌اندازی که از دستورات ویژه tpic پشتیبانی نمی‌کند نیز قابل چاپ است.

گزینه‌ها (OPTIONS)

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

-d: از دستورات ویژه tpic برای پیاده‌سازی دستورات رسم استفاده نمی‌کند. خطوط افقی و عمودی با استفاده از خط‌کش‌ها (rules) پیاده‌سازی می‌شوند. سایر دستورات رسم نادیده گرفته می‌شوند.
-F dir: شاخه dir/devname را به ابتدای مسیر جستجو برای فایل‌های توصیف قلم و دستگاه اضافه می‌کند؛ name نام دستگاه است که معمولاً dvi می‌باشد.
-l: به‌جای جهت عمودی (portrait) از جهت افقی (landscape) استفاده می‌کند.
-p paper-format: ابعاد فیزیکی رسانه خروجی را تعیین می‌کند و دستورالعمل‌های papersize، paperlength و paperwidth را در فایل DESC نادیده می‌گیرد (بازنویسی می‌کند). paper-format می‌تواند هر آرگومانی باشد که توسط دستورالعمل papersize پذیرفته می‌شود؛ groff_font(5) را ببینید.
-w n: خط‌کش‌ها (خطوط) را با ضخامت n هزارم یک em رسم می‌کند. ضخامت پیش‌فرض 40 (0.04 em) است.

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

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

محیط (ENVIRONMENT)

GROFF_FONT_PATH: فهرستی از دایرکتوری‌ها را مشخص می‌کند که باید در آن‌ها به دنبال devdvi، شاخه فایل‌های توصیف قلم و دستگاه grodvi، جستجو شود. troff(1) و groff_font(5) را ببینید.

فایل‌ها (FILES)

/usr/share/groff/1.24.1/font/devdvi/DESC: دستگاه خروجی dvi را توصیف می‌کند.
/usr/share/groff/1.24.1/font/devdvi/F: قلم شناخته‌شده با نام F را بر روی دستگاه dvi توصیف می‌کند.
/usr/share/groff/1.24.1/tmac/dvi.tmac: نگاشت‌های قلم، نویسه‌های ویژه و رنگ‌ها را برای استفاده با دستگاه خروجی dvi تعریف می‌کند. این فایل هنگام انتخاب دستگاه خروجی dvi به‌طور خودکار توسط troffrc بارگذاری می‌شود.
/usr/share/groff/1.24.1/tmac/ec.tmac: دستگاه خروجی dvi را به گونه‌ای پیکربندی می‌کند که به‌جای خانواده قلم‌های CM (Computer Modern) از خانواده قلم‌های EC و TC استفاده کند.

اشکالات (BUGS)

فایل‌های DVI تولیدشده توسط grodvi از تفکیک‌پذیری متفاوتی (۵۷٬۸۱۶ واحد در هر اینچ) نسبت به فایل‌های تولیدشده توسط TeX استفاده می‌کنند. راه‌اندازهایی که به‌اشتباه نوشته شده‌اند و به‌جای استفاده از وضوح مشخص‌شده در فایل DVI، وضوح استفاده‌شده توسط TeX را فرض می‌کنند، با grodvi کار نخواهند کرد.

هنگام استفاده از گزینه -d با جدول‌های کادربندی‌شده، خطوط افقی و عمودی گاهی اوقات می‌توانند به اندازه یک پیکسل بیرون بزنند. این امر نتیجه روشی است که TeX بر اساس آن الزام می‌کند که ارتفاع و پهنای خط‌کش‌ها گرد شوند.

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

“قلم‌های EC چه هستند؟”; TeX FAQ: فهرست پرسش‌های متداول برای TeX

tfmtodit(1), groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7), groff_tmac(5)