نام (NAME)

pstops - بازآرایی صفحات یک سند PDF یا PostScript

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

pstops [OPTION...] [INFILE [OUTFILE]]

توضیحات (DESCRIPTION)

صفحات یک سند PDF یا PostScript را بازآرایی می‌کند. فایل‌های PostScript باید از قراردادهای ساختاردهی سند ادوبی (Adobe Document Structuring Conventions) پیروی کنند.

دستور pstops می‌تواند برای انجام بازآرایی‌های دلخواه روی اسناد به کار رود. برای بسیاری از کارها، استفاده از ابزارهای دیگر مجموعه‌ی PSUtils ساده‌تر است: نگاه کنید به psutils(1).

INFILE: `-' یا نبود آرگومان INFILE به معنی ورودی استاندارد است
OUTFILE: `-' یا نبود آرگومان OUTFILE به معنی خروجی استاندارد است

گزینه‌ها (OPTIONS)

-S SPECS, --specs SPECS: مشخصات صفحات (پایین‌تر را ببینید)
-R PAGERANGE, --pages PAGERANGE: انتخاب محدوده‌های مشخص‌شده‌ی صفحات
-e, --even: انتخاب صفحات خروجی با شماره‌ی زوج
-o, --odd: انتخاب صفحات خروجی با شماره‌ی فرد
-r, --reverse: معکوس کردن ترتیب صفحات خروجی
-p PAPER, --paper PAPER: نام یا ابعاد کاغذ خروجی (WIDTHxHEIGHT)
-P INPAPER, --inpaper INPAPER: نام یا ابعاد کاغذ ورودی (WIDTHxHEIGHT)
-d [DIMENSION], --draw [DIMENSION]: رسم خطی با ضخامت مشخص‌شده (نسبت به صفحه‌ی اصلی) دور هر صفحه [پیش‌فرض آرگومان 1pt است؛ حالت پیش‌فرض بدون خط است؛ ضخامت برای PDF ثابت است]
-v, --version: نمایش شماره نسخه‌ی برنامه و خروج
-q, --quiet: عدم نمایش روند پیشرفت

یادداشت‌ها (COMMENTS)

مقدار PAGES فهرستی از صفحات و محدوده‌های صفحات است که با ویرگول از هم جدا شده‌اند.

مقدار SPECS فهرستی از مشخصات صفحات است [پیش‌فرض "0" است که هر صفحه را با ترتیب عادی خود انتخاب می‌کند].

نحوه‌ی نگارش مشخصات صفحه (Pagespecs) به صورت زیر است:

pagespecs: = [modulo:]specs
specs: = spec[+specs|,specs]
spec: = [-]pageno[transform...][@scale][(xoff,yoff)]
transform: = L|R|U|H|V

مقدار modulo تعداد صفحات موجود در هر بلوک است. مقدار modulo باید بزرگ‌تر از ۰ باشد؛ مقدار پیش‌فرض ۱ است.

مقدار specs مشخصات صفحات را برای هر بلوک تعیین می‌کند. مقدار pageno در هر spec باید بین ۰ (برای نخستین صفحه‌ی بلوک) و modulo-1 (برای آخرین صفحه‌ی هر بلوک)، شامل خود آن‌ها باشد. اگر تنها یک مشخصه‌ی صفحه وجود داشته باشد، می‌توان از pageno (۰) صرف‌نظر کرد.

ابعاد اختیاری xoff و yoff صفحه را به میزان مشخص‌شده جابه‌جا می‌کنند. xoff و yoff می‌توانند اندازه باشند (نگاه کنید به psutils(1)) یا در ادامه به w یا h ختم شوند تا مضربی از عرض یا ارتفاع صفحه‌ی خروجی را مشخص کنند.

تبدیل‌های اختیاری L، R، U، H و V صفحه را به ترتیب به سمت چپ، راست یا وارونه حول گوشه‌ی پایین-چپ آن می‌چرخانند، و صفحه را به صورت افقی یا عمودی بازتاب (آینه‌ای) می‌کنند. پارامتر اختیاری scale صفحه را با ضریب مشخص‌شده مقیاس‌بندی می‌کند. اگر علامت منفی اختیاری تعیین شود، شماره‌ی صفحه به جای ابتدای سند، نسبت به انتهای آن محاسبه می‌شود.

صفحاتی که spec آن‌ها با + از هم جدا شده باشد، در یک صفحه‌ی واحد ادغام خواهند شد؛ در غیر این صورت، به صورت صفحاتی جداگانه باقی می‌مانند.

جابه‌جایی، چرخش و مقیاس‌بندی، صرف‌نظر از ترتیبی که در خط فرمان وارد شده‌اند، دقیقاً به همین ترتیب بر ماتریس تبدیل PostScript اعمال می‌شوند.

نام اندازه‌های کاغذ با استفاده از paper(1) به ابعاد تبدیل می‌شوند. اندازه‌ی صفحه‌ی خروجی در صورت تنظیم شدن، (پس از مقیاس‌بندی) برای تنظیم مسیر برش (clipping path) برای هر صفحه استفاده می‌شود.

مثال‌ها (EXAMPLES)

برای قرار دادن دو صفحه‌ی سری A یا B (مانند A4 یا B5) روی یک برگ کاغذ، مشخصه‌ی صفحه‌ی مورد استفاده عبارت است از:

2:0L@.7(1w,0)+1L@.7(1w,0.5h)

برای انتخاب همه‌ی صفحات فرد با ترتیب معکوس، استفاده کنید از:

2:-0

برای بازآرایی صفحات جهت چاپ کتابچه‌های دوصفحه‌ای (2-up)، استفاده کنید از:

4:-3L@.7(1w,0h)+0L@.7(1w,0.5h)

برای صفحات رویی، و:

4:1L@.7(1w,0h)+-2L@.7(1w,0.5h)

برای صفحات پشتی؛ یا برای چاپ دورو با لبه‌ی بلند (long-edge duplex)، دو مشخصه را بدین گونه ادغام کنید:

4:-3L@.7(1w,0h)+0L@.7(1w,0.5h),1L@.7(1w,0h)+-2L@.7(1w,0.5h)

برای چاپ دورو با لبه‌ی کوتاه (short-edge duplex)، عبارت به این صورت است:

4:-3L@.7(1w,0h)+0L@.7(1w,0.5h),1R@.7(0w,0.5h)+-2R@.7(0w,1h)

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

گزارش باگ‌ها (BUGS)

pstops تمام کامنت‌های DSC را نمی‌پذیرد.