.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "kupfer" "1" "2017" ""
.SH "نام (NAME)"
kupfer \- ابزاری مناسب برای دستورات و دسترسی سریع به برنامه‌ها و اسناد
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBkupfer\fP [ \fIOPTIONS\fP | \fIFILE\fP ... ]
\fBkupfer\-exec\fP \fIFILE\fP ...
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
نرم‌افزار Kupfer رابطی برای دسترسی سریع و راحت به برنامه‌ها و اسناد آن‌ها است.
.sp
معمول‌ترین کاربرد آن، یافتن یک برنامهٔ مشخص و اجرای آن است. ما تلاش کرده‌ایم گسترش Kupfer را با پلاگین‌ها ساده کنیم تا این الگوی دسترسی سریع بتواند به مواردی فراتر از برنامه‌ها تعمیم یابد.
.sp
اسکریپت \fBkupfer\-exec\fP یک اسکریپت کمکی است که می‌تواند دستورهای ذخیره‌شده در فایل را اجرا کند، اما این کار تنها با اتصال به یک نمونهٔ در حال اجرای Kupfer امکان‌پذیر است.
.SH "راه‌اندازی (SPAWNING)"
.sp
اجرای kupfer در خط فرمان (بدون گزینه‌ها) در صورتی که برنامه از قبل در حال اجرا باشد، تلاش می‌کند آن را به نمایش درآورد.
.sp
می‌توان Kupfer را به همراه فهرستی از فایل‌ها فراخوانی کرد
.INDENT 0.0
.INDENT 3.5
\fBkupfer\fP \fIFILE\fP ...
.UNINDENT
.UNINDENT
.sp
مسیرهای فایل به یک نمونهٔ در حال اجرای برنامه فرستاده شده و در آن انتخاب می‌شوند.
.sp
همچنین می‌توانید متن را با لوله (pipe) به \fBkupfer\fP هدایت کنید تا به نمونهٔ در حال اجرا ارسال شود.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B  \-\-no\-splash
راه‌اندازی بدون نمایش رابط کاربری اصلی
.TP
.B  \-\-debug
فعال‌سازی خروجی پرجزئیات‌تر که می‌تواند به درک عملکرد برنامه کمک کند.
.TP
.B  \-\-list\-plugins
فهرست کردن تمام پلاگین‌های نصب‌شده بر اساس شناسه، نسخه و توضیحات آن‌ها.
.UNINDENT
.sp
گزینه‌های زیر برای مصارف داخلی هستند
.INDENT 0.0
.TP
.BI \-\-exec\-helper\fB= HELPER
اجرای برنامهٔ کمکی پلاگین، که باید نام یک ماژول درون kupfer باشد.
.UNINDENT
.sp
گزینه‌های زیر گزینه‌های عمومی هستند
.INDENT 0.0
.TP
.B  \-\-help
نمایش اطلاعات نحوهٔ استفاده
.TP
.B  \-\-version
نمایش اطلاعات نسخه
.UNINDENT
.SH "پیکربندی (CONFIGURATION)"
.sp
پلاگین‌های سفارشی با قرارگیری در دایرکتوری \fI~/.local/share/kupfer/plugins\fP یا هر دایرکتوری kupfer/plugins درون هر یک از مسیرهای \fB$XDG_DATA_DIRS\fP به kupfer اضافه می‌شوند.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.sp
اگر \fIKUPFER_NO_CUSTOM_PLUGINS\fP تنظیم شده باشد، فقط بارگذاری پلاگین‌های داخلی (نصب‌شده در بستهٔ پایتون برنامه) مجاز خواهد بود.
.sp
اگر \fIKUPFER_NO_CACHE\fP تنظیم شده باشد، هیچ داده‌ای از فایل‌های حافظهٔ موقت (کَش) منبع خوانده نشده و در آن‌ها نوشته نمی‌شود.
.sp
اگر \fIKUPFER_NO_KEYBINDER\fP تنظیم شده باشد، حتی در صورت نصب بودن \fBKeybinder\fP از آن استفاده نخواهد شد.
.SH "عیب‌یابی / باگ‌های شناخته‌شده (TROUBLESHOOTING / KNOWN BUGS)"
.SS Wayland
.sp
تنظیم متغیر محیطی \fIGDK_BACKEND\fP به مقدار \fBx11\fP مشکل موقعیت نادرست پنجره را برطرف می‌کند.
.sp
برخی از پلاگین‌ها (برای نمونه \fIWindows\fP) به دلیل عدم پشتیبانی توسط کتابخانهٔ \fIWnck\fP کار نمی‌کنند.
.\" vim: ft=rst tw=72
.
.\" this document best viewed with::
.\" rst2pdf Quickstart.rst && xdg-open Quickstart.pdf
.
.SH "نویسندگان (AUTHORS)"
Ulrik Sverdrup
.\" End of generated man page.