.\" .\" GNU enscript manual page. .\" Copyright (c) 1995-1999 Markku Rossi. .\" Author: Markku Rossi .\" .\" .\" This file is part of GNU Enscript. .\" .\" Enscript is free software: you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation, either version 3 of the License, or .\" (at your option) any later version. .\" .\" Enscript is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with Enscript. If not, see . .\" .TH ENSCRIPT 1 "Mar 12, 1999" "ENSCRIPT" "ENSCRIPT" .SH "نام (NAME)" enscript \- تبدیل فایل‌های متنی به PostScript، HTML، RTF، ANSI و overstrikeها .SH "خلاصه دستور (SYNOPSIS)" .B enscript [\f3\-123456789BcgGhjkKlmOqrRvVzZ\f1] [\f3\-# \f2copies\f1] [\f3\-a \f2pages\f1] [\f3\-A \f2align\f1] [\f3\-b \f2header\f1] [\f3\-C\f1[\f2start_line\f1]] [\f3\-d \f2printer\f1] [\f3\-D \f2key\f1[\f3:\f2value\f1]] [\f3\-e\f1[\f2char\f1]] [\f3\-E\f1[\f2lang\f1]] [\f3\-f \f2font\f1] [\f3\-F \f2header_font\f1] [\f3\-H\f1[\f2num\f1]] [\f3\-i \f2indent\f1] [\f3\-I \f2filter\f1] [\f3\-J \f2title\f1] [\f3\-L \f2lines_per_page\f1] [\f3\-M \f2media\f1] [\f3\-n \f2copies\f1] [\f3\-N \f2newline\f1] [\f3\-o \f2outputfile\f1] [\f3\-o \-\f1] [\f3\-p \f2outputfile\f1] [\f3\-p \-\f1] [\f3\-P \f2printer\f1] [\f3\-s \f2baselineskip\f1] [\f3\-S \f2key\f1[\f3:\f2value\f1]] [\f3\-t \f2title\f1] [\f3\-T \f2tabsize\f1] [\f3\-u\f1[\f2text\f1]] [\f3\-U \f2num\f1] [\f3\-w \f2language\f1] [\f3\-X \f2encoding\f1] [\f2filename\f1 ...] .SH "توضیحات (DESCRIPTION)" برنامهٔ \f3Enscript\f1 فایل‌های متنی را به PostScript یا زبان‌های خروجی دیگر تبدیل می‌کند. \f3Enscript\f1 می‌تواند خروجی تولیدشده را مستقیماً به یک چاپگر مشخص ارسال کند (spool کند) یا آن را در یک فایل ذخیره نماید. در صورتی که هیچ فایل ورودی مشخص نشود، \f3enscript\f1 ورودی استاندارد \f3stdin\f1 را پردازش می‌کند. \f3Enscript\f1 قابلیت توسعه برای پشتیبانی از انواع مختلف رسانه‌های خروجی (media) را دارد و دارای گزینه‌های متعددی است که می‌توان از آن‌ها برای سفارشی‌سازی خروجی‌های چاپ استفاده کرد. .SH "گزینه‌ها (OPTIONS)" .TP 8 .B \-# \f2num\f3 چاپ \f2num\f1 نسخه از هر صفحه. .TP 8 .B \-1, \-2, \-3, \-4, \-5, \-6, \-7, \-8, \-9, \-\-columns=\f2num\f3 مشخص می‌کند که هر صفحه چند ستون داشته باشد. با گزینهٔ بلند \f3\-\-columns=\f2num\f1 می‌توانید بیش از ۹ ستون در هر صفحه تعیین کنید. .TP 8 .B \-a \f2pages\f3, \-\-pages=\f2pages\f3 مشخص می‌کند کدام صفحات چاپ شوند. مشخصهٔ صفحات \f2pages\f1 می‌تواند در قالب‌های زیر داده شود: .RS 8 .TP 8 \f2begin\f1\-\f2end\f1 چاپ صفحات از \f2begin\f1 تا \f2end\f1 .TP 8 \-\f2end\f1 چاپ صفحات از 0 تا \f2end\f1 .TP 8 \f2begin\f1\- چاپ صفحات از \f2begin\f1 تا انتها .TP 8 \f2page\f1 چاپ صفحهٔ \f2page\f1 .TP 8 odd چاپ صفحات فرد .TP 8 even چاپ صفحات زوج .RE .TP 8 .B \-A \f2align\f3, \-\-file\-align=\f2align\f3 تراز کردن فایل‌های ورودی مجزا با تعداد صفحات مضربی از \f2align\f1. این گزینه در چاپ دو رو و چاپ ۲ صفحه در ۱ صفحه (2-up) مفید است (\-\-file\-align=2). .TP 8 .B \-b \f2header\f3, \-\-header=\f2header\f3 استفاده از متن \f2header\f1 به عنوان سربرگ صفحه. سربرگ پیش‌فرض صفحه بر اساس نام فایل و زمان آخرین تغییر آن ساخته می‌شود. رشتهٔ سربرگ \f2header\f1 می‌تواند شامل همان نویسه‌های گریز قالب‌بندی باشد که می‌توان برای دستورالعمل‌های \f3%Format\f1 در سربرگ‌های سفارشی تعریف‌شده توسط کاربر تعیین کرد. برای نمونه، گزینهٔ زیر نام فایل، تاریخ جاری و شمارهٔ صفحات را چاپ می‌کند: \f3enscript \-\-header='$n %W Page $% of $=' *.c\f1 رشتهٔ سربرگ همچنین می‌تواند شامل فیلدهای چپ‌چین، وسط‌چین و راست‌چین باشد. فیلدها با نویسهٔ \f3'|'\f1 از یکدیگر جدا می‌شوند: \f3enscript \-\-header='$n|%W|Page $% of $=' *.c\f1 اکنون نام فایل به صورت چپ‌چین، تاریخ در وسط سربرگ و شماره‌های صفحه به صورت راست‌چین چاپ می‌شوند. .TP 8 .B \-B, \-\-no\-header عدم چاپ سربرگ‌های صفحه. .TP 8 .B \-c, \-\-truncate\-lines بریدن خطوطی که برای صفحه بیش از حد طولانی هستند. به طور پیش‌فرض، \f3enscript\f1 خطوط طولانی را به خط بعدی می‌شکند تا هیچ اطلاعاتی از دست نرود. همچنین می‌توانید از گزینهٔ \f3\-\-slice\f1 استفاده کنید که خطوط طولانی را به صفحات جداگانه برش می‌دهد. .TP 8 .B \-C\f1[\f2start_line\f1]\f3, \-\-line\-numbers\f1[\f3=\f2start_line\f1]\f3 درج شمارهٔ خط در ابتدای هر سطر. آرگومان اختیاری \f2start_line\f1 شمارهٔ اولین خط در ورودی را تعیین می‌کند. مقدار پیش‌فرض شمارهٔ خط اول 1 است. .TP 8 .B \-d \f2name\f3 ارسال خروجی (spool) به چاپگر \f2name\f1. .TP 8 .B \-D \f2key\f1[\f3:\f2value\f1]\f3, \-\-setpagedevice=\f2key\f1[\f3:\f2value\f1]\f3 ارسال یک تعریف دستگاه صفحه (page device definition) به خروجی PostScript تولیدشده. اگر مقداری مشخص نشود، کلید \f2key\f1 از تعاریف حذف می‌شود. برای نمونه، دستور .B enscript \-DDuplex:true foo.txt فایل foo.txt را در حالت دو رو (duplex) چاپ می‌کند. عملگرهای دستگاه صفحه وابسته به پیاده‌سازی هستند اما استاندارد شده‌اند. برای جزئیات بخش \f3PAGE DEVICE OPTIONS\f1 را ببینید. .TP 8 .B \-e\f1[\f2char\f1]\f3, \-\-escapes\f1[\f3=\f2char\f1]\f3 فعال کردن تفسیر نویسه‌های گریز ویژه (بخش \f3SPECIAL ESCAPES\f1 را ببینید). اگر آرگومان \f2char\f1 داده شود، نویسهٔ گریز را به \f2char\f1 تغییر می‌دهد. نویسهٔ گریز پیش‌فرض 0 است. .TP 8 .B \-E\f1[\f2lang\f1]\f3, \-\-highlight\f1[\f3=\f2lang\f1]\f3 برجسته‌سازی نحو کد منبع (highlight) با ایجاد یک فیلتر ورودی ویژه از طریق برنامهٔ \f3states\f1. آرگومان اختیاری \f2lang\f1 زبان مورد نظر برای برجسته‌سازی را تعیین می‌کند. به طور پیش‌فرض، برنامهٔ \f3states\f1 زبانی را بر اساس حدس هوشمندانه انتخاب می‌کند. می‌توانید شرح مختصری از زبان‌ها و قالب‌های فایل پشتیبانی‌شده را با دستور زیر چاپ کنید: .B enscript \-\-help\-highlight قواعد برجسته‌سازی در فایل‌های `/usr/share/enscript/hl/*.st' تعریف شده‌اند که می‌توان آن‌ها را برای تعریف برجسته‌سازی زبان‌های جدید ویرایش کرد. \f3نکته!\f1 با این گزینه نمی‌توانید از فیلترهای ورودی شخصی خود استفاده کنید. .TP 8 .B \-f \f2name\f3, \-\-font=\f2name\f3 انتخاب قلمی که برای متن بدنه استفاده می‌شود. قلم پیش‌فرض بدنه \f3Courier10\f1 است، مگر این‌که حالت چاپ چندستونه و افقی (landscape) انتخاب شده باشد که در این صورت قلم پیش‌فرض \f3Courier7\f1 خواهد بود. مشخصهٔ قلم \f2name\f1 شامل دو بخش است: نام قلم و اندازهٔ آن بر حسب پوینت‌های PostScript. برای نمونه، "\f3Times\-Roman12\f1" قلم "Times\-Roman" را با اندازهٔ 12pt انتخاب می‌کند. مشخصهٔ قلم \f2name\f1 همچنین می‌تواند در قالب `\f2name\f1@\f2ptsize\f1' داده شود که در آن نام قلم و اندازهٔ پوینت آن با یک نویسهٔ `@' از یکدیگر جدا می‌شوند. این قابلیت به \f3enscript\f1 امکان می‌دهد از قلم‌هایی استفاده کند که در نامشان ارقام وجود دارد. اندازهٔ پوینت قلم همچنین می‌تواند در قالب \f2width\f1/\f2height\f1 مشخص شود که در آن \f2width\f1 و \f2height\f1 اندازهٔ قلم را در جهت‌های x و y تعیین می‌کنند. برای نمونه، "\f3Times\-Roman@10/12\f1" یک قلم "Times\-Roman" با پهنای 10 پوینت و ارتفاع 12 پوینت را انتخاب می‌کند. همچنین می‌توانید اندازهٔ قلم‌ها را به صورت اعداد اعشاری وارد کنید. برای نمونه، "\f3Times\-Roman10.2\f1" یک قلم "Times\-Roman" با اندازهٔ 10.2pt را انتخاب می‌کند..TP 8 .B \-F \f2name\f3, \-\-header\-font=\f2name\f3 انتخاب قلم برای متن‌های سربرگ. .TP 8 .B \-g, \-\-print\-anyway چاپ فایل حتی در صورت وجود داده‌های دودویی (باینری). این گزینه صرفاً برای اهداف سازگاری پیاده‌سازی شده است. \f3Enscript\f1 در هر حال بدون توجه به این گزینه فایل‌های دودویی را چاپ می‌کند. .TP 8 .B \-G, \-\-fancy\-header\f1[\f3=\f2name\f1]\f3 چاپ یک سربرگ تزیینی صفحه به نام \f2name\f1 در بالای هر صفحه. گزینه \f3\-G\f1 سربرگ تزیینی پیش‌فرض را تعیین می‌کند. برای مشاهده نحوه تغییر سربرگ تزیینی پیش‌فرض، بخش \f3CONFIGURATION FILES\f1 را ببینید. .TP 8 .B \-h, \-\-no\-job\-header جلوگیری از چاپ صفحه سربرگ کار. .TP 8 .B \-H\f1[\f2num\f1]\f3, \-\-highlight\-bars\f1[\f3=\f2num\f1]\f3 تعیین ارتفاع نوارهای برجسته‌سازی بر حسب سطر. اگر \f2num\f1 مشخص نشود، مقدار پیش‌فرض ۲ استفاده می‌شود. به‌طور پیش‌فرض، هیچ نوار برجسته‌سازی چاپ نمی‌شود. .TP 8 .B \-i \f2num\f3, \-\-indent=\f2num\f3 تودندانه کردن هر خط به اندازه \f2num\f1 نویسه. تورفتگی را می‌توان با افزودن شناسه واحد پس از عدد، در واحدهای دیگر نیز تعیین کرد. شناسه‌های واحدهای مجاز و واحدهای متناظر آن‌ها عبارتند از: .RS 8 .TP 8 .B c سانتی‌متر .TP 8 .B i اینچ .TP 8 .B l نویسه (پیش‌فرض) .TP 8 .B p پوینت‌های PostScript .RE .TP 8 .B \-I \f2filter\f3, \-\-filter=\f2filter\f1 خواندن تمام فایل‌های ورودی از طریق فیلتر ورودی \f2filter\f1. فیلتر ورودی می‌تواند یک دستور منفرد یا یک خط لوله از دستورها باشد. فیلتر می‌تواند با کد گریز `\f3%s\f1' به نام فایل ورودی ارجاع دهد. نام ورودی استاندارد را می‌توان با گزینه `\f3\-\-filter\-stdin\f1' تغییر داد. برای مثال، دستور زیر فایل `foo.c' را تنها با نویسه‌های بزرگ چاپ می‌کند: .B enscript \-\-filter="cat %s | tr 'a-z' 'A-Z'" foo.c دستور زیر تغییراتی را که از آخرین checkout در فایل‌ها اعمال شده است برجسته می‌کند: .B enscript \-\-filter="rcsdiff %s | diffpp %s" \-e *.c برای گنجاندن رشته "%s" در دستور فیلتر، باید آن را به صورت "%%s" بنویسید. .TP 8 .B \-j, \-\-borders چاپ حاشیه در اطراف ستون‌ها. .TP 8 .B \-J \f2title\f3 نام مستعاری برای گزینه \f3\-t\f1، \f3\-\-title\f1. .TP 8 .B \-k, \-\-page\-prefeed فعال‌سازی تغذیه پیشاپیش صفحه (page prefeed). .TP 8 .B \-K, \-\-no\-page\-prefeed غیرفعال‌سازی تغذیه پیشاپیش صفحه (پیش‌فرض). .TP 8 .B \-l, \-\-lineprinter شبیه‌سازی چاپگر سطری (lineprinter). این گزینه میان‌بری برای گزینه‌های \f3\-\-lines\-per\-page=66\f1 و \f3\-\-no\-header\f1 است. .TP 8 .B \-L \f2num\f3, \-\-lines\-per\-page=\f2num\f3 چاپ فقط \f2num\f1 خط در هر صفحه. به‌طور پیش‌فرض، تعداد خطوط هر صفحه بر اساس ارتفاع صفحه و اندازه قلم محاسبه می‌شود. .TP 8 .B \-m, \-\-mail ارسال یک اعلان ایمیلی به کاربر پس از اتمام کار چاپ. .TP 8 .B \-M \f2name\f3, \-\-media=\f2name\f3 انتخاب رسانه خروجی \f2name\f1. رسانه خروجی پیش‌فرض \f3Enscript\f1 برابر \f3A4\f1 است. .TP 8 .B \-n \f2num\f3, \-\-copies=\f2num\f3 چاپ \f2num\f1 نسخه از هر صفحه. .TP 8 .B \-N \f2nl\f3, \-\-newline=\f2nl\f3 انتخاب نویسه خط جدید (\f2newline\f1). مقادیر ممکن برای \f2nl\f1 عبارتند از: \f3n\f1 (خط جدید یونیکس، 0xa هگز) و \f3r\f1 (خط جدید مک، 0xd هگز). .TP 8 .B \-o \f2file\f3 نام مستعاری برای گزینه \f3\-p\f1، \f3\-\-output\f1. .TP 8 .B \-O, \-\-missing\-characters چاپ فهرستی از کدهای نویسه‌ای که امکان چاپ آن‌ها وجود نداشت. .TP 8 .B \-p \f2file\f3, \-\-output=\f2file\f3 ذخیره خروجی در فایل \f2file\f1. اگر \f2file\f1 برابر `\-' باشد، enscript خروجی را به خروجی استاندارد \f3stdout\f1 می‌فرستد. .TP 8 .B \-P \f2name\f3, \-\-printer=\f2name\f3 ارسال خروجی به صف چاپگر \f2name\f1 (spool). .TP 8 .B \-q, \-\-quiet, \-\-silent کاملاً بی‌صدا کردن \f3enscript\f1. تنها پیام‌های خطای مهلک در \f2stderr\f1 چاپ می‌شوند. .TP 8 .B \-r, \-\-landscape چاپ در حالت افقی (landscape)؛ چرخاندن صفحه به میزان ۹۰ درجه. .TP 8 .B \-R, \-\-portrait چاپ در حالت عمودی (portrait) (پیش‌فرض). .TP 8 .B \-s \f2num\f3, \-\-baselineskip=\f2num\f3 تعیین فاصله خط کرسی بر حسب پوینت‌های PostScript. عدد \f2num\f1 می‌تواند به صورت یک عدد اعشاری داده شود. هنگامی که \f3enscript\f1 از خطی به خط دیگر می‌رود، مختصات \f2y\f1 نقطه جاری به میزان (\f2font point size + baselineskip\f1) پوینت به پایین جابه‌جا می‌شود. فاصله خط کرسی پیش‌فرض ۱ است. .TP 8 .B \-S \f2key\f1[\f3:\f2value\f1]\f3, \-\-statusdict=\f2key\f1[\f3:\f2value\f1]\f3 ارسال یک تعریف statusdict به خروجی PostScript تولیدشده. اگر مقداری داده نشود، کلید \f2key\f1 از تعاریف حذف می‌شود. عملگرهای statusdict وابسته به پیاده‌سازی هستند؛ برای جزئیات به مستندات چاپگر مراجعه کنید. برای مثال، دستور .B enscript \-Ssetpapertray:1 foo.txt فایل \f2foo.txt\f1 را با استفاده از کاغذ سینی ۱ چاپ می‌کند (با این فرض که چاپگر از انتخاب سینی کاغذ پشتیبانی کند). .TP 8 .B \-t \f2title\f3, \-\-title=\f2title\f3 تنظیم عنوان کار در صفحه بنر روی \f2title\f1. این گزینه همچنین نام فایل ورودی \f3stdin\f1 را تعیین می‌کند. .TP 8 .B \-T \f2num\f3, \-\-tabsize=\f2num\f3 تنظیم اندازه تب (tabulator) به اندازه \f2num\f1 نویسه. مقدار پیش‌فرض ۸ است. .TP 8 .B \-u\f1[\f2text\f1]\f3, \-\-underlay\f1[\f3=\f2text\f1]\f3 چاپ رشته متنی \f2text\f1 زیر هر صفحه (پس‌زمینه). ویژگی‌های متن را می‌توان با گزینه‌های \f3\-\-ul\-angle\f1، \f3\-\-ul\-font\f1، \f3\-\-ul\-gray\f1، \f3\-\-ul\-position\f1 و \f3\-\-ul\-style\f1 تغییر داد. اگر \f2text\f1 داده نشود، متن زیرین چاپ نمی‌شود. از این حالت می‌توان برای حذف متن زیرینی که با گزینه فایل پیکربندی `\f3Underlay\f1' مشخص شده بود استفاده کرد. .TP 8 .B \-U \f2num\f3, \-\-nup=\f2num\f3 چاپ \f2num\f1 صفحه منطقی در هر صفحه خروجی (چاپ N\-up). مقدار \f2num\f1 باید توانی از ۲ باشد. .TP 8 .B \-v, \-\-verbose\f1[\f3=\f2level\f1]\f3 گزارش آنچه \f3enscript\f1 در حال انجام آن است. .TP 8 .B \-V, \-\-version چاپ اطلاعات نسخه \f3enscript\f1 و خروج. .TP 8 .B \-w \f1[\f2lang\f1]\f3, \-\-language\f1[\f3=\f2lang\f1]\f3 تولید خروجی برای زبان \f2lang\f1. مقادیر مجاز برای \f2lang\f1 عبارتند از: .RS 8 .TP 8 .B PostScript تولید PostScript (پیش‌فرض) .TP 8 .B html تولید HTML .TP 8 .B overstrike تولید overstrike (برای چاپگرهای سطری، less) .TP 8 .B rtf تولید RTF (Rich Text Format) .TP 8 .B ansi تولید کدهای کنترلی ترمینال ANSI .RE .TP 8 .B \-X \f2name\f3, \-\-encoding=\f2name\f3 استفاده از کدگذاری ورودی \f2name\f1. در حال حاضر \f3enscript\f1 از کدگذاری‌های زیر پشتیبانی می‌کند: .RS 8 .TP 8 .B 88591, latin1 ISO\-8859\-1 (ISO Latin1) (کدگذاری پیش‌فرض \f3enscript\f1). .TP 8 .B 88592, latin2 ISO\-8859\-2 (ISO Latin2) .TP 8 .B 88593, latin3 ISO\-8859\-3 (ISO Latin3).TP 8 .B 88594, latin4 کدگذاری ISO\-8859\-4 (لاتین۴ ISO) .TP 8 .B 88595, cyrillic کدگذاری ISO\-8859\-5 (سیریلیک ISO) .TP 8 .B 88597, greek کدگذاری ISO\-8859\-7 (یونانی ISO) .TP 8 .B 88599, latin5 کدگذاری ISO\-8859\-9 (لاتین۵ ISO) .TP 8 .B 885910, latin6 کدگذاری ISO\-8859\-10 (لاتین۶ ISO) .TP 8 .B ascii کدگذاری ascii هفت بیتی .TP 8 .B asciifise, asciifi, asciise کدگذاری ascii هفت بیتی همراه با برخی افزونه‌های اسکاندیناویایی (فنلاند، سوئد) .TP 8 .B asciidkno, asciidk, asciino کدگذاری ascii هفت بیتی همراه با برخی افزونه‌های اسکاندیناویایی (دانمارک، نروژ) .TP 8 .B ibmpc, pc, dos مجموعه نویسهٔ IBM PC .TP 8 .B mac مجموعه نویسهٔ Mac .TP 8 .B vms مجموعه نویسهٔ چندملیتی VMS .TP 8 .B hp8 مجموعه نویسهٔ HP Roman-8 .TP 8 .B koi8 مجموعه نویسهٔ قلم سیریلیک استاندارد ادوبی KOI8 .TP 8 .B ps, PS کدگذاری پیش‌فرض قلم PostScript .TP 8 .B pslatin1, ISOLatin1Encoding کدگذاری \(lqISOLatin1Encoding\(rq در مفسر PostScript .RE .TP 8 .B \-z, \-\-no\-formfeed تفسیر نویسهٔ پرش صفحه (form feed) را غیرفعال می‌کند. .TP 8 .B \-Z, \-\-pass\-through تمام فایل‌های PostScript و PCL را بدون هیچ تغییری عبور می‌دهد. این کار اجازه می‌دهد \f3enscript\f1 به عنوان یک فیلتر lp استفاده شود. فایل‌های PostScript با بررسی کوکی جادویی \(lq%!\(rq در ابتدای فایل شناسایی می‌شوند. \f3توجه!\f1 دستور \f3Enscript\f1 همچنین کوکی آسیب‌دیدهٔ ویندوزی \(lq^D%!\(rq را نیز شناسایی می‌کند. فایل‌های PCL با بررسی کوکی‌های جادویی \(lq^[E\(rq یا \(lq^[%\(rq در ابتدای فایل شناسایی می‌شوند. .TP 8 .B \-\-color\f1[\f3=\f2bool\f1]\f3 از رنگ‌ها در خروجی‌های برجسته‌سازی استفاده می‌کند. .TP 8 .B \-\-download\-font=\f2fontname\f3 فایل توصیف قلم (فایل \f2.pfa\f1 یا \f2.pfb\f1) مربوط به قلم \f2fontname\f1 را در خروجی تولیدشده می‌گنجاند. .TP 8 .B \-\-extended\-return\-values مقدارهای بازگشتی گسترش‌یافته را فعال می‌کند. به‌طور پیش‌فرض، \f3enscript\f1 هنگام بروز خطا ۱ و در غیر این صورت ۰ برمی‌گرداند. مقدارهای بازگشتی گسترش‌یافته جزئیات بیشتری دربارهٔ عملیات چاپ ارائه می‌دهند. برای جزئیات بخش \f3RETURN VALUE\f1 را ببینید. .TP 8 .B \-\-filter\-stdin=\f2name\f1 مشخص می‌کند که \f3stdin\f1 چگونه به فیلتر ورودی نشان داده شود. مقدار پیش‌فرض یک رشتهٔ خالی ("") است، اما برخی برنامه‌ها نیازمند آن هستند که \f3stdin\f1 با نام دیگری، معمولاً "-"، خوانده شود. .TP 8 .B \-\-footer=\f2footer\f3 از متن \f2footer\f1 به عنوان پاورقی صفحه استفاده می‌کند. در غیر این صورت، این گزینه مانند گزینهٔ \f3\-\-header\f1 عمل می‌کند. .TP 8 .B \-\-h\-column\-height=\f2height\f3 ارتفاع ستون افقی را روی \f2height\f1 نقطهٔ PostScript تنظیم می‌کند. این گزینه نوع برگه‌خور را به \f3horizontal\-columns\f1 تنظیم می‌کند. .TP 8 .B \-\-help پیام راهنمای کوتاهی نمایش داده و خارج می‌شود. .TP 8 .B \-\-help\-highlight تمامی زبان‌ها و قالب‌های پروندهٔ پشتیبانی‌شده برای \f3\-\-highlight\f1 را شرح می‌دهد. .TP 8 .B \-\-highlight\-bar\-gray=\f2gray\f3 سطح خاکستری مورداستفاده در چاپ نوارهای برجسته را مشخص می‌کند. .TP 8 .B \-\-list\-media نام تمامی رسانه‌های خروجی شناخته‌شده را فهرست کرده و با موفقیت خارج می‌شود. .TP 8 .B \-\-margins=\f2left\f3:\f2right\f3:\f2top\f3:\f2bottom\f3 حاشیه‌های صفحه را دقیقاً روی مقادیر نقطه‌ای PostScript برای \f2left\f1 (چپ)، \f2right\f1 (راست)، \f2top\f1 (بالا) و \f2bottom\f1 (پایین) تنظیم می‌کند. هر یک از این آرگومان‌ها می‌توانند خالی رها شوند که در این صورت از مقدار پیش‌فرض استفاده می‌شود. .TP 8 .B \-\-mark\-wrapped\-lines\f1[\f3=\f2style\f1]\f3 خطوط پیچیده‌شده را در خروجی با سبک \f2style\f1 مشخص می‌کند. مقادیر ممکن برای \f2style\f1 عبارتند از: .RS 8 .TP 8 .B none آن‌ها را علامت‌گذاری نکن (پیش‌فرض) .TP 8 .B plus یک نویسهٔ مثبت (+) در انتهای هر خط پیچیده‌شده چاپ کن .TP 8 .B box یک جعبهٔ سیاه در انتهای هر خط پیچیده‌شده چاپ کن .TP 8 .B arrow یک فلش کوچک در انتهای هر خط پیچیده‌شده چاپ کن .RE .TP 8 .B \-\-non\-printable\-format=\f2format\f3 نحوهٔ چاپ نویسه‌های غیرقابل‌چاپ را مشخص می‌کند. مقادیر ممکن برای \f2format\f1 عبارتند از: .RS 8 .TP 8 .B caret نماد هشتک (caret): \(lq^@\(rq، \(lq^A\(rq، \(lq^B\(rq، ... .TP 8 .B octal نماد هشت‌هشتی (octal): \(lq\\000\(rq، \(lq\\001\(rq، \(lq\\002\(rq، ... (پیش‌فرض) .TP 8 .B questionmark نویسه‌های غیرقابل‌چاپ را با یک علامت سؤال \(lq?\(rq جایگزین می‌کند .TP 8 .B space نویسه‌های غیرقابل‌چاپ را با یک فاصله \(lq \(rq جایگزین می‌کند .RE .TP 8 .B \-\-nup\-columnwise چیدمان زیرصفحه‌ها را در چاپ N\-up از حالت سطری به حالت ستونی تغییر می‌دهد. .TP 8 .B \-\-nup\-xpad=\f2num\f3 فاصلهٔ لبهٔ افقی (x-padding) صفحه را در چاپ \f2n\f1-up روی \f2num\f1 نقطهٔ PostScript تنظیم می‌کند. مقدار پیش‌فرض ۱۰ نقطه است. .TP 8 .B \-\-nup\-ypad=\f2num\f3 فاصلهٔ لبهٔ عمودی (y-padding) صفحه را در چاپ \f2n\f1-up روی \f2num\f1 نقطهٔ PostScript تنظیم می‌کند. مقدار پیش‌فرض ۱۰ نقطه است. .TP 8 .B \-\-page\-label\-format=\f2format\f3 قالب برچسب صفحه را روی \f2format\f1 تنظیم می‌کند. قالب برچسب صفحه مشخص می‌کند که برچسب‌ها برای توضیحات PostScript از نوع \(lq%%Page:\(rq چگونه قالب‌بندی شوند. مقادیر ممکن عبارتند از: .RS 8 .TP 8 .B short شماره صفحهٔ فعلی را چاپ می‌کند: \(lq%%Page: (1) 1\(rq (پیش‌فرض) .TP 8 .B long نام فایل فعلی و شماره صفحه را چاپ می‌کند: \(lq%%Page: (main.c: 1) 1\(rq .RE .TP 8 .B \-\-ps\-level=\f2level\f3 سطح زبان PostScript که \f3enscript\f1 برای خروجی خود استفاده می‌کند را روی \f2level\f1 تنظیم می‌کند. مقادیر ممکن \f31\f1 و \f32\f1 هستند. .TP 8 .B \-\-printer\-options=\f2options\f3 گزینه‌های اضافی را به دستور چاپگر ارسال می‌کند. .TP 8 .B \-\-rotate\-even\-pages هر صفحه با شمارهٔ زوج را ۱۸۰ درجه می‌چرخاند. .TP 8 .B \-\-slice=\f2num\f3 برش عمودی \f2num\f1 را چاپ می‌کند. برش‌ها بخش‌های عمودی فایل‌های ورودی هستند. یک برش جدید از نقطه‌ای آغاز می‌شود که در غیر این صورت خط به خط بعد پیچیده می‌شد. شماره‌گذاری برش‌ها از ۱ شروع می‌شود. .TP 8 .B \-\-style=\f2style\f3 سبک برجسته‌سازی را روی \f2style\f1 تنظیم می‌کند. مقادیر ممکن عبارتند از: \f3a2ps\f1، \f3emacs\f1، \f3emacs_verbose\f1، \f3ifh\f1 و \f3msvc\f1. .TP 8 .B \-\-swap\-even\-page\-margins حاشیه‌های چپ و راست صفحات دارای شمارهٔ زوج را با یکدیگر تعویض می‌کند. .TP 8 .B \-\-toc یک جدول فهرست مطالب در انتهای خروجی چاپ می‌کند. .TP 8 .B \-\-word\-wrap خطوط طولانی را از مرز کلمات می‌شکند. .TP 8 .B \-\-ul\-angle=\f2angle\f3 زاویهٔ متن زیرلایه (underlay) را روی \f2angle\f1 تنظیم می‌کند. به‌طور پیش‌فرض، این زاویه برابر با \f3atan(\-d_page_h, d_page_w)\f1 است..TP 8 .B \-\-ul\-font=\f2name\f3 انتخاب قلم برای متن زیرلایه (underlay). قلم پیش‌فرض متن زیرلایه \f3Times-Roman200\f1 است. .TP 8 .B \-\-ul\-gray=\f2num\f3 چاپ متن زیرلایه با مقدار خاکستری \f2num\f1 (از ۰ تا ۱)؛ مقدار خاکستری پیش‌فرض .8 است. .TP 8 .B \-\-ul\-position=\f2position_spec\f3 تنظیم موقعیت آغازین متن زیرلایه بر اساس \f2position_spec\f1. مشخصه موقعیت باید در قالب `\f2sign\f1 \f2xpos\f1 \f2sign\f1 \f2ypos\f1' داده شود، که در آن \f2sign\f1 باید `+' یا `\-' باشد. ابعاد مثبت از گوشه پایین سمت چپ و ابعاد منفی از گوشه بالا سمت راست محاسبه می‌شوند. برای نمونه، مشخصه `+0\-0' گوشه بالا سمت چپ و `\-0+0' گوشه پایین سمت راست را مشخص می‌کند. .TP 8 .B \-\-ul\-style=\f2style\f3 تنظیم سبک متن زیرلایه به \f2style\f1. مقادیر ممکن برای \f2style\f1 عبارت‌اند از: .RS 8 .TP 8 .B outline چاپ متن‌های زیرلایه به صورت توخالی/طرح بیرونی (پیش‌فرض) .TP 8 .B filled چاپ متن‌های زیرلایه به صورت توپر .RE .SH "فایل‌های پیکربندی (CONFIGURATION FILES)" دستور .B Enscript اطلاعات پیکربندی را از منابع زیر (به همین ترتیب) می‌خواند: گزینه‌های خط فرمان، متغیر محیطی \f3ENSCRIPT\f1، فایل پیکربندی شخصی کاربر (\f3$HOME/.enscriptrc\f1)، فایل پیکربندی سایت (\f3/etc/enscript/enscriptsite.cfg\f1) و فایل پیکربندی سراسری سیستم (\f3/etc/enscript/enscript.cfg\f1). فایل‌های پیکربندی قالب زیر را دارند: خطوط خالی و خطوطی که با `#' آغاز می‌شوند، کامنت (توضیحات) هستند. تمام خطوط دیگر، خطوط تنظیم گزینه هستند و قالب زیر را دارند: \f2option\f1 [\f2arguments ...\f1]. گزینه‌های زیر را می‌توان مشخص کرد: .TP 8 .B AcceptCompositeCharacters: \f2bool\f1 مشخص می‌کند که آیا نویسه‌های ترکیبی (composite characters) قلم PostScript به عنوان نویسه قابل چاپ پذیرفته شوند یا به عنوان نویسه‌های ناموجود در نظر گرفته شوند. مقدار پیش‌فرض false (0) است. .TP 8 .B AFMPath: \f2path\f3 مسیر جستجو برای فایل‌های \f2AFM\f1 را مشخص می‌کند. .TP 8 .B AppendCtrlD: \f2bool\f3 مشخص می‌کند که آیا نویسه Control-D (^D) به انتهای خروجی افزوده شود یا خیر. مقدار پیش‌فرض false (0) است. .TP 8 .B Clean7Bit: \f2bool\f3 نحوه چاپ نویسه‌های بزرگ‌تر از ۱۲۷ را مشخص می‌کند. مقدار true (1) با تبدیل نویسه‌های بزرگ‌تر از ۱۲۷ به نشانه‌گذاری هشت‌هشتی با بک‌اسلش (backslash-octal)، کد تمیز ۷ بیتی تولید می‌کند (پیش‌فرض). مقدار false (0) کد ۸ بیتی PostScript تولید کرده و تمام نویسه‌ها را دست‌نخورده باقی می‌گذارد. .TP 8 .B DefaultEncoding: \f2name\f3 انتخاب کدگذاری ورودی پیش‌فرض. نام کدگذاری \f2name\f1 می‌تواند یکی از مقادیر گزینه \f3\-X\f1 یا \f3\-\-encoding\f1 باشد. .TP 8 .B DefaultFancyHeader: \f2name\f3 انتخاب سربرگ تزئینی پیش‌فرض. سربرگ پیش‌فرض هنگامی استفاده می‌شود که گزینه \f3\-G\f1 مشخص شده باشد یا گزینه \f3\-\-fancy\-header\f1 بدون آرگومان داده شود. مقدار پیش‌فرض سراسری سیستم `\f3enscript\f1' است. .TP 8 .B DefaultMedia: \f2name\f3 انتخاب رسانه (media) خروجی پیش‌فرض. .TP 8 .B DefaultOutputMethod: \f2method\f3 انتخاب مقصد پیش‌فرضی که خروجی تولیدشده به آن ارسال می‌شود. مقادیر ممکن برای \f2method\f1 عبارت‌اند از: .RS 8 .TP 8 .B printer ارسال خروجی به چاپگر (پیش‌فرض) .TP 8 .B stdout ارسال خروجی به \f3stdout\f1 .RE .TP 8 .B DownloadFont: \f2fontname\f3 گنجاندن فایل توصیف قلم مربوط به قلم \f2fontname\f1 در خروجی تولیدشده. .TP 8 .B EscapeChar: \f2num\f3 مشخص کردن نویسه گریز برای دنباله‌های گریز ویژه. مقدار پیش‌فرض 0 است. .TP 8 .B FormFeedType: \f2type\f3 مشخص می‌کند در صورت مواجهه با نویسه برگه‌خور (formfeed) در ورودی چه اقدامی صورت گیرد. مقادیر ممکن برای \f2type\f1 عبارت‌اند از: .RS 8 .TP 8 .B column رفتن به ابتدای ستون بعدی (پیش‌فرض) .TP 8 .B page رفتن به ابتدای صفحه بعدی .RE .TP 8 .B GeneratePageSize: \f2bool\f3 مشخص می‌کند که آیا تنظیمات دستگاه صفحه \f3PageSize\f1 در خروجی PostScript تولید شود یا خیر. مقدار پیش‌فرض true (1) است. .TP 8 .B HighlightBarGray: \f2gray\f3 مشخص کردن سطح خاکستری مورد استفاده برای چاپ نوارهای برجسته (highlight bars). .TP 8 .B HighlightBars: \f2num\f3 مشخص می‌کند ارتفاع نوارهای برجسته چند خط باشد. مقدار پیش‌فرض 0 است که به معنای چاپ نشدن هیچ نوار برجسته‌ای است. .TP 8 .B LibraryPath: \f2path\f3 مسیر کتابخانه \f3enscript\f1 را برای جستجوی منابع مختلف مشخص می‌کند. مسیر پیش‌فرض عبارت است از: `/usr/share/enscript:\f2home\f1/.enscript'. که در آن \f2home\f1 دایرکتوری خانگی کاربر است. .TP 8 .B MarkWrappedLines: \f2style\f3 علامت‌گذاری خط‌های شکسته شده (wrap شده) در خروجی با سبک \f2style\f1. مقادیر ممکن برای \f2format\f1 همان مقادیری هستند که می‌توان برای گزینه \f3\-\-mark\-wrapped\-lines\f1 مشخص کرد. .TP 8 \f3Media: \f2name\f3 \f2width\f3 \f2height\f3 \f2llx\f3 \f2lly\f3 \f2urx\f3 \f2ury\f3 افزودن یک رسانه خروجی جدید با نام \f2name\f1. ابعاد فیزیکی رسانه \f2width\f1 و \f2height\f1 هستند. کادر تحدید (bounding box) رسانه توسط نقاط (\f2llx\f1, \f2lly\f1) و (\f2urx\f1, \f2ury\f1) مشخص می‌شود. \f3Enscript\f1 تمام نگاره‌ها را درون کادر تحدید رسانه چاپ می‌کند. کاربر می‌تواند این رسانه را با گزینه \f3\-M \f2name\f1 انتخاب کند. .TP 8 .B NoJobHeaderSwitch: \f2switch\f1 مشخص کردن گزینه اسپولر برای چشم‌پوشی از چاپ صفحه سربرگ کار. این گزینه زمانی به اسپولر چاپگر ارسال می‌شود که گزینه \f3\-h\f1 یا \f3\-\-no\-job\-header\f1 در \f3enscript\f1 انتخاب شده باشد. .TP 8 .B NonPrintableFormat: \f2format\f1 مشخص می‌کند که نویسه‌های غیرقابل‌چاپ چگونه چاپ شوند. مقادیر ممکن برای \f2format\f1 همان‌هایی است که می‌توان برای گزینه \f3\-\-non\-printable\-format\f1 مشخص کرد. .TP 8 .B OutputFirstLine: \f2line\f1 تنظیم سطر نخست خروجی PostScript به \f2line\f1. مقدار پیش‌فرض \f3PS-Adobe-3.0\f1 است. از آن‌جایی که برخی چاپگرها سطوح DSC بالاتر از 2.0 را نمی‌پذیرند، این گزینه می‌تواند برای تغییر خط نخست خروجی به مقداری مناسب‌تر مانند \f3%!PS-Adobe-2.0\f1 یا \f3%!\f1 به کار رود. .TP 8 .B PageLabelFormat: \f2format\f1 تنظیم قالب برچسب صفحه به \f2format\f1. مقادیر ممکن برای \f2format\f1 همان‌هایی است که می‌توان برای گزینه \f3\-\-page\-label\-format\f1 مشخص کرد. .TP 8 .B PagePrefeed: \f2bool\f3 فعال یا غیرفعال کردن پیش‌خوراندن صفحه (page prefeed). مقدار پیش‌فرض false (0) است. .TP 8 .B PostScriptLevel: \f2level\f3 تنظیم سطح زبان PostScript که \f3enscript\f1 برای خروجی استفاده می‌کند به \f2level\f1. مقادیر ممکن برای \f2level\f1 همان مقادیری است که می‌توان برای گزینه \f3\-\-ps\-level\f1 مشخص کرد. .TP 8 .B Printer: \f2name\f3 تعیین نام چاپگری که خروجی برای آن صف‌بندی (spool) می‌شود. .TP 8 .B QueueParam: \f2name\f3 سوئیچ دستور اسپولر برای انتخاب صف چاپگر؛ برای نمونه \f3\-P\f1 در \f3lpr \-Pps\f1. از این گزینه همچنین می‌توان برای ارسال سایر پرچم‌ها به دستور اسپولر استفاده کرد. این گزینه‌ها باید قبل از سوئیچ صف مشخص شوند. .TP 8 .B SetPageDevice: \f2key\f1[\f3:\f2value\f1]\f3 ارسال تعریف page device به خروجی PostScript تولیدشده. .TP 8 .B Spooler: \f2name\f3 تعیین دستور اسپولر چاپگر. \f3Enscript\f1 خروجی PostScript تولیدشده را به دستور \f2name\f1 لوله‌کشی (pipe) می‌کند. .TP 8 .B StatesBinary: \f2path\f3 تعیین یک مسیر مطلق برای برنامه \f3states\f1. .TP 8 .B StatesColor: \f2bool\f3 آیا برنامه \f3states\f1 باید خروجی رنگی تولید کند یا خیر. .TP 8 .B StatesConfigFile: \f2file\f3 خواندن پیکربندی حالت‌های برجسته‌سازی از فایل \f2file\f1. فایل پیکربندی پیش‌فرض `/usr/share/enscript/hl/enscript.st' است. .TP 8 .B StatesHighlightStyle: \f2style\f3 تنظیم سبک برجسته‌سازی به \f2style\f1..TP 8 .B StatesPath: \f2path\f3 مسیر برنامه \f3states\f1 را مشخص می‌کند. برنامه \f3states\f1 فایل‌های تعریف وضعیت خود را از این مسیر جستجو خواهد کرد. مقدار پیش‌فرض `$HOME/.enscript:/usr/share/enscript/hl' است. .TP 8 .B StatusDict: \f2key\f1[\f3:\f2value\f1]\f3 یک تعریف statusdict را به خروجی PostScript تولیدشده ارسال می‌کند. .TP 8 .B TOCFormat: \f2format\f3 ورودی‌های جدول محتوا (فهرست مطالب) را با رشته قالب \f2format\f1 قالب‌بندی می‌کند. رشته قالب \f2format\f1 می‌تواند شامل همان دنباله‌های گریزی باشد که برای قالب‌بندی رشته‌های سرصفحه با توضیح ویژه `%Format' استفاده می‌شوند. .TP 8 .B Underlay: \f2text\f3 رشته \f2text\f1 را در زیر متن هر صفحه (به عنوان پس‌زمینه) چاپ می‌کند. .TP 8 .B UnderlayAngle: \f2num\f3 زاویه متن پس‌زمینه را روی \f2num\f1 تنظیم می‌کند. .TP 8 .B UnderlayFont: \f2fontspec\f3 یک قلم برای متن پس‌زمینه انتخاب می‌کند. .TP 8 .B UnderlayGray: \f2num\f3 متن پس‌زمینه را با مقدار روشنایی خاکستری \f2num\f1 چاپ می‌کند. .TP 8 .B UnderlayPosition: \f2position_spec\f3 موقعیت شروع متن پس‌زمینه را بر اساس \f2position_spec\f1 تنظیم می‌کند. .TP 8 .B UnderlayStyle: \f2style\f3 سبک متن پس‌زمینه را روی \f2style\f1 تنظیم می‌کند. .SH "سرصفحه‌های سفارشی (FANCY HEADERS)" کاربران می‌توانند با ساخت یک فایل توصیف سرصفحه و قرار دادن آن در دایرکتوری‌ای که در مسیر کتابخانه \f3enscript\f1 باشد، سرصفحه‌های سفارشی خود را ایجاد کنند. نام فایل سرصفحه باید در قالب `\f2headername\f1.hdr' باشد. سرصفحه را می‌توان با مشخص کردن گزینه \f3\-\-fancy\-header=\f2headername\f1 انتخاب کرد. فایل توصیف سرصفحه شامل کد PostScript است که سرصفحه را ترسیم می‌کند. فایل توصیف باید رویه \f3do_header\f1 را ارائه دهد که توسط \f3enscript\f1 در ابتدای هر صفحه فراخوانی می‌شود. فایل توصیف سرصفحه شامل دو بخش است: توضیحات و کد. این بخش‌ها توسط خطی حاوی متن زیر از هم جدا می‌شوند: % \-\- code follows this line \-\- .B Enscript تنها بخش کد فایل توصیف را به خروجی PostScript تولیدشده کپی می‌کند. بخش توضیحات می‌تواند حاوی هر داده‌ای باشد و کپی نمی‌شود. اگر خط جداکننده وجود نداشته باشد، هیچ داده‌ای به خروجی کپی نخواهد شد. .B Enscript ثابت‌های زیر را تعریف می‌کند که می‌توان از آن‌ها در فایل‌های توصیف سرصفحه استفاده کرد: .TP 16 .B d_page_w عرض صفحه .TP 16 .B d_page_h ارتفاع صفحه .TP 16 .B d_header_x مختصات \f2x\f1 گوشه پایین-چپ سرصفحه .TP 16 .B d_header_y مختصات \f2y\f1 گوشه پایین-چپ سرصفحه .TP 16 .B d_header_w عرض سرصفحه .TP 16 .B d_header_h ارتفاع سرصفحه .TP 16 .B d_footer_x مختصات \f2x\f1 گوشه پایین-چپ پانویس .TP 16 .B d_footer_y مختصات \f2y\f1 گوشه پایین-چپ پانویس .TP 16 .B d_footer_w عرض پانویس .TP 16 .B d_footer_h ارتفاع پانویس .TP 16 .B d_output_w عرض ناحیه خروجی متن .TP 16 .B d_output_h ارتفاع ناحیه خروجی متن .TP 16 .B user_header_p گزاره‌ای که مشخص می‌کند آیا کاربر رشته سرصفحه خود را تعریف کرده است یا خیر: \f3true\f1/\f3false\f1 .TP 16 .B user_header_left_str اگر \f3user_header_p\f1 برابر با \f3true\f1 باشد، این فیلد سمت چپ رشته سرصفحه ارائه‌شده توسط کاربر است. .TP 16 .B user_header_center_str اگر \f3user_header_p\f1 برابر با \f3true\f1 باشد، این فیلد مرکزی رشته سرصفحه ارائه‌شده توسط کاربر است .TP 16 .B user_header_right_str اگر \f3user_header_p\f1 برابر با \f3true\f1 باشد، این فیلد سمت راست رشته سرصفحه ارائه‌شده توسط کاربر است .TP 16 .B user_footer_p گزاره‌ای که مشخص می‌کند آیا کاربر رشته پانویس خود را تعریف کرده است یا خیر: \f3true\f1/\f3false\f1 .TP 16 .B user_footer_left_str اگر \f3user_footer_p\f1 برابر با \f3true\f1 باشد، این فیلد سمت چپ رشته پانویس ارائه‌شده توسط کاربر است. .TP 16 .B user_footer_center_str اگر \f3user_footer_p\f1 برابر با \f3true\f1 باشد، این فیلد مرکزی رشته پانویس ارائه‌شده توسط کاربر است .TP 16 .B user_footer_right_str اگر \f3user_footer_p\f1 برابر با \f3true\f1 باشد، این فیلد سمت راست رشته پانویس ارائه‌شده توسط کاربر است .TP 16 .B HF قلم استاندارد سرصفحه (از گزینه \f3\-F\f1، \f3\-\-header\-font\f1). این قلم را می‌توان به‌سادگی با اجرای دستور `\f3HF setfont\f1' انتخاب کرد. .TP 16 .B pagenum شماره صفحه جاری .TP 16 .B fname نام کامل فایل چاپ‌شده (/foo/bar.c) .TP 16 .B fdir بخش دایرکتوریِ نام فایل (/foo) .TP 16 .B ftail نام فایل بدون بخش دایرکتوری (bar.c) .TP 16 .B gs_languagelevel سطح زبان مفسر PostScript (در حال حاضر ۱ یا ۲) .P همچنین می‌توانید از توضیحات ویژه زیر برای سفارشی‌سازی سرصفحه‌های خود و مشخص کردن برخی گزینه‌های اضافی استفاده کنید. توضیحات ویژه مانند توضیحات DSC هستند، اما با یک نویسه `%' آغاز می‌شوند؛ توضیحات ویژه از ابتدای خط شروع شده و ساختار دستوری زیر را دارند: %\f2commentname\f1: \f2options\f1 در حال حاضر \f3enscript\f1 از توضیحات ویژه زیر پشتیبانی می‌کند: .TP 8 .B %Format: \f2name\f3 \f2format\f3 یک ثابت رشته‌ای جدید با نام \f2name\f1 را مطابق با رشته قالب‌بندی \f2format\f1 تعریف می‌کند. رشته قالب‌بندی از نخستین نویسه غیرفاصله شروع شده و در انتهای خط پایان می‌یابد. رشته قالب‌بندی می‌تواند شامل گریزهای عمومی `%' و گریزهای مربوط به فایل ورودی `$' باشد. در حال حاضر دنباله‌های گریز زیر پشتیبانی می‌شوند: .RS 8 .TP 8 .B %% نویسه `%' .TP 8 .B $$ نویسه `$' .TP 8 .B $% شماره صفحه جاری .TP 8 .B $= تعداد صفحات در فایل جاری .TP 8 .B $p تعداد صفحاتی که تاکنون پردازش شده‌اند .TP 8 .B $(\f2VAR\f3) مقدار متغیر محیطی \f2VAR\f1. .TP 8 .B %c مؤلفه انتهایی دایرکتوری کاری جاری .TP 8 .B %C \f1(\f3$C\f1)\f3 زمان جاری (زمان ویرایش فایل) در قالب `hh:mm:ss' .TP 8 .B %d دایرکتوری کاری جاری .TP 8 .B %D \f1(\f3$D\f1)\f3 تاریخ جاری (تاریخ ویرایش فایل) در قالب `yy-mm-dd' .TP 8 .B %D{\f2string\f3} \f1(\f3$D{\f2string\f3}\f1)\f3 رشته \f2string\f1 را با تابع strftime(3) قالب‌بندی می‌کند. `\f3%D{}\f1' به تاریخ جاری و `\f3$D{}\f1' به تاریخ آخرین تغییرات فایل ورودی اشاره دارد. .TP 8 .B %E \f1(\f3$E\f1)\f3 تاریخ جاری (تاریخ ویرایش فایل) در قالب `yy/mm/dd'.TP 8 .B %F \f1(\f3$F\f1)\f3 تاریخ جاری (تاریخ تغییر فایل) در قالب `dd.mm.yyyy' .TP 8 .B %H عنوان سند .TP 8 .B $L تعداد خطوط در فایل ورودی جاری. این مورد فقط برای مدخل‌های فهرست مطالب (toc) معتبر است و نمی‌توان از آن در رشته‌های سرآیند استفاده کرد. .TP 8 .B %m نام میزبان تا اولین نویسهٔ `.' .TP 8 .B %M نام کامل میزبان .TP 8 .B %n نام کاربری (لاگین) .TP 8 .B $n نام فایل ورودی بدون بخش دایرکتوری .TP 8 .B %N فیلد pw_gecos کاربر تا اولین نویسهٔ `,' .TP 8 .B $N نام کامل فایل ورودی .TP 8 .B %t \f1(\f3$t\f1)\f3 زمان جاری (زمان تغییر فایل) در قالب ۱۲ ساعته am/pm .TP 8 .B %T \f1(\f3$T\f1)\f3 زمان جاری (زمان تغییر فایل) در قالب ۲۴ ساعته `hh:mm' .TP 8 .B %* \f1(\f3$*\f1)\f3 زمان جاری (زمان تغییر فایل) در قالب ۲۴ ساعته همراه با ثانیه `hh:mm:ss' .TP 8 .B $v شمارهٔ ترتیبی فایل ورودی جاری .TP 8 .B $V شمارهٔ ترتیبی فایل ورودی جاری در قالب «Table of Contents» (فهرست مطالب): اگر گزینهٔ \f3\-\-toc\f1 داده شده باشد، کد گریز به `\f2num\f1\-' گسترش می‌یابد؛ اگر \f3\-\-toc\f1 داده نشده باشد، به یک رشتهٔ خالی تبدیل می‌شود. .TP 8 .B %W \f1(\f3$W\f1)\f3 تاریخ جاری (تاریخ تغییر فایل) در قالب `mm/dd/yy' .RE .RS 8 تمام دستورالعمل‌های قالب‌بندی به جز `$=' را می‌توان در قالب زیر نیز مشخص کرد: \f2escape\f1 \f2width\f1 \f2directive\f1 که در آن \f2width\f1 عرض ستونی را تعیین می‌کند که کد گریز در آن چاپ می‌شود. برای مثال، کد گریز "$5%" به چیزی شبیه " 12" گسترش خواهد یافت. اگر مقدار عرض منفی باشد، مقدار به صورت چپ‌چین چاپ خواهد شد. برای مثال، فایل `emacs.hdr' رشتهٔ تاریخ خود را با کامنت قالب زیر تعریف می‌کند: .B %Format: eurdatestr %E که به مقدار زیر گسترش می‌یابد: .B /eurdatestr (96/01/08) def .RE .P .TP 8 .B %HeaderHeight: \f2height\f1 تخصیص فضای \f2height\f1 نقطه برای سرآیند صفحه. ارتفاع پیش‌فرض سرآیند ۳۶ نقطه است. .TP 8 .B %FooterHeight: \f2height\f1 تخصیص فضای \f2height\f1 نقطه برای پانویس صفحه. ارتفاع پیش‌فرض پانویس ۰ نقطه است. .P طبق قراردادهای ساختاردهی سند ادوبی (DSC)، تمام منابع مورد نیاز یک سند باید در بخش آغازین (prolog) سند فهرست شوند. از آنجا که کاربران می‌توانند سرآیندهای اختصاصی خود را بسازند، \f3enscript\f1 نمی‌داند که این سرآیندها از چه منابعی استفاده می‌کنند. به همین دلیل، تمام سرآیندها باید حاوی یک کامنت استاندارد DSC باشند که کلیهٔ منابع مورد نیاز را فهرست کند. به عنوان مثال، فونت‌های استفاده‌شده را می‌توان با کامنت زیر فهرست کرد: %%DocumentNeededResources: font \f2fontname1\f1 \f2fontname2\f1 کامنت را می‌توان با کامنت ادامه‌دهندهٔ استاندارد در خط بعد ادامه داد: %%+ font \f2fontname3\f1 .SH "کدهای گریز ویژه (SPECIAL ESCAPES)" دستور \f3enscript\f1 از دنباله‌های گریز ویژه پشتیبانی می‌کند که می‌توان از آن‌ها برای افزودن برخی دستورات قالب‌بندی صفحه به اسناد ASCII استفاده کرد. به طور پیش‌فرض، تفسیر کدهای گریز ویژه غیرفعال است، بنابراین تمام فایل‌های ASCII همان‌طور که انتظار می‌رود چاپ می‌شوند. تفسیر کدهای گریز ویژه با دادن گزینهٔ \f3\-e\f1 یا \f3\-\-escapes\f1 به \f3enscript\f1 فعال می‌شود. تمام کدهای گریز ویژه با نویسهٔ گریز آغاز می‌شوند. نویسهٔ گریز پیش‌فرض ^@ (اکتال 000) است؛ نویسهٔ گریز را می‌توان با گزینهٔ \f3\-e\f1 یا \f3\-\-escapes\f1 تغییر داد. پس از نویسهٔ گریز، نام گریز و گزینه‌ها و آرگومان‌های اختیاری قرار می‌گیرند. در حال حاضر \f3enscript\f1 از کدهای گریز زیر پشتیبانی می‌کند: .TP 8 .B bgcolor تغییر رنگ پس‌زمینهٔ متن. نحو این کد گریز به صورت زیر است: ^@bgcolor{\f2red\f1 \f2green\f1 \f2blue\f1} که در آن مؤلفه‌های رنگی \f2red\f1، \f2green\f1 و \f1blue\f1 به صورت اعداد اعشاری بین مقادیر 0 و 1 مشخص می‌شوند. .TP 8 .B bggray تغییر رنگ پس‌زمینهٔ متن. نحو این کد گریز به صورت زیر است: ^@bggray{\f2gray\f1} که در آن \f2gray\f1 مقدار خاکستری جدید پس‌زمینهٔ متن است. مقدار پیش‌فرض 1.0 (سفید) است. .TP 8 .B color تغییر رنگ متن. نحو این کد گریز به صورت زیر است: ^@color{\f2red\f1 \f2green\f1 \f2blue\f1} که در آن مؤلفه‌های رنگی \f2red\f1، \f2green\f1 و \f2blue\f1 به صورت اعداد اعشاری بین مقادیر 0 و 1 مشخص می‌شوند. .TP 8 .B comment کامنت کردن بقیهٔ خط شامل نویسهٔ خط جدید. نحو این کد گریز عبارت است از: ^@comment \f2text\f1 \f2newline_character\f1 .TP 8 .B escape تغییر نویسهٔ گریز. نحو این کد گریز عبارت است از: ^@escape{\f2code\f1} که در آن \f2code\f1 کد ده‌دهی نویسهٔ گریز جدید است. .TP 8 .B epsf درج درون‌خطی (inline) فایل EPS در سند. نحو این کد گریز عبارت است از: ^@epsf[\f2options\f1]{\f2filename\f1} که در آن \f2options\f1 دنباله‌ای اختیاری از نویسه‌ها و مقادیر گزینه درون براکت‌ها بوده و \f2filename\f1 نام فایل EPS است. اگر \f2filename\f1 به نویسهٔ `|' ختم شود، آنگاه فرض می‌شود که \f2filename\f1 نام دستوری است که داده‌های EPS را در خروجی استاندارد خود چاپ می‌کند. در این حالت، \f3enscript\f1 یک لوله (pipe) به دستور مشخص‌شده باز کرده و داده‌های EPS را از لوله می‌خواند. گزینه‌های زیر را می‌توان برای کد گریز \f3epsf\f1 مشخص کرد: .RS 8 .TP 8 .B c چاپ تصویر به صورت وسط‌چین .TP 8 .B r چاپ تصویر به صورت راست‌چین .TP 8 .B n عدم به‌روزرسانی مکان جاری. خروجی بعدی در همان موقعیتی چاپ می‌شود که نقطهٔ جاری دقیقاً پیش از کد گریز \f3epsf\f1 در آن قرار داشت .TP 8 .B nx عدم به‌روزرسانی مختصات \f2x\f1 نقطهٔ جاری .TP 8 .B ny عدم به‌روزرسانی مختصات \f2y\f1 نقطهٔ جاری .TP 8 .B x\f2num\f3 انتقال مختصات \f2x\f1 گوشهٔ بالا-چپ تصویر به اندازهٔ \f2num\f1 نویسه از مختصات \f2x\f1 نقطهٔ جاری (موقعیت نسبی) .TP 8 .B x\f2num\f3a تنظیم مختصات \f2x\f1 گوشهٔ بالا-چپ تصویر در ستون \f2num\f1 (موقعیت مطلق) .TP 8 .B y\f2num\f3 انتقال مختصات \f2y\f1 گوشهٔ بالا-چپ تصویر به اندازهٔ \f2num\f1 خط از خط جاری (موقعیت نسبی) .TP 8 .B y\f2num\f3a تنظیم مختصات \f2y\f1 گوشهٔ بالا-چپ تصویر در خط \f2num\f1 (موقعیت مطلق) .TP 8 .B h\f2num\f3 تنظیم ارتفاع تصویر به اندازهٔ \f2num\f1 خط.TP 8 .B s\f2num\f3 مقیاس‌بندی تصویر با ضریب \f2num\f1 .TP 8 .B sx\f2num\f3 مقیاس‌بندی تصویر در راستای \f2x\f1 با ضریب \f2num\f1 .TP 8 .B sy\f2num\f3 مقیاس‌بندی تصویر در راستای \f2y\f1 با ضریب \f2num\f1 .P به‌طور پیش‌فرض، تمام ابعاد بر حسب خطوط (عمودی) و نویسه‌ها (افقی) مشخص می‌شوند. همچنین می‌توانید با افزودن یک مشخص‌کنندهٔ واحد پس از عدد، واحدهای دیگری را تعیین کنید. مشخص‌کننده‌های واحد ممکن و واحدهای متناظر آن‌ها عبارتند از: .TP 8 .B c سانتی‌متر .TP 8 .B i اینچ .TP 8 .B l خطوط یا نویسه‌ها (پیش‌فرض) .TP 8 .B p پوینت‌های PostScript .P به‌عنوان مثال، برای چاپ تصویری با ارتفاع یک اینچ، می‌توانید ارتفاع را با گزینه‌های زیر مشخص کنید: \f3h1i\f1 (۱ اینچ)، \f3h2.54c\f1 (۲٫۵۴ سانتی‌متر)، \f3h72p\f1 (۷۲ پوینت). .RE .TP 8 .B font انتخاب قلم جاری. نحو این توالی گریز (escape) به‌صورت زیر است: ^@font{\f2fontname\f1[:\f2encoding\f1]} که در آن \f2fontname\f1 یک مشخصهٔ استاندارد قلم است. مشخصهٔ ویژهٔ قلم \f3default\f1 می‌تواند برای انتخاب قلم پیش‌فرض بدنه به کار رود (پیش‌فرض \f3enscript\f1 یا قلم تعیین‌شده توسط گزینهٔ خط فرمان \f3\-f\f1 یا \f3\-\-font\f1). آرگومان اختیاری \f2encoding\f1 کدگذاری مورد استفاده برای قلم جدید را تعیین می‌کند. در حال حاضر، این کدگذاری تنها می‌تواند کدگذاری ورودی سراسری \f3enscript\f1 یا \f3ps\f1 باشد. .TP 8 .B ps گنجاندن کد خام PostScript در خروجی. نحو این توالی گریز به‌صورت زیر است: ^@ps{\f2code\f1} .TP 8 .B shade برجسته‌سازی بخش‌هایی از متن با تغییر رنگ پس‌زمینهٔ متن. نحو این توالی گریز به‌صورت زیر است: ^@shade{\f2gray\f1} که در آن \f2gray\f1 مقدار جدید خاکستری پس‌زمینهٔ متن است. مقدار پیش‌فرض 1.0 (سفید) است که برجسته‌سازی را غیرفعال می‌کند. .SH "گزینه‌های دستگاه صفحه (PAGE DEVICE OPTIONS)" دستگاه صفحه (Page device) یکی از قابلیت‌های سطح ۲ زبان PostScript است که رابطی یکپارچه برای کنترل دستگاه خروجی چاپگر ارائه می‌دهد. \f3Enscript\f1 تمام گزینه‌های دستگاه صفحه را درون یک بلوک شرطی if محافظت می‌کند تا در مفسرهای سطح ۱ بی‌اثر باشند. اگرچه تمام مفسرهای سطح ۲ از دستگاه صفحه پشتیبانی می‌کنند، اما نیازی نیست که از تمام گزینه‌های آن پشتیبانی به عمل آورند. برای نمونه، برخی از چاپگرها قابلیت چاپ دورو دارند و برخی ندارند. برای گزینه‌های پشتیبانی‌شده به مستندات چاپگر خود مراجعه کنید. در ادامه برخی از گزینه‌های کاربردی دستگاه صفحه که می‌توان با گزینهٔ \f3\-D\f1 یا \f3\-\-setpagedevice\f1 انتخاب کرد آورده شده است. برای مشاهدهٔ فهرست کامل، به \f2PostScript Language Reference Manual\f1، بخش 4.11 Device Setup مراجعه کنید. .TP 8 .B Collate \f2boolean\f1 چگونگی مرتب‌سازی خروجی هنگام چاپ چند نسخه .TP 8 .B Duplex \f2boolean\f1 چاپ دورو (دو طرفه) .TP 8 .B ManualFeed \f2boolean\f1 سینی تغذیهٔ دستی کاغذ .TP 8 .B OutputFaceUp \f2boolean\f1 چاپ خروجی به‌صورت رو به بالا (`face up') یا رو به پایین (`face down') .TP 8 .B Tumble \f2boolean\f1 چگونگی جهت‌گیری صفحات مقابل هم در چاپ دورو .SH "مثال‌های چاپ (PRINTING EXAMPLES)" مثال‌های چاپ زیر با فرض این است که \f3enscript\f1 از پیکربندی پیش‌فرض استفاده می‌کند. اگر رفتارهای پیش‌فرض از طریق فایل‌های پیکربندی تغییر داده شده باشند، برخی مثال‌ها عملکرد متفاوتی خواهند داشت. .TP 8 .B enscript foo.txt چاپ فایل \f3foo.txt\f1 در چاپگر پیش‌فرض. .TP 8 .B enscript \-Possu foo.txt چاپ فایل \f3foo.txt\f1 در چاپگر \f3ossu\f1. .TP 8 .B enscript \-pfoo.ps foo.txt چاپ فایل \f3foo.txt\f1، اما هدایت خروجی PostScript به فایل \f3foo.ps\f1. .TP 8 .B enscript \-2 foo.txt چاپ فایل \f3foo.txt\f1 به‌صورت دو ستونه. .TP 8 .B enscript \-2r foo.txt چاپ فایل به‌صورت دو ستونه و چرخاندن خروجی به اندازهٔ ۹۰ درجه (افقی/landscape). .TP 8 .B enscript \-DDuplex:true foo.txt چاپ فایل در حالت دورو (دو طرفه) (وابسته به چاپگر). .TP 8 .B enscript \-G2rE \-U2 foo.c دستور پیش‌فرض من برای چاپ کد: سربرگ پرزرق‌وبرق (gaudy)، دو ستونه، افقی، برجسته‌سازی کد، چاپ دو صفحه در یک برگه (2-up). .TP 8 \f3enscript \-E \-\-color \-whtml \-\-toc \-pfoo.html *.h *.c\f1 یک گزارش زیبای HTML از فایل‌های منبع C پروژهٔ شما..SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" متغیر محیطی \f3ENSCRIPT\f1 می‌تواند برای انتقال گزینه‌های پیش‌فرض به \f3enscript\f1 استفاده شود. برای نمونه، جهت انتخاب فونت بدنه پیش‌فرض به صورت Times\-Roman 7pt، مقدار زیر را برای متغیر محیطی \f3ENSCRIPT\f1 تنظیم کنید: .TP 8 .B \-fTimes\-Roman7 .P مقدار متغیر \f3ENSCRIPT\f1 پیش از گزینه‌های خط فرمان پردازش می‌شود، بنابراین می‌توان از گزینه‌های خط فرمان برای بازنویسی این مقادیر پیش‌فرض استفاده کرد. متغیر \f3ENSCRIPT_LIBRARY\f1 دایرکتوری کتابخانه \f3enscript\f1 را مشخص می‌کند. از این متغیر می‌توان برای بازنویسی مقدار پیش‌فرض داخلی \(aq/usr/share/enscript\(aq استفاده کرد. .SH "مقدار بازگشتی (RETURN VALUE)" در صورت بروز هرگونه خطا، \f3Enscript\f1 مقدار 1 و در غیر این صورت مقدار 0 را به شل برمی‌گرداند. اگر گزینه \f3\-\-extended\-return\-values\f1 مشخص شده باشد، مقدار بازگشتی از پرچم‌های زیر ساخته می‌شود: .TP 8 .B 0 بدون هیچ‌گونه خطا یا هشدار .TP 8 .B 2 برخی از خطوط بریده یا شکسته شدند (wrap) .TP 8 .B 4 برخی نویسه‌ها در فونت‌های استفاده‌شده موجود نبودند .TP 8 .B 8 برخی نویسه‌ها غیرقابل‌چاپ بودند .SH "فایل‌ها (FILES)" .nf .ta 4i /usr/share/enscript/*.hdr فایل‌های سرآیند /usr/share/enscript/*.enc بردارهای کدگذاری ورودی /usr/share/enscript/enscript.pro پرولوگ PostScript /usr/share/enscript/afm/*.afm فایل‌های AFM برای فونت‌های PostScript /usr/share/enscript/font.map نمایه برای فایل‌های AFM /usr/share/enscript/hl/*.st فایل‌های تعریف states /etc/enscript/enscript.cfg فایل پیکربندی سراسری سیستم /etc/enscript/enscriptsite.cfg فایل پیکربندی سایت ~/.enscriptrc فایل پیکربندی شخصی ~/.enscript/ دایرکتوری منابع شخصی .fi .SH "همچنین ببینید (SEE ALSO)" diffpp(1), ghostview(1), gs(1), lpq(1), lpr(1), lprm(1), states(1) .SH "نویسنده (AUTHOR)" Markku Rossi صفحه وب خانگی GNU Enscript: