.TH pdfmom 1 "2026-03-15" "groff 1.24.1"
.SH "نام (NAME)"
pdfmom \- تولید اسناد PDF با استفاده از بسته ماکروی mom برای groff
.
.
.\" ====================================================================
.\" Legal Terms
.\" ====================================================================
.\"
.\" Copyright 2012-2023 Free Software Foundation, Inc.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of
.\" this manual under the conditions for verbatim copying, provided that
.\" the entire resulting derived work is distributed under the terms of
.\" a permission notice identical to this one.
.\"
.\" Permission is granted to copy and distribute translations of this
.\" manual into another language, under the above conditions for
.\" modified versions, except that this permission notice may be
.\" included in translations approved by the Free Software Foundation
.\" instead of in the original English.
.
.
.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr *groff_pdfmom_1_man_C \n[.cp]
.cp 0
.
.\" Define fallback for groff 1.23's MR macro if the system lacks it.
.nr do-fallback 0
.if !\n(.f           .nr do-fallback 1 \" mandoc
.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
.if \n[do-fallback]  \{\
.  de MR
.    ie \\n(.$=1 \
.      I \%\\$1
.    el \
.      IR \%\\$1 (\\$2)\\$3
.  .
.\}
.rr do-fallback
.
.
.\" ====================================================================
.SH "خلاصه دستور (SYNOPSIS)"
.\" ====================================================================
.
.SY pdfmom
.RB [ \-\-roff ]
.RB [ \-Tpdf ]
.RI [ groff-options ]
.RI [ file\~ .\|.\|.]
.YS
.
.
.P
.SY pdfmom
.RB [ \-\-roff ]
.B \-Tps
.RI [ pdfroff-options ]
.RI [ groff-options ]
.RI [ file\~ .\|.\|.]
.YS
.
.
.P
.SY pdfmom
.B \-v
.YS
.
.SY pdfmom
.B \%\-\-version
.YS
.
.
.\" ====================================================================
.SH "توضیحات (DESCRIPTION)"
.\" ====================================================================
.
دستور
.I pdfmom
یک پوشش (wrapper) پیرامون
.MR groff 1
است که تولید اسناد PDF از فایل‌های قالب‌بندی‌شده با ماکروهای
.I mom
را تسهیل می‌کند.
.
.
.P
اگر گزینه
.B \-\-roff
استفاده شود،
این پوشش می‌تواند با بسته‌های ماکروی دیگر به جز
.MR groff_mom 7
نیز به کار گرفته شود.
.
این موضوع همچنین در حالتی که این پوشش تغییر نام یابد یا با یک نام مستعار پیوند داده شود صادق است؛
برای نمونه،
ایجاد یک پیوند
.I pdfms
که به فایل اجرایی
.I pdfmom
اشاره دارد، پوششی برای تولید اسناد PDF با بسته
.I ms
فراهم می‌کند.
.
.
.P
دستور
.I pdfmom
خروجی را در خروجی استاندارد می‌نویسد،
بنابراین خروجی معمولاً باید به یک فایل مقصد هدایت شود.
.
حجم نهایی فایل PDF را می‌توان با هدایت خروجی به صورت لوله‌ای (pipe) به
.MR ps2pdf 1
کاهش داد.
.
.
.P
اگر با گزینه
.B \-Tpdf
(که پیش‌فرض است) فراخوانی شود،
.I pdfmom
فایل‌ها را با استفاده از درایور بومی PDF در
.IR groff ،
یعنی
.MR gropdf 1
پردازش می‌کند.
.
اگر
.B \-Tps
داده شود،
پردازش به
.IR pdfroff
واگذار می‌شود که از درایور PostScript در
.IR groff
استفاده می‌کند.
.
در هر دو حالت،
اجرای چندباره فایل مبدا انجام می‌شود تا تمام ارجاعات به جلو در سند پاسخ داده شوند.
.
.
.P
دستور
.I pdfmom
تمام گزینه‌های مشابه
.IR groff
را می‌پذیرد.
.
اگر گزینه
.B \-Tps
مشخص شود،
گزینه‌های مرتبط با
.I pdfroff
نیز پذیرفته می‌شوند.
.
هنگامی که
.I pdfmom
برنامه
.IR pdfroff
را فراخوانی می‌کند، گزینه‌های
.RB \[lq] "\-mpdfmark \-mom \-\-no\-toc" \[rq]
به طور ضمنی اعمال می‌شوند و نباید در خط فرمان داده شوند.
.
به همین ترتیب، در صورت عدم وجود
.BR \-Tps ،
نیازی به ارائه گزینه‌های
.B \-mom
یا
.B "\-m\~mom"
نیست.
.
.
.P
یکپارچه‌سازی PDF با ماکروهای
.I mom
به طور مفصل در دفترچه راهنمای
\[lq]Producing PDFs with
.I groff
and
.IR mom \[rq]
مورد بحث قرار گرفته است که خود آن نیز با
.IR pdfmom
تولید شده است.
.
.
.P
در صورت فراخوانی با گزینه‌های
.B \-v
یا
.BR \%\-\-version ،
دستور
.I pdfmom
اطلاعات نگارش خود را نمایش داده و خارج می‌شود.
.
استفاده از گزینه
.B \-\-help
یک پیام راهنما برای نحوه استفاده را نمایش داده و خارج می‌شود.
.
.
.\" ====================================================================
.SH "نویسندگان (AUTHORS)"
.\" ====================================================================
.
دستور
.I pdfmom
توسط
.MT deri@\:chuzzlewit\:.myzen\:.co\:.uk
Deri James
.ME
و
.MT peter@\:schaffter\:.ca
Peter Schaffter
.ME
نوشته شده است،
و توسط James نگهداری می‌شود.
.
.
.\" ====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.\" ====================================================================
.
.TP
.I /usr/\:\%share/\:\%doc/\:\%groff\-1.24.1/\:\%pdf/\:mom\-pdf.pdf
\[lq]Producing PDFs with
.I groff
and
.IR mom \[rq],
نوشته Deri James و Peter Schaffter.
.
این فایل به همراه سورس آن،
.IR mom\-pdf.mom ،
بخشی از توزیع
.I groff
است.
.
.
.P
.MR groff 1 ,
.MR gropdf 1 ,
.MR pdfroff 1 ,
.MR ps2pdf 1
.
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[*groff_pdfmom_1_man_C]
.do rr *groff_pdfmom_1_man_C
.
.
.\" Local Variables:
.\" fill-column: 72
.\" mode: nroff
.\" End:
.\" vim: set filetype=groff textwidth=72: