'\" t
.\"     Title: cowsay
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2024-11-30
.\"    Manual: Cowsay Manual
.\"    Source: Cowsay
.\"  Language: Persian
.\"
.TH "COWSAY" "1" "2024-11-30" "Cowsay" "Cowsay Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
cowsay, cowthink \- گاو سخن‌گو و متفکر با قابلیت پیکربندی (و کمی بیشتر)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcowsay\fP
[\fB\-f\fP \fIcowfile\fP]
[\fB\-r\fP [\fB\-C\fP] ]
[\fB\-e\fP \fIeye_string\fP]
[\fB\-T\fP \fItongue_string\fP]
[\fB\-bdgpstwy\fP]
[\fB\-n\fP]
[\fB\-W\fP \fIcolumn\fP]
[<\fIپیام\fP>]
.sp
\fBcowsay\fP \fB\-l\fP
.sp
\fBcowsay\fP [\fB\-h\fP | \fB\-\-help\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور
\fIcowsay\fP
یک تصویر اسکی‌آرت (ASCII\-art) از یک گاو تولید می‌کند که پیام ارائه‌شده توسط کاربر را بازگو می‌کند. اگر این دستور بدون هیچ آرگومان غیرگزینه‌ای اجرا شود، پیام را از ورودی استاندارد می‌خواند، خطوط پیام را تقریباً در ستون چهلم می‌شکند (word\-wrap)، و تصویر گاو را در حالی که پیام داده‌شده را بیان می‌کند در خروجی استاندارد چاپ می‌نماید.
.sp
برای تسهیل استفاده از پیام‌های دلخواه با فاصله‌های خالی (whitespace) دلخواه، از گزینه
\fB\-n\fP
استفاده کنید. اگر این گزینه مشخص شود، پیام ورودی شکسته‌خط نخواهد شد. این قابلیت به‌ویژه زمانی مفید است که بخواهید گاو با قلم‌های
.BR figlet (6)
فکر کند یا سخن بگوید. در صورت مشخص شدن گزینه
.BR \-n ،
نباید پس از پردازش تمام گزینه‌ها، هیچ آرگومان خط فرمانی دیگری باقی مانده باشد.
.sp
گزینه
\fB\-W\fP
محل تقریبی شکستن خطوط پیام را تعیین می‌کند. مقدار پیش‌فرض معادل
\fB\-W 40\fP
است (یعنی کلمات در ستون چهلم یا پیش از آن شکسته می‌شوند).
.sp
اگر پس از پردازش تمام گزینه‌ها، هرگونه آرگومان خط فرمانی باقی مانده باشد، به جای خواندن از ورودی استاندارد، همان آرگومان‌ها به عنوان پیام گاو در نظر گرفته می‌شوند. در این حالت، ورودی استاندارد نادیده گرفته می‌شود.
.sp
اگر برنامه به صورت
\fBcowthink\fP
فراخوانی شود، گاو به جای گفتن پیام، به آن فکر خواهد کرد (این وضعیت با ظاهر شدن «حباب تفکر» در تصویر گاو نمایش داده می‌شود؛ cowsay موضع فلسفی خاصی درباره اینکه آیا ادراک واقعی در حال رخ دادن است یا خیر اتخاذ نمی‌کند).
.sp
(تصویر حاصل از نظر فنی لزوماً فقط اسکی نیست؛ بسته به محیط شما و فایل‌های تعریف گاو مورد استفاده، ممکن است در کدگذاری‌های دیگر باشد، شامل نویسه‌های غیراسکی شود یا حتی توالی‌های نویسه کنترلی ترمینال را در بر گیرد.)
.SH "گزینه‌ها (OPTIONS)"
.sp
چندین حالت مختلف ارائه شده است که ظاهر گاو را بسته به وضعیت احساسی یا جسمانی خاص آن تغییر می‌دهد.
.SS "تغییر ظاهر گاو (Cow modification)"
.sp
\fB\-b\fP
.RS 4
حالت بورگ (Borg) را فعال می‌کند.
.RE
.sp
\fB\-d\fP
.RS 4
باعث می‌شود گاو مرده به نظر برسد.
.RE
.sp
\fB\-g\fP
.RS 4
حالت حریص و طمع‌کار (greedy) را فعال می‌کند.
.RE
.sp
\fB\-p\fP
.RS 4
حالت پارانویا و سوءظن را بر گاو مستولی می‌کند.
.RE
.sp
\fB\-s\fP
.RS 4
ظاهری کاملاً نشئه یا گیج و منگ (stoned) به گاو می‌دهد.
.RE
.sp
\fB\-t\fP
.RS 4
یک گاو خسته (tired) را نمایش می‌دهد.
.RE
.sp
\fB\-w\fP
.RS 4
تا حدی نقطه مقابل گزینه
\fB\-t\fP
است و حالت هیجان‌زده و گوش‌به‌زنگ (wired) را فعال می‌کند.
.RE
.sp
\fB\-y\fP
.RS 4
ظاهر جوانی و شادابی گاو را به نمایش می‌گذارد.
.RE
.sp
\fB\-e\fP
.RS 4
ظاهر چشمان گاو را تعیین می‌کند؛ در این حالت دو نویسه نخست از رشته آرگومان
\fIeye_string\fP
استفاده خواهد شد. چشمان پیش‌فرض
\fBoo\fP
هستند. در صورت استفاده از هر یک از حالت‌های از پیش تعریف‌شده، هرگونه پیکربندی انجام‌شده توسط گزینه‌های
\fB\-e\fP
و
\fB\-T\fP
نادیده گرفته خواهد شد.
.RE
.sp
\fB\-T\fP
.RS 4
ظاهر زبان گاو را تعیین می‌کند. آرگومان
\fItongue_string\fP
باید دقیقاً دو نویسه باشد. به طور پیش‌فرض هیچ زبانی نمایش داده نمی‌شود، مگر در حالت‌های مرده (\fIdead\fP) و نشئه (\fIstoned\fP).
.RE
.SS "انتخاب گاو (Cow selection)"
.sp
\fB\-f\fP
.RS 4
یک فایل تصویر گاو (\fIcowfile\fP) مشخص را برای استفاده تعیین می‌کند. اگر مشخصه فایل به یک فایل موجود اشاره کند، به عنوان مسیری به آن فایل در نظر گرفته می‌شود؛ در غیر این صورت، cowsay متغیر مسیر COWPATH را برای یافتن فایلی با این نام (همراه با پسوند \fI.cow\fP) جستجو می‌کند. ورودی‌های مسیر اضافی را می‌توان در متغیر محیطی
\fBCOWPATH\fP
مشخص کرد. برای مشاهده فهرست تمام فایل‌های گاو در مسیر فعلی
.BR COWPATH ،
دستور
\fBcowsay \-l\fP
را اجرا کنید.
.RE
.sp
\fB\-r\fP
.RS 4
یک گاو تصادفی را از میان گاوهای موجود در مسیر
\fBCOWPATH\fP
انتخاب می‌کند.
.RE
.sp
\fB\-C\fP
.RS 4
گاوهای رنگی واقعی (true\-color ۲۴ بیتی) را فعال می‌کند. در حال حاضر این گزینه تنها هنگام استفاده همراه با
\fB\-r\fP
اثرگذار است. در صورت مشخص نشدن،
\fB\-r\fP
تنها از میان گاوهای غیر رنگی واقعی انتخاب خواهد کرد.
.RE
.SS "عملیات غیرمربوط به گاو (Non\-cow operations)"
.sp
\fB\-l\fP
.RS 4
فهرست گاوهای تعریف‌شده در مسیر فعلی
\fBCOWPATH\fP
را نمایش می‌دهد. هنگام نمایش در یک ترمینال، خروجی در قالبی مرتب و خوانا برای انسان نمایش می‌یابد. هنگامی که خروجی به دستگاهی غیر از ترمینال ارسال شود، فهرست در قالبی مناسب پردازش خودکار با یک نام گاو در هر خط و بدون سرصفحه یا خطوط خالی چاپ می‌شود.
.RE
.sp
\fB\-h\fP
.RS 4
صفحه راهنمای دستور را نمایش می‌دهد.
.RE
.SH "قالب فایل گاو (COWFILE FORMAT)"
.sp
یک فایل گاو (cowfile) از یک بلوک ساده از کد
\fBperl(1)\fP
تشکیل شده است که تصویری از یک گاو را به متغیر
\fB$the_cow\fP
اختصاص می‌دهد. اگر مایل به سفارشی‌سازی چشم‌ها یا زبان گاو باشید، می‌توانید از متغیرهای
\fB$eyes\fP
و
\fB$tongue\fP
استفاده کنید. خط منتهی به حباب پیام گاو از نویسه(های) موجود در متغیر
\fB$thoughts\fP
تشکیل می‌شود. متغیرهای دیگر نباید مقداردهی شوند.
.sp
هرگونه بک‌اسلش در متن فایل گاو (درون رشته‌های متنی یا heredocها) باید دو بار تکرار شود تا از تفسیر آن جلوگیری گردد. همچنین، نویسه‌های «@»، «$» و احتمالاً «&» باید با بک‌اسلش اسکیپ شوند، زیرا پرل چنین انتظاری دارد.
.sp
نام یک فایل گاو باید به پسوند
\fB.cow\fP
ختم شود، در غیر این صورت به عنوان فایل گاو شناخته نخواهد شد.
.SH "محیط (ENVIRONMENT)"
.sp
متغیر محیطی
.BR COWPATH ،
در صورت وجود، برای جستجوی فایل‌های گاو استفاده می‌شود. این متغیر شامل فهرستی از پوشه‌ها است که با دو‌نقطه (:) از یکدیگر جدا شده‌اند، بسیار شبیه به متغیرهای
\fBPATH\fP
یا
.BR MANPATH .
.sp
مسیر پیش‌فرض
\fBCOWPATH\fP
پس از ورودی‌های تعیین‌شده توسط کاربر در متغیر محیطی
\fBCOWPATH\fP
جستجو می‌شود. برای جلوگیری از این رفتار (مثلاً در کارهای توسعه)، متغیر محیطی
\fBCOWSAY_ONLY_COWPATH\fP
را روی
\fB1\fP
تنظیم کنید. در این حالت،
\fBCOWPATH\fP
باید حداقل شامل پوشه‌ای باشد که فایلی به نام
\fBdefault.cow\fP
در آن قرار دارد.
.SH "فایل‌ها (FILES)"
.sp
مسیر
\fB%PREFIX%/share/cowsay/cows\fP
شامل یک گله نمونه از فایل‌های گاو است. متغیر
\fBCOWPATH\fP
شما به طور خودکار شامل این پوشه است، مگر اینکه متغیر محیطی
\fBCOWSAY_ONLY_COWPATH\fP
روی
\fB1\fP
تنظیم شده باشد.
.sp
مسیر
\fB%PREFIX%/share/cowsay/site\-cows\fP
برای مدیران سیستم جهت نصب گاوهای سفارشی در نظر گرفته شده است. گاوهای موجود در
\fBshare/cowsay/site\-cows\fP
نسبت به گاوهای هم‌نام در
\fBshare/cowsay/cows\fP
اولویت دارند. پوشه
\fBsite\-cows\fP
هرگز توسط مراحل نصب cowsay دستکاری نخواهد شد؛ بنابراین گاوهای سفارشی تعریف‌شده در آن پس از ارتقای نسخه cowsay نیز حفظ خواهند شد. پوشه
\fBsite\-cows\fP
نیز در مسیر پیش‌فرض
\fBCOWPATH\fP
قرار دارد.
.sp
مسیر
\fB%PREFIX%/etc/cowsay/cowpath.d/\fP
(یا \fB/etc/cowsay/cowpath.d/\fP در صورتی که %PREFIX% برابر \fB/usr\fP باشد)
پوشه‌ای است که شامل فایل‌هایی از فهرست ورودی‌های افزوده به
\fBCOWPATH\fP
پیش‌فرض است. این سازوکار به مجموعه‌های گاو ارائه‌شده توسط شخص ثالث امکان می‌دهد خود را بدون نیاز به پیکربندی جداگانه برای هر کاربر در cowsay ثبت کنند. فایل‌های مسیر تحت
\fBcowpath.d\fP
باید پسوند
\fB.path\fP
داشته باشند (در غیر این صورت نادیده گرفته می‌شوند) و باید شامل فهرستی از مسیرهای پوشه‌ها، یکی در هر خط باشند.
.sp
در شرایط خاص که
\fBcowsay\fP
در پیشوند
\fB/usr\fP
نصب شده باشد، به جای
\fB%PREFIX%/etc\fP
از پوشه
\fB/etc\fP
برای فایل‌های پیکربندی، از جمله
.BR cowpath.d ،
استفاده می‌شود.
.SH "اشکالات (BUGS)"
.sp
در صورت مشاهده هرگونه اشکال، لطفاً آن را در صفحه گیت‌هاب cowsay گزارش دهید (\c
.URL "https://github.com/cowsay\-org/cowsay/issues" "" ")،"
یا از طریق نشانی رایانامه زیر به نویسنده اطلاع دهید.
.SH "نویسندگان (AUTHORS)"
.sp
پروژه Cowsay توسط اندرو جانکی (Andrew Janke) نگه‌داری می‌شود (\c
.MTO "floss\(atapjanke.net" "" ").\fR"
.sp
این برنامه در ابتدا توسط تونی مونرو (Tony Monroe) نوشته شده است (\c
.MTO "tony\(atnog.net" "" ")،\fR"
همراه با پیشنهادهایی از شنون آپل (Shannon Appel) (\c
.MTO "appel\(atcsua.berkeley.edu" "" ")\fR"
و مشارکت‌های آنتونی پولیتو (Anthony Polito) (\c
.MTO "aspolito\(atcsua.berkeley.edu" "" ").\fR"
.SH "منابع (RESOURCES)"
.sp
گیت‌هاب: \c
.URL "https://github.com/cowsay\-org/cowsay" "" ""
.sp
وبگاه اصلی: \c
.URL "http://cowsay.diamonds" "" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBfortune(1)\fP, \fBperl(1)\fP, \fBwall(1)\fP, \fBnwrite(1)\fP, \fBfiglet(6)\fP