نام (NAME)

a2ps - قالببندی فایلها جهت چاپ روی چاپگر پستاسکریپت (PostScript)

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

a2ps [OPTION]... [FILE]...

توضیحات (DESCRIPTION)

تبدیل FILE(ها) یا ورودی استاندارد به پست‌اسکریپت (PostScript). به‌طور پیش‌فرض، خروجی به چاپگر پیش‌فرض فرستاده می‌شود. با استفاده از -o می‌توان یک فایل خروجی را مشخص کرد.

گزینهها (OPTIONS)

آرگومان‌های الزامی برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز الزامی هستند. گزینه‌های طولانی که با «*» مشخص شده‌اند به یک آرگومان yes/no نیاز دارند؛ گزینه‌های کوتاه متناظر معادل «yes» هستند.

وظایف (Tasks):

--version

نمایش نسخه

--help

نمایش این راهنما

--guess

گزارش انواع حدس‌زده‌شده برای FILES

--which

گزارش مسیر کامل فایل‌های کتابخانه‌ای با نام FILES

--glob

گزارش مسیر کامل فایل‌های کتابخانه‌ای منطبق با FILES

--list=defaults

نمایش تنظیمات و پارامترهای پیش‌فرض

--list=TOPIC

فهرست تفصیلی دربارهٔ TOPIC (شامل delegations، encodings، features، variables، media، ppd، printers، prologues، style-sheets، user-options)

پس از انجام وظیفه، خروج با موفقیت صورت می‌گیرد. فهرست‌های تفصیلی می‌توانند راهنمایی‌های بیشتری دربارهٔ قابلیت‌های خاص ارائه دهند.

عمومی (Global):

-q, --quiet, --silent

کاملاً بی‌صدا بودن (عدم نمایش پیام‌ها)

-v, --verbose[=LEVEL]

فعال‌سازی حالت پرجزئیات، یا تنظیم روی LEVEL

-=, --user-option=OPTION

استفاده از میانبر OPTION تعریف‌شده توسط کاربر

--debug

فعال‌سازی قابلیت‌های اشکال‌زدایی

-D, --define=KEY[:VALUE]

حذف متغیر KEY یا مقداردهی آن به VALUE

برگه‌ها (Sheets):

-M, --medium=NAME

استفاده از رسانه/اندازه کاغذ خروجی NAME

-r, --landscape

چاپ در حالت افقی (landscape)

-R, --portrait

چاپ در حالت عمودی (portrait)

--columns=NUM

تعداد ستون‌ها در هر برگه

--rows=NUM

تعداد سطرها در هر برگه

--major=DIRECTION

پر کردن ابتدا سطرها یا ستون‌ها (DIRECTION=)

-1, -2, ..., -9

اندازه‌های قلم و چیدمان‌های از پیش تعریف‌شده برای ۱ تا ۹ صفحهٔ مجازی

-A, --file-align=MODE

تراز کردن فایل‌های مجزا بر اساس MODE (مقادیر fill، rank page، sheet یا یک عدد)

-j, --borders*

چاپ کادر در اطراف ستون‌ها

--margin[=NUM]

تعیین یک حاشیهٔ داخلی به اندازهٔ NUM

گزینه‌های -1.. -9 بر چندین پارامتر اولیه جهت تنظیم چیدمان‌های از پیش تعریف‌شده با ۸۰ ستون تأثیر می‌گذارند. بنابراین ترتیب آن‌ها مهم است: '-R -f40 -2' معادل '-2' است. برای اصلاح چیدمان، از '-2Rf40' استفاده کنید، یا گزینه‌های اولیه را ترکیب نمایید (مانند --columns، --font-size و غیره).

صفحات مجازی (Virtual pages):

--line-numbers=NUM

درج شمارهٔ خط در ابتدای هر NUM خط

-C

نام مستعار برای --line-numbers=5

-f, --font-size=SIZE

استفاده از اندازه قلم SIZE (اعشاری) برای متن اصلی

-L, --lines-per-page=NUM

مقیاس‌بندی قلم برای چاپ NUM خط در هر صفحهٔ مجازی

-l, --chars-per-line=NUM

مقیاس‌بندی قلم برای چاپ NUM ستون در هر صفحهٔ مجازی

-m, --catman

پردازش FILE به عنوان یک صفحهٔ راهنما (man page) (مشابه -L66)

-T, --tabsize=NUM

تنظیم اندازهٔ تب‌گذار (tabulator) به NUM

--non-printable-format=FMT تعیین نحوهٔ چاپ کاراکترهای غیرقابل‌چاپ

سربرگ‌ها و پاورقی‌ها (Headings):

-B, --no-header

عدم چاپ هیچ‌گونه سربرگ در صفحات

-b, --header[=TEXT]

تنظیم سربرگ صفحه

-u, --underlay[=TEXT]

چاپ TEXT در زیر تمامی صفحات (پس‌زمینه)

--center-title[=TEXT]

تنظیم عنوان صفحه به TITLE

--left-title[=TEXT]

تنظیم عنوان چپ و راست صفحه به TEXT

--right-title[=TEXT]

--left-footer[=TEXT]

تنظیم پاورقی‌های برگه به TEXT

--footer[=TEXT]

--right-footer[=TEXT]

متن‌های TEXT ممکن است از توالی‌های گریز (escape) ویژه استفاده کنند.

ورودی (Input):

-a, --pages[=RANGE]

انتخاب صفحات جهت چاپ

-c, --truncate-lines*

بریدن خطوط طولانی

-i, --interpret*

تفسیر کاراکترهای tab، bs و ff

--end-of-line=TYPE

تعیین کاراکتر پایان خط (TYPE: r، n، nr، rn، any)

-X, --encoding=NAME

استفاده از کدگذاری ورودی NAME

-t, --title=NAME

تنظیم نام کار چاپ (job)

--stdin=NAME

تنظیم نام فایل ورودی stdin

--print-anyway*

اجبار به چاپ باینری

-Z, --delegate*

واگذاری فایل‌ها به برنامه‌ای دیگر

--toc[=TEXT]

تولید جدول فهرست مطالب

هنگامی که واگذاری‌ها فعال باشند، a2ps ممکن است از برنامه‌های دیگر برای پردازش فایل‌هایی استفاده کند که نباید به صورت اطلاعات خام چاپ شوند؛ مانند HTML، PostScript، PDF و غیره.

چاپ آراسته (Pretty-printing):

-E, --pretty-print[=LANG]

فعال‌سازی چاپ آراسته (تنظیم شیوه روی LANG)

--highlight-level=LEVEL

تنظیم سطح برجسته‌سازی در چاپ آراسته؛ LEVEL می‌تواند none، normal یا heavy باشد

-g

نام مستعار برای --highlight-level=heavy

--strip-level=NUM

سطح حذف توضیح‌ها (comments)

خروجی (Output):

-o, --output=FILE

ارسال خروجی به پروندهٔ FILE. اگر FILE برابر «-» باشد، خروجی به stdout فرستاده می‌شود.

--version-control=WORD

لغو کنترل نسخهٔ معمول

--suffix=SUFFIX

لغو پسوند پشتیبان‌گیری معمول

-P, --printer=NAME

ارسال خروجی به چاپگر NAME

-d

ارسال خروجی به چاپگر پیش‌فرض (این رفتار پیش‌فرض است)

پست‌اسکریپت (PostScript):

--prologue=FILE

گنجاندن FILE.pro به عنوان مقدمهٔ پست‌اسکریپت (PostScript prologue)

--ppd[=KEY]

انتخاب خودکار PPD یا تنظیم روی KEY

-n, --copies=NUM

چاپ NUM نسخه از هر صفحه

-s, --sides=MODE

تنظیم حالت دورو MODE (مقادیر '1' یا 'simplex'،

-S, --setpagedevice=K[:V]

ارسال تعریف pagedevice به خروجی

--statusdict=K[:[:]V]

ارسال تعریف statusdict به خروجی

-k, --page-prefeed

فعال کردن پیش‌تغذیهٔ صفحه (page prefeed)

-K, --no-page-prefeed

غیرفعال کردن پیش‌تغذیهٔ صفحه

به‌طور پیش‌فرض a2ps به گونه‌ای تنظیم شده است که آنچه می‌خواهید را انجام دهد، بنابراین به آن اعتماد کنید. برای چاپ آراستهٔ محتویات پوشهٔ 'src' و جدول فهرست مطالب، و ارسال نتیجه به چاپگر 'lw':

$ a2ps -P lw --toc src/*

برای پردازش فایل‌های 'sample.ps' و 'sample.html' و نمایش نتیجه:

$ a2ps -P display sample.ps sample.html

برای پردازش یک صندوق پستی به صورت ۴ صفحه در یک برگه:

$ a2ps -=mail -4 mailbox

برای چاپ به صورت یک دفترک روی چاپگر پیش‌فرض، با قابلیت چاپ دورو:

$ a2ps -=book paper.dvi.gz -d

فایل‌ها (FILES)

دستور a2ps چندین فایل را پیش از گزینه‌های خط فرمان می‌خواند. این پرونده‌ها به ترتیب عبارتند از:

1.

فایل پیکربندی سیستم (معمولاً /usr/local/etc/a2ps.cfg)، مگر اینکه متغیر محیطی A2PS_CONFIG را تعریف کرده باشید که در این صورت a2ps فایلی را که به آن اشاره شده می‌خواند؛

2.

فایل پیکربندی کاربر در پوشهٔ خانگی ($HOME/.a2ps/a2psrc)؛

3.

فایل .a2psrc در پوشهٔ جاری.

برای اطلاعات بیشتر، از جمله شرح ساختار فایل پیکربندی، به کتابچه راهنمای info مراجعه کنید.

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

نوشته‌شده توسط Akim Demaille، Miguel Santana و Reuben Thomas.

گزارش اشکالات (REPORTING BUGS)

گزارش اشکالات به: bug-a2ps@gnu.org
صفحه اصلی GNU a2ps: https://www.gnu.org/software/a2ps
راهنمای عمومی استفاده از نرم‌افزارهای گنو: https://www.gnu.org/gethelp

حق نشر (COPYRIGHT)

حق نشر © 2025 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc).
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html.
این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.

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

a2ps(1), card(1), fixps(1), pdiff(1).

مستندات کامل برای a2ps به‌صورت کتابچه راهنمای Texinfo نگهداری می‌شود. چنانچه برنامه‌های info و a2ps به‌درستی در سیستم شما نصب شده باشند، دستور

info a2ps

باید دسترسی شما به راهنمای کامل را فراهم کند.