.TH toilet 1 "2006-11-10" "libcaca @PACKAGE_VERSION@"
.SH "نام (NAME)"
TOIlet \- نمایش نویسه‌های بزرگ و رنگارنگ
.SH "خلاصه دستور (SYNOPSIS)"
.B toilet
[
.B \-hkostvSW
] [
.B \-d
.I fontdirectory
]
.PD 0
.IP
.PD
[
.B \-f
.I fontfile
] [
.B \-F
.I filter
] [
.B \-w
.I outputwidth
]
.PD 0
.IP
.PD
[
.B \-I
.I infocode
] [
.B \-E
.I format
] [
.I message
]
.RI
.SH "توضیحات (DESCRIPTION)"
برنامهٔ
.B TOIlet
متن را با استفاده از نویسه‌های بزرگی که از نویسه‌های کوچک‌تر ساخته شده‌اند چاپ می‌کند. این برنامه از بسیاری جهات شبیه به
.B FIGlet
است با امکانات اضافی نظیر پشتیبانی از یونیکد (Unicode)، قلم‌های رنگی، فیلترها و قالب‌های خروجی گوناگون.
.RI
.SH "نحوه استفاده (USAGE)"
برنامهٔ
.B TOIlet
ورودی خود را یا از خط فرمان و یا از ورودی استاندارد می‌خواند.
.RI
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-f, \-\-font <name>
استفاده از قلم مشخص‌شده به‌جای مقدار پیش‌فرض. قلم‌ها فایل‌های
.B .flf
یا
.B .tlf
ذخیره‌شده در پوشهٔ
.B /usr/share/figlet
هستند. قلم‌ها ابتدا در پوشهٔ قلم و سپس در دایرکتوری جاری جستجو می‌شوند. همچنین یک قلم توکار ویژه به نام
.I term
وجود دارد که در صورت در دسترس نبودن هیچ قلمی، به‌عنوان جایگزین استفاده می‌شود.
.TP
.B \-d, \-\-directory <dir>
مشخص کردن دایرکتوری مورد نظر برای جستجوی قلم‌ها. مقدار پیش‌فرض در زمان ساخت برنامه تعیین می‌شود و معمولاً به‌طور پیش‌فرض
.B /usr/share/figlet
است.
.TP
.B \-s, \-S, \-k, \-W, \-o
انتخاب قواعد ترکیب نویسه‌ها.
.B \-S
حالت ادغام یا smushing (ادغام ظریف گلیف‌ها) را فعال می‌کند،
.B \-k
حالت فاصله‌گذاری نزدیک یا kerning (رندر کردن زیرنویسه‌ها تا جای ممکن نزدیک به یکدیگر) را تنظیم می‌کند،
.B \-W
نویسه‌ها را در پهنای کامل آن‌ها رندر می‌کند و
.B \-o
حالت هم‌پوشانی یا overlapping (هم‌پوشانی جزئی هر گلیف با گلیف قبلی) را فعال می‌سازد.
.B \-s
(رفتار پیش‌فرض) در صورت وجود، از اطلاعات ادغام (smushing) قلم استفاده می‌کند؛ در غیر این صورت هم‌پوشانی را تحمیل کرده، یا اگر گلیف تنها یک زیرنویسه داشته باشد هیچ کاری انجام نمی‌دهد.
.TP
.B \-w, \-\-width <width>
تنظیم عرض خروجی. به‌طور پیش‌فرض،
.B TOIlet
خروجی خود را در عرض ۸۰ ستون نویسه می‌شکند.
.TP
.B \-t, \-\-termwidth
تنظیم عرض خروجی برابر با عرض ترمینال.
.TP
.B \-F, \-\-filter <filters>
.PD 0
.TP
.B \-F, \-\-filter list
.TP
.B \-\-rainbow, \-\-metal
.PD
مشخص کردن فهرستی از فیلترها برای اعمال بر روی خروجی.
.I <filters>
فهرستی از فیلترها است که با دو نقطه (:) از هم جدا شده‌اند، مانند
.I crop:rotate:rainbow
و آرگومان ویژهٔ
.I list
فهرستی از فیلترهای موجود را نمایش می‌دهد.

گزینه‌های
.B \-\-rainbow
و
.B \-\-metal
میان‌برهایی برای فیلترهای پرکاربرد هستند که وجود آن‌ها تضمین شده است. همچنین می‌توان چندین پرچم
.B \-F
را در خط فرمان مشخص کرد که در این صورت، فیلترها به ترتیب ظاهر شدن اعمال خواهند شد.
.TP
.B \-E, \-\-export <format>
.PD 0
.TP
.B \-E, \-\-export list
.TP
.B \-\-irc, \-\-html
.PD
مشخص کردن قالب خروجی. به‌طور پیش‌فرض،
.B TOIlet
متن UTF-8 را با کدهای رنگی ANSI مناسب برای اغلب ترمینال‌ها مانند XTerm یا rxvt تولید می‌کند.
.I <format>
نام قالب صدور خروجی است که توسط libcaca شناخته می‌شود. آرگومان ویژهٔ
.I list
فهرستی از قالب‌های خروجی موجود را نمایش می‌دهد.

گزینه‌های
.B \-\-irc
و
.B \-\-html
میان‌برهایی برای قالب‌های پرکاربرد صدور خروجی هستند که وجود آن‌ها تضمین شده است.
.TP
.B \-h, \-\-help
نمایش یک پیام راهنمای کوتاه و خروج.
.TP
.B \-I, \-\-infocode <code>
چاپ یک infocode متعلق به
.B FIGlet .
این پرچم صرفاً برای سازگاری با
.B FIGlet
در نظر گرفته شده است؛ برای اطلاعات بیشتر دربارهٔ آن، به صفحهٔ راهنمای
.B figlet
مراجعه کنید.
.TP
.B \-v, \-\-version
نمایش اطلاعات نسخه و خروج.
.RI
.SH "مثال‌ها (EXAMPLES)"
toilet Hello World

toilet Hello | toilet

tail -f /var/log/messages | toilet -f term --rainbow
.RI
.SH "گزارش باگ‌ها (BUGS)"
سازگاری با
.B FIGlet
هنوز کامل نیست.
.RI
.SH "نویسندگان (AUTHORS)"
برنامهٔ
.B TOIlet
و این صفحهٔ راهنما توسط Sam Hocevar <sam@hocevar.net> نوشته شده‌اند. یک صفحهٔ وب در آدرس http://caca.zoy.org/wiki/toilet در دسترس است.
.SH "همچنین ببینید (SEE ALSO)"
figlet(6)