.\" Hey, EMACS: -*- nroff -*- .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) .TH SM 1 "November 24, 2012" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: .\" .nh disable hyphenation .\" .hy enable hyphenation .\" .ad l left justify .\" .ad b justify to both left and right margins .\" .nf disable filling .\" .fi enable filling .\" .br insert line break .\" .sp insert n+1 empty lines .\" for manpage-specific macros, see man(7) .SH "نام (NAME)" sm \- نمایش یک متن کوتاه به‌صورت تمام‌صفحه .SH "خلاصه دستور (SYNOPSIS)" .B sm [ .I گزینه‌ها ] [ .I متن | .B \- ] .SH "توضیحات (DESCRIPTION)" برنامه .BR Screen\ Message پیام چندخطی ارائه‌شده را تا جای ممکن بزرگ، به‌صورت تمام‌صفحه و سیاه روی پس‌زمینه سفید نمایش می‌دهد. متن را می‌توانید هم هنگام اجرای .B sm مشخص کنید، یا آن را در حین اجرای برنامه ویرایش نمایید. .PP پس از وقفه‌ای کوتاه، کادر ورود متن و دکمه خروج ناپدید خواهند شد و چیزی جز متن واردشده روی صفحه باقی نمی‌ماند. برای ادامه وارد کردن متن، کافی است شروع به تایپ کنید یا در هر کجای صفحه (کلیک چپ) نمایید. .PP برای پاک کردن متن نمایش‌داده‌شده، کلید .B Escape را فشار دهید. .PP برای معکوس کردن رنگ متن و پس‌زمینه، کلیدهای .B Ctrl\-I را فشار دهید. .PP برای خروج از برنامه، کلیدهای .BR Ctrl\-Q ، یا دو بار کلید .BR Escape را فشار دهید، یا روی دکمه "Quit" کلیک کنید. .br .SH "گزینه‌ها (OPTIONS)" .TP [ \fIمتن\fR | \fB\-\fR ] متنی که باید در شروع برنامه نمایش داده شود. مقدار پیش‌فرض ":-)" است. اگر "\fB\-\fR" به .B sm داده شود، متن نمایشی را از ورودی استاندارد می‌خواند؛ بخش .B "کنترل از راه دور (REMOTE CONTROLLING SM)" را ببینید. .TP .BI \-f,\ \-\-foreground= colordesc تعیین رنگی متفاوت با سیاه برای پیش‌زمینه متن نمایشی. رشته متنی رنگ می‌تواند در هر قالبی که توسط .B XParseColor پذیرفته می‌شود باشد؛ از جمله نام رنگ از .BR rgb.txt ، مانند .BR DarkSlateGray ، یا یک مشخصه هگز مانند .B #3050b2 یا .BR #35b . .TP .BI \-b,\ \-\-background= colordesc تعیین رنگی متفاوت با سفید برای پس‌زمینه متن نمایشی. برای مقادیر ممکن، موارد بالا را ببینید. .TP .BI \-i,\ \-\-invert جابه‌جا کردن نقش رنگ‌های پیش‌زمینه و پس‌زمینه. اگر حالت سفید روی سیاه را ترجیح می‌دهید، مفید است. .TP .BI \-n,\ \-\-font= fontspec تعیین فونتی متفاوت با فونت sans-serif پیش‌فرض سیستم شما. .I fontspec می‌تواند نام کامل یک فونت truetype (مانند "DejaVu Sans" یا "Bitstream Vera Serif") یا فقط یک مشخصه کوتاه خانواده فونت ("serif"، "sans-serif") باشد. .TP .BI \-r,\ \-\-rotate= rotation چرخاندن صفحه نمایش به میزان .I rotation*90 درجه در خلاف جهت عقربه‌های ساعت. بنابراین .B \-r 1 نمایش را به چپ می‌چرخاند و .B \-r 2 آن را وارونه می‌کند. .TP .BI \-a,\ \-\-align= alignment تراز کردن متن به‌صورت وسط‌چین .RB ( \-a\ 0 )، چپ‌چین .RB ( \-a\ 1 ) یا راست‌چین .RB ( \-a\ 2 ). .TP .BI \-\- (خط تیره دوگانه) پایان تجزیه گزینه‌ها. این مورد برای این استفاده می‌شود که بتوان متنی را که با خط تیره شروع می‌شود ارسال کرد. .TP .BI \-h,\ \-\-help نمایش پیام کوتاه راهنما که گزینه‌های شناخته‌شده را خلاصه می‌کند و خروج از برنامه. .TP .BI \-V,\ \-\-version چاپ نام پروژه به همراه شماره نسخه آن و خروج از برنامه. .SH "کنترل از راه دور (REMOTE CONTROLLING SM)" اگر .B sm با آرگومان خط فرمان \fB\-\fR فراخوانی شود، متن نمایشی را از ورودی استاندارد می‌خواند. ورودی تا زمان رسیدن به انتهای فایل یا کاراکتر تغییر صفحه (form feed) \fB\\f\fR خوانده می‌شود و تمام ورودی خوانده‌شده تا آن نقطه یک‌جا نمایش داده خواهد شد. کاراکترهای خط جدید در ابتدا یا انتهای متن نادیده گرفته می‌شوند. فرض می‌شود که ورودی دارای کدگذاری UTF-8 است .RB "(به " utf8 (7) مراجعه کنید). .PP از این قابلیت می‌توان برای ایجاد نمایشگرهای خودکار داده‌های متغیر یا ترفندهای مشابه استفاده کرد. به عنوان مثال، دستور زیر یک ساعت دیجیتال ساده ایجاد می‌کند: .sp .B (while sleep 1; do date +%T; printf \\\\\\\\f; done) | sm - .SH "نویسنده (AUTHOR)" این صفحه راهنما توسط Joachim Breitner نوشته شده و توسط Gerfried Fuchs برای بازتاب موارد اضافه‌شده در مدیریت گزینه‌های خط فرمان به‌روزرسانی شده است.