نام (NAME)

TOIlet - نمایش نویسه‌های بزرگ و رنگارنگ

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

toilet [ -hkostvSW ] [ -d fontdirectory ]

: [ -f fontfile ] [ -F filter ] [ -w outputwidth ]
: [ -I infocode ] [ -E format ] [ message ]

توضیحات (DESCRIPTION)

برنامهٔ TOIlet متن را با استفاده از نویسه‌های بزرگی که از نویسه‌های کوچک‌تر ساخته شده‌اند چاپ می‌کند. این برنامه از بسیاری جهات شبیه به FIGlet است با امکانات اضافی نظیر پشتیبانی از یونیکد (Unicode)، قلم‌های رنگی، فیلترها و قالب‌های خروجی گوناگون.

نحوه استفاده (USAGE)

برنامهٔ TOIlet ورودی خود را یا از خط فرمان و یا از ورودی استاندارد می‌خواند.

گزینه‌ها (OPTIONS)

-f, --font <name>: استفاده از قلم مشخص‌شده به‌جای مقدار پیش‌فرض. قلم‌ها فایل‌های .flf یا .tlf ذخیره‌شده در پوشهٔ /usr/share/figlet هستند. قلم‌ها ابتدا در پوشهٔ قلم و سپس در دایرکتوری جاری جستجو می‌شوند. همچنین یک قلم توکار ویژه به نام term وجود دارد که در صورت در دسترس نبودن هیچ قلمی، به‌عنوان جایگزین استفاده می‌شود.
-d, --directory <dir>: مشخص کردن دایرکتوری مورد نظر برای جستجوی قلم‌ها. مقدار پیش‌فرض در زمان ساخت برنامه تعیین می‌شود و معمولاً به‌طور پیش‌فرض /usr/share/figlet است.
-s, -S, -k, -W, -o: انتخاب قواعد ترکیب نویسه‌ها. -S حالت ادغام یا smushing (ادغام ظریف گلیف‌ها) را فعال می‌کند، -k حالت فاصله‌گذاری نزدیک یا kerning (رندر کردن زیرنویسه‌ها تا جای ممکن نزدیک به یکدیگر) را تنظیم می‌کند، -W نویسه‌ها را در پهنای کامل آن‌ها رندر می‌کند و -o حالت هم‌پوشانی یا overlapping (هم‌پوشانی جزئی هر گلیف با گلیف قبلی) را فعال می‌سازد. -s (رفتار پیش‌فرض) در صورت وجود، از اطلاعات ادغام (smushing) قلم استفاده می‌کند؛ در غیر این صورت هم‌پوشانی را تحمیل کرده، یا اگر گلیف تنها یک زیرنویسه داشته باشد هیچ کاری انجام نمی‌دهد.
-w, --width <width>: تنظیم عرض خروجی. به‌طور پیش‌فرض، TOIlet خروجی خود را در عرض ۸۰ ستون نویسه می‌شکند.
-t, --termwidth: تنظیم عرض خروجی برابر با عرض ترمینال.
-F, --filter <filters>
-F, --filter list
--rainbow, --metal: مشخص کردن فهرستی از فیلترها برای اعمال بر روی خروجی. <filters> فهرستی از فیلترها است که با دو نقطه (:) از هم جدا شده‌اند، مانند crop:rotate:rainbow و آرگومان ویژهٔ list فهرستی از فیلترهای موجود را نمایش می‌دهد.
گزینه‌های --rainbow و --metal میان‌برهایی برای فیلترهای پرکاربرد هستند که وجود آن‌ها تضمین شده است. همچنین می‌توان چندین پرچم -F را در خط فرمان مشخص کرد که در این صورت، فیلترها به ترتیب ظاهر شدن اعمال خواهند شد.
-E, --export <format>
-E, --export list
--irc, --html: مشخص کردن قالب خروجی. به‌طور پیش‌فرض، TOIlet متن UTF-8 را با کدهای رنگی ANSI مناسب برای اغلب ترمینال‌ها مانند XTerm یا rxvt تولید می‌کند. <format> نام قالب صدور خروجی است که توسط libcaca شناخته می‌شود. آرگومان ویژهٔ list فهرستی از قالب‌های خروجی موجود را نمایش می‌دهد.
گزینه‌های --irc و --html میان‌برهایی برای قالب‌های پرکاربرد صدور خروجی هستند که وجود آن‌ها تضمین شده است.
-h, --help: نمایش یک پیام راهنمای کوتاه و خروج.
-I, --infocode <code>: چاپ یک infocode متعلق به FIGlet . این پرچم صرفاً برای سازگاری با FIGlet در نظر گرفته شده است؛ برای اطلاعات بیشتر دربارهٔ آن، به صفحهٔ راهنمای figlet مراجعه کنید.
-v, --version: نمایش اطلاعات نسخه و خروج.

مثال‌ها (EXAMPLES)

toilet Hello World

toilet Hello | toilet

tail -f /var/log/messages | toilet -f term --rainbow

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

سازگاری با FIGlet هنوز کامل نیست.

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

برنامهٔ TOIlet و این صفحهٔ راهنما توسط Sam Hocevar <sam@hocevar.net> نوشته شده‌اند. یک صفحهٔ وب در آدرس http://caca.zoy.org/wiki/toilet در دسترس است.

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

figlet(6)