'\" t
.\"     Title: git-imap-send
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: دستورات عمومی کاربر
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-IMAP\-SEND" "1" "2026\-06\-29" "Git 2\&.55\&.0" "دستورات عمومی کاربر"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-imap-send \- ارسال مجموعه‌ای از وصله‌ها از ورودی استاندارد به یک پوشه IMAP
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBimap\-send\fR [\fB\-v\fR] [\fB\-q\fR] [\fB\-\-\fR[\fBno\-\fR]\fBcurl\fR] [(\fB\-\-folder\fR|\fB\-f\fR) \fI<folder>\fR]
\fBgit\fR \fBimap\-send\fR \fB\-\-list\fR
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور یک صندوق پستی (mailbox) تولیدشده با \fBgit\fR \fBformat\-patch\fR را در پوشه پیش‌نویس‌های (drafts) یک سرور IMAP بارگذاری می‌کند\&. این کار اجازه می‌دهد تا هنگام استفاده از کلاینت‌های ایمیلی که نمی‌توانند مستقیماً فایل‌های صندوق پستی را بخوانند، وصله‌ها مانند ایمیل‌های دیگر ارسال شوند\&. این دستور همچنین با هر صندوق پستی عمومی که ایمیل‌های آن به ترتیب دارای فیلدهای \fBFrom\fR، \fBDate\fR و \fBSubject\fR باشند کار می‌کند\&.
.sp
استفاده متداول معمولاً چیزی شبیه به این است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git format\-patch \-\-signoff \-\-stdout \-\-attach origin | git imap\-send
.fi
.if n \{\
.RE
.\}
.sp
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
نمایش جزئیات کامل خروجی (پرگویی)\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
حالت بی‌صدا و عدم نمایش پیام‌های غیرضروری\&.
.RE
.PP
\fB\-f\fR \fI<folder>\fR, \fB\-\-folder=\fR\fI<folder>\fR
.RS 4
مشخص کردن پوشه‌ای که ایمیل‌ها باید در آن ذخیره شوند\&. برای مثال:
\fB\-\-folder=\fR[\fBGmail\fR]\fB/Drafts\fR
یا
\fB\-f\fR
\fBINBOX/Drafts\fR\&.
.RE
.PP
\fB\-\-curl\fR
.RS 4
استفاده از libcurl برای برقراری ارتباط با سرور IMAP، مگر اینکه از طریق تونل به آن متصل شوید\&. اگر گیت بدون فعال بودن گزینه USE_CURL_FOR_IMAP_SEND کامپایل شده باشد، نادیده گرفته می‌شود\&.
.RE
.PP
\fB\-\-no\-curl\fR
.RS 4
برقراری ارتباط با سرور IMAP با استفاده از روال‌های داخلی IMAP خود گیت به‌جای libcurl\&. اگر گیت با گزینه NO_OPENSSL کامپایل شده باشد، نادیده گرفته می‌شود\&.
.RE
.PP
\fB\-\-list\fR
.RS 4
اجرای دستور LIST در پروتکل IMAP برای خروجی دادن فهرستی از تمام پوشه‌های موجود\&.
.RE
.SH "پیکربندی (CONFIGURATION)"
.sp
برای استفاده از این ابزار، باید \fBimap\&.folder\fR و یکی از گزینه‌های \fBimap\&.tunnel\fR یا \fBimap\&.host\fR روی مقادیر مناسب تنظیم شده باشند\&.
.sp
تمام موارد بالای این خط در این بخش از مستندات \fBgit-config\fR(1) گنجانده نشده است\&. محتوایی که در ادامه می‌آید همان چیزی است که در آنجا یافت می‌شود:
.PP
\fBimap\&.folder\fR
.RS 4
پوشه‌ای که ایمیل‌ها باید در آن قرار گیرند، که معمولاً پوشه Drafts است\&. برای مثال:
\fBINBOX\&.Drafts\fR،
\fBINBOX/Drafts\fR
یا [\fBGmail\fR]\fB/Drafts\fR\&.
پوشه IMAP برای تعامل الزامی است و باید مشخص شود؛ مقدار این متغیر پیکربندی به عنوان مقدار پیش‌فرض جایگزین در زمانی که گزینه
\fB\-\-folder\fR
داده نشده باشد، استفاده می‌شود\&.
.RE
.PP
\fBimap\&.tunnel\fR
.RS 4
دستوری که برای ایجاد تونل به سرور IMAP استفاده می‌شود و دستورات به‌جای اتصال مستقیم شبکه‌ای به سرور، از طریق آن هدایت (pipe) می‌شوند\&. در صورتی که
\fBimap\&.host\fR
تنظیم نشده باشد، الزامی است\&.
.RE
.PP
\fBimap\&.host\fR
.RS 4
نشانی اینترنتی (URL) مشخص‌کننده سرور\&. از پیشوند
\fBimap://\fR
برای اتصالات غیرامن و از پیشوند
\fBimaps://\fR
برای اتصالات امن استفاده کنید\&. در صورت تنظیم بودن
\fBimap\&.tunnel\fR
نادیده گرفته می‌شود، اما در غیر این صورت الزامی است\&.
.RE
.PP
\fBimap\&.user\fR
.RS 4
نام کاربری برای ورود به سرور\&.
.RE
.PP
\fBimap\&.pass\fR
.RS 4
رمز عبور برای ورود به سرور\&.
.RE
.PP
\fBimap\&.port\fR
.RS 4
یک عدد پورت صحیح برای اتصال به سرور\&. مقدار پیش‌فرض برای میزبان‌های
\fBimap://\fR
برابر با 143 و برای میزبان‌های
\fBimaps://\fR
برابر با 993 است\&. در صورت تنظیم بودن
\fBimap\&.tunnel\fR
نادیده گرفته می‌شود\&.
.RE
.PP
\fBimap\&.sslverify\fR
.RS 4
یک مقدار بولی برای فعال/غیرفعال کردن اعتبارسنجی گواهی سرور مورداستفاده در اتصال SSL/TLS\&. مقدار پیش‌فرض
\fBtrue\fR
است\&. در صورت تنظیم بودن
\fBimap\&.tunnel\fR
نادیده گرفته می‌شود\&.
.RE
.PP
\fBimap\&.preformattedHTML\fR
.RS 4
یک مقدار بولی برای فعال/غیرفعال کردن استفاده از کدگذاری HTML هنگام ارسال وصله\&. وصله با کدگذاری HTML درون تگ‌های
\fI<pre>\fR
قرار می‌گیرد و نوع محتوای آن text/html خواهد بود\&. از قضا فعال کردن این گزینه باعث می‌شود Thunderbird وصله را به صورت یک ایمیل plain/text با format=fixed ارسال کند\&. مقدار پیش‌فرض
\fBfalse\fR
است\&.
.RE
.PP
\fBimap\&.authMethod\fR
.RS 4
مشخص کردن روش احراز هویت با سرور IMAP\&. اگر گیت با گزینه NO_CURL کامپایل شده باشد، یا نسخه curl شما قدیمی‌تر از 7\&.34\&.0 باشد، یا git\-imap\-send را با گزینه
\fB\-\-no\-curl\fR
اجرا می‌کنید، تنها روش‌های پشتیبانی‌شده عبارتند از
\fBPLAIN\fR،
\fBCRAM\-MD5\fR،
\fBOAUTHBEARER\fR
و
\fBXOAUTH2\fR\&.
اگر این گزینه تنظیم نشده باشد،
\fBgit\fR
\fBimap\-send\fR
از دستور اولیه و متن‌ساده IMAP یعنی
\fBLOGIN\fR
استفاده می‌کند\&.
.RE
.SH "دریافت فهرست پوشه‌های در دسترس (GETTING A LIST OF AVAILABLE FOLDERS)"
.sp
برای ارسال ایمیل به یک پوشه خاص، باید نام صحیح پوشه مورد نظر را در صندوق پستی خود بدانید\&. نام‌هایی مانند "Junk"، "Trash" و غیره که توسط کلاینت‌های ایمیل مختلف نمایش داده می‌شوند، لزوماً نام‌های واقعی پوشه‌های ذخیره‌شده در سرور ارائه‌دهنده ایمیل شما نیستند\&.
.sp
به منظور دریافت نام صحیح پوشه برای استفاده با \fBgit\fR \fBimap\-send\fR، می‌توانید دستور \fBgit\fR \fBimap\-send\fR \fB\-\-list\fR را اجرا کنید\&. این کار فهرستی از نام‌های معتبر پوشه‌ها را نمایش می‌دهد\&. یک نمونه از چنین خروجی هنگام اجرا روی یک حساب جیمیل به این صورت است:
.sp
.if n \{\
.RS 4
.\}
.nf
* LIST (\eHasNoChildren) "/" "INBOX"
* LIST (\eHasChildren \eNoselect) "/" "[Gmail]"
* LIST (\eAll \eHasNoChildren) "/" "[Gmail]/All Mail"
* LIST (\eDrafts \eHasNoChildren) "/" "[Gmail]/Drafts"
* LIST (\eHasNoChildren \eImportant) "/" "[Gmail]/Important"
* LIST (\eHasNoChildren \eSent) "/" "[Gmail]/Sent Mail"
* LIST (\eHasNoChildren \eJunk) "/" "[Gmail]/Spam"
* LIST (\eFlagged \eHasNoChildren) "/" "[Gmail]/Starred"
* LIST (\eHasNoChildren \eTrash) "/" "[Gmail]/Trash"
.fi
.if n \{\
.RE
.\}
.sp
در اینجا می‌توانید مشاهده کنید که نام صحیح برای پوشه "Junk" برابر با [\fBGmail\fR]\fB/Spam\fR و برای پوشه "Trash" برابر با [\fBGmail\fR]\fB/Trash\fR است\&. از منطق مشابه می‌توان برای تعیین سایر پوشه‌ها نیز استفاده کرد\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
استفاده از حالت تونل:
.sp
.if n \{\
.RS 4
.\}
.nf
[imap]
    folder = "INBOX\&.Drafts"
    tunnel = "ssh \-q \-C user@example\&.com /usr/bin/imapd \&./Maildir 2> /dev/null"
.fi
.if n \{\
.RE
.\}
.sp
استفاده از حالت مستقیم:
.sp
.if n \{\
.RS 4
.\}
.nf
[imap]
    folder = "INBOX\&.Drafts"
    host = imap://imap\&.example\&.com
    user = bob
    pass = p4ssw0rd
.fi
.if n \{\
.RE
.\}
.sp
استفاده از حالت مستقیم همراه با SSL:
.sp
.if n \{\
.RS 4
.\}
.nf
[imap]
    folder = "INBOX\&.Drafts"
    host = imaps://imap\&.example\&.com
    user = bob
    pass = p4ssw0rd
    port = 123
    ; sslVerify = false
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBیادداشت\fR
.ps -1
.br
.sp
ممکن است بخواهید هنگام عیب‌یابی از \fBsslVerify=false\fR استفاده کنید، در صورتی که احتمال می‌دهید دلیل بروز مشکل در اتصال این است که گواهی مورداستفاده در سرور خصوصی \fBexample\&.com\fR که قصد راه‌اندازی آن را دارید (یا راه‌اندازی کرده‌اید) ممکن است به درستی تأیید نشده باشد\&.
.sp .5v
.RE
.sp
استفاده از رابط IMAP جیمیل:
.sp
.if n \{\
.RS 4
.\}
.nf
[imap]
    folder = "[Gmail]/Drafts"
    host = imaps://imap\&.gmail\&.com
    user = user@gmail\&.com
    port = 993
.fi
.if n \{\
.RE
.\}
.sp
.sp
جیمیل اجازه استفاده از گذرواژه معمولی شما را برای \fBgit\fR \fBimap\-send\fR نمی‌دهد\&. اگر در حساب جیمیل خود احراز هویت چندعاملی را تنظیم کرده‌اید، می‌توانید یک گذرواژه مخصوص برنامه (app\-specific password) برای استفاده با \fBgit\fR \fBimap\-send\fR تولید کنید\&. برای ایجاد آن به \m[blue]\fBhttps://security\&.google\&.com/settings/security/apppasswords\fR\m[] مراجعه کنید\&. متناوباً، می‌توانید از احراز هویت بر پایه OAuth2\&.0 همان‌طور که در ادامه توضیح داده شده است استفاده کنید\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBیادداشت\fR
.ps -1
.br
.sp
اگر خطایی دریافت کردید مبنی بر اینکه "Folder doesn\(cqt exist" (پوشه وجود ندارد)، ممکن است لازم باشد در عوض از \fBfolder\fR \fB=\fR "[\fBGoogle\fR \fBMail\fR]\fB/Drafts\fR" استفاده کنید\&. همچنین می‌توانید دستور \fBgit\fR \fBimap\-send\fR \fB\-\-list\fR را برای دریافت فهرست پوشه‌های موجود اجرا نمایید\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBیادداشت\fR
.ps -1
.br
.sp
اگر حساب جیمیل شما روی زبانی غیر از انگلیسی تنظیم شده باشد، نام پوشه "Drafts" بومی‌سازی خواهد شد\&.
.sp .5v
.RE
.sp
اگر می‌خواهید از احراز هویت مبتنی بر OAuth2\&.0 استفاده کنید، می‌توانید سازوکار \fBOAUTHBEARER\fR یا \fBXOAUTH2\fR را در پیکربندی خود مشخص کنید\&. این روش امن‌تر از استفاده از گذرواژه‌های مخصوص برنامه است و همچنین نیازی به داشتن احراز هویت چندعاملی را تحمیل نمی‌کند\&. هنگام استفاده از این احراز هویت، باید از یک توکن دسترسی OAuth2\&.0 به جای گذرواژه خود استفاده کنید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[imap]
    folder = "[Gmail]/Drafts"
    host = imaps://imap\&.gmail\&.com
    user = user@gmail\&.com
    port = 993
    authmethod = OAUTHBEARER
.fi
.if n \{\
.RE
.\}
.sp
.sp
استفاده از رابط IMAP اوت‌لوک (Outlook):
.sp
برخلاف جیمیل، اوت‌لوک فقط از احراز هویت مبتنی بر OAuth2\&.0 پشتیبانی می‌کند\&. همچنین تنها از \fBXOAUTH2\fR به عنوان سازوکار پشتیبانی می‌نماید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[imap]
    folder = "Drafts"
    host = imaps://outlook\&.office365\&.com
    user = user@outlook\&.com
    port = 993
    authmethod = XOAUTH2
.fi
.if n \{\
.RE
.\}
.sp
.sp
پس از آماده شدن کامیت‌ها برای ارسال، دستور زیر را اجرا کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git format\-patch \-\-cover\-letter \-M \-\-stdout origin/master | git imap\-send
.fi
.if n \{\
.RE
.\}
.sp
فقط مطمئن شوید که شکستن خطوط (line wrapping) را در کلاینت ایمیل غیرفعال کرده‌اید (رابط وب جیمیل در هر صورت خطوط را می‌شکند، بنابراین باید از یک کلاینت واقعی IMAP استفاده کنید)\&.
.sp
در صورتی که از احراز هویت OAuth2\&.0 استفاده می‌کنید، استفاده از دستیارهای اعتبارسنجی (credential helpers) برای تولید توکن‌ها آسان‌تر است\&. دستیارهای اعتبارنامه‌ای که در \fBgit-send-email\fR(1) پیشنهاد شده‌اند، می‌توانند برای \fBgit\fR \fBimap\-send\fR نیز استفاده شوند\&.
.SH "هشدار (CAUTION)"
.sp
همچنان مسئولیت این موضوع با شماست که اطمینان حاصل کنید پیام ایمیل ارسال‌شده توسط برنامه ایمیل شما با استانداردهای پروژه مطابقت دارد\&. بسیاری از پروژه‌ها دوست ندارند وصله‌ها به صورت ضمیمه (attachment) ارسال شوند\&. برخی از نرم‌افزارهای ایمیل وصله‌ها را به روش‌هایی تغییر می‌دهند (مانند شکستن خطوط، ارسال آن‌ها به صورت format=flowed) که باعث شکست و نامعتبر شدن آن‌ها می‌شود\&. اگر این مورد را بررسی نکنید، با انتقادهای تند مواجه خواهید شد\&.
.sp
به‌ویژه مشخص شده است که تاندربرد (Thunderbird) مشکل‌ساز است\&. کاربران Thunderbird می‌توانند برای اطلاعات بیشتر به این صفحه وب مراجعه کنند: \m[blue]\fBhttps://kb\&.mozillazine\&.org/Plain_text_e\-mail_\-_Thunderbird#Completely_plain_email\fR\m[]
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-format-patch\fR(1), \fBgit-send-email\fR(1), mbox(5)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)