نام (NAME)

pdfmom - تولید اسناد PDF با استفاده از بسته ماکروی mom برای groff

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

pdfmom [--roff] [-Tpdf] [groff-options] [file ...]

pdfmom [--roff] -Tps [pdfroff-options] [groff-options] [file ...]

pdfmom -v

pdfmom --version

توضیحات (DESCRIPTION)

دستور pdfmom یک پوشش (wrapper) پیرامون groff(1) است که تولید اسناد PDF از فایل‌های قالب‌بندی‌شده با ماکروهای mom را تسهیل می‌کند.

اگر گزینه --roff استفاده شود، این پوشش می‌تواند با بسته‌های ماکروی دیگر به جز groff_mom(7) نیز به کار گرفته شود. این موضوع همچنین در حالتی که این پوشش تغییر نام یابد یا با یک نام مستعار پیوند داده شود صادق است؛ برای نمونه، ایجاد یک پیوند pdfms که به فایل اجرایی pdfmom اشاره دارد، پوششی برای تولید اسناد PDF با بسته ms فراهم می‌کند.

دستور pdfmom خروجی را در خروجی استاندارد می‌نویسد، بنابراین خروجی معمولاً باید به یک فایل مقصد هدایت شود. حجم نهایی فایل PDF را می‌توان با هدایت خروجی به صورت لوله‌ای (pipe) به ps2pdf(1) کاهش داد.

اگر با گزینه -Tpdf (که پیش‌فرض است) فراخوانی شود، pdfmom فایل‌ها را با استفاده از درایور بومی PDF در groff، یعنی gropdf(1) پردازش می‌کند. اگر -Tps داده شود، پردازش به pdfroff واگذار می‌شود که از درایور PostScript در groff استفاده می‌کند. در هر دو حالت، اجرای چندباره فایل مبدا انجام می‌شود تا تمام ارجاعات به جلو در سند پاسخ داده شوند.

دستور pdfmom تمام گزینه‌های مشابه groff را می‌پذیرد. اگر گزینه -Tps مشخص شود، گزینه‌های مرتبط با pdfroff نیز پذیرفته می‌شوند. هنگامی که pdfmom برنامه pdfroff را فراخوانی می‌کند، گزینه‌های “-mpdfmark -mom --no-toc” به طور ضمنی اعمال می‌شوند و نباید در خط فرمان داده شوند. به همین ترتیب، در صورت عدم وجود -Tps، نیازی به ارائه گزینه‌های -mom یا -m mom نیست.

یکپارچه‌سازی PDF با ماکروهای mom به طور مفصل در دفترچه راهنمای “Producing PDFs with groff and mom” مورد بحث قرار گرفته است که خود آن نیز با pdfmom تولید شده است.

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

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

دستور pdfmom توسط Deri James و Peter Schaffter نوشته شده است، و توسط James نگهداری می‌شود.

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

/usr/share/doc/groff-1.24.1/pdf/mom-pdf.pdf: “Producing PDFs with groff and mom”, نوشته Deri James و Peter Schaffter. این فایل به همراه سورس آن، mom-pdf.mom، بخشی از توزیع groff است.

groff(1), gropdf(1), pdfroff(1), ps2pdf(1)