نام (NAME)

gxditview - نمایش خروجی troff در سامانه پنجره‌ای X11

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

توضیحات (DESCRIPTION)

برنامه gxditview خروجی troff گنو را در یک نمایشگر سامانه پنجره‌ای X11 نمایش می‌دهد. این برنامه از قلم‌های استاندارد X11 استفاده می‌کند که توسط سرور X رندر می‌شوند.

خروجی troff(1) به یک زبان توصیف صفحه است که در groff_out(5) مستند شده است. به طور معمول، کاربران این خروجی را مشاهده نمی‌کنند زیرا پوشش groff(1) به‌طور خودکار یک راه‌انداز خروجی را برای تفسیر آن اجرا می‌کند؛ در مقابل، گزینه -Z در groff آن را در جریان خروجی استاندارد باقی می‌گذارد. این خروجی را می‌توان با فراخوانی صریح “gxditview file” مشاهده کرد. اگر عملوند file برابر “-” باشد، gxditview جریان ورودی استاندارد را خواهد خواند؛ file نمی‌تواند حذف شود. زبان توصیف صفحه troff گنو مستقل از دستگاه است اما ناآگاه از دستگاه نیست. برنامه gxditview می‌تواند آن را برای تمام دستگاه‌های حروف‌چینی نمایش دهد، اما کیفیت آن وابسته به دستگاه است. برنامه gxditview خروجی مربوط به دستگاه‌های متنی ترمینال (nroff) را نمایش نخواهد داد.

بهترین نتایج با دستگاه‌های X* برای گزینه -T در troff به دست می‌آید که چهار مورد هستند: -TX75، -TX75-12، -TX100 و -TX100-12. آن‌ها از نظر تفکیک‌پذیری X (۷۵ یا ۱۰۰ نقطه در اینچ) و اندازه پایه پوینت (۱۰ یا ۱۲ پوینت) متفاوت هستند. آن‌ها به‌طور ویژه برای gxditview ساخته شده‌اند. هنگام استفاده از یکی از این موارد، troff خروجی مناسب آن دستگاه را تولید کرده و gxditview را به‌طور خودکار برای مشاهده فراخوانی می‌کند.

گزینه -X تنها با -Tps، -TX75، -TX75-12، -TX100 و -TX100-12 نتایج خوبی تولید می‌کند. تفکیک‌پذیری پیش‌فرض برای پیش‌نمایش خروجی -Tps برابر با 75dpi است؛ این مقدار را می‌توان با گزینه -resolution تغییر داد.

هنگامی که gxditview در حال اجرا است، کلیک دکمه چپ ماوس منویی با چندین گزینه باز می‌کند.

Next Page

نمایش صفحه بعد.

Previous Page

نمایش صفحه قبل.

Select Page

دریافت شماره صفحه از یک کادر محاوره‌ای و نمایش آن.

Print

دریافت یک دستور از یک کادر محاوره‌ای و استفاده از آن برای چاپ خروجی troff. دستور پیش‌فرضی که در ابتدا نمایش داده می‌شود، توسط منبع برنامه‌ای printCommand و گزینه -printCommand کنترل می‌شود.

Open

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

Quit

خروج از gxditview.

گزینه‌های منو متناظر با کنش‌هایی با نام‌های مشابه اما نه کاملاً یکسان هستند که می‌توان از طریق کلیدهای میان‌بر صفحه‌کلید نیز به آن‌ها دسترسی پیدا کرد. کلیدهای n، Space، Return و Next (PgDn) به کنش NextPage اختصاص یافته‌اند. کلیدهای p، b، BackSpace، Delete و Prior (PgUp) به کنش PreviousPage اختصاص یافته‌اند. کلید p همراه با هر کلید تغییردهنده‌ای (Shift، Control، Alt یا Meta) به کنش Print اختصاص دارد. کلید g به کنش SelectPage اختصاص یافته است. کلید o به کنش OpenFile اختصاص یافته است. کلید q به کنش Quit اختصاص دارد. کلید r به کنش Rerasterize اختصاص یافته است که فایل جاری را دوباره می‌خواند و صفحه جاری را مجدداً نمایش می‌دهد؛ اگر فایل جاری یک دستور باشد، دستور مجدداً اجرا خواهد شد. پیمایش عمودی با کلیدهای k و j امکان‌پذیر است؛ پیمایش افقی نیز به کلیدهای h و l اختصاص داده شده است. کلیدهای جهت‌نما (بالا، پایین، چپ و راست) نیز به کنش‌های پیمایش متناظر اختصاص یافته‌اند.

دستورهای paperlength و paperwidth در فایل DESC که یک دستگاه خروجی groff را توصیف می‌کند، طول و عرض صفحه مجازی نمایش‌داده‌شده توسط gxditview را بر حسب واحدهای پایه مشخص می‌کنند؛ به groff_font(5) مراجعه کنید.

TR  -adobe-times-medium-r-normal--*-100-*-*-*-*-iso8859-1\n\
TI  -adobe-times-medium-i-normal--*-100-*-*-*-*-iso8859-1\n\
TB  -adobe-times-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
TBI -adobe-times-bold-i-normal--*-100-*-*-*-*-iso8859-1\n\
CR  -adobe-courier-medium-r-normal--*-100
        -*-*-*-*-iso8859-1\n\
CI  -adobe-courier-medium-o-normal
        --*-100-*-*-*-*-iso8859-1\n\
CB  -adobe-courier-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
CBI -adobe-courier-bold-o-normal--*-100-*-*-*-*-iso8859-1\n\
HR  -adobe-helvetica-medium-r-normal
        --*-100-*-*-*-*-iso8859-1\n\
HI  -adobe-helvetica-medium-o-normal
        --*-100-*-*-*-*-iso8859-1\n\
HB  -adobe-helvetica-bold-r-normal
        --*-100-*-*-*-*-iso8859-1\n\
HBI -adobe-helvetica-bold-o-normal
        --*-100-*-*-*-*-iso8859-1\n\
NR  -adobe-new century schoolbook-medium-r-normal--*-100
        -*-*-*-*-iso8859-1\n\
NI  -adobe-new century schoolbook-medium-i-normal--*-100
        -*-*-*-*-iso8859-1\n\
NB  -adobe-new century schoolbook-bold-r-normal--*-100
        -*-*-*-*-iso8859-1\n\
NBI -adobe-new century schoolbook-bold-i-normal--*-100
        -*-*-*-*-iso8859-1\n\
S   -adobe-symbol-medium-r-normal--*-100
        -*-*-*-*-adobe-fontspecific\n\
SS  -adobe-symbol-medium-r-normal--*-100
        -*-*-*-*-adobe-fontspecific\n\

گزینه‌ها (OPTIONS)

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

برنامه gxditview تمامی گزینه‌های استاندارد خط فرمان X Toolkit را به همراه گزینه‌های اضافی فهرست‌شده در زیر می‌پذیرد.

-page

این گزینه شماره صفحه‌ای از سند را که باید نمایش داده شود مشخص می‌کند.

-backingStore backing-store-type

از آنجا که نمایش مجدد خروجی رندرشده troff می‌تواند زمان قابل توجهی ببرد، این گزینه باعث می‌شود سرور محتویات پنجره را ذخیره کند تا هنگام پیمایش آن در درگاه نمایش (viewport)، پنجره از روی محتویات ذخیره‌شده در حافظه پشتیبان (backing store) بازترسیم شود. backing-store-type می‌تواند یکی از مقادیر Always، WhenMapped یا NotUseful باشد.

-printCommand command

دستور پیش‌فرضی که در کادر محاوره‌ای گزینه منوی Print نمایش داده می‌شود، command خواهد بود.

-resolution res

فایل خروجی troff با تفکیک‌پذیری res نقطه در اینچ نمایش داده خواهد شد، مگر اینکه فایل DESC شامل دستورالعمل X11 باشد که در این صورت از تفکیک‌پذیری دستگاه استفاده خواهد شد. این مورد متناظر با منبع resolution در ویجت Dvi است. مقدار پیش‌فرض 75 است.

-filename string

نام فایل پیش‌فرضی که در کادر محاوره‌ای گزینه منوی Open نمایش داده می‌شود، string خواهد بود. این می‌تواند نام یک فایل یا دستوری باشد که با “|” آغاز می‌شود.

آرگومان‌های استاندارد خط فرمان X Toolkit زیر معمولاً به همراه gxditview استفاده می‌شوند.

-bg color

این گزینه رنگ مورد استفاده برای پس‌زمینه پنجره را مشخص می‌کند. مقدار پیش‌فرض “white” است.

-bd color

این گزینه رنگ مورد استفاده برای حاشیه پنجره را مشخص می‌کند. مقدار پیش‌فرض “black” است.

-bw number

این گزینه عرض حاشیه اطراف پنجره را بر حسب پیکسل مشخص می‌کند.

-fg color

این گزینه رنگ مورد استفاده برای نمایش متن را مشخص می‌کند. مقدار پیش‌فرض “black” است.

-fn font

این گزینه قلم مورد استفاده برای نمایش متن ویجت را مشخص می‌کند. مقدار پیش‌فرض “fixed” است.

-rv

این گزینه مشخص می‌کند که تصویر معکوس (reverse video) با جابه‌جایی رنگ‌های پیش‌زمینه و پس‌زمینه شبیه‌سازی شود.

-geometry geometry

این گزینه اندازه و موقعیت ترجیحی پنجره را مشخص می‌کند.

-display host:display

این گزینه سرور X مورد نظر را برای اتصال مشخص می‌کند.

-xrm resourcestring

این گزینه یک رشته منبع (resource string) را برای استفاده مشخص می‌کند.

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

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

محیط (ENVIRONMENT)

GROFF_FONT_PATH

فهرستی از دایرکتوری‌ها برای جستجوی دایرکتوری پرونده‌های توصیف قلم و دستگاه خروجی انتخاب‌شده. به troff(1) و groff_font(5) مراجعه کنید.

فایل‌ها (FILES)

/usr/lib/X11/app-defaults/GXditview

/usr/lib/X11/app-defaults/GXditview-color

پیش‌فرض‌های برنامه X را برای gxditview تعریف می‌کنند. کاربران می‌توانند این مقادیر را در فایل .Xdefaults، که معمولاً در دایرکتوری خانگی کاربر قرار دارد، بازنویسی کنند. به appres(1) و xrdb(1) مراجعه کنید.

/usr/share/groff/1.24.1/font/devX100/DESC

دستگاه خروجی X100 را توصیف می‌کند.

/usr/share/groff/1.24.1/font/devX100/F

قلم شناخته‌شده به عنوان F را در دستگاه X100 توصیف می‌کند.

/usr/share/groff/1.24.1/font/devX100-12/DESC

دستگاه خروجی X100-12 را توصیف می‌کند.

/usr/share/groff/1.24.1/font/devX100-12/F

قلم شناخته‌شده به عنوان F را در دستگاه X100-12 توصیف می‌کند.

/usr/share/groff/1.24.1/font/devX75/DESC

دستگاه خروجی X75 را توصیف می‌کند.

/usr/share/groff/1.24.1/font/devX75/F

قلم شناخته‌شده به عنوان F را در دستگاه X75 توصیف می‌کند.

/usr/share/groff/1.24.1/font/devX75-12/DESC

دستگاه خروجی X75-12 را توصیف می‌کند.

/usr/share/groff/1.24.1/font/devX75-12/F

قلم شناخته‌شده به عنوان F را در دستگاه X75-12 توصیف می‌کند.

/usr/share/groff/1.24.1/tmac/X.tmac

ماکروهایی را برای استفاده به همراه دستگاه‌های خروجی X100، X100-12، X75 و X75-12 تعریف می‌کند. این فایل هنگام انتخاب هر یک از این دستگاه‌های خروجی، به‌طور خودکار توسط troffrc بارگذاری می‌شود.

/usr/share/groff/1.24.1/tmac/Xps.tmac

تنظیمات troff را برای استفاده از gxditview به عنوان یک پیش‌نمایشگر برای خروجی مستقل از دستگاه با هدف دستگاه خروجی ps آماده می‌سازد. این فایل هنگامی که گزینه‌های -X و -Tps به troff داده شوند، به‌طور خودکار توسط troffrc بارگذاری می‌شود.

مثال‌ها (EXAMPLES)

دستور زیر این صفحه راهنما را با اندازه پوینت پایه ۱۲ نمایش می‌دهد.

groff -TX100-12 -man gxditview.1

کیفیت نتیجه عمدتاً به اندازه پوینت انتخاب‌شده و تفکیک‌پذیری نمایشگر بستگی دارد؛ با این حال برای پیش‌نمایش سریع، دستوری مانند

groff -X -P-resolution -P100 document

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

برنامه gxditview و نسخه پیشین آن xditview توسط Keith Packard (MIT X Consortium)، Richard L. Hyde (Purdue)، David Slattengren (Berkeley)، Malcolm Slaney (Schlumberger Palo Alto Research)، Mark Moraes (University of Toronto) و James Clark نوشته شده‌اند.

این برنامه برگرفته از xditview است؛ بخش‌هایی از xditview از xtroff نشأت گرفته‌اند که آن نیز از suntroff برگرفته شده بود.

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

“X Logical Font Description Conventions”، نوشته Jim Flowers و Stephen Gildea.

X(7), xrdb(1), xditview(1), groff(1), groff_out(5)