.\" This -*- nroff -*- source file is part of foomatic.

.hy 0
.TH FOOMATIC-RIP 1 "2013-11-06" "cups-filters"
.SH "نام (NAME)"
foomatic-rip \- فیلتر همگانی اسپولر چاپ برای تبدیل داده‌های چاپ به فرمت چاپگر
.SH "خلاصه دستور (SYNOPSIS)"

.SS "گزینه‌های عمومی (General Options)"
.BI \fBfoomatic-rip\fR\ \fB[-v]\ [-q]\fP \fI\ <mode-specific\ options>

.SS "فیلتر چاپ بدون اسپولر (Spooler-less printing filter)"
.BI \fBfoomatic-rip\fR\ \fB[\fB-P\fR \ \fI<printer>\fR \
| \ \fB--ppd\fR \ \fI<ppdfile>\fR \fB]\fR \ [\fB-J\fR\ \fI<jobtitle>\fR ]
[\fB-o\fR \ \fI<option>\fB=\fI<value>\fR \ [...]] \ \fB[\fI<files>\fB]\fR

.SS "فیلتر کاپس (CUPS filter)"
.BI \fBfoomatic-rip\fR\ \fI<jobid>\fR \ \fI<user>\fR \ \fI<jobtitle>\fR \ \fI<numcopies>\fR \ \fI<options>\fR \ \fB[\fI<file>\fB]\fR

.SH "توضیحات (DESCRIPTION)"
برنامه
.B foomatic-rip
یک فیلتر چاپ همگانی است که می‌تواند به‌عنوان فیلتر CUPS یا به‌صورت مستقل برای چاپ مستقیم و بدون اسپولر استفاده شود. این ابزار دارای ویژگی‌های زیر است:

.TP 2m
\[bu]
داده‌های PostScript و PDF را از ورودی استاندارد یا از یک فایل به زبان بومی چاپگر روی خروجی استاندارد ترجمه می‌کند.

.TP 2m
\[bu]
این ترجمه با یک پردازشگر (رندرر) خارجی انجام می‌شود، معمولاً Ghostscript
(\fBgs(1)\fR).
اگر نیازی به ترجمه نباشد (چاپگر PostScript)، خط فرمان پردازشگر به دستور
.B cat(1)
کاهش می‌یابد. نحوه انجام این ترجمه در یک
.B فایل PPD
شرح داده شده است.

.TP 2m
\[bu]
قابلیت‌های چاپگر، نحوه مدیریت گزینه‌های کاربر و نحوه ساخت خط فرمان پردازشگر همواره توسط
.B فایل‌های PPD
توصیف می‌شوند. این فایل‌های PPD معمولاً از
.B Foomatic
می‌آیند یا می‌توانند مواردی باشند که توسط سازندگان چاپگرهای PostScript ارائه شده‌اند. فایل‌های PPD هم برای CUPS و هم برای چاپ مستقیم یکسان هستند.

.TP 2m
\[bu]
ابزار
.B foomatic-rip
با
.B CUPS
و برای چاپ مستقیم
(\fBبدون اسپولر\fR)
کار می‌کند، که حالت دوم عمدتاً برای آزمایش و اشکال‌زدایی است. این حالت با گزینه‌های خط فرمان و متغیرهای محیطی که به foomatic-rip داده می‌شوند انتخاب می‌گردد.

.TP 2m
\[bu]
ابزار
.B foomatic-rip
نه تنها تنظیمات گزینه‌های ارائه‌شده توسط کاربر از طریق خط فرمان دستور چاپ را اعمال می‌کند، بلکه کل کار چاپ را برای یافتن تنظیمات گزینه‌های جاسازی‌شده (تنها در کارهای PostScript) جستجو می‌کند. در اینجا نه‌تنها تنظیماتی که بر کل کار تأثیر می‌گذارند اعمال می‌شوند، بلکه تنظیمات موجود در سربرگ صفحات که فقط برای صفحه مربوطه معتبر هستند نیز در نظر گرفته می‌شوند؛ بنابراین برنامه‌هایی که کد PostScript را با گزینه‌های اختصاصی صفحه تولید می‌کنند کاملاً پشتیبانی می‌شوند.

.SH "گزینه‌ها (OPTIONS)"

.TP 10
.B \-v
حالت پرگو برای اشکال‌زدایی.
.B هشدار:
این کار فایلی را در
.I /tmp
ایجاد می‌کند که حاوی اطلاعات اشکال‌زدایی است. این امر یک رخنه امنیتی ایجاد کرده و نباید در محیط عملیاتی استفاده شود.

.TP 10
.B \-q
حالت بی‌صدا \- حداقل اطلاعات خروجی.

.TP 10
.BI \-P \ <printer>
مقدار
.I <printer>
چاپگر پیکربندی‌شده‌ای است که باید برای این کار چاپ استفاده شود.

.TP 10
.BI \-\-ppd \ <ppdfile>
فایل PPD مشخص‌شده با
.I <ppdfile>
باید برای پردازش این کار چاپ اعمال گردد.

.TP 10
.BI \-o \ \fI<option>\fB=\fI<value>\fR
تنظیمات گزینه برای این کار چاپ.

.TP 10
.BI \fI<files>\fR
فایل یا فایل‌هایی که باید چاپ شوند.

.SH "چاپ مستقیم، بدون اسپولر (DIRECT, SPOOLER-LESS PRINTING)"
برنامه
.B foomatic-rip
از ورودی استاندارد چاپ خواهد کرد مگر آنکه حداقل یک فایل برای چاپ در خط فرمان مشخص شده باشد.
اگر فایل PPD چاپگر شما در مسیر
.I /etc/direct/<printer>.ppd
یا
.I ~/.foomatic/direct/<printer>.ppd
ذخیره شده است، می‌توانید تنها با تعیین
.BR "\-P " <printer>
از آن استفاده کنید.

.PP
خط زیر را:
.PP
\fB*FoomaticRIPPostPipe: "| \fI<command>\fB"\fR
.hy 0
.PP
دقیقاً پس از
\fB*PPD-Adobe: "4.3"\fR
در فایل PPD قرار دهید، که در آن
.I <command>
دستوری است که می‌خواهید داده‌های خروجی را به آن هدایت کنید. به دلیل محدودیت‌های فایل‌های PPD، کاراکترهای
\fB<\fR،
\fB>\fR
و
\fB"\fR
در
.I <command>
مجاز نیستند؛ آن‌ها را مطابق جدول زیر جایگزین کنید:

.ie t \
.  sp 0.2v
.el \
.  sp
.nf
.B Character	Replacement
.B ---------------------
.B		<	&lt;
.B		>	&gt;
.B		"	&quot;
.B		'	&apos;
.B		&	&amp;
.fi

.PP
به این ترتیب می‌توانید مستقیماً به چاپگر خود خروجی بفرستید؛ از
.PP
\fB*FoomaticRIPPostPipe: "| cat &gt; /dev/lp0"\fR
.PP
یا
.PP
\fB*FoomaticRIPPostPipe: "| cat &gt; /dev/usb/lp0"\fR
.PP
برای چاپگرهای محلی درگاه موازی (parallel) یا USB استفاده کنید. برای اینکه کاربران عادی بتوانند از این طریق چاپ کنند، آن‌ها را به گروه
.B lp
اضافه کرده و مطمئن شوید که فایل دستگاه چاپگر مربوطه در مسیر
.I /dev/...
برای گروه
.B lp
دارای مجوز نوشتن گروهی (group-writable) باشد.

.PP
برای چاپگر تحت شبکه TCP/Socket/JetDirect با نام میزبان
.B printer
که روی درگاه
.B 9100
گوش می‌دهد، به این خط نیاز دارید:
.PP
\fB*FoomaticRIPPostPipe: "| /usr/bin/nc -w 1 printer 9100"\fR
.PP
به گزینه
.B \-w 1
در خط فرمان
.B nc
توجه کنید؛ این گزینه باعث می‌شود
.B nc
بلافاصله پس از انتقال داده‌ها به چاپگر پایان یابد.
.PP
\fB*FoomaticRIPPostPipe: "| rlpr -Plp@printserver"\fR
.PP
کارهای چاپی شما را به صف چاپگر LPD با نام
.B lp
روی دستگاهی با نام
.B printserver
هدایت می‌کند.

.PP
همچنین ببینید:
http://www.openprinting.org/direct-doc.html

.SH "چاپ با اسپولر (PRINTING WITH SPOOLER)"
مستندات موجود در وب‌سایت OpenPrinting را ببینید:
.PP
.ft CW
http://www.openprinting.org
.ft R

.SH "فایل پیکربندی (CONFIGURATION FILE)"
فایل
\fB/etc/cups/foomatic-rip.conf\fR
یا در صورت عدم خوانایی، فایل
\fB/etc/foomatic/filter.conf\fR
در هر بار اجرای foomatic-rip خوانده می‌شود. این فایل امکان پیکربندی رفتار foomatic-rip را به شرح زیر فراهم می‌کند (خطوطی که با
.B #
آغاز می‌شوند توضیحات هستند و در نتیجه نادیده گرفته می‌شوند):

.TP 10
.B debug: 0|1
حالت اشکال‌زدایی را روشن
(\fB1\fR)
یا خاموش
(\fB0\fR)
می‌کند. این معادل ارائه گزینه خط فرمان
.B \-\-debug
است. مقدار پیش‌فرض
.B 0
است.

.TP 10
.BI echo: \ [<path>/]<executable>
مسیر فایل اجرایی
.BR echo (1)
را تعیین می‌کند که از
.B \-n
پشتیبانی کند.

.TP 10
.BI gspath: \ [<path>/]<executable>
مسیر فایل اجرایی Ghostscript
(\fBgs(1)\fR)
را تعیین می‌کند. برای زمانی استفاده می‌شود که Ghostscript در مکانی غیرمعمول باشد یا قرار باشد یک نسخه جایگزین از Ghostscript به کار رود.

.TP 10
.BI execpath: \ <path>[:<path>]...
متغیر محیطی
.B $PATH
را برای استفاده توسط foomatic-rip تنظیم می‌کند.

.TP 10
.BI cupsfilterpath: \ <path>[:<path>]...
دایرکتوری‌هایی را مشخص می‌کند (جداشده با دونقطه) که foomatic-rip در آن‌ها به دنبال فیلترهای CUPS می‌گردد.

.TP 10
.BI preferred_shell: \ [<path>/]<executable>
پوسته ترجیحی را برای اجرا هنگام فراخوانی FoomaticRIPCommandLine و متعلقات آن تعیین می‌کند. چندین فایل PPD از ساختارهای پوسته‌ای استفاده می‌کنند که نیازمند پوسته‌های جدیدتری مانند
.BR bash ،
.B zsh
یا
.B ksh
هستند.

.SH "فایل‌ها (FILES)"
.PD 0
.TP 0
/etc/cups/ppd/<printer>.ppd
.TP 0
/etc/direct/<printer>.ppd

فایل‌های PPD چاپگرهای تعریف‌شده کنونی

.TP 0
/etc/cups/foomatic-rip.conf
.TP 0
/etc/foomatic/filter.conf

فایل پیکربندی برای foomatic-rip

.PD 0

.SH "همچنین ببینید (SEE ALSO)"
.BR cups (1),
.BR gs (1),
.BR cat (1),
.BR echo (1)

.SH "وضعیت خروج (EXIT STATUS)"
دستور
.B foomatic-rip
در صورت عدم بروز رخدادی غیرمنتظره، مقدار 0 را برمی‌گرداند.

.SH "نویسندگان (AUTHORS)"
Till Kamppeter <\fItill.kamppeter@gmail.com\fR> به همراه بخش‌هایی از صفحات راهنمای Manfred Wassmanns <\fImanolo@NCC-1701.B.Shuttle.de\fR> برای فیلترهای Foomatic 2.0.x.

.SH "گزارش اشکالات (BUGS)"
تاکنون موردی گزارش نشده است.
.PP
لطفاً گزارش‌های اشکال را به سامانه ردیابی اشکالات OpenPrinting ارسال کنید:
.PP
http://bugs.linuxfoundation.org
.PP
از "OpenPrinting" به‌عنوان محصول و "cups-filters" به‌عنوان بخش مربوطه (component) استفاده کنید.