قلمها (Typefaces)

سبک‌های موسوم به R، I، B و BI در موقعیت‌های قلم ۱ تا ۴ بارگذاری می‌شوند. قلم‌های متنی در خانواده‌های A، BM، C، H، HN، N، P و T گروه‌بندی می‌شوند که هر یک شامل اعضایی در هر یک از این سبک‌ها هستند.

یک قلم متنی دیگر عضو هیچ خانواده‌ای نیست.

قلم‌های ویژه عبارتند از: S، قلم Symbol در PostScript؛ SS، زیرمجموعه‌ای از S با حروف کوچک مورب یونانی؛ EURO، که گلیف یورو را در چندین سبک برای استفاده در دستگاه‌های قدیمی فاقد آن فراهم می‌کند؛ و ZD، Zapf Dingbats. برخلاف grops، ابزار gropdf به نگارش معکوس آن (ZDR) نیازی ندارد؛ گلیف “دست اشاره‌کننده به چپ” (\[lh]) با این وجود همچنان در دسترس است، زیرا pdf.tmac آن را با استفاده از دستور گسترش دستگاهِ \X'pdf: xrev' تعریف می‌کند (پایین‌تر را ببینید). برخی از گلیف‌ها در این قلم‌ها بی‌نام هستند و باید با استفاده از دنباله فرار \N به عنوان نویسه‌های دارای اندیس مورد دسترسی قرار گیرند.

قلم‌های متناظر با EURO و SS برای استاندارد PDF ناشناخته هستند؛ بنابراین groff فایل‌های AFM (معیارهای ابعادی قلم) و فایل‌های PFA یا PFB آنها را ارائه می‌دهد تا بتوان از آنها در نرم‌افزارهای دیگر استفاده کرد و در خروجی PDF تعبیه (جاسازی) نمود.

سطوح سرویس ویژگی و پشتیبانی قلم URW (Feature service levels and URW font support)

قلم‌های سنتی Type 1 در PostScript از نظر مجموعه گلیف‌های خود محدود هستند، و نسخه‌های اصلی عرضه‌شده از ریخته‌گری Adobe نرم‌افزار آزاد نیستند. از نظر تاریخی، از آنجا که حضور آن‌ها توسط استاندارد PostScript الزامی شده بود، می‌شد انتظار داشت که در هر دستگاه منطبق با استاندارد یا رندرکننده نرم‌افزاری PostScript از آن‌ها پشتیبانی شود. استاندارد PostScript (“Level 1”) در ابتدا ۱۴ تایپ‌فیس را استانداردسازی کرد: Times، Helvetica و Courier هر کدام در چهار سبک (که groff آن‌ها را در “خانواده‌ها” گروه‌بندی می‌کند)؛ یک قلم نماد (symbol)؛ و یک قلم dingbats. نسخه PostScript Level 2 این تعداد را به ۳۵ افزایش داد، و خانواده‌های Avant Garde، Bookman، Helvetica Narrow، New Century Schoolbook و Palatino؛ و یک قلم متنی در یک سبک، Zapf Chancery medium italic را افزود. یک سند می‌توانست کم‌حجم باشد چرا که نیازی به جاسازی منابع قلم در آن نبود، مگر آنکه نیازمندی‌های غیرمعمولی (برای آن دوران) از نظر گلیف یا تایپ‌فیس داشت. این وضعیت به سال‌های آغازینِ زبان توصیف صفحه جانشین PostScript، یعنی PDF نیز سرایت کرد. امروزه، جاسازی قلم‌ها در فایل‌های PDF امری رایج است، و مراجع معتبر این شیوه را به‌طور گسترده توصیه می‌کنند، رویکردی که قابلیت اطمینان رندر سند را افزایش می‌دهد، و قلم‌های نرم‌افزار آزاد فراوانی در دسترس هستند که پوشش گلیف بسیار بیشتری نسبت به قلم‌های Type 1 شرکت Adobe برای PostScript دارند.

دستور gropdf تلاش می‌کند در سناریوهای گوناگونی کار کند، و هنگامی که با فایل‌های قلم دیجیتال پشتیبان (برای جاسازی) و فایل‌های متریک قلم که این قلم‌ها را برای قالب‌بندی‌کننده توصیف می‌کنند پیکربندی شود، نتایج بهتری ارائه می‌دهد.

•

سطح Full service (سرویس کامل) زمانی در دسترس است که gropdf بتواند هر ۳۵ قلم استاندارد PostScript Level 2 را روی سیستم فایل به همراه فایل‌های متریک قلم متناظر آن‌ها (AFM) پیدا کند. ریخته‌گری بی‌نام سازگار با Adobe (پیش‌فرض) حداکثر از ۲۵۶ گلیف در هر تایپ‌فیس پشتیبانی می‌کند. قلم‌های ریخته‌گری URW (“U”) افزونه‌های سازگار با قلم‌های Adobe هستند که پوشش گلیف گسترده‌تری دارند، از جمله پشتیبانی از خط سیریلیک. فرآیند ساخت groff از afmtodit(1) برای تولید فایل‌های توصیف قلم از فایل‌های AFM ریخته‌گری URW استفاده می‌کند؛ بخش “فایل‌ها (FILES)” در زیر را ببینید.

•

سطح Intermediate service (سرویس میانی) زمانی در دسترس است که gropdf بتواند هر ۳۵ قلم استاندارد PostScript Level 2 را پیدا کند، اما فایل‌های متریک قلم متناظر آن‌ها (AFM) در دسترس نباشند. فرآیند ساخت groff فایل‌های توصیف قلم را از فایل‌های مربوط به درایور grops(1) کپی کرده، و از آن‌ها مجدداً برای gropdf استفاده می‌کند؛ این کار پوشش گلیف را برای هر تایپ‌فیس به حداکثر ۲۵۶ گلیف کاهش می‌دهد، و ریخته‌گری “U” در دسترس نخواهد بود.

•

سطح Basic service (سرویس پایه) زمانی حاصل می‌شود که gropdf نتواند هر ۳۵ قلم استاندارد PostScript Level 2 را پیدا کند. تنها ۱۴ قلم پایه استاندارد PDF در دسترس خواهند بود، و آن هم فقط از این حیث که قالب‌بندی‌کننده می‌تواند از متریک‌های آن‌ها استفاده کند (که همان‌طور که در بالا شرح داده شد، از توصیف‌های قلم grops کپی شده‌اند). استفاده از گزینه -e برای جاسازی قلم‌ها در PDF تولیدشده، منجر به بروز خطا می‌شود.

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

gropdf از افزونه‌های دستگاه متعددی پشتیبانی می‌کند، که با درخواست groff به نام device یا توالی گریز roff \X قابل دسترسی هستند. نخست، این برنامه بسیاری از افزونه‌های دستگاه پشتیبانی‌شده توسط grops(1) را درک می‌کند.

\X'ps: invis'

جلوگیری از چاپ خروجی (پنهان‌سازی خروجی).

\X'ps: endinvis'

پایان پنهان‌سازی خروجی.

\X'ps: exec gsave currentpoint 2 copy translate n rotate neg exch neg exch translate'

که در آن n زاویه چرخش است. این برای پشتیبانی از دستور align در pic(1) است.

\X'ps: exec grestore'

توسط pic(1) برای بازگردانی وضعیت پس از چرخش استفاده می‌شود.

\X'ps: exec n setlinejoin'

که در آن n می‌تواند یکی از مقادیر زیر باشد:

0 = اتصال فارسی‌بر (Miter join)
1 = اتصال گرد (Round join)
2 = اتصال پخ‌دار (Bevel join)

\X'ps: exec n setlinecap'

که در آن n می‌تواند یکی از مقادیر زیر باشد:

0 = لبه تخت (Butt cap)
1 = لبه گرد (Round cap)، و
2 = لبه مربعی برآمده (Projecting square cap)

gropdf همچنین از زیرمجموعه‌ای از دستورات معرفی‌شده در present.tmac مربوط به gpresent پشتیبانی می‌کند.

این دستورات به شما امکان می‌دهند پرونده‌های PDF ارائه‌ای (اسلاید) ایجاد کنید. بسیاری از دستورات دیگر در حال حاضر در سایر بسته‌های ماکرو موجود هستند.

این دستورات با دستورات X در groff پیاده‌سازی شده‌اند:-

\X'ps: exec %%%%PAUSE'

بخش قبل از این به عنوان یک بلوک در نظر گرفته می‌شود و با استفاده از تنظیمات گذر (transition) فعلی BLOCK معرفی می‌گردد (بخش “\X'pdf: transition'” در زیر را ببینید). به طور معادل، ماکروی .pdfpause نیز در دسترس است.

\X'ps: exec %%%%BEGINONCE'

هر متنی که پس از این دستور بیاید (تا %%%%ENDONCE) تنها یک بار نشان داده می‌شود؛ دستور %%%%PAUSE بعدی آن را حذف خواهد کرد. اگر در حال تولید یک PDF غیرارائه‌ای هستید، یعنی نادیده گرفتن مکث‌ها (به GROPDF_NOSLIDE در زیر مراجعه کنید)، این متن نادیده گرفته می‌شود.

\X'ps: exec %%%%ENDONCE'

این دستور بلوک تعریف‌شده با %%%%BEGINONCE را خاتمه می‌دهد. این جفت دستور چیزی است که دستورات .BLOCKS Once/.BLOCKE را در present.tmac پیاده‌سازی می‌کند.

بسته ماکروی mom پیش‌تر این افزونه‌ها را یکپارچه کرده است، بنابراین می‌توانید با mom اسلاید بسازید.

اگر از present.tmac همراه با gropdf استفاده کنید نیازی به اجرای برنامه presentps(1) نیست، چرا که خروجی از قبل یک PDF ارائه‌ای خواهد بود.

تمامی برچسب‌های دیگر ps: بدون اعلان نادیده گرفته می‌شوند.

gropdf همچنین یک افزونه دستگاه را که توسط درایور DVI استفاده می‌شود، تشخیص می‌دهد.

\X'papersize=width,length'

ابعاد صفحه را بر حسب سانتی‌متر روی width در length تنظیم می‌کند. اگر گزینه -l مشخص شده باشد، این ابعاد جابه‌جا می‌شوند. تغییرات در ابعاد کاغذ باید پیش از صفحه نخست، یا در حین خروج صفحه قبل از شروع صفحه بعدی اعمال شود.

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

\X'pdf: markstart /ANN-definition'

\X'pdf: markend'

ماکروهایی که از قابلیت‌های PDF پشتیبانی می‌کنند از این دستورات افزونه به صورت داخلی برای احاطه کردن متن نقطه حساس (hotspot) (یک ابرپیوند) استفاده می‌کنند. اسناد کاربری در عوض باید ماکروی .pdfhref را فراخوانی کنند. کاربرد آن‌ها در سایر بسته‌های ماکرو یافت می‌شود (مانند groff_man(7) یا groff_mdoc(7)) که .pdfhref را با یک آرگومان -S فراخوانی کرده، سپس پایان متن نقطه حساس را با \X'pdf: markend'\m[\*[pdf:curcol]] مشخص می‌کنند.

\X'pdf: xrev'

تغییر وضعیت معکوس‌سازی جهت گلیف‌ها (نشانه‌ها). این قابلیت با معکوس کردن تمامی متن‌های بعدی کار می‌کند. هر حرف جداگانه نیز آینه‌ای می‌شود. یک کاربرد آن، معکوس‌سازی گلیف‌ها در قلم Zapf Dingbats است. برای بازگردانی جهت عادی گلیف‌ها، دستور را تکرار کنید.

gropdf از چندین افزونه دستگاه دیگر با استفاده از برچسب pdf: پشتیبانی می‌کند. موارد زیر دارای ماکروهای تسهیل‌کننده مشابهی هستند که همان آرگومان‌ها را می‌پذیرند و رفتاری یکسان دارند.

.pdfbackground cmd left top right bottom weight

.pdfbackground off

.pdfbackground footnote bottom

\X'pdf: background cmd left top right bottom weight'

\X'pdf: background off'

\X'pdf: background footnote bottom'

یک مستطیل پس‌زمینه در صفحه ایجاد می‌کند.

.pdfmarksuspend

.pdfmarkrestart

\X'pdf: marksuspend'

\X'pdf: markrestart'

اگر برای ایجاد سربرگ یا پانویس، یا به گونه‌ای دیگر برای ایجاد وقفه در متن سند از یک تله مکانی صفحه استفاده می‌کنید، در صورتی که یک نقطه حساس (hotspot) در PDF از مرز تله عبور کند، باید از این دستورات استفاده نمایید؛ در غیر این صورت هر متنی که توسط تله خروجی داده شود، به عنوان بخشی از نقطه حساس علامت‌گذاری خواهد شد. برای جلوگیری از این خطا، این توالی‌های گریز افزونه دستگاه یا ماکروهای تسهیل‌کننده متناظر آن‌ها یعنی .pdfmarksuspend و .pdfmarkrestart را به ترتیب در ابتدا و انتهای ماکروی تله قرار دهید.

.pdfpagename name

\X'pdf: pagename name'

اختصاص یک name (نام) به صفحه فعلی. همه اسناد دارای دو نام پیش‌فرض ‘top’ و ‘bottom’ هستند.

.pdfpagenumbering type prefix start

\X'pdf: pagenumbering type prefix start'

.pdfpic file alignment width height line-length

\X'pdf: pdfpic file alignment width height line-length'

تصویری را از فایل file با width (عرض) و height (ارتفاع) دلخواه درج می‌کند (اگر height مشخص نشده یا صفر باشد، اندازه آن متناسب تغییر مقیاس می‌یابد). اگر alignment برابر با -L باشد، طرح چپ‌چین می‌شود. اگر برابر با -C یا -R باشد، تعیین یک line-length بزرگ‌تر از عرض طرح نیز الزامی است. اگر width صفر مشخص شده باشد، عرض متناسب با ارتفاع تغییر مقیاس می‌دهد. اگر هر دو مقدار width و height غیر صفر باشند، تصویر به حالت «بهترین برازش» (‘best fit’) تغییر مقیاس می‌یابد.

در دسترس بودن سایر نرم‌افزارها روی سیستم، مانند PerlMagick، بر انواع فایل‌های تصویری که gropdf می‌تواند در خروجی خود جاسازی کند اثر می‌گذارد.

	none	file(1)	identify(1)	Image::Magick(3pm)
.pdf	✓	✓	✓	✓
.jpg	✗	✓	✓	✓
.jp2	✗	✗	✓	✓
other	✗	✗	✗	✓

برای توضیحات ماکروی PDFPIC که یک رابط سطح‌بالا و راحت را برای گنجاندن فرمت‌های مختلف فایل گرافیکی فراهم می‌کند، به groff_tmac(5) مراجعه کنید.

.pdfswitchtopage when name

\X'pdf: switchtopage when name'

به‌طور معمول هر صفحه جدید به انتهای سند افزوده می‌شود؛ این دستور امکان درج صفحات بعدی را در یک موقعیت ‘named’ (نام‌گذاری‌شده) درون سند فراهم می‌سازد (دستور pagename در بالا را ببینید). ‘when’ می‌تواند ‘after’ یا ‘before’ باشد. اگر حذف شود، مقدار پیش‌فرض آن ‘before’ است. این دستور باید در انتهای صفحه‌ای پیش از جایی که می‌خواهید جابجایی رخ دهد، استفاده شود. این قابلیت اجازه می‌دهد صفحاتی مانند فهرست مطالب (TOC) به جای دیگری از سند منتقل شوند، اما کاربردهای تخصصی‌تر دیگری نیز امکان‌پذیر است.

.pdftransition scope mode duration dimension motion direction scale bool

\X'pdf: transition scope mode duration dimension motion direction scale bool'

سبک گذار (transition) صفحات را، همان‌گونه که در «اسلایدها» (“slides” یا “foils”) به‌کار می‌رود، پیکربندی می‌کند. scope می‌تواند SLIDE یا BLOCK باشد. SLIDE گذار را هنگامی اعمال می‌کند که یک اسلاید جدید به صفحه نمایش معرفی می‌شود؛ BLOCK آن را روی بلوک‌های مجزایی که اسلاید را تشکیل می‌دهند اعمال می‌کند.

mode نوع گذار میان اسلایدها است:

duration طول مدت گذار بر حسب ثانیه است (پیش‌فرض 1).

dimension (اختیاری؛ فقط در سبک‌های گذار Split و Blinds) بُعدی که جلوه گذار مشخص‌شده باید در آن رخ دهد: H افقی (Horizontal)، یا V عمودی (Vertical).

motion (اختیاری؛ فقط در سبک‌های گذار Split، Box و Fly) جهت حرکت برای جلوه گذار مشخص‌شده: I رو به داخل (Inward) از لبه‌های صفحه، یا O رو به خارج (Outward) از مرکز صفحه.

direction (اختیاری؛ فقط در سبک‌های گذار Wipe، Glitter، Fly، Cover، Uncover و Push) جهتی که جلوه گذار مشخص‌شده باید در آن حرکت کند، که بر حسب درجه در خلاف جهت عقربه‌های ساعت و با شروع از جهت چپ‌به‌راست بیان می‌شود. اگر مقدار یک عدد باشد، باید یکی از مقادیر زیر باشد: 0 = چپ به راست، 90 = پایین به بالا (فقط Wipe)، 180 = راست به چپ (فقط Wipe)، 270 = بالا به پایین، 315 = بالا-چپ به پایین-راست (فقط Glitter). این مقدار می‌تواند None نیز باشد، که تنها برای گذار Fly هنگامی که مقدار scale برابر با 1.0 نباشد کاربرد دارد.

scale (اختیاری؛ PDF 1.5؛ فقط در سبک گذار Fly) مقیاس شروع یا پایان که تغییرات باید در آن ترسیم شوند. اگر motion یک گذار به سمت داخل را مشخص کند، مقیاس تغییرات ترسیم‌شده در طول گذار، از scale به 1.0 پیش می‌رود. اگر motion یک گذار به سمت خارج را مشخص کند، مقیاس تغییرات ترسیم‌شده در طول گذار، از 1.0 به scale پیش می‌رود.

bool (اختیاری؛ PDF 1.5؛ فقط در سبک گذار Fly) اگر true باشد، ناحیه‌ای که باید به داخل پرواز کند مستطیلی و کدر خواهد بود.

هر یک از پارامترها می‌تواند با یک "." جایگزین شود که نشان می‌دهد پارامتر مقدار قبلی خود را حفظ می‌کند؛ همچنین هر پارامتر مفقود در انتها نادیده گرفته می‌شود.

نکته: همه پی‌دی‌اف‌خوان‌ها از همه یا هیچ‌یک از این گذارها پشتیبانی نمی‌کنند.

ماکروها (Macros)

ماکروهای پشتیبانی gropdf در pdf.tmac ماکروهای تسهیل‌کننده‌ای را که در بالا شرح داده شد، تعریف می‌کنند. برخی قابلیت‌ها هیچ معادل مستقیمی در دنباله‌های گریز افزونه دستگاه ندارند.

.pdfbookmark [-T tag-name] level text

نزدیک‌ترین مکان صفحه را به عنوان یک نشانه (bookmark)، و در صورت تمایل یک مقصد نام‌گذاری‌شده، نشانه‌گذاری می‌کند. نشانه‌ها (Bookmarks) قاب طرح کلی (outline pane) خواننده را پر می‌کنند. آن‌ها در یک درخت سلسله‌مراتبی سازماندهی می‌شوند؛ هر سطح از درخت، با شروع از ۱، شماره‌گذاری شده و با text در طرح کلی نام‌گذاری می‌شود. مقاصد نام‌گذاری‌شده (Named destinations) امکان پیمایش به سبک ابرپیوند را در سند فراهم می‌کنند. مشخص کردن -T به همراه tag-name یک مقصد نام‌گذاری‌شده ایجاد می‌کند که این مکان صفحه را به عنوان هدفی تعیین‌شده توسط “.pdfhref L ...” واجد شرایط می‌سازد.

.pdfhref L -D dest [-S] [-P prefix-text]

[-A suffix-text] [link-text] یک پیوند نقطه حساس به dest (همان tag-name) ایجاد می‌کند که فراخوانی “.pdfbookmark ...” یا “.pdfhref M ...” در جای دیگری از سند باید آن را تعریف کرده باشد. (اگر سند از ارجاعات رو به جلو استفاده می‌کند، باید دو بار پردازش شود؛ pdfmom(1) را ببینید.) اگر link-text حذف شود، متنی که هنگام ایجاد dest به آن اختصاص یافته بود، به عنوان متن پیوند قالب‌بندی می‌شود. آرگومان‌های -P و -A موارد پس از خود را به ترتیب به صورت متنی قبل و بعد از متن پیوند، بدون هیچ فاصله میانی، قالب‌بندی می‌کنند. مشخص کردن -S مانع از آن می‌شود که pdfhref نقطه حساس را «ببندد»، که سند (یا بسته ماکرویی که pdfhref را در بر می‌گیرد) را ملزم می‌سازد این کار را خودش با “\X'pdf: markend'\m[\*[pdf:curcol]]” انجام دهد.

.pdfhref M [-E] [-N tag-name] dest

نزدیک‌ترین مکان صفحه را به عنوان مقصدی به نام (اولین کلمه از) dest علامت‌گذاری می‌کند که باید درون سند یکتا باشد. مشخص کردن -T به همراه tag-name این پیش‌فرض را لغو می‌کند. مشخص کردن -E همچنین dest را به عنوان متن در سند قالب‌بندی می‌کند.

.pdfhref W -D uri [-S] [-P prefix-text]

[-A suffix-text] link-text یک پیوند نقطه حساس به uri ایجاد می‌کند که یک شناسه جهانی منبع (URI) در وب جهانی است. آرگومان‌های -P و -A موارد پس از خود را به ترتیب به صورت متنی قبل و بعد از متن پیوند، بدون هیچ فاصله میانی، قالب‌بندی می‌کنند. مشخص کردن -S مانع از آن می‌شود که pdfhref نقطه حساس را «ببندد»، که سند (یا بسته ماکرویی که pdfhref را در بر می‌گیرد) را ملزم می‌سازد این کار را خودش با “\X'pdf: markend'\m[\*[pdf:curcol]]” انجام دهد.

.pdfinfo /field content ...

فراداده پی‌دی‌اف را تعریف می‌کند. field می‌تواند یکی از موارد Title، Author، Subject، Keywords یا داده دیگری باشد که توسط استاندارد PDF یا خواننده شما پشتیبانی می‌شود. field باید با یک اسلش پیشوندگذاری شود.

.pdfnote [-T title] text

یک حاشیه‌نویسی در سند ایجاد می‌کند. پشتیبانی برنامه‌های خواننده از این ویژگی متفاوت است. برخی نمادی را در موقعیت فعلی در صفحه قرار می‌دهند؛ نگه‌داشتن اشاره‌گر روی نماد، title احتمالی را آشکار می‌کند، در حالی که کلیک روی نماد پنجره‌ای حاوی text را باز می‌کند.

پارامترها (Parameters)

پارامترهای زیر، که به عنوان خطوط کنترل roff نشان داده شده‌اند، بر عملکرد gropdf تأثیر می‌گذارند.

در موارد بالا، می‌توانید “COLOR” را در نام‌های رشته به صورت “COLOUR” نیز بنویسید.

وارد کردن گرافیکهای PDF (Importing PDF graphics)

اگر تصویری را به عنوان یک فایل PDF وارد می‌کنید، این پرونده باید تک‌صفحه‌ای باشد و نقاشی باید دقیقاً درون ابعاد رسانه فایل PDF جای بگیرد. برای مثال، در inkscape(1) یا gimp(1)، اطمینان حاصل کنید که اندازه بوم نقاشی دقیقاً به اندازه تصویر باشد.

تجزیه‌کنندهٔ PDF که gropdf پیاده‌سازی می‌کند، به صورت جامع با همه برنامه‌هایی که PDF تولید می‌کنند آزمایش نشده است. اگر به یک فایل PDF تک‌صفحه‌ای برخوردید که به درستی وارد نمی‌شود، پردازش آن را با برنامه pdftk(1) امتحان کنید.

pdftk 
existing-file 
output 
new-file

قالبهای فونت TrueType و دیگر موارد (TrueType and other font formats)

gropdf هنوز از هیچ قالب فونتی به جز Adobe Type 1 (شامل PFA یا PFB) پشتیبانی نمی‌کند.