نام (NAME)

kitten-ask - درخواست ورودی از کاربر

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

توضیحات (DESCRIPTION)

درخواست ورودی از کاربر.

گزینه‌ها (OPTIONS)

--type, -t [=line]

نوع ورودی. پیش‌فرض، درخواست یک خط متن است.

انتخاب‌ها: line، choices، file، password، yesno

--message, -m

پیامی که باید به کاربر نمایش داده شود. در صورت مشخص نشدن، پیام پیش‌فرض نشان داده می‌شود.

--name, -n

نام این پرسش. برای ذخیرهٔ تاریخچهٔ پاسخ‌های پیشین استفاده می‌شود که می‌تواند برای تکمیل خودکار و از طریق کلیدهای میان‌بر مرور تاریخچه در readline به کار رود.

--title, --window-title

عنوان پنجره‌ای که پرسش در آن نمایش داده می‌شود. فقط برای انواع yesno و choices پیاده‌سازی شده است.

--choice, -c

یک گزینه برای نوع choices. می‌تواند چندین بار مشخص شود. هر گزینه دارای نحو زیر است: ``letter[;color]:text``، که در آن text متن گزینه و letter کلید انتخاب است. letter یک نویسهٔ منفرد متعلق به text است. این نویسه در متن گزینه برجسته می‌شود. همچنین می‌تواند یک مشخصهٔ رنگ اختیاری پس از نویسه برای تعیین رنگ آن وجود داشته باشد. برای مثال: y:Yes و n;red:No

--default, -d

یک گزینه یا متن پیش‌فرض. در صورت تعیین نشدن، برای نوع yesno مقدار y، برای نوع choices نخستین گزینه و برای سایر انواع خالی است. هنگامی که کاربر کلید Enter را فشار می‌دهد، گزینهٔ پیش‌فرض انتخاب می‌شود.

--prompt, -p [="> "]

اعلان (prompt) مورد استفاده هنگام دریافت یک خط متن یا گذرواژه.

--unhide-key [=u]

کلیدی که برای آشکار کردن متن پنهان باید فشرده شود.

--hidden-text-placeholder

متنی در پیام که باید با متن پنهان جایگزین شود. متن پنهان از طریق STDIN خوانده می‌شود.

--help, -h [=no]

نمایش راهنما برای این دستور.