.\" Manpage for pdfxup.
.\" Contact pdfxup@markey.fr to correct errors or typos.
.TH man 1 "11 june 2024" "2.12" "pdfxup man page"
.SH "نام (NAME)"
pdfxup \- ابزار چیدمان n-up در صفحه با کاهش حاشیه‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B pdfxup
[\fIگزینه‌ها\fR] [\fIفایل\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pdfxup
یک سند PDF ایجاد می‌کند که در آن هر صفحه از ترکیب چندین صفحه از یک فایل PDF به دست می‌آید. ویژگی مهم
.BR pdfxup ،
در مقایسه با برنامه‌های مشابه، این است که تلاش می‌کند کادر احاطه‌کننده (سراسری) فایل PDF ورودی را محاسبه کند تا حاشیه‌ها حذف شوند و تنها متن باقی بماند. به جای اینکه اندازه قلم به نصف کاهش یابد (در حالت خروجی ۲ صفحه در یک برگه)، در برخی موارد ممکن است اندازه قلم خروجی تقریباً با سند اصلی یکسان باشد (مانند یک سند پیش‌فرض 'article' تولیدشده توسط LaTeX).
.PP
دستور
.B pdfxup
از ghostscript برای محاسبه بیشترین اندازه کادر احاطه‌کننده (برخی از) صفحات سند استفاده می‌کند، و سپس از pdflatex (به همراه بسته graphicx) برای تولید سند جدید بهره می‌برد.
.SH "گزینه‌ها (OPTIONS)"
دستور
.B pdfxup
گزینه‌های متعددی را می‌پذیرد. مهم‌ترین آن‌ها عبارتند از:
.TP
\fB\-x\fR \fIm\fR, \fB\-\-columns\fR \fIm\fR
تعداد ستون‌های فایل خروجی را تعیین می‌کند (پیش‌فرض: ۲).
.TP
\fB\-y\fR \fIn\fR, \fB\-\-rows\fR \fIn\fR
تعداد خطوط (ردیف‌های) فایل خروجی را تعیین می‌کند (پیش‌فرض: ۱).
.TP
\fB\-nup\fR \fIm\fR\fBx\fR\fIn\fR, \fB\-\-nup\fR \fIm\fR\fBx\fR\fIn\fR
تعداد ردیف‌ها و ستون‌های فایل خروجی را تنظیم می‌کند (پیش‌فرض: 2x1).
.TP
\fB\-l\fR (0|1), \fB\-\-landscape\fR, \fB\-\-portrait\fR
جهت کاغذ (سند نهایی) را تعیین می‌کند.
.TP
\fB\-cf\fR \fIfile\fR, \fB\-\-config\fR \fIfile\fR, \fB\-\-mode\fR \fIfile\fR
فایل را (با پسوند \fB.xup\fR) می‌خواند و از گزینه‌های تعریف‌شده در آن فایل استفاده می‌کند (برای جزئیات بیشتر درباره فایل‌های \fB.xup\fR به بخش زیر مراجعه کنید). تمام گزینه‌ها به ترتیبی که در خط فرمان ظاهر می‌شوند پردازش می‌گردند، بنابراین می‌توان گزینه‌های تنظیم‌شده در فایل پیکربندی را تغییر داد (و حتی امکان گنجاندن چند فایل پیکربندی وجود دارد که فایل‌های بعدی گزینه‌های فایل‌های قبلی را بازنویسی می‌کنند). فایل‌ها در صورت در دسترس بودن با استفاده از kpsewhich جستجو می‌شوند.
.TP
\fB\-b\fR (le|se), \fB\-\-booklet\fR (le|se)
پیکربندی برای چاپ به صورت کتابچه. مقدار 'le' (که در صورت استفاده از \fB\-b\fR بدون آرگومان، مقدار پیش‌فرض است) به این معنی است که چاپ دورو در حالت 'long-edge' (لبه بلند) انجام می‌شود (چرخش از یک صفحه به صفحه بعد در امتداد لبه بلند کاغذ صورت می‌گیرد). مقدار 'se' گزینه 'short-edge' (لبه کوتاه) است.
.TP
\fB\-c\fR, \fB\-\-clip\fR, \fB\-nc\fR, \fB\-\-no-clip\fR
برش زدن (یا نزدن) صفحات بر اساس کادر احاطه‌کننده محاسبه‌شده. به طور پیش‌فرض، محتوا برای جلوگیری از هم‌پوشانی میان صفحات مجاور برش داده می‌شود. با \fB\-\-no-clip\fR، هر چیزی خارج از کادر احاطه‌کننده نمایش داده خواهد شد.
.TP
\fB\-o\fR \fIfile\fR, \fB\-\-output\fR \fIfile\fR
نام فایل خروجی.
.TP
\fB\-i\fR
پرسش قبل از بازنویسی فایل خروجی.
.TP
\fB\-ow\fR
بازنویسی فایل خروجی بدون پرسش.
.TP
\fB\-ps\fR \fIs\fR, \fB\-\-paper\fR \fIs\fR
اندازه کاغذ را تعیین می‌کند (پیش‌فرض: a4). این نام باید برای بسته geometry شناخته‌شده باشد (به طور دقیق‌تر، باید "<s>paper" در آن بسته تعریف شده باشد).
.TP
\fB\-fw\fR \fId\fR, \fB\-\-framewidth\fR \fId\fR
عرض کادر دور هر صفحه (پیش‌فرض: 0.4pt). برای نداشتن کادر، مقدار را برابر با 0pt قرار دهید.
.TP
\fB\-tf\fR [0|1], \fB\-\-tight-frame\fR [0|1]
مشخص می‌کند که کادر محکم دور صفحه باشد و فضای خالی افقی خارج از کادر باقی بماند، یا عریض باشد و تمام عرض موجود را بپوشاند.
.TP
\fB\-im\fR \fId\fR, \fB\-\-innermargins\fR \fId\fR
حاشیه داخلی بین کادر و صفحه (پیش‌فرض: 5pt).
.TP
\fB\-m\fR \fId\fR, \fB\-\-margins\fR \fId\fR
حاشیه صفحات سند جدید (پیش‌فرض: 5pt).
.TP
\fB\-is\fR \fId\fR, \fB\-\-intspaces\fR \fId\fR
فاصله میان صفحات مختلف (پیش‌فرض: 1pt).
.TP
\fB\-p\fR \fIlist\fR, \fB\-\-pages\fR \fIlist\fR
فقط زیرمجموعه‌ای از صفحات سند ورودی را در نظر می‌گیرد. فهرست به صورت صفحات یا بازه‌هایی از صفحات جداشده با کاما به شکل a-b است؛ می‌توان a را برای شروع از نخستین صفحه حذف کرد، و b را برای پایان در آخرین صفحه خالی گذاشت. بنابراین، \fB\-p\fR \- (که حالت پیش‌فرض است) تمام صفحات را شامل می‌شود. همچنین امکان استفاده از عملگر پیمانه وجود دارد، به طوری که "\fB\-p\fR 0%2" تنها صفحات زوج را در بر می‌گیرد.
.TP
\fB\-bb\fR \fIlist\fR, \fB\-\-bb\fR \fIlist\fR
فقط زیرمجموعه‌ای از صفحات سند ورودی را برای محاسبه کادر احاطه‌کننده در نظر می‌گیرد.
.TP
\fB\-nobb\fR \fIlist\fR, \fB\-\-no-bb\fR \fIlist\fR
فهرست صفحات سند ورودی را از محاسبه کادر احاطه‌کننده حذف می‌کند.
.TP
\fB\-g\fR, \fB\-\-get-bb\fR
تنها کادر احاطه‌کننده را محاسبه کرده (و چاپ می‌کند). هیچ فایل خروجی تولید نخواهد شد.
.TP
\fB\-kbb\fR, \fB\-\-keep-bb\fR
کادر احاطه‌کننده را محاسبه نمی‌کند و حاشیه‌های فعلی را نگه می‌دارد.
.TP
\fB\-s\fR \fIx y W H\fR, \fB\-\-set-bb\fR \fIx y W H\fR
کادر احاطه‌کننده را روی مقادیر ارائه‌شده تنظیم می‌کند. مقادیر بر حسب pt هستند؛ دو مقدار نخست مربوط به گوشه پایین-چپ بوده، در حالی که دو مقدار آخر نشان‌دهنده عرض و ارتفاع بخشی هستند که باید نمایش داده شود.
.TP
\fB\-w\fR \fIfile\fR, \fB\-\-watermark\fR \fIfile\fR
از فایل به عنوان واترمارک پس‌زمینه استفاده می‌کند. فایل می‌تواند در هر قالبی باشد که توسط pdflatex پشتیبانی می‌شود (مانند png یا pdf). اگر فایل یک PDF چندصفحه‌ای باشد، صفحه n از فایل واترمارک به همراه صفحه n فایل ورودی استفاده می‌شود و در صورتی که فایل ورودی صفحات بیشتری داشته باشد، آخرین صفحه فایل واترمارک تکرار می‌شود.
.TP
\fB\-wp\fR \fIp\fR, \fB\-\-watermark-period\fR \fIp\fR
به جای تکرار تنها آخرین صفحه، p صفحه آخر فایل واترمارک را تکرار می‌کند.
.TP
\fB\-d\fR, \fB\-\-debug\fR
حالت عیب‌یابی: فایل‌های میانی را نگه می‌دارد.
.TP
\fB\-col\fR, \fB\-\-column-mode\fR, \fB\-\-vertical\fR
صفحات را ابتدا از بالا به پایین پر می‌کند (به جای حالت پیش‌فرض چپ به راست). به صورت پیش‌فرض، صفحات از چپ به راست درج می‌شوند تا زمانی که سطر پر شود؛ با این گزینه، صفحات از بالا به پایین درج می‌شوند تا زمانی که ستون پر شود. برای مثال:
.nf
           ---------                     ---------
row-mode  | 1  2  3 |      column-mode  | 1  4  7 |
          | 4  5  6 |                   | 2  5  8 |
          | 7  8  9 |                   | 3  6  9 |
           ---------                     ---------

.fi
.TP
\fB\-row\fR, \fB\-\-row-mode\fR, \fB\-\-horizontal\fR
صفحات را از چپ به راست پر می‌کند.
.TP
\fB\-bal\fR, \fB\-\-balance-last\fR
تراز کردن آخرین صفحه: هنگام استفاده از حالت ستونی، صفحات از بالا به پایین پر می‌شوند و آخرین صفحه نیز استثنا نیست. با این حال، ممکن است ترجیح داده شود که ستون‌های صفحه آخر به صورت متوازن باقی بمانند، که این گزینه این کار را انجام می‌دهد. به طور متقارن، در حالت سطری، این گزینه سطرها را متوازن می‌کند.
.nf
                 ---------                        ---------
row, no-balance | 1  2  3 |  column, no-balance  | 1  4    |
                | 4  5    |                      | 2  5    |
                |         |                      | 3       |
                 ---------                        ---------

                 ---------                        ---------
   row, balance | 1  2    |     column, balance  | 1  3  5 |
                | 3  4    |                      | 2  4    |
                | 5       |                      |         |
                 ---------                        ---------

.fi
.TP
\fB\-V [0-3]\fR, \fB\-\-verbose\fR [0-3]
تعیین میزان گزارش‌دهی جزئیات (پیش‌فرض: ۱).
.TP
\fB\-q\fR, \fB\-\-quiet\fR
اجرای بی‌صدا (معادل '-V 0').
.TP
\fB\-v\fR, \fB\-\-version\fR
چاپ شماره نسخه و خروج.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ پیام راهنما و خروج.
.SH "فایل‌های پیکربندی (CONFIGURATION FILES)"
فایل‌های پیکربندی (با پسوند \fB.xup\fR) اسکریپت‌های bash هستند که برای مقداردهی برخی متغیرها استفاده می‌شوند. اگر گزینه "\fB\-\-config-file\fR <file>" (یا معادل آن) استفاده شود، در صورتی که <file> شامل '/' نباشد ابتدا با kpsewhich جستجو می‌شود. اگر kpsewhich آن را پیدا نکند، آنگاه pdfxup بررسی می‌کند که آیا فایل وجود دارد یا خیر (با استفاده از 'test \-e') پیش از آنکه آن را سورس کند (از متغیر \fBPATH\fR برای یافتن آن استفاده نخواهد شد).
.PP
این اسکریپت تنها باید برخی از متغیرهای داخلی pdfxup را تنظیم کند، مانند \fBNB_ROWS\fR، \fBNB_COLUMNS\fR، \fBLANDSCAPE\fR (برای تنظیم یک طرح‌بندی از پیش تعریف‌شده). می‌توان از آن برای تنظیم کادر احاطه‌کننده استفاده کرد، اما معمولاً بهتر است آن را روی چند صفحه نخست سند محاسبه کرد. در اینجا نمونه‌هایی از خطوطی که می‌توان در یک فایل \fB.xup\fR قرار داد آورده شده است:
.TP
\fBNB_COLUMNS=1\fR
تنظیم تعداد ستون‌ها روی ۱
.TP
\fBNB_ROWS=2\fR
تنظیم تعداد ردیف‌ها روی ۲
.TP
\fBLANDSCAPE=0\fR
تنظیم حالت عمودی (portrait)
.TP
\fBKEEP_ORIG_BBOX=1\fR
حاشیه‌ها برش داده نشوند
.TP
\fBSET_BBOX="75 47 540 755"\fR
تنظیم کادر احاطه‌کننده: پایین چپ=(75,47)؛ بالا راست=(540,755)
.TP
\fBTIGHT_FRAME=1\fR
تنظیم کادرهای چسبیده دور صفحات
.TP
\fBINNER_MARGINS=10pt\fR
تنظیم حاشیه دور هر صفحه (داخل کادر) روی 10pt
.TP
\fBINTERM_SPACES=10pt\fR
تنظیم فاصله بین صفحات روی 10pt
.TP
\fBFRAME_WIDTH=2mm\fR
تنظیم عرض کادر روی 2mm
.PP
سایر متغیرهای موجود را می‌توان در تابع \fBsetdefaultvalues\fR پیدا کرد.
.SH "مثال‌ها (EXAMPLES)"
.TP
\fB# pdfxup file.pdf\fR
تولید فایل pdf به صورت ۲ صفحه در یک برگه (2-up) از file.pdf.
.TP
\fB# pdfxup -bb 1-4 file.pdf\fR
رفتار مشابه، اما کادر احاطه‌کننده را فقط با استفاده از ۴ صفحه نخست محاسبه می‌کند (این کار در پردازش اسناد طولانی در زمان صرفه‌جویی می‌کند).
.TP
\fB# pdfxup -b -o booklet.pdf file.pdf\fR
رفتار مشابه، اما یک کتابچه (دفترچه) ایجاد می‌کند (به عنوان booklet.pdf).
.TP
\fB# pdfxup -kbb -x1 -y2 -l0 beamer-frames.pdf\fR
چیدمان ۲ فریم beamer در هر صفحه (بدون کاهش حاشیه‌ها).
.TP
\fB# pdfxup --mode beamer2 beamer-frames.pdf\fR
چیدمان صفحات PDF بر اساس فایل پیکربندی beamer2.xup.
.TP
\fB# pdfxup -kbb -x2 -y2 -l beamer-frames.pdf:1-12,15-19\fR
چیدمان ۴ فریم beamer در هر صفحه (بدون کاهش حاشیه‌ها)، تنها شامل فریم‌های ۱ تا ۱۲ و ۱۵ تا ۱۹.
.SH "همچنین ببینید (SEE ALSO)"
.BR gs (1),
.BR pdflatex (1)
.SH "نویسندگان (AUTHORS)"
Nicolas Markey (pdfxup@markey.fr)