.TH CopyQ 1
.SH "نام (NAME)"
copyq \- مدیر کلیپ‌بورد با قابلیت‌های پیشرفته


.SH "خلاصه دستور (SYNOPSIS)"
.B copyq
[\fBCOMMAND\fR]


.SH "توضیحات (DESCRIPTION)"
.B CopyQ
یک مدیر کلیپ‌بورد پیشرفته با قابلیت‌های ویرایش و اسکریپت‌نویسی است. این برنامه کلیپ‌بورد سیستم را زیر نظر گرفته و محتوای آن را در زبانه‌های سفارشی ذخیره می‌کند. محتوای ذخیره‌شده را می‌توان بعداً مستقیماً در هر برنامه‌ای کپی و جای‌گذاری کرد.


.SH "دستورها (COMMANDS)"
در صورت عدم تعیین دستور، سرور برنامه اجرا می‌شود.

.TP
.BR show " [\fINAME\fR]"
نمایش پنجره اصلی و در صورت تمایل باز کردن زبانه با نام مشخص‌شده.
.TP
.B hide
مخفی کردن پنجره اصلی.
.TP
.B toggle
نمایش یا مخفی کردن پنجره اصلی.
.TP
.B menu
باز کردن منوی زمینه‌ای (Context Menu).
.TP
.B exit
خروج از سرور برنامه.
.TP
.BR disable ", " enable
غیرفعال یا فعال کردن ذخیره‌سازی محتوای کلیپ‌بورد.

.sp
.TP
.BR clipboard " [\fIMIME\fR]"
چاپ محتوای کلیپ‌بورد.
.TP
.BR selection " [\fIMIME\fR]"
چاپ محتوای انتخاب (Selection) در X11.
.TP
.B paste
جای‌گذاری محتوای کلیپ‌بورد در پنجره جاری (ممکن است در برخی برنامه‌ها کار نکند).
.TP
.BR copy " \fITEXT\fR"
تنظیم متن کلیپ‌بورد.
.TP
.BR copy " \fIMIME\fR \fIDATA\fR [\fIMIME\fR \fIDATA\fR]..."
تنظیم محتوای کلیپ‌بورد.

.sp
.TP
.B count
چاپ تعداد آیتم‌های زبانه جاری.
.TP
.BR select " [\fIROW=0\fR]"
کپی کردن آیتم موجود در سطر مشخص‌شده به کلیپ‌بورد.
.TP
.B next
کپی کردن آیتم بعدی از زبانه جاری به کلیپ‌بورد.
.TP
.B previous
کپی کردن آیتم قبلی از زبانه جاری به کلیپ‌بورد.
.TP
.BR add " \fITEXT\fR..."
افزودن متن به کلیپ‌بورد.
.TP
.BR insert " \fIROW\fR \fITEXT\fR"
درج متن در سطر مشخص‌شده.
.TP
.BR remove " [\fIROWS=0\fR...]"
حذف آیتم‌های سطرهای مشخص‌شده.
.TP
.BR edit " [\fIROW=-1\fR...]"
ویرایش آیتم‌ها یا ایجاد و ویرایش یک آیتم جدید.
مقدار \-1 برای متن جاری موجود در کلیپ‌بورد است.

.sp
.TP
.BR separator " \fISEPARATOR\fR"
تنظیم جداکننده برای آیتم‌ها در خروجی.
.TP
.BR read " [\fIMIME\fR|\fIROW\fR]..."
چاپ داده‌های خام کلیپ‌بورد یا آیتم موجود در سطر.
.TP
.BR write " [\fIROW=0\fR] \fIMIME\fR \fIDATA\fR [\fIMIME\fR \fIDATA\fR]..."
نوشتن داده‌های خام در سطر مشخص‌شده.

.sp
.TP
.BR action " [\fIROWS=0.\fR..]"
نمایش پنجره گفتگوی عملیات (Action).
.TP
.BR action " [\fIROWS=0\fR...] [\fIPROGRAM\fR [\fISEPARATOR=\[rs]n\fR]]"
اجرای PROGRAM روی متن آیتم‌های موجود در سطرها.
برای ارسال متن به عنوان آرگومان، از %1 در PROGRAM استفاده کنید.
.TP
.BR popup " \fITITLE\fR \fIMESSAGE\fR [\fITIME=8000\fR]"
نمایش پیام پاپ‌آپ در سینی سیستم (Tray) به مدت TIME میلی‌ثانیه.

.sp
.TP
.B tab
فهرست کردن نام زبانه‌های موجود.
.TP
.BR tab " \fINAME\fR [\fICOMMAND\fR]"
اجرای دستور روی زبانه با نام مشخص‌شده.
در صورت عدم وجود زبانه، ایجاد می‌شود.
پیش‌فرض زبانه اول است.
.TP
.BR removetab " \fINAME\fR"
حذف زبانه.
.TP
.BR renametab " \fINAME\fR \fINEW_NAME\fR"
تغییر نام زبانه.

.sp
.TP
.BR exporttab " \fIFILE_NAME\fR"
خروجی گرفتن از آیتم‌ها در فایل.
.TP
.BR importtab " \fIFILE_NAME\fR"
وارد کردن آیتم‌ها از فایل.

.sp
.TP
.B config
فهرست کردن تمام گزینه‌ها.
.TP
.BR config " \fIOPTION\fR"
دریافت مقدار گزینه.
.TP
.BR config " \fIOPTION\fR \fIVALUE\fR"
تنظیم مقدار گزینه.

.sp
.TP
.BR eval ", " \-e " [\fISCRIPT\fR] [\fIARGUMENTS\fR]..."
ارزیابی و اجرای برنامه ECMAScript.
آرگومان‌ها با استفاده از "arguments[0..N]" قابل دسترسی هستند.
.TP
.BR session ", " \-s ", " \-\-session " \fISESSION\fR"
شروع یا اتصال به نمونه‌ای از برنامه با نام نشست مشخص‌شده.
.TP
.BR help ", " \-h ", " \-\-help " [\fICOMMAND\fR]..."
چاپ راهنما برای COMMAND یا تمام دستورها.


.SH "نکات (NOTES)"
از \fBآرگومان خط تیره\fR (\fB\-\fR) برای خواندن داده‌ها از ورودی استاندارد استفاده کنید.
.sp
از \fBآرگومان دو خط تیره\fR (\fB\-\-\fR) برای خواندن تمام آرگومان‌های بعدی بدون گسترش دنباله‌های اسکیپ (مانند \\n، \\t و غیره) استفاده کنید.
.sp
از \fB?\fR برای MIME جهت چاپ نوع‌های MIME موجود استفاده کنید (پیش‌فرض "text/plain" است).


.SH "مثال‌ها (EXAMPLES)"
.TP
درج چند متن در تاریخچه:
copyq add "first item" "second item" "third item"

.TP
چاپ محتوای سه آیتم اول:
copyq read 0 1 2
copyq separator "," read 0 1 2

.TP
نمایش محتوای فعلی کلیپ‌بورد:
copyq clipboard
copyq clipboard text/html
copyq clipboard \\? # فهرست کردن فرمت‌های موجود در کلیپ‌بورد

.TP
کپی کردن متن به کلیپ‌بورد:
copyq copy "Some Text"

.TP
بارگذاری محتوای فایل در کلیپ‌بورد:
copyq copy - < file.txt
copyq copy text/html < index.html
copyq copy image/jpeg - < image.jpg

.TP
ایجاد آیتم‌های تصویری:
copyq write image/gif - < image.gif
copyq write image/svg - < image.svg


.SH "همچنین ببینید (SEE ALSO)"
.B https://copyq.readthedocs.io


.SH "نویسندگان (AUTHORS)"
نگه‌دارنده CopyQ شخص Lukas Holecek <hluk@email.cz> است. فهرست جامع نویسندگان و مشارکت‌کنندگان در فایل AUTHORS در دسترس است.
.PP
این صفحه راهنما توسط GengYu Rao (zouyoo@outlook.com) برای پروژه دبیان نوشته شده است (و ممکن است توسط دیگران نیز استفاده شود).