نام (NAME)

xclip - رابط خط فرمان برای گزینش‌های سامانهٔ X (کلیپ‌بورد)

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

xclip [OPTION] [FILE]...

توضیحات (DESCRIPTION)

داده‌ها را از ورودی استاندارد یا از یک یا چند فایل خوانده و آن‌ها را به عنوان یک گزینش X (X selection) جهت الصاق در برنامه‌های X در دسترس قرار می‌دهد. همچنین گزینش فعلی X را در خروجی استاندارد چاپ می‌کند.

-i, -in

خواندن متن از ورودی استاندارد یا فایل‌ها و قرار دادن آن در گزینش X (پیش‌فرض)

-o, -out

چاپ محتوای گزینش در خروجی استاندارد (به‌طور کلی برای هدایت به یک فایل یا برنامه)

-f, -filter

هنگامی که xclip در حالت ورودی (-in) و با سطح خروجی بی‌صدا (silent) که حالت‌های پیش‌فرض هستند اجرا شود، گزینهٔ فیلتر موجب می‌شود xclip متنی را که به ورودی استاندارد فرستاده شده، بدون تغییر به خروجی استاندارد بازگرداند.

-r, -rmlastnl

در صورتی که آخرین نویسهٔ گزینش یک نویسهٔ خط‌جدید (newline) باشد، آن را حذف می‌کند. نویسه‌های خط‌جدیدی که آخرین نویسهٔ گزینش نیستند دست‌نخورده باقی می‌مانند. اگر گزینش با نویسهٔ خط‌جدید پایان نیابد، این گزینه هیچ اثری ندارد. این گزینه برای کپی کردن خروجیِ تک‌خطیِ برنامه‌هایی مانند pwd به کلیپ‌بورد جهت الصاق مجدد آن در خط فرمان بسیار مفید است، بدون آن‌که دستور بلافاصله به دلیل نویسهٔ خط‌جدیدی که pwd اضافه می‌کند اجرا شود.

-l, -loops

تعداد دفعات درخواست گزینش X (الصاق در برنامه‌های X) که باید قبل از خروج منتظر آن‌ها بماند؛ مقدار 0 (پیش‌فرض) موجب می‌شود xclip تا زمانی که برنامهٔ دیگری (شاید اجرای دیگری از xclip) مالکیت گزینش را به دست گیرد، برای تعداد نامحدودی از درخواست‌ها منتظر بماند.

-t, -target

مشخص کردن یک قالب دادهٔ خاص با استفاده از اتم هدف (target atom) ارائه‌شده. به همراه -o می‌توان از نام اتم هدف ویژهٔ “TARGETS” برای دریافت فهرستی از اتم‌های هدف معتبر برای این گزینش استفاده کرد. برای اطلاعات بیشتر دربارهٔ اتم‌های هدف به بخش 2.6.2 سند ICCCM مراجعه کنید.

-d, -display

نمایشگر X مورد استفاده (مانند “localhost:0”)؛ در صورت حذف این گزینه، xclip به‌طور پیش‌فرض از مقدار متغیر $DISPLAY استفاده می‌کند.

-h, -help

نمایش خلاصه‌ای سریع از گزینه‌ها

-selection

مشخص کردن گزینش X مورد استفاده؛ گزینه‌ها عبارتند از “primary” برای استفاده از XA_PRIMARY (پیش‌فرض)، “secondary” برای XA_SECONDARY یا “clipboard” برای XA_CLIPBOARD.

-version

نمایش اطلاعات نسخه

-silent

انشعاب به پس‌زمینه (fork) جهت انتظار برای درخواست‌ها، بدون خروجی اطلاعاتی و تنها نمایش خطاها (پیش‌فرض)

-quiet

نمایش پیام‌های اطلاعاتی در پایانه و اجرا در پیش‌زمینه

-verbose

ارائهٔ گزارش مرحله‌به‌مرحله و زنده از کارهایی که xclip انجام می‌دهد

-noutf8

کارکرد در حالت سنتی (یعنی غیر UTF-8) برای سازگاری با نسخه‌های گذشته (تنها در صورت لزوم واقعی از این گزینه استفاده کنید، زیرا رفتار پیشین دچار ایراد بود)

دستور xclip متن را از ورودی استاندارد یا فایل‌ها می‌خواند و آن را برای الصاق در سایر برنامه‌های سامانهٔ X به عنوان یک گزینش X (به‌طور سنتی با کلیک‌وسط ماوس) در دسترس قرار می‌دهد. این دستور داده‌ها را از تمام فایل‌های مشخص‌شده می‌خواند، و در صورتی که فایلی تعیین نشده باشد از ورودی استاندارد دریافت می‌کند. همچنین xclip می‌تواند با استفاده از گزینهٔ -o محتوای یک گزینش را در خروجی استاندارد چاپ کند.

برنامهٔ xclip برای امکان یکپارچگی بیشتر میان برنامه‌های X و برنامه‌های خط فرمان طراحی شده است. عمل پیش‌فرض این است که بی‌صدا در پس‌زمینه منتظر درخواست‌های گزینش X (الصاق‌ها) بماند تا زمانی که برنامهٔ X دیگری داده‌ای را در کلیپ‌بورد قرار دهد؛ در آن زمان xclip بی‌صدا خارج می‌شود. می‌توانید از گزینهٔ -verbose استفاده کنید تا ببینید آیا و در چه زمانی xclip در عمل درخواست‌های گزینش را از سایر برنامه‌های X دریافت می‌کند.

گزینه‌ها را تا زمانی که ابهامی ایجاد نکنند می‌توان به‌صورت مخفف نوشت. برای نمونه، می‌توان به جای -display از -d یا -disp استفاده کرد. با این حال، -v را نمی‌توان به کار برد زیرا مبهم است (می‌تواند مخفف -verbose یا -version باشد)، در نتیجه به عنوان یک نام فایل تفسیر خواهد شد.

توجه داشته باشید که تنها نویسهٔ نخستِ گزینش مشخص‌شده با گزینهٔ -selection اهمیت دارد. این بدان معناست که مقادیر “p”، “sec” و “clip” دقیقاً همان اثر “primary”، “secondary” یا “clipboard” را خواهند داشت.

مثال‌ها (EXAMPLES)

از صفحات راهنمای بدون مثال بیزارم!

uptime | xclip

قرار دادن خروجی uptime در گزینش X. سپس در یک برنامهٔ X کلیک‌وسط کنید تا الصاق شود.

xclip -loops 10 -verbose /etc/motd

خروج پس از ۱۰ بار الصاق شدن محتوای فایل /etc/motd (پیام روز). نمایش تعداد درخواست‌های گزینش (الصاق‌ها) که پردازش شده‌اند.

xclip -o > helloworld.c

قرار دادن محتوای گزینش درون یک فایل.

xclip -t text/html index.html

کلیک‌وسط در یک برنامهٔ X با پشتیبانی از HTML برای الصاق محتوای فایل داده‌شده در قالب HTML.

محیط (ENVIRONMENT)

DISPLAY

نمایشگر X مورد استفاده، در صورتی که هیچ نمایشگری با گزینهٔ -display تعیین نشده باشد.

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

لطفاً هرگونه باگ، مشکل، پرسش، تجربه و موارد دیگر را مستقیماً به نویسنده گزارش دهید.

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

Kim Saunders <kims@debian.org> Peter Åstrand <astrand@lysator.liu.se>