.TH PSNUP "1" "2026\-08\-05" "psutils 3.3.16" "User Commands"
.SH "نام (NAME)"
psnup \- قرار دادن چند صفحه از یک سند در یک برگ کاغذ
.SH "خلاصه دستور (SYNOPSIS)"
.B psnup
[OPTION...] \-NUMBER [INFILE [OUTFILE]]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
.B psnup
از
.B pstops
برای گنجاندن چند صفحه منطقی روی هر برگ کاغذ فیزیکی استفاده می‌کند.
.PP
اندازه کاغذ را می‌توان با نام (رجوع کنید به
.BR paper (1))
یا به‌صورت \fBعرض\fRx\fBطول\fR (برای مشاهده واحدهای موجود رجوع کنید به
.BR psutils (1))
مشخص کرد.
این ابزار چند صفحه از یک سند PostScript را روی یک صفحه قرار می‌دهد.

.TP
\fB\-NUMBER\fR
تعداد صفحاتی که باید روی هر صفحه خروجی قرار گیرند

.TP
\fBINFILE\fR
مقدار `\-' یا تعیین نکردن آرگومان INFILE به معنی ورودی استاندارد است

.TP
\fBOUTFILE\fR
مقدار `\-' یا تعیین نکردن آرگومان OUTFILE به معنی خروجی استاندارد است

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-p\fR \fI\,PAPER\/\fR, \fB\-\-paper\fR \fI\,PAPER\/\fR
نام کاغذ خروجی یا ابعاد آن (WIDTHxHEIGHT)

.TP
\fB\-P\fR \fI\,INPAPER\/\fR, \fB\-\-inpaper\fR \fI\,INPAPER\/\fR
نام کاغذ ورودی یا ابعاد آن (WIDTHxHEIGHT)

.TP
\fB\-m\fR \fI\,DIMENSION\/\fR, \fB\-\-margin\fR \fI\,DIMENSION\/\fR
عرض حاشیه پیرامون هر صفحه خروجی
[پیش‌فرض: 0pt]؛ مناسب برای برگه‌های بندانگشتی (thumbnail)،
زیرا حاشیه‌های صفحه اصلی کوچک خواهند شد

.TP
\fB\-b\fR \fI\,DIMENSION\/\fR, \fB\-\-border\fR \fI\,DIMENSION\/\fR
عرض کادر دور هر صفحه ورودی

.TP
\fB\-d\fR \fI\,[DIMENSION]\/\fR, \fB\-\-draw\fR \fI\,[DIMENSION]\/\fR
رسم خطی با عرض مشخص‌شده (نسبت به صفحه اصلی)
دور هر صفحه [مقدار پیش‌فرض آرگومان 1pt است؛
حالت پیش‌فرض بدون خط است؛ این عرض برای PDF ثابت است]

.TP
\fB\-l\fR, \fB\-\-rotatedleft\fR
صفحات ورودی ۹۰ درجه به چپ چرخانده می‌شوند

.TP
\fB\-r\fR, \fB\-\-rotatedright\fR
صفحات ورودی ۹۰ درجه به راست چرخانده می‌شوند

.TP
\fB\-f\fR, \fB\-\-flip\fR
جابه‌جایی عرض و ارتفاع صفحات خروجی

.TP
\fB\-c\fR, \fB\-\-transpose\fR
جابه‌جایی سطرها و ستون‌ها (چیدمان ستون‌محور)

.TP
\fB\-t\fR \fI\,NUMBER\/\fR, \fB\-\-tolerance\fR \fI\,NUMBER\/\fR
حداکثر فضای هدررفته بر حسب پوینت مربع [پیش‌فرض: 100000]

.TP
\fB\-v\fR, \fB\-\-version\fR
نمایش شماره نسخه برنامه و خروج

.TP
\fB\-q\fR, \fB\-\-quiet\fR
عدم نمایش روند پیشرفت

.SH "نکات (COMMENTS)"
اگر
.B psnup
نتواند صفحات ورودی را به گونه‌ای مرتب کند که فضای هدررفته کمتر از حد مجاز داده‌شده باشد، با یک خطا متوقف می‌شود.
.PP
اندازه صفحه خروجی به‌طور پیش‌فرض برابر با اندازه صفحه ورودی است؛ اگر در سند یا در خط فرمان چیزی تعیین نشده باشد، از اندازه پیش‌فرض دستور
.B paper
استفاده می‌شود.
.PP
اندازه صفحه ورودی به‌طور پیش‌فرض برابر با اندازه صفحه خروجی است.
.PP
در چیدمان سطرمحور (پیش‌فرض)، صفحات مجاور در سطرهایی در امتداد کاغذ چیده می‌شوند؛ در چیدمان ستون‌محور، آن‌ها در ستون‌هایی به سمت پایین صفحه قرار می‌گیرند.
.SH "مثال‌ها (EXAMPLES)"
کاربردهای بالقوه این ابزار متنوع است، اما یک استفاده خاص در ترکیب با
.BR psbook (1)
است.
برای مثال، با استفاده از groff برای ایجاد یک سند PostScript و lpr به عنوان اسپولر چاپ
.SM UNIX
، یک خط فرمان معمول ممکن است شبیه به این باشد:
.sp
groff -Tps -ms \fIfile\fP | psbook | psnup -2 | lpr
.sp
در صورتی که file یک سند ۴ صفحه‌ای باشد، این دستور منجر به تولید سندی ۲ صفحه‌ای می‌شود که در هر صفحه دو صفحه از \fIfile\fP را چاپ می‌کند و ترتیب صفحات را بازآرایی می‌کند تا با قرار دادن صفحات ورودی ۴ و ۱ در اولین صفحه خروجی و صفحات ۲ و سپس ۳ سند ورودی در دومین صفحه خروجی مطابقت داشته باشد.

.SH "نویسندگان (AUTHORS)"
.nf
Reuben Thomas <rrt@sc3d.org>
.fi