.\"                                      Hey, EMACS: -*- nroff -*-
.\" (C) Copyright 2018 Boyuan Yang <073plan@gmail.com>,
.\" This file is released under CC0 1.0 Universal (CC0-1.0) license.
.\"
.TH "FLAMESHOT" "1" "2021-11-11"
.\" 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 <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH "نام (NAME)"
Flameshot \- نرم‌افزار قدرتمند و در عین حال ساده برای ثبت تصویر از صفحه نمایش
.SH "خلاصه دستور (SYNOPSIS)"
.B flameshot
[subcommands] [arguments]
.br
.B flameshot gui
[gui arguments]
.br
.B flameshot screen
[screen arguments]
.br
.B flameshot full
[fullscreen arguments]
.br
.B flameshot config
[config arguments]
.br
.B flameshot launcher
.br
.
.\"----------------------------------------------------------------------------
.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما به طور خلاصه دستور
.B flameshot
عرضه‌شده توسط بسته
.B flameshot
را شرح می‌دهد.
.PP
ابزار \fBflameshot\fP برنامه‌ای برای گرفتن اسکرین‌شات است که هدف آن ارائه امکاناتی قدرتمند در کنار کاربری ساده است.
از ویژگی‌های برجسته آن می‌توان به ظاهر قابل شخصی‌سازی، ویرایش درون‌برنامه‌ای تصویر گرفته‌شده،
رابط کاربری D-Bus، پشتیبانی از آیکون سینی اعلان سیستم (tray)، پشتیبانی آزمایشی از وی‌لند در GNOME/KDE،
یکپارچگی با Imgur و پشتیبانی از هر دو رابط کاربری گرافیکی (GUI) و خط فرمان (CLI) اشاره کرد.
.PP
افزون بر اطلاعات نحوه استفاده از \fBflameshot\fR در این صفحه راهنما، می‌توانید اطلاعات مشابهی را با استفاده از \fBflameshot --help\fR نیز مشاهده کنید. همچنین می‌توان از همان گزینه \fB--help\fR برای هر زیردستور استفاده کرد تا آرگومان‌های مجاز آن نمایش داده شوند. جزئیات بیشتر درباره نحوه استفاده از \fBflameshot\fP در فایل \fIREADME.md\fR در صفحه مخزن گیت پروژه مستند شده است:
https://github.com/flameshot-org/flameshot
.
.\"----------------------------------------------------------------------------
.SH "زیردستورها (SUBCOMMANDS)"
.PP
به طور پیش‌فرض و بدون ذکر زیردستورها، \fBflameshot\fR در پس‌زمینه اجرا شده و یک آیکون سینی سیستم برای پیکربندی اضافه می‌کند. توجه داشته باشید که این دستور اسکرین‌شاتی نخواهد گرفت مگر اینکه یکی از حالت‌ها را از طریق زیردستورها مشخص کنید. زیردستورهای گوناگونی برای استفاده از flameshot در حالت‌های مختلف وجود دارند:
.
.TP
.B gui
اجرای Flameshot در حالت \fBgui\fR به کاربر امکان می‌دهد ناحیه‌ای را که باید از آن اسکرین‌شات گرفته شود انتخاب کرده و سپس روی آن یادداشت‌نویسی و ویرایش انجام دهد.
.
.TP
.B full
گرفتن اسکرین‌شات از تمام نمایشگرها به صورت همزمان.
.
.TP
.B screen
گرفتن اسکرین‌شات از نمایشگر مشخص‌شده.
.
.TP
.B launcher
هیچ آرگومانی نمی‌پذیرد؛ صرفاً پنجره راه‌انداز (launcher) را باز می‌کند.
.
.TP
.B config
اگر هیچ آرگومانی ارائه نشود، پنجره تنظیمات را باز می‌کند؛ در غیر این صورت تنظیمات را بر اساس آرگومان‌های ارائه‌شده تغییر می‌دهد.
.
.\"----------------------------------------------------------------------------
.SH "آرگومان‌ها (ARGUMENTS)"
.PP
در اینجا تمامی آرگومان‌های موجود برای همه زیردستورها فهرست شده‌اند. زیردستورهایی که هر آرگومان را می‌پذیرند در ذیل آن ذکر شده‌اند. همچنین می‌توانید از \fBflameshot [subcommand] --help\fR برای مشاهده فهرست آرگومان‌های معتبر برای هر زیردستور استفاده کنید.
.
.PP
\-s, \-\-accept-on-select
.RS 4
تایید و ذخیره تصویر به محض انتخاب ناحیه
.br
معتبر برای زیردستورهای: gui
.RE
.
.PP
\-a, \-\-autostart <bool>
.RS 4
فعال‌سازی یا غیرفعال‌سازی اجرا در هنگام شروع به کار سیستم
.br
معتبر برای زیردستورهای: config
.RE
.
.PP
\-\-check
.RS 4
بررسی فایل پیکربندی برای یافتن خطاها. این گزینه زمانی سودمند است که فایل پیکربندی را به صورت دستی ویرایش کرده‌اید و می‌خواهید مطمئن شوید که فاقد خطا است.
.br
معتبر برای زیردستورهای: config
.RE
.
.PP
\-c, \-\-clipboard
.RS 4
ذخیره تصویر گرفته‌شده در کلیپ‌بورد
.br
معتبر برای زیردستورهای: full, gui, screen
.RE
.
.PP
\-k, \-\-contrastcolor <color-code>
.RS 4
تعیین رنگ کنتراست رابط کاربری
.br
معتبر برای زیردستورهای: config
.RE
.
.PP
\-d, \-\-delay <milliseconds>
.RS 4
مدت زمانی که Flameshot باید پیش از گرفتن اسکرین‌شات منتظر بماند (به میلی‌ثانیه)
.br
معتبر برای زیردستورهای: full, gui, screen
.RE
.
.PP
\-e, \-\-edit
.RS 4
انتخاب و ویرایش تعاملی ناحیه اسکرین‌شات
.br
معتبر برای زیردستورهای: screen
.RE
.
.PP
\-f, \-\-filename <pattern>
.RS 4
تنظیم الگوی نام فایل
.br
معتبر برای زیردستورهای: config
.RE
.
.PP
\-h, \-\-help
.RS 4
نمایش یک پیام راهنمای مختصر و فهرست آرگومان‌های معتبر برای آن زیردستور
.br
معتبر برای زیردستورهای: config, full, gui, launcher, screen
.RE
.
.PP
\-\-last-region
.RS 4
تکرار اسکرین‌شات با ناحیه انتخابی پیشین
.br
معتبر برای زیردستورهای: gui
.RE
.
.PP
\-m, \-\-maincolor <color-code>
.RS 4
تعیین رنگ اصلی رابط کاربری
.br
معتبر برای زیردستورهای: config
.RE
.
.PP
\-n, \-\-notifications
.RS 4
فعال یا غیرفعال کردن اعلان‌ها
.br
معتبر برای زیردستورهای: config
.RE
.
.PP
\-n, \-\-number <Screen number>
.RS 4
تعیین نمایشگر جهت گرفتن اسکرین‌شات (شروع از ۰)، پیش‌فرض: نمایشگری که مکان‌نما در آن قرار دارد
.br
معتبر برای زیردستورهای: screen
.RE
.
.PP
\-p, \-\-path <path>
.RS 4
دایرکتوری موجود یا فایل جدید برای ذخیره تصویر در آن
.br
معتبر برای زیردستورهای: full, gui, screen
.RE
.
.PP
\-\-pin
.RS 4
سنجاق کردن تصویر گرفته‌شده روی صفحه نمایش
.br
معتبر برای زیردستورهای: gui, screen
.RE
.
.PP
\-g, \-\-print-geometry
.RS 4
چاپ ابعاد هندسی ناحیه انتخابی در قالب WxH+X+Y. در صورت تعیین raw اثری ندارد
.br
معتبر برای زیردستورهای: gui
.RE
.
.PP
\-r, \-\-raw
.RS 4
ارسال فایل خام PNG به خروجی استاندارد (stdout)
.br
معتبر برای زیردستورهای: full, gui, screen
.RE
.
.PP
\-\-region <WxH+X+Y or string>  
.RS 4
ناحیه اسکرین‌شات برای انتخاب
.br
معتبر برای زیردستورهای: gui, screen
.RE
.
.PP
\-s, \-\-showhelp <bool>
.RS 4
نمایش پیام راهنما در حالت گرفتن تصویر
.br
معتبر برای زیردستورهای: config
.RE
.
.PP
\-t, \-\-trayicon <bool>
.RS 4
فعال یا غیرفعال کردن آیکون سینی سیستم
.br
معتبر برای زیردستورهای: config
.RE
.
.\"----------------------------------------------------------------------------
.SH "مثال‌ها (EXAMPLES)"
.PP
این بخش برخی از متداول‌ترین شیوه‌های استفاده از \fBflameshot\fR از طریق خط فرمان را فهرست می‌کند.
.
.TP
.B flameshot
اجرای flameshot در پس‌زمینه. در صورت فعال بودن، آیکونی در بخش سینی سیستم محیط میزکار فعلی نمایان خواهد شد.
.
.TP
.B flameshot gui
گرفتن تصویر با رابط کاربری گرافیکی.
.
.TP
\fBflameshot gui\fR \-p /path/to/captures
گرفتن تصویر با رابط کاربری گرافیکی و ذخیره در مسیر دلخواه.
.
.TP
\fBflameshot gui\fR \-d 2000
باز کردن رابط گرافیکی با ۲ ثانیه تاخیر.
.
.TP
.B flameshot launcher
باز کردن کادر محاوره‌ای راه‌انداز برای گرفتن اسکرین‌شات پیشرفته مانند تاخیر زمانی سفارشی و غیره.
.
.TP
.B flameshot full \-\-help
نمایش راهنما برای زیردستور \fBflameshot full\fR.
.
.TP
\fBflameshot full\fR -p /path/to/captures -d 5000
گرفتن تصویر تمام‌صفحه با مسیر ذخیره دلخواه (بدون رابط گرافیکی) و تاخیر زمانی.
.
.TP
\fBflameshot full\fR -c -p /path/to/captures
گرفتن تصویر تمام‌صفحه با مسیر ذخیره دلخواه و رونوشت در کلیپ‌بورد.
.
.TP
\fBflameshot screen\fR \-\-number <screen number>
تعیین نمایشگر جهت گرفتن تصویر. به طور پیش‌فرض از صفحه‌ای که مکان‌نما در آن قرار دارد تصویر می‌گیرد.
.
.TP
\fBflameshot screen\fR \-\-help
نمایش راهنما برای زیردستور \fBflameshot screen\fR.
.
.\"----------------------------------------------------------------------------
.SH "مقدار بازگشتی (RETURN VALUE)"
در صورت خروج عادی مقدار 0، در صورت لغو اسکرین‌شات مقدار 2، در صورت قطع اتصال dbus مقدار 3، در صورت دریافت SIGINT مقدار 130 و در صورت دریافت SIGTERM مقدار 143 را بازمی‌گرداند.
.
.\"----------------------------------------------------------------------------
.SH "همچنین ببینید (SEE ALSO)"
.PP
همچنین می‌توانید مستندات برخط و تفصیلی بیشتری را در صفحه اصلی پروژه بالادست بیابید.
.
.HP
صفحه اصلی پروژه بالادست:
.br
• \m[blue]\fBhttps://flameshot.org\fR\m[]
.br
• \m[blue]\fBhttps://github.com/flameshot-org/flameshot\fR\m[]
.
.\"----------------------------------------------------------------------------
.SH "نویسندگان (AUTHORS)"
.PP
.ad l
برنامه
.B Flameshot
در ابتدا توسط
.MT izhe@\:hotmail.es
lupoDharkael
.ME
نوشته شد و در حال حاضر توسط
Jeremy Borgman,
.MT byang@\:debian.org
Boyuan Yang
.ME ,
Haris Gušić,
Ahmed Zetao Yang,
Mehrad Mahmoudian,
و
Martin Eckleben
(بر اساس تعداد مشارکت‌ها در تاریخ نگارش این صفحه راهنما) نگهداری می‌شود.
.br
پیوند زیر فهرست کامل‌تری از مشارکت‌کنندگان را ارائه می‌دهد:
.RS
\m[blue]\fBhttps://github.com/flameshot-org/flameshot/graphs/contributors\fR\m[]\&.
.RE
.
.\"----------------------------------------------------------------------------
.SH "مجوز (LICENSE)"
.nh
.PP
• کد اصلی تحت مجوز GPLv3+ منتشر شده است
.br
• نشان‌واره (لوگو) Flameshot تحت مجوز Free Art License v1.3 منتشر شده است
.br
• آیکون‌های دکمه‌ها تحت مجوز Apache License 2.0 قرار دارند. ببینید: \m[blue]\fBhttps://github.com/google/material-design-icons\fR\m[]
.br
• کد در capture/capturewidget.cpp بر پایه \m[blue]\fBhttps://github.com/ckaiser/Lightscreen/blob/master/dialogs/areadialog.cpp\fR\m[] است (GPLv2)
.br
• کد در capture/capturewidget.h بر پایه \m[blue]\fBhttps://github.com/ckaiser/Lightscreen/blob/master/dialogs/areadialog.h\fR\m[] است (GPLv2)
.br
• چند خط کد از KSnapshot در regiongrabber.cpp ویرایش 796531 مخزن SVN برگرفته شده است (LGPL)
.br
• ابزارک‌های Qt-Color-Widgets از \m[blue]\fBhttps://github.com/mbasaglia/Qt-Color-Widgets\fR\m[] گرفته و تغییر داده شده‌اند (مجوز و استثنائات آن‌ها را در پروژه ببینید) (LGPL/GPL)